---
title: 'MCP para agentes de IA'
description: 'Cómo conectar Claude, Codex, OpenCode, OpenClaw o Hermes a la plataforma mediante MCP.'
type: doc
locale: es
canonical: 'https://yoseno.com/es/docs/integrations/mcp-agent'
updated: '2026-07-30'
---

# MCP para agentes de IA

Cómo conectar Claude, Codex, OpenCode, OpenClaw o Hermes a la plataforma mediante MCP.

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:

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

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

```bash
claude mcp login platform
```

## Codex

Agrega el servidor Streamable HTTP:

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

Luego realiza el inicio de sesión OAuth:

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

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

```bash
opencode mcp auth platform
```

## OpenClaw

Guarda el servidor MCP como Streamable HTTP y activa OAuth:

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

Inicia sesión y verifica la conexión:

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

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

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

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

## Hermes

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

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

```txt
/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](https://yoseno.com/es/docs/integrations/api-tokens.md).
MCP es necesario precisamente para agentes de IA que necesitan tools, resources, prompts, OAuth y scopes específicos.

## Páginas relacionadas

- [Tokens de API](https://yoseno.com/es/docs/integrations/api-tokens.md) — Tokens personales y acceso bearer a \`/api/v1\`.
- [Créditos y límites](https://yoseno.com/es/docs/account/billing-plans.md) — Créditos, compras, suscripción y comportamiento de las funciones de IA cuando faltan créditos.
- [REST API](https://yoseno.com/es/docs/integrations/rest-api.md) — Tokens, acceso Bearer, ejemplo de solicitud y enlaces a la referencia de OpenAPI.

## Continuar leyendo

- [REST API](https://yoseno.com/es/docs/integrations/rest-api.md) — Tokens, acceso Bearer, ejemplo de solicitud y enlaces a la referencia de OpenAPI.