O Cockpit API tem três superfícies distintas. Escolha a integração de acordo com o trabalho, antes de enviar credenciais.
#Quando usar
Use o Cockpit para coordenar agentes de programação no computador da pessoa, pedir tarefas numa missão existente e acompanhar entregas, revisões e testes. Use o MCP remoto quando o agente está na nuvem; use a API local quando o agente já está no computador que executa o Cockpit. O site não executa projetos nem oferece um sandbox público de programação.
#API pública do site
A especificação OpenAPI 3.1.1 descreve a descoberta de integrações, ativação de licença e troca de login do aplicativo. Cada operação tem identificador único, descrição e schemas tipados para uso em ferramentas de agentes. GET /api devolve os links de descoberta sem autenticação.
POST /api/v1/license recebe JSON com key, deviceId e, opcionalmente, label e appVersion. A chave é criada pela própria pessoa no painel; não é uma chave para a API local de missões. Novos testes exigem cartão confirmado no Stripe antes da ativação. Peça autorização antes de ativar um computador. A operação admite 120 pedidos por IP por hora.
POST /api/v1/app-login recebe o secret do fluxo iniciado pelo aplicativo e um label opcional. Consulte a cada dois segundos por até dez minutos: 202 significa aguardar aprovação no navegador; 200 entrega a chave uma única vez. Não registre chaves ou segredos nos logs.
Erros dessa API usam JSON com error, code, message e resolution. Em 429, respeite Retry-After. OAuth usa os erros próprios do protocolo; MCP usa JSON-RPC, sem converter esses formatos para o formato da API de licenças.
#Cockpit MCP remoto
O endpoint de transporte é https://cockpit.vep.sh/mcp, por Streamable HTTP. Ele aceita POST e OPTIONS; não mantém fluxo SSE por GET. Configure esse endereço como servidor MCP remoto no seu cliente. Siga a descoberta OAuth em /.well-known/oauth-protected-resource e /.well-known/oauth-authorization-server. O cliente solicita autorização com PKCE e a pessoa escolhe o computador e a missão que serão compartilhados.
Depois da autorização, use Authorization: Bearer <access_token> e o protocolo MCP para inicializar, descobrir ferramentas com tools/list e chamar uma ferramenta com tools/call. A lista real vem do Cockpit conectado; não presuma nomes de ferramentas. O aplicativo precisa estar aberto, online e com o relay e a missão liberados. Há limite de 240 pedidos por concessão por minuto. As permissões da missão continuam valendo.
Veja o passo a passo de conexão. A documentação do servidor fica nesta página; o próprio /mcp é um endpoint de protocolo e responde 405 a GET.
#API local e CLI
A API e WebSocket locais usam o servidor do aplicativo, normalmente http://127.0.0.1:4000. Consulte /api/openapi.json nesse servidor para a especificação local e use o token configurado pela pessoa. Nunca envie esse token ao site.
Os comandos do servidor documentam o CLI disponível no checkout compilado. Não há nesta documentação um pacote oficial publicado no npm, PyPI ou Homebrew para instalar o Cockpit globalmente. Não confunda os CLIs dos provedores de IA com um CLI distribuído do Cockpit.
#Começar sem falar com vendas
Crie uma conta, baixe o aplicativo e gere sua chave em Painel → Chaves. O teste dura 7 dias a partir da confirmação do cartão no Stripe. Cobrança automática depois do teste, se você não cancelar. As contas e custos dos provedores de IA são separados. Para experimentar automação, use um projeto de teste no seu computador; não há ambiente sandbox hospedado separado nem chave pública compartilhada.