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

# Herramientas y alcances

> El catálogo completo de herramientas de MCP, cómo delimitarlo con alcances y el perfil público de solo lectura

Una vez conectado un cliente (consulta [Conectar un cliente de IA](/es/mcp/overview)), el lenguaje natural llega a cada herramienta para la que está autorizado. Esta página cubre el catálogo completo, cómo reducirlo y qué ocurre con las operaciones de larga duración o fallidas.

## Grupos de herramientas

El catálogo completo está organizado en 13 grupos. Una conexión con clave de API del espacio de trabajo recibe el catálogo completo de forma predeterminada; una conexión OAuth (Claude, ChatGPT) recibe un subconjunto curado de 7 de forma predeterminada — consulta [Qué puede ver un cliente conectado](/es/mcp/overview#qué-puede-ver-un-cliente-conectado).

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

## Elegir qué herramientas exponer

Selecciona uno o más 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 — está siempre disponible sin importar qué grupos hayas seleccionado.

Para una conexión con clave de API del espacio de trabajo, añade `?toolsets=all` para obtener el catálogo completo de 13 grupos en lugar del conjunto curado predeterminado.

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

## 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 — consulta [Límites de tasa](/es/mcp/overview#límites-de-tasa) |
