Skip to main content
El endpoint Model Context Protocol (MCP) permite que una aplicación de IA trabaje con los mismos recursos del espacio de trabajo que usas en el panel — asistentes, llamadas, campañas, bases de conocimiento y más — sujeto a tu plan, tu rol y los permisos aprobados.
En un dominio de marca blanca, usa ese dominio en su lugar. Las pantallas de inicio de sesión y consentimiento usan la misma marca. Tu plan debe incluir Connect AI / MCP.
Esta página trata sobre cómo conectar un cliente de IA (Claude, ChatGPT y otros) a Famulor. ¿Buscas conectar uno de tus asistentes hacia afuera, a un servidor MCP externo durante la llamada — tu propio CRM o tus herramientas internas? Consulta Herramientas y webhooks en su lugar.

​
Conectar clientes

  1. Abre Settings → Connectors → Add custom connector.
  2. Introduce https://app.famulor.io/mcp.
  3. Inicia sesión y aprueba los permisos solicitados.
  4. Las herramientas aprobadas aparecen en Claude.

​
Conectar desde dentro de Famulor

Elige Connect en la barra lateral, o Use with ChatGPT & Claude en el panel. El diálogo muestra la URL de MCP correcta para tu dominio actual, te permite elegir con qué grupos de herramientas conectarte (consulta Herramientas y alcances), y ofrece prompts iniciales para tareas habituales — crear un asistente, diagnosticar uno que se comporta mal, analizar tu última llamada, mejorar a partir de tus últimas 30 llamadas, o lanzar una campaña. El mismo selector está disponible en cualquier momento desde Settings → API & MCP.
Si trabajas desde un agente de código como Claude Code, Cursor o Codex, instala el Famulor Skill de código abierto con npx skills add bekservice/Famulor-Skill. Incluye la configuración del endpoint (añade la URL manualmente si tu cliente no la detecta) además de reglas de trabajo específicas de Famulor por encima del acceso MCP puro: lee el estado actual antes de cambiarlo, confirma cualquier cosa difícil de revertir, y quédate dentro del espacio de trabajo autenticado.

​
Autenticación y consentimiento

Los clientes compatibles inician el acceso OAuth automáticamente. La pantalla de consentimiento muestra los grupos de herramientas solicitados antes de compartir nada, y tu elección se recuerda para futuras conexiones. Las conexiones aprobadas se muestran en Settings → API & MCP, donde cada una se puede revocar en cualquier momento. Para una conexión manual o de servidor a servidor, envía en su lugar una clave de API del espacio de trabajo:
Usa los alcances más restringidos que necesites. Los alcances de escritura incluyen el acceso de lectura correspondiente.

​
Qué puede ver un cliente conectado

De forma predeterminada, un cliente conectado mediante OAuth (Claude, ChatGPT y similares) recibe un conjunto curado de 7 grupos de herramientas — assistants, calls, campaigns, knowledge, telephony, billing y settings — en lugar del catálogo completo. Se trata de un límite deliberado, no de una restricción del plan: el catálogo completo de herramientas de Famulor es extenso, y cargarlo entero de una vez supera lo que estos clientes admiten de forma fiable. Por eso, seleccionar todos los grupos durante la configuración también te deja en el conjunto curado. Para usar menos grupos, deselecciona los que no necesites al conectar, o edita tu selección en cualquier momento en Settings → API & MCP. Consulta Herramientas y alcances para ver qué cubre cada grupo. Si tu integración realmente necesita el catálogo completo — los 13 grupos —, conéctate con una clave de API del espacio de trabajo en lugar de OAuth, y añade ?toolsets=all a la URL del endpoint. Esta vía está pensada para tus propios scripts e integraciones de servidor a servidor, no para un cliente de IA de uso general.

​
Límites de tasa

Las solicitudes MCP tienen un límite de frecuencia para mantener la plataforma responsiva para todos los espacios de trabajo: Un cliente que supere estos límites recibe una respuesta 429 y debe esperar y volver a intentarlo — consulta Errores.
Las mismas funciones orientadas al cliente están disponibles a través de la API REST. Elige la interfaz que mejor se adapte a tu integración.