---
title: 'MCP para agentes de IA'
description: 'Como conectar Claude, Codex, OpenCode, OpenClaw ou Hermes à plataforma via MCP.'
type: doc
locale: pt-BR
canonical: 'https://yoseno.com/pt-BR/docs/integrations/mcp-agent'
updated: '2026-07-30'
---

# MCP para agentes de IA

Como conectar Claude, Codex, OpenCode, OpenClaw ou Hermes à plataforma via MCP.

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:

```txt
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:

```bash
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:

```bash
claude mcp login platform
```

## Codex

Adicione um servidor Streamable HTTP:

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

Em seguida, faça o login OAuth:

```bash
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`:

```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:

```bash
opencode mcp auth platform
```

## OpenClaw

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

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

Execute o login e verifique a conexão:

```bash
openclaw mcp login platform
openclaw mcp doctor platform --probe
```

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

```bash
openclaw mcp login platform --code <code>
```

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

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

## Hermes

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

```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:

```txt
/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](https://yoseno.com/pt-BR/docs/integrations/api-tokens.md). O MCP é necessário justamente para agentes de IA que dependem de ferramentas, recursos, prompts, OAuth e escopos individuais.

## Páginas relacionadas

- [Tokens de API](https://yoseno.com/pt-BR/docs/integrations/api-tokens.md) — Tokens pessoais e acesso bearer ao \`/api/v1\`.
- [Créditos e limites](https://yoseno.com/pt-BR/docs/account/billing-plans.md) — Créditos, compras, assinatura e o comportamento das funcionalidades de IA quando faltam créditos.
- [REST API](https://yoseno.com/pt-BR/docs/integrations/rest-api.md) — Tokens, acesso Bearer, exemplo de requisição e links para a referência OpenAPI.

## Leia a seguir

- [REST API](https://yoseno.com/pt-BR/docs/integrations/rest-api.md) — Tokens, acesso Bearer, exemplo de requisição e links para a referência OpenAPI.