> ## 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.
# Conectar un cliente de IA
> Conecta Claude, ChatGPT u otro cliente MCP a tu espacio de trabajo de Famulor
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.
```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**.
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](/es/api/tools-and-webhooks#servidores-mcp-externos) 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.
1. Abre **Settings → Connectors → Create**.
2. Introduce `https://app.famulor.io/mcp` y selecciona **OAuth**.
3. Inicia sesión y aprueba los permisos solicitados.
Cursor, Windsurf, VS Code, Cline, Continue, Zed y cualquier otro cliente compatible con MCP funcionan de la misma forma: apunta el cliente al endpoint anterior y completa el inicio de sesión 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 — consulta [Autenticación](#autenticación-y-consentimiento) más abajo.
### 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](/es/mcp/tools-and-scopes)), 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](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 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:
```http theme={null}
Authorization: Bearer fam_...
```
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](/es/mcp/tools-and-scopes) 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:
| Límite | Valor |
| ---------------------------------- | -------------- |
| Solicitudes por credencial | 120 por minuto |
| Solicitudes por espacio de trabajo | 600 por minuto |
| Tamaño del cuerpo de la solicitud | 1 MB |
Un cliente que supere estos límites recibe una respuesta `429` y debe esperar y volver a intentarlo — consulta [Errores](/es/mcp/tools-and-scopes#errores).
Las mismas funciones orientadas al 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.