MCP para agentes de IA

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

https://<dominio-plataforma>/mcp

En la primera conexión, el agente abrirá una ventana de inicio de sesión OAuth en el navegador. Verá qué cliente solicita acceso y qué alcances (scopes) pide. Después de la confirmación, el token lo almacena el propio cliente MCP; no es necesario copiar el secreto manualmente.

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

Claude

Para Claude Code, agregue un servidor MCP HTTP:

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

Abra Claude Code y ejecute /mcp, luego complete la autenticación OAuth en el navegador. Si necesita iniciar sesión desde la terminal, use:

claude mcp login tealband

Codex

Agregue un servidor HTTP de transmisión (Streamable HTTP):

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

Luego realice el inicio de sesión OAuth:

codex mcp login tealband

En Codex CLI, el estado de la conexión se visualiza con /mcp.

OpenCode

Agregue el servidor en opencode.json:

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

La primera vez que se utilice, OpenCode pedirá autorización. Para iniciar OAuth manualmente, ejecute:

opencode mcp auth tealband

OpenClaw

Guarde el servidor MCP como HTTP de transmisión y active OAuth:

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

Inicie sesión y verifique la conexión:

openclaw mcp login tealband
openclaw mcp doctor tealband --probe

Si login devuelve un código de confirmación, complete el inicio de sesión con:

openclaw mcp login tealband --code <code>

Si edita la configuración manualmente, este es el formato:

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

Hermes

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

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

Inicie Hermes. En la primera conexión, abrirá OAuth en el navegador y guardará los tokens para sesiones futuras. Después de modificar la configuración en una sesión ya abierta, ejecute:

/reload-mcp

Acceso

El agente obtiene solo los alcances (scopes) confirmados:

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

Los scopes no sustituyen el rol del usuario. Si su rol no permite realizar una acción en la organización, el agente tampoco podrá realizarla.

Privacidad

MCP no expone las respuestas de los participantes eludiendo las reglas de la plataforma. Nadie ve las respuestas en su forma directa; solo se muestran datos anonimizados y agregados cuando hay un número suficiente de respuestas (al menos 5). Si los datos son escasos, el agente recibirá un resultado limitado.

Para scripts habituales e integraciones de servidor, utilice tokens API. MCP está pensado específicamente para agentes de IA que necesiten herramientas, recursos, indicaciones, OAuth y scopes independientes.