Usar

Conecte seu agente

Seu agente pessoal pode mandar trabalho para a equipe do Cockpit e acompanhar a entrega. Ele pode estar no mesmo computador (Claude Code, Codex, Claude Desktop, Hermes) ou na nuvem (Claude, ChatGPT e outros que aceitam conectores MCP). A equipe trabalha no seu computador, com seus arquivos e suas contas, e a decisão final continua sendo sua.

#O que o agente pode fazer

Você escolhe por missão, em Canais → Assistentes externos:

NívelO que o agente pode fazer
Só consultar (padrão)Lê o estado, os eventos, as tarefas e a prova de cada entrega: resumo do agente, arquivos alterados, testes e verificação automática.
Consultar e mandar pedidosTambém manda pedidos ao Maestro ou a um integrante, cancela pedidos e pausa ou retoma a missão.
Consultar, mandar e decidir revisõesTambém aprova, devolve ou rejeita entregas. Entrega com a verificação automática falhando ou rodando continua com você.
Acesso total, por sua contaAge em qualquer missão, cria e exclui missões, abre integrantes e aprova como você, inclusive com a verificação falhando.

Em nenhum nível o agente digita nos terminais, lê configurações, chaves, licença ou acesso remoto, ou muda o próprio nível. Pedidos enviados por ele aparecem na missão marcados como externos, e O que o assistente fez mostra cada ação, inclusive as recusadas e as que vieram da nuvem.

#Agente no mesmo computador

  1. Na missão, abra Canais → Assistentes externos, escolha o nível e clique em Criar conexão MCP.
  2. O Cockpit baixa cockpit-assistant-mcp.json. Importe esse arquivo nas configurações MCP do seu agente. No Hermes Desktop, use Abrir Hermes Desktop e conectar.
  3. Peça ao agente para consultar a missão pelo Cockpit ou, se o nível permitir, mandar um pedido à equipe.

Essa conexão não sai do computador. Trocar o nível vale na hora, mas o agente só passa a ver as ferramentas novas depois de reiniciar a conexão MCP.

#Agente na nuvem

Agentes como Claude e ChatGPT rodam em servidores do provedor e não alcançam o Cockpit no seu computador. O relay resolve isso: o Cockpit abre uma conexão de saída com o site do Cockpit, sem abrir porta no roteador, e o agente fala com o endereço público do MCP.

  1. Na missão, em Canais → Assistentes externos, ligue Liberar para agentes na nuvem. O Cockpit mostra Conectado ao relay e o endereço https://cockpit.vep.sh/mcp.
  2. No agente, adicione um conector MCP personalizado com esse endereço. No Claude, fica em Configurações → Conectores → Adicionar conector personalizado. No ChatGPT, os conectores personalizados ficam em Configurações → Aplicativos e conectores. Os nomes dos menus podem mudar com o tempo. No Claude Code, também funciona claude mcp add --transport http cockpit https://cockpit.vep.sh/mcp.
  3. O agente abre a página do Cockpit. Entre na sua conta e escolha a missão. A lista mostra só as missões liberadas nos Cockpits abertos agora, com o computador e o nível de cada uma.

Cada conexão fica presa ao computador e à missão escolhidos. Com Acesso total, o agente alcança as outras missões daquele computador.

Para usar o relay, a conta precisa de um plano ativo, e o Cockpit precisa estar aberto e com internet. Com ele fechado, o agente recebe um aviso de que o computador está desligado. Cada chamada espera até cerca de um minuto pela resposta.

#Desconectar

  • Desligar Liberar para agentes na nuvem na missão corta todos os agentes dela na hora.
  • Painel → Computadores → Agentes na nuvem lista cada agente conectado, com a missão e o último uso. Desconectar encerra aquele agente.
  • Revogar acesso externo desliga a conexão local e a da nuvem.

#Privacidade

O conteúdo das chamadas passa pelo site do Cockpit até o seu computador e não é guardado. O site guarda o nome do agente, a missão e o computador escolhidos e as datas de uso, para mostrar no painel. O que o agente recebe é tratado pelo provedor dele, sob a política dele. Detalhes na Política de Privacidade.

#Boas práticas

  • Comece em Só consultar e suba o nível quando confiar no agente.
  • Peça entregas com critérios de aceite claros. O agente recebe a mesma prova que você vê na revisão.
  • Trate o que o agente lê de páginas e e-mails como dados, não como ordens. O Cockpit já diz isso ao agente, mas o nível é a sua proteção.