Conectar apps de IA (MCP)

El MonoChat MCP Server permite que una app de IA compatible con el Model Context Protocol (MCP), como Claude Code o Cursor, trabaje con tu cuenta de MonoChat. La app de IA pide datos a MonoChat mediante un conjunto fijo de herramientas; solo puede ver lo que tú puedes ver.

El MonoChat MCP Server está disponible en todos los planes, sin límites según el plan.

Una conexión actúa como tú

Una app de IA conectada con tu clave de acceso actúa como tu usuario. Accede a los tenants a los que tú tienes acceso y a nada más. Revoca las conexiones que ya no uses.

Qué puede hacer la app de IA

Estas herramientas están disponibles para todas las conexiones:

Herramienta	Qué hace
list_tenants	Lista los tenants a los que la conexión tiene acceso.
list_sessions	Lista las sesiones de conversación de un tenant, de la más reciente a la más antigua, opcionalmente solo las opened, assigned o closed.
get_session	Devuelve una sesión de conversación.
list_messages	Lista los mensajes de una sesión, del más reciente al más antiguo.
search_customers	Busca los clientes de un tenant por palabra clave.
list_message_templates	Lista las plantillas de mensajes de un canal de un tenant.

El texto de los mensajes proviene de clientes y agentes. Son datos que la app de IA lee, no instrucciones.

Una conexión tiene un alcance, Solo lectura o Lectura y escritura. Una conexión de solo lectura nunca ve las herramientas que modifican datos. Todas las herramientas indicadas arriba solo leen.

Crear una conexión

Una conexión pertenece a tu cuenta, no a un tenant. Antes necesitas tener configurada la verificación en dos pasos (por correo electrónico o con una app de autenticación).

1. Abre los ajustes del perfil, selecciona la pestaña Conexiones MCP y haz clic en Crear.
2. Escribe un nombre, elige el alcance (Solo lectura por defecto) y la caducidad en días (90 por defecto, 365 como máximo).
3. Introduce el código de confirmación de 6 dígitos de tu método de verificación en dos pasos. Si usas la verificación por correo, haz clic primero en Enviar código de confirmación.
4. Copia la clave de acceso. Solo se muestra una vez; empieza por mcp_sk_.

Puedes tener hasta 10 conexiones activas.

Conectar una app de IA

El servidor está en https://app.monochat.ai/api/mcp-server (usa tu propia dirección de MonoChat si ejecutas MonoChat en tus propios servidores) y espera la clave de acceso como bearer token en la cabecera Authorization.

Claude Code

claude mcp add --transport http monochat https://app.monochat.ai/api/mcp-server \
  --header "Authorization: Bearer <access key>"

Cursor

Añade el servidor a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "monochat": {
      "url": "https://app.monochat.ai/api/mcp-server",
      "headers": { "Authorization": "Bearer <access key>" }
    }
  }
}

Cualquier otro cliente MCP compatible con el transporte HTTP streamable y con cabeceras personalizadas se conecta de la misma manera.

Límites

Las llamadas se cuentan por minuto: 60 por conexión, 300 por cuenta y 600 por tenant, y como máximo 4 llamadas simultáneas por conexión. Algunas herramientas cuentan como más de una llamada. Cuando se alcanza un límite, el servidor responde con un estado 429 y una cabecera Retry-After; la app de IA debe esperar esa cantidad de segundos.

Revocar una conexión

Cada conexión de la pestaña Conexiones MCP muestra su estado, alcance, caducidad y último uso. Haz clic en Revocar para cortar el acceso de la app de IA de inmediato. Una conexión revocada o caducada no se puede volver a usar; crea una nueva.

Gestionar el acceso MCP de una organización

Los usuarios que pueden cambiar la configuración de una organización gestionan su acceso MCP en Configuración › Organización › Servidor MCP.

• Desactivar el acceso MCP para esta organización: actívalo y haz clic en Guardar para rechazar todas las llamadas MCP a esta organización, desde cualquier conexión de cualquier usuario. La organización deja de aparecer en list_tenants. Desactívalo y guarda para volver a permitir el acceso MCP.
• Llamadas MCP: todas las llamadas a herramientas que nombran esta organización, de la más reciente a la más antigua, incluidas las rechazadas. Cada fila muestra el usuario, la conexión, la herramienta, el estado (Correcto o Fallido), la dirección IP y la hora. No se muestran las llamadas de usuarios que no son miembros de esta organización.