Conectar asistentes de IA a Cooby (MCP)

Conecta asistentes de IA como Claude o ChatGPT a tu workspace de Cooby y obtén respuestas directamente de tus conversaciones de WhatsApp. Pregunta quién está esperando una respuesta, pide un resumen de un negocio antes de una llamada o, si eres gerente de ventas, revisa los seguimientos de tu equipo.

Cooby ofrece un servidor de solo lectura MCP (Model Context Protocol) en https://mcp.cooby.co/mcp. Cualquier cliente de IA compatible con MCP puede conectarse: Claude (Desktop y claude.ai), ChatGPT, Cursor y otros.

Lo que pueden hacer los agentes de IA: leer tus chats y mensajes de WhatsApp, tus contactos y sus vínculos con el CRM.
Lo que nunca pueden hacer: enviar mensajes, registrar actividad en el CRM, ni cambiar o eliminar nada.

Requisitos

• Una cuenta en un workspace de Cooby (cualquier rol, consulta Roles y acceso a datos).
• Un cliente de IA compatible con MCP. Esta guía cubre Claude Desktop, claude.ai, ChatGPT y Cursor, además de instrucciones generales para cualquier otro cliente MCP.
• Sin claves de API y sin configuración por parte de tu administrador. Tú mismo autorizas la conexión con tu inicio de sesión de Cooby.

Conectar Claude Desktop

1. Abre Claude Desktop → Settings → Connectors → Add custom connector.
2. Ingresa la URL del servidor:

   https://mcp.cooby.co/mcp

3. Haz clic en Add y luego en Connect. Tu navegador abrirá la página de inicio de sesión de Cooby. Inicia sesión con tu cuenta de Cooby si aún no lo has hecho.
4. Revisa la pantalla de consentimiento. Muestra qué aplicación lo solicita (por ejemplo, "Claude") y exactamente qué puede y qué no puede hacer:

• ✅ Puede leer tus chats y mensajes de WhatsApp
• ✅ Puede leer tus contactos y vínculos con el CRM
• ❌ No puede enviar mensajes
• ❌ No puede cambiar ni eliminar nada

5. Haz clic en Approve. Se te redirigirá de vuelta y el conector aparecerá como conectado.
6. Pruébalo: "¿Con quién debería hacer seguimiento hoy?"

Conectar claude.ai (web)

1. Ve a claude.ai → Settings → Connectors → Add custom connector.
2. Ingresa https://mcp.cooby.co/mcp y haz clic en Add.
3. Completa el mismo proceso de inicio de sesión y consentimiento que arriba.

Conectar ChatGPT o Codex

Los conectores personalizados en ChatGPT requieren un plan compatible con conectores (por ejemplo, Plus, Pro o Business) y puede que necesites activar el Developer mode (Settings → Apps & Connectors → Advanced).

1. Abre ChatGPT → Settings → Apps & Connectors → Create (o Add custom connector).
2. Asígnale el nombre "Cooby" e ingresa la URL del servidor MCP:

   https://mcp.cooby.co/mcp

3. Elige la autenticación OAuth (ChatGPT detecta automáticamente el servicio de inicio de sesión de Cooby) y guarda.
4. Completa el mismo proceso de inicio de sesión y consentimiento de Cooby que arriba y luego activa el conector en una conversación (en algunos planes, desde el menú de herramientas o "Use connectors").

Conectar Cursor

1. Cursor → Settings → MCP → Add new MCP server, transporte HTTP (streamable).
2. URL: https://mcp.cooby.co/mcp. Cursor inicia el mismo proceso de inicio de sesión y consentimiento en el navegador.

Conectar cualquier otro cliente MCP

Cooby funciona con cualquier cliente compatible con MCP sobre Streamable HTTP con OAuth:

• URL del servidor: https://mcp.cooby.co/mcp
• Autenticación: OAuth 2.1 con detección automática, sin clave de API ni ID de cliente que pegar. El cliente se registra solo y abre una ventana del navegador para el inicio de sesión y el consentimiento de Cooby.
• Para clientes que se configuran con JSON (por ejemplo, algunas herramientas de escritorio), una entrada típica se ve así:

{
    "mcpServers": {
      "cooby": { "type": "http", "url": "https://mcp.cooby.co/mcp" }
    }
  }

• Si tu cliente pide los datos de OAuth manualmente, los endpoints de autorización y token están publicados en https://mcp.cooby.co/.well-known/oauth-authorization-server; el scope es mcp:read; se requiere PKCE (S256).

Nota: por seguridad, Cooby solo acepta URLs de redirección de OAuth de aplicaciones de IA conocidas (Claude, ChatGPT, Cursor) y de aplicaciones de escritorio locales (localhost). Si tu cliente MCP no es aceptado, contacta a soporte y evaluaremos agregarlo.

Qué preguntar

Para representantes de ventas

Para gerentes de ventas (solo administradores)

Vistas interactivas

Cuando tu cliente de IA es compatible con MCP Apps (Claude y ChatGPT lo son), algunas respuestas llegan como una tarjeta interactiva dentro de la conversación, no solo como texto. Hoy hay dos vistas disponibles:

Panel de actividad del equipo (administradores)

Pregunta "Muéstrame el panel del equipo" (o "¿Cómo le va a mi equipo esta semana?"). En lugar de un montón de números, obtienes una tarjeta visual con una fila por representante:

• total de chats y cuántos están esperando respuesta (gráfico de barras)
• cuántos chats han estado activos en los últimos 7 días
• un indicador de última actividad para que los representantes con poca actividad se noten de inmediato

Úsalo el lunes por la mañana para ver rápidamente dónde se acumulan los seguimientos y quién necesita un empujón. (Solo administradores, igual que los datos del equipo en los que se basa.)

Vista de conversación

Pregunta "Muestra mi conversación con Acme" (representantes) o "Muestra el chat de Maria con Acme" (administradores) y los mensajes se muestran como un hilo al estilo de WhatsApp, con tus mensajes a la derecha, los del cliente a la izquierda, separadores por día y una etiqueta de "sin respuesta" cuando el último mensaje fue del cliente. Es más fácil de revisar que una transcripción simple antes de entrar al chat.
Si tu cliente no es compatible con MCP Apps, no pasa nada. Recibes la misma información como texto limpio en lugar de una tarjeta. No hay que activar nada; la vista aparece automáticamente cuando el cliente puede mostrarla.

Administrar agentes conectados

Ve a Cooby workspace → Settings → Connected AI agents (app.cooby.co/settings/connected-agents).

• Los miembros ven los agentes conectados a su propia cuenta.
• Los administradores ven todos los agentes conectados en el workspace, con el propietario indicado en cada fila.
• Cada fila muestra el nombre del agente, cuándo se conectó y cuándo se usó por última vez.
• Revoke desconecta a ese agente de inmediato. Su token de sesión actual deja de funcionar en la siguiente solicitud, no solo en la próxima actualización. Los miembros pueden revocar sus propios agentes; los administradores pueden revocar los de cualquiera.

Volver a conectar después de revocar sigue el mismo proceso que la primera conexión.

Roles y acceso a datos

Cada solicitud está limitada a un solo workspace, el que autorizaste durante el consentimiento. Un agente no puede acceder a los datos de otro workspace, y si un miembro pide datos de otra persona recibe un error de permisos, sin importar cómo formule la pregunta.

Detalles técnicos

Protocolo y endpoint

• MCP sobre Streamable HTTP en https://mcp.cooby.co/mcp (sin estado; sin afinidad de sesión en el servidor).
• Herramientas disponibles (todas de solo lectura, con anotaciones readOnlyHint y esquemas de salida tipados): get_workspace_snapshot, search_contacts, get_contact, list_chats, get_chat, list_members (administradores).

Autorización y aislamiento de datos

• Cada token está vinculado a un usuario y un workspace, definidos en el consentimiento. Cada consulta a la base de datos filtra por ese workspace; ningún parámetro de herramienta puede ampliarlo.
• Las capacidades de miembro y administrador se aplican en el servidor en cada solicitud (consulta la tabla de arriba).
• Revocar un permiso invalida de inmediato sus tokens de acceso y de actualización.

Límites de uso, auditoría y privacidad

• Límites de uso: 60 solicitudes por minuto por agente conectado, 600 por minuto por workspace. Si se superan, se devuelve un error de límite de uso y el agente puede reintentar después de una pausa.
• Cada llamada a una herramienta queda registrada en la auditoría: quién, qué agente, qué herramienta, estado y latencia. Los argumentos de las herramientas se guardan solo como un hash, así que el contenido de los mensajes y los nombres de los contactos nunca aparecen en los registros.
• El contenido de los mensajes está cifrado en reposo y solo se descifra dentro de la solicitud que lo devuelve a tu agente autorizado.

Solución de problemas

¿Preguntas? Escribe a support@cooby.co.

Actualizado el: 14/10/2026