MCP para agentes de IA

O MCP dá a um agente de IA externo acesso operacional à plataforma: ler análises, ajudar com pesquisas e executar ações em nome do usuário. A conexão é feita por um endpoint Streamable HTTP:

https://<dominio-da-plataforma>/mcp

Na primeira chamada, o agente abre o login OAuth no navegador. Você vê qual cliente está pedindo acesso e quais escopos ele solicita. Após a confirmação, o token é armazenado pelo próprio cliente MCP; não é necessário copiar o segredo manualmente.

Um único endpoint funciona para todas as suas organizações. A organização ativa é obtida a partir da sessão autorizada; se o agente suportar a troca de organização, ele poderá selecionar outra organização disponível.

Claude

No Claude Code, adicione um servidor MCP HTTP:

claude mcp add --transport http platform https://<dominio-da-plataforma>/mcp

Abra o Claude Code e execute /mcp; em seguida, faça o login OAuth no navegador. Se precisar iniciar o login pelo terminal, use:

claude mcp login platform

Codex

Adicione um servidor Streamable HTTP:

codex mcp add platform --url https://<dominio-da-plataforma>/mcp

Em seguida, faça o login OAuth:

codex mcp login platform

No Codex CLI, o status da conexão pode ser consultado por meio de /mcp.

OpenCode

Adicione o servidor no arquivo opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "platform": {
      "type": "remote",
      "url": "https://<dominio-da-plataforma>/mcp",
      "enabled": true
    }
  }
}

No primeiro uso, o OpenCode pedirá autorização. Para iniciar o OAuth manualmente, execute:

opencode mcp auth platform

OpenClaw

Salve o servidor MCP como Streamable HTTP e ative o OAuth:

openclaw mcp add platform \
  --url https://<dominio-da-plataforma>/mcp \
  --transport streamable-http \
  --auth oauth

Execute o login e verifique a conexão:

openclaw mcp login platform
openclaw mcp doctor platform --probe

Se o comando login retornar um código de confirmação, conclua o login com:

openclaw mcp login platform --code <code>

Se for editar a configuração manualmente, o formato é este:

{
  "mcp": {
    "servers": {
      "platform": {
        "url": "https://<dominio-da-plataforma>/mcp",
        "transport": "streamable-http",
        "auth": "oauth"
      }
    }
  }
}

Hermes

Adicione o servidor no arquivo ~/.hermes/config.yaml:

mcp_servers:
  platform:
    url: "https://<dominio-da-plataforma>/mcp"
    auth: oauth

Inicie o Hermes. Na primeira conexão, ele vai abrir o login OAuth no navegador e salvar os tokens para as próximas sessões. Depois de alterar a configuração em uma sessão já aberta, execute:

/reload-mcp

Acesso

O agente recebe apenas os escopos aprovados:

• analytics:read — ler pesquisas, resultados, análises e pontos de melhoria;
• surveys:write — criar, editar e publicar pesquisas;
• org:manage — gerenciar organizações, configurações e participantes.

Os escopos não substituem o papel do usuário. Se o seu papel não permitir executar uma ação na organização, o agente também não conseguirá executá-la.

Limites de requisições

As requisições ao MCP estão sujeitas a limites de frequência:

• Endpoint /mcp: 300 requisições por minuto, por token ou IP.
• Autorização OAuth: 20 requisições por par IP + client_id a cada 5 minutos (120 requisições por IP).

Quando o limite é excedido, o servidor retorna o erro rate_limited com o tempo de espera (retryAfter).

Privacidade

O MCP não expõe as respostas dos participantes contornando as regras da plataforma. Ninguém vê as respostas brutas; só são expostos dados anonimizados e agregados quando há um número suficiente de respostas (pelo menos 5). Se houver poucos dados, o agente receberá um resultado limitado.

Para scripts comuns e integrações de servidor, use tokens de API. O MCP é necessário justamente para agentes de IA que dependem de ferramentas, recursos, prompts, OAuth e escopos individuais.