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

Conecta tu espacio de trabajo con el conector de Famulor en el directorio de Claude.
  1. Abre la página del directorio y elige Connect.
  2. Inicia sesión con tu cuenta de Famulor y aprueba el acceso solicitado.
  3. Inicia un chat y pregunta, por ejemplo: «Revisa mi asistente de soporte y resume sus últimas llamadas».
El conector del directorio ofrece información de los asistentes e historial de conversaciones de solo lectura. Consulta Perfil del directorio público.
Para crear y modificar asistentes, iniciar campañas o usar un dominio de marca blanca, añade un conector personalizado con la URL que aparece en Configuración → API y MCP:
  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 en la barra lateral y Añadir a Claude en Configuración → API y MCP ofrecen ambas opciones: el conector del directorio o un conector personalizado ya rellenado.

​
Conectar desde dentro de Famulor

Elige Connect en la barra lateral, o Use with ChatGPT & Claude en el panel. Elige tu app de IA a la izquierda (Claude, ChatGPT, Cursor o Windsurf): verás la configuración en tres pasos cortos y un botón que abre la app o instala el conector. Para Claude, elige entre el conector del directorio (solo lectura) y un conector personalizado con acceso completo. Siempre que se usa un conector personalizado, 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. La URL de MCP y los mismos botones de apps están disponibles 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.
Formulario de creación de clave API con el nombre vacío y el botón Create key

Para tu propia integración de servidor, abre Settings → API & MCP → Create a new API key, escribe un nombre reconocible y selecciona Create key.

​
Qué puede ver un cliente conectado

El plugin oficial de ChatGPT usa el perfil de directorio público de solo lectura. Sus permisos se limitan a la información de asistentes y al historial de conversaciones. Una conexión OAuth personalizada recibe de forma predeterminada 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 14 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.