MCP para agentes de IA

MCP da a un agente de IA externo acceso funcional a la plataforma: leer analítica, ayudar con las encuestas y realizar acciones en nombre del usuario. La conexión se realiza a través del endpoint Streamable HTTP:

https://<dominio-de-la-plataforma>/mcp

En el primer acceso, el agente abre el inicio de sesión OAuth en el navegador. Ves qué cliente solicita acceso y qué scopes solicita. Después de confirmar, el propio cliente MCP guarda el token; no es necesario copiar el secreto manualmente.

Un solo endpoint funciona para todas tus organizaciones. La organización activa se toma de la sesión autorizada; si el agente admite el cambio de organización, podrá elegir otra organización disponible.

Claude

Para Claude Code, agrega un servidor MCP HTTP:

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

Abre Claude Code y ejecuta /mcp, luego realiza el OAuth en el navegador. Si necesitas iniciar sesión desde la terminal, usa:

claude mcp login platform

Codex

Agrega el servidor Streamable HTTP:

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

Luego realiza el inicio de sesión OAuth:

codex mcp login platform

En Codex CLI, el estado de la conexión se puede ver a través de /mcp.

OpenCode

Agrega el servidor en opencode.json:

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

En el primer uso, OpenCode te ofrecerá autorizarte. Para iniciar OAuth manualmente, puedes hacerlo así:

opencode mcp auth platform

OpenClaw

Guarda el servidor MCP como Streamable HTTP y activa OAuth:

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

Inicia sesión y verifica la conexión:

openclaw mcp login platform
openclaw mcp doctor platform --probe

Si login devolvió un código de confirmación, completa el inicio de sesión con el comando:

openclaw mcp login platform --code <code>

Si editas el config manualmente, el formato es el siguiente:

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

Hermes

Agrega el servidor en ~/.hermes/config.yaml:

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

Inicia Hermes. En la primera conexión, abrirá OAuth en el navegador y guardará los tokens para las siguientes sesiones. Después de cambiar el config en una sesión ya abierta, ejecuta:

/reload-mcp

Acceso

El agente solo recibe los scopes confirmados:

• analytics:read — leer encuestas, resultados, analítica y áreas de mejora;
• surveys:write — crear, editar y publicar encuestas;
• org:manage — gestionar organizaciones, ajustes y participantes.

Los scopes no reemplazan el rol del usuario. Si tu rol no te permite realizar una acción en la organización, el agente tampoco podrá completarla.

Límites de solicitudes

Las solicitudes a MCP están protegidas por límites de frecuencia:

• Endpoint operativo /mcp: 300 solicitudes por minuto por token o IP.
• Autorización OAuth: 20 solicitudes por par IP + client_id en 5 minutos (120 solicitudes por IP).

Si se excede el límite, el servidor devuelve el error rate_limited indicando el tiempo de pausa (retryAfter).

Privacidad

MCP no revela las respuestas de los participantes al margen de las reglas de la plataforma. Nadie ve las respuestas en su forma pura; solo se muestran datos anonimizados y agregados cuando hay un número suficiente de respuestas (al menos 5). Si hay pocos datos, el agente obtendrá un resultado limitado.

Para scripts comunes e integraciones de servidor, usa tokens de API. MCP es necesario precisamente para agentes de IA que necesitan tools, resources, prompts, OAuth y scopes específicos.