Conectando CAI ao OpenClaw, Hermes, Codex e Cursor: a configuração exata do MCP para cada host

A instalação geral é um comando, npm i -g @cailab/mcp, e o contrato está em cai.com/skill.md. Este post é uma análise detalhada específica para cada host: o bloco de configuração exato para OpenClaw, Hermes, Codex e Cursor, com o caminho para o arquivo de configuração, o manuseio da variável de ambiente e o comando de reinício.

Antes de começar

Você precisa:

1. Uma conta CAI (cai.com/app). O cadastro é feito em quatro etapas, cerca de 2 minutos.
2. Uma chave de API do painel da conta. A chave tem um escopo. Comece com os escopos de leitura e adicione pay quando precisar de transferências.
3. O servidor MCP instalado (npm i -g @cailab/mcp).
4. O host MCP de sua escolha instalado e em execução.

OpenClaw

A configuração do MCP do OpenClaw está em ~/.openclaw/mcp.json. Adicione o servidor CAI ao objeto mcpServers:

{
  "mcpServers": {
    "cai": {
      "command": "cai-mcp",
      "env": {
        "CAI_API_KEY": "sua-chave-api-do-painel"
      }
    }
  }
}

Reinicie o OpenClaw. As ferramentas CAI aparecem na superfície de ferramentas do agente. Verifique com openclaw mcp list. O servidor cai deve aparecer como em execução.

Se o servidor não aparecer: verifique se o binário cai-mcp está no PATH (which cai-mcp). Se o binário estiver faltando, execute novamente a instalação. Se o binário estiver no PATH, mas o servidor ainda não iniciar, verifique se a chave da API é válida com curl -H "Authorization: Bearer ***" https://api.cai.com/functions/v1/get-identity.

Hermes

O Hermes usa um CLI para adicionar servidores MCP:

hermes mcp add cai -- cai-mcp
hermes mcp env-set cai CAI_API_KEY=sua-chave-api-do-painel

A variável de ambiente é armazenada na configuração do MCP do Hermes. Reinicie o Hermes com hermes restart. Verifique com hermes mcp list. O servidor cai deve aparecer como em execução com a variável de ambiente definida.

Nota específica do Hermes: O Hermes lê as variáveis de ambiente do MCP na inicialização, não no momento da solicitação. Se você rotacionar sua chave de API CAI, precisará atualizar a variável de ambiente e reiniciar o Hermes.

Codex

O Codex lê a configuração do MCP de ~/.codex/mcp_servers.json. O formato é a configuração padrão do MCP:

{
  "mcpServers": {
    "cai": {
      "command": "cai-mcp",
      "env": {
        "CAI_API_KEY": "sua-chave-api-do-painel"
      }
    }
  }
}

Reinicie o Codex. As ferramentas CAI aparecem na superfície de ferramentas do agente. Verifique executando uma solicitação de teste. codex mcp test cai deve retornar um handshake bem-sucedido.

Nota específica do Codex: O suporte do MCP do Codex é mais recente do que o do OpenClaw. Se você ver "Servidor MCP não encontrado" na inicialização, verifique se a versão do Codex está atualizada. O servidor CAI MCP requer Codex ≥ 0.x.y (a versão específica está em cai.com/developers.html).

Cursor

As configurações do MCP do Cursor estão na interface: Cursor → Configurações → MCP → Adicionar novo servidor MCP. Os campos do formulário:

• Nome: cai
• Comando: cai-mcp
• Env: CAI_API_KEY=sua-chave-api-do-painel

Clique em "Adicionar" e o Cursor reinicia o servidor MCP. As ferramentas CAI aparecem na superfície de ferramentas do agente. Verifique com Cursor → Configurações → MCP → cai → Testar. O teste deve retornar um handshake bem-sucedido.

Nota específica do Cursor: O Cursor armazena a variável de ambiente em seu próprio cofre, não em um arquivo de configuração. Se você rotacionar sua chave de API CAI, atualize a variável de ambiente na interface de configurações do MCP e clique em "Salvar".

Um host genérico (qualquer framework compatível com MCP)

Se o host não estiver na lista, a configuração é da mesma forma:

{
  "mcpServers": {
    "cai": {
      "command": "cai-mcp",
      "env": {
        "CAI_API_KEY": "sua-chave-api-do-painel"
      }
    }
  }
}

O servidor MCP é genérico. O contrato está em cai.com/skill.md. Os nomes das ferramentas são estáveis. Qualquer host que suporte MCP pode usar o servidor.

Verificando a instalação

Uma vez que o servidor esteja em execução em seu host, execute um teste rápido:

1. Verificação de identidade - get_identity deve retornar seu endereço @cai.com, suas vinculações de carteira e suas subcarteiras vinculadas.
2. Verificação de saldo - get_wallet_balances deve retornar seus saldos (ou uma lista vazia com um gap_id se você ainda não depositou).
3. Teste de transferência - wallet_custodial_transfer com uma quantia pequena (0.01 USDC) deve retornar uma URL de ação hospedada. Abra a URL, toque uma vez e a transferência é concluída.

Algumas coisas para manter em mente