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. Customize → Connectors → + Add → 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

Abre Connect en la barra lateral o Settings → API & MCP. Ambos clientes ofrecen un conector personalizado. Claude y ChatGPT usan la URL MCP completa de forma predeterminada. Los espacios de la plataforma también pueden elegir el conector del marketplace, marcado como Limitado, para consultar asistentes e historial. Los clientes de marca blanca usan su propia conexión. Filtrar grupos es opcional; el consentimiento OAuth define los permisos aprobados. Claude también ofrece tareas iniciales. Elige un espacio en la página de autorización y revisa los grupos de herramientas antes de conectarlo. Solo se conecta ese espacio; tu membresía, rol y plan siguen vigentes. Puedes filtrar la URL MCP por grupo de herramientas.
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. Las conexiones personalizadas usan /mcp de forma predeterminada. Al dar un nuevo consentimiento se guardan todos los grupos seleccionados, incluida una selección explícita de todos ellos. El acceso sigue dependiendo de los permisos solicitados y aprobados, del rol en el espacio y del plan. Que una herramienta aparezca en el catálogo no autoriza por sí solo una acción. En la pantalla de autorización, abre Permisos → Editar y elige Solo lectura, Lectura y escritura o Personalizado. Solo Personalizado muestra los grupos de herramientas y la opción Permitir cambios. Solo lectura excluye los permisos de escritura; los tokens existentes conservan sus permisos. Las conexiones existentes conservan sus permisos. Para añadir accesos, revoca la conexión anterior en Settings → API & MCP, vuelve a conectarla y aprueba los grupos necesarios. Después actualiza las herramientas del cliente de IA o inicia un nuevo chat. Los grupos siguen siendo un filtro opcional útil para tareas concretas o clientes con dificultades para cargar catálogos grandes. Los filtros de URL y encabezado no pueden ampliar los grupos autorizados explícitamente. Los conectores del marketplace siguen limitados a su perfil revisado.

​
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.