Conectar o Cursor e o Codex

O Cursor e o Codex comunicam através de MCP sobre HTTP. O endpoint e as credenciais são os mesmos que para o Claude Code; apenas o ficheiro de configuração difere. Esta página mostra os formatos de configuração e as verificações que confirmam que a ligação funciona.

1. Criar um token

Em chat.ismscopilot.com, abra Definições → Connected apps → Create token. Conceda os âmbitos necessários, copie o valor pat-isms-… uma vez e mantenha-o fora de ficheiros submetidos ao controlo de versões.

Para a lista de capacidades e o que cada ferramenta pode fazer, consulte ISMS Copilot para agentes. Para âmbitos e ciclo de vida do token, consulte Tokens e âmbitos.

2. Endpoint

https://account.ismscopilot.com/v1/account/mcp

Transporte: HTTP MCP. Autenticação: Authorization: Bearer pat-isms-…

3. Configuração do Cursor

O Cursor lê servidores MCP a partir de um ficheiro mcp.json: a nível de projeto em .cursor/mcp.json ou global em ~/.cursor/mcp.json. Em 2026-09, uma entrada de servidor HTTP com cabeçalhos personalizados tem o seguinte aspeto:

{
  "mcpServers": {
    "ismscopilot": {
      "url": "https://account.ismscopilot.com/v1/account/mcp",
      "headers": {
        "Authorization": "Bearer pat-isms-..."
      }
    }
  }
}

Adicione a entrada (nas Definições do Cursor, secção MCP, ou crie o ficheiro diretamente), reinicie o Cursor e confirme que ismscopilot aparece na lista de ferramentas MCP.

4. Configuração do Codex

O Codex lê o ficheiro ~/.codex/config.toml. Em 2026-09, uma entrada de servidor MCP HTTP tem o seguinte aspeto:

[mcp_servers.ismscopilot]
url = "https://account.ismscopilot.com/v1/account/mcp"

[mcp_servers.ismscopilot.http_headers]
"Authorization" = "Bearer pat-isms-..."

Reinicie o Codex após a edição. Se a sua versão do Codex utilizar um nome de chave diferente para cabeçalhos HTTP, siga a documentação MCP atual; as partes constantes são o URL e o cabeçalho Bearer pat-isms-….

5. Teste de funcionamento

Peça ao agente para listar os seus workspaces do ISMS Copilot. Se as ferramentas não aparecerem:

• reinicie o cliente após adicionar o servidor,
• confirme que o token não foi truncado ao colar (deve começar com pat-isms-),
• confirme que o URL é o host da conta indicado acima, não um host de API.

Se atingir o limite de utilização

A ligação utiliza a mesma janela de sessão de 4 horas (UTC) da aplicação de chat. Se create_conversation ou send_message atingir o limite, o primeiro texto de erro é a frase de espera ou de atualização (incluindo a próxima hora de reposição) e o bloco JSON inclui reset_at. Contas individuais e proprietários de organizações também recebem upgrade_url. Os membros de organizações recebem a frase da equipa: peça ao proprietário por utilização extra ou espere até à próxima janela de 4 horas. O JSON destes inclui quota_scope, org_role e extra_usage_buyable, sem link de atualização.

Espere até reset_at ou abra upgrade_url num navegador enquanto estiver com sessão iniciada na mesma conta ISMS Copilot (contas individuais e proprietários de organizações). Quando o JSON incluir fallback_available: true e o overflow do seu plano estiver disponível (contas individuais pagas com a Proteção Avançada de Dados desativada; nunca num pool de equipa), também pode pedir ao agente para continuar: com a sua autorização explícita, este reenvia com overflow_consent: true e o turno é executado com o mesmo overflow até 2x que a aplicação web oferece (a resposta inclui overflow_active: true). As ferramentas de leitura continuam a funcionar após o limite do chat.

Consulte O que fazer quando atinge o limite de utilização.

6. Rodar

Para rotação de rotina, crie um novo token, substitua o token antigo em mcp.json (Cursor) ou config.toml (Codex), reinicie o cliente e execute o teste de funcionamento. De seguida, revogue o token antigo em Definições. Se o token antigo pode ter sido comprometido, revogue-o imediatamente antes de configurar o substituto.