> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.
# Endpoint MCP
> Conecta Claude, ChatGPT u otro cliente MCP a tu espacio de trabajo
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.
```text theme={null}
https://app.famulor.io/mcp
```
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.
1. Abre **Settings → Connectors → Create**.
2. Introduce `https://app.famulor.io/mcp` y selecciona **OAuth**.
3. Inicia sesión y aprueba los permisos solicitados.
Usa el endpoint anterior con OAuth. Para integraciones de servidor a servidor de confianza, puedes enviar en su lugar una clave de API del espacio de trabajo como token Bearer.
### 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](https://github.com/bekservice/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:
```http theme={null}
Authorization: Bearer fam_...
```
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:
```text theme={null}
https://app.famulor.io/mcp?toolsets=assistants,calls
```
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.
| Grupo | Funciones orientadas al cliente |
| ------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `assistants` | Asistentes, versiones, modelos, voces, herramientas reutilizables, reservas y simulaciones |
| `calls` | Llamadas, historial de conversaciones, transcripciones y acciones de llamada permitidas |
| `campaigns` | Campañas, audiencias, leads, supresión y sincronización con CRM |
| `messaging` | Conectores de mensajería y correo, plantillas y conversaciones |
| `telephony` | Números de teléfono, troncales SIP, tus propias conexiones de operador e importación BYOC, Caller ID y verificación de número, y el sistema Famulor Loop completo — presencia, grupos de timbrado, colas, reglas de enrutamiento, dispositivos y Recall |
| `knowledge` | Bases de conocimiento, documentos, importaciones de sitios web y fuentes de archivos conectadas |
| `dashboards` | Paneles de analítica y widgets |
| `automations` | Automatizaciones, conexiones, Milian Missions e historial de ejecuciones |
| `billing` | Saldo, uso, transacciones, referidos y límites de llamadas salientes |
| `settings` | Configuración del espacio de trabajo, dominios, claves de API y retención |
| `platform` | Gestión de clientes de marca blanca para revendedores autorizados |
| `migration` | Vista previa e importación de recursos de Famulor 1.0, o de estructuras de asistente inactivas desde Retell AI, Vapi y Synthflow |
| `tasks` | Exportaciones, rastreos, simulaciones y preparación de campañas de larga duración |
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:
```text theme={null}
https://app.famulor.io/mcp?profile=assistant-history
```
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:
| Tarea | Prueba preguntando |
| ----------- | ----------------------------------------------------------------------------------------------------------------------- |
| Assistants | "Crea un asistente de soporte fuera de horario y ejecuta una conversación de prueba con él antes de ponerlo en marcha." |
| Calls | "Muéstrame las llamadas de la semana pasada que no tuvieron éxito, con la transcripción de cada una." |
| Campaigns | "Inicia la campaña de renovación del Q3 y dime cuántos contactos están en cola." |
| Messaging | "Redacta una plantilla de WhatsApp pidiendo a un cliente que confirme su cita." |
| Knowledge | "Añade nuestra página de política de reembolsos como fuente de conocimiento y dime cuántas páginas indexó." |
| Automations | "Crea una automatización que envíe un SMS de seguimiento 30 minutos después de una llamada perdida." |
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
| Estado | Significado |
| ------ | ------------------------------------------------------------------------- |
| `401` | Falta el token o no es válido; vuelve a conectar el cliente |
| `403` | El plan, el rol o los alcances aprobados no permiten la acción solicitada |
| `405` | Envía las solicitudes MCP con `POST` |
| `429` | Demasiadas solicitudes; espera y vuelve a intentarlo |
Las mismas funciones para el cliente están disponibles a través de la [API REST](/es/api-reference/introduction). Elige la interfaz que mejor se adapte a tu integración.