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

​
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 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.
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 permisos solicitados antes de compartir nada. Las aprobaciones se pueden revocar desde la configuración de tu cuenta. Para una conexión manual o de servidor a servidor, envía una clave de API del espacio de trabajo:
Usa los alcances más restringidos posibles. Los alcances de escritura incluyen el acceso de lectura correspondiente.

​
Elegir qué herramientas exponer

El endpoint estándar expone todas las herramientas que permite la credencial. Para una lista de herramientas más reducida, selecciona uno o varios grupos al conectar:
También puedes enviar X-MCP-Toolsets: assistants,calls. El encabezado tiene prioridad sobre el parámetro de la URL. Usa list_mcp_toolsets para ver los grupos disponibles para tu cuenta. El cliente MCP recibe el esquema de entrada actual, los permisos y las indicaciones de seguridad de cada herramienta que tiene permitido usar. Este descubrimiento en vivo es la referencia autorizada para los argumentos de cada herramienta.

​
Perfil de directorio público

La conexión revisada de los directorios de ChatGPT y Claude usa:
Este perfil se limita a información de asistentes de solo lectura y a historial de conversaciones de solo lectura. Excluye cambios en asistentes, llamadas salientes, campañas, mensajería, gestión de números de teléfono, facturación, integraciones y descubrimiento de grupos de herramientas. Las conexiones MCP personalizadas conservan los permisos elegidos durante su propia configuración.

​
Ejemplos de prompts

Una vez conectado un cliente, el lenguaje natural llega a cada herramienta para la que está autorizado:
Un cliente bien diseñado lee el estado actual antes de cambiarlo, y te pide que confirmes cualquier cosa difícil de revertir — una llamada saliente, el envío de un mensaje, el inicio de una campaña, una compra. Usa números de teléfono en formato E.164 en tus prompts, revisa un prompt del sistema generado antes de pedirle al cliente que lo guarde, y mantén un flujo de trabajo por prompt para que una solicitud de varios pasos siga siendo fácil de seguir.

​
Tareas de larga duración

Las importaciones de sitios web, las simulaciones, las exportaciones de historial y las preparaciones de campañas grandes pueden continuar como tareas de MCP. Un cliente compatible puede mostrar el progreso, obtener el resultado o solicitar la cancelación. La cancelación detiene el trabajo restante cuando es posible; una acción ya aceptada por un servicio externo puede completarse igualmente. Las exportaciones usan enlaces de descarga privados y de corta duración. Las tareas y sus resultados permanecen limitados al espacio de trabajo y a la credencial que los creó. Las herramientas de historial de llamadas devuelven un objeto failure independiente del proveedor cuando una llamada no puede completarse. Usa su código, su mensaje seguro para el cliente, su indicación de reintento y su acción sugerida en lugar de depender de detalles específicos de la infraestructura.

​
Errores

Las mismas funciones para el cliente están disponibles a través de la API REST. Elige la interfaz que mejor se adapte a tu integración.