> ## 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.
# Point de terminaison MCP
> Connecter Claude, ChatGPT ou un autre client MCP à votre espace de travail
Le point de terminaison **Model Context Protocol (MCP)** permet à une application d'IA d'utiliser les mêmes ressources d'espace de travail que celles du tableau de bord, dans les limites de votre forfait, de votre rôle et des autorisations approuvées.
```text theme={null}
https://app.famulor.io/mcp
```
Sur un domaine en marque blanche, utilisez ce domaine à la place. Les écrans de connexion et de consentement reprennent la même marque. Votre forfait doit inclure **Connect AI / MCP**.
## Connexion des clients
1. Ouvrez **Settings → Connectors → Add custom connector**.
2. Saisissez `https://app.famulor.io/mcp`.
3. Connectez-vous et approuvez les autorisations demandées.
4. Les outils approuvés apparaissent dans Claude.
1. Ouvrez **Settings → Connectors → Create**.
2. Saisissez `https://app.famulor.io/mcp` et choisissez **OAuth**.
3. Connectez-vous et approuvez les autorisations demandées.
Utilisez le point de terminaison ci-dessus avec OAuth. Pour une intégration serveur à serveur de confiance, vous pouvez à la place envoyer une clé API d'espace de travail comme jeton Bearer.
### Se connecter depuis Famulor
Choisissez **Connect** dans la barre latérale, ou **Use with ChatGPT & Claude** sur le tableau de bord. La fenêtre affiche l'URL MCP adaptée à votre domaine actuel et propose des prompts de démarrage pour les tâches courantes — créer un assistant, diagnostiquer un assistant qui se comporte mal, analyser votre dernier appel, vous améliorer à partir de vos 30 derniers appels, ou lancer une campagne.
Si vous travaillez depuis un agent de code comme Claude Code, Cursor ou Codex, installez le [Famulor Skill](https://github.com/bekservice/Famulor-Skill) open source avec `npx skills add bekservice/Famulor-Skill`. Il embarque la configuration du point de terminaison (ajoutez l'URL manuellement si votre client ne la détecte pas automatiquement), ainsi que des règles de travail spécifiques à Famulor en plus de l'accès MCP brut : lire l'état actuel avant de le modifier, faire confirmer tout ce qui est difficile à annuler, et rester à l'intérieur de l'espace de travail authentifié.
## Authentification et consentement
Les clients compatibles lancent automatiquement la connexion OAuth. L'écran de consentement affiche les autorisations demandées avant tout partage. Vous pouvez révoquer ces autorisations depuis les paramètres de votre compte.
Pour une connexion manuelle ou serveur à serveur, envoyez une clé API d'espace de travail :
```http theme={null}
Authorization: Bearer fam_...
```
Utilisez les portées les plus restreintes possible. Les portées d'écriture incluent l'accès en lecture correspondant.
## Choisir les outils à exposer
Le point de terminaison standard expose tous les outils autorisés par l'identifiant utilisé. Pour une liste d'outils plus restreinte, choisissez un ou plusieurs groupes lors de la connexion :
```text theme={null}
https://app.famulor.io/mcp?toolsets=assistants,calls
```
Vous pouvez aussi envoyer `X-MCP-Toolsets: assistants,calls`. L'en-tête est prioritaire sur le paramètre de requête. Utilisez `list_mcp_toolsets` pour voir les groupes disponibles pour votre compte.
| Groupe | Fonctionnalités client |
| ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `assistants` | Assistants, versions, modèles, voix, outils réutilisables, réservations et simulations |
| `calls` | Appels, historique des conversations, transcriptions et actions d'appel autorisées |
| `campaigns` | Campagnes, audiences, prospects, listes de suppression et synchronisation CRM |
| `messaging` | Connecteurs de messagerie et d'e-mail, modèles et conversations |
| `telephony` | Numéros de téléphone, trunks SIP, vos propres connexions opérateur et import BYOC, identifiant d'appelant et vérification de numéro, ainsi que l'ensemble du système Famulor Loop — présence, groupes d'appel, files d'attente, règles de routage, appareils et Recall |
| `knowledge` | Bases de connaissances, documents, imports de sites web et sources de fichiers connectées |
| `dashboards` | Tableaux de bord analytiques et widgets |
| `automations` | Automatisations, connexions, Milian Missions et historique d'exécution |
| `billing` | Solde, usage, transactions, parrainages et limites d'appels sortants |
| `settings` | Paramètres d'espace de travail, domaines, clés API et conservation |
| `platform` | Gestion des clients en marque blanche pour les revendeurs autorisés |
| `migration` | Prévisualiser et importer des ressources Famulor 1.0 ou des coquilles d'assistants inactives depuis Retell AI, Vapi et Synthflow |
| `tasks` | Exports longs, explorations de sites, simulations et préparation de campagne |
Le client MCP reçoit le schéma d'entrée actuel, les autorisations et les indications de sécurité de chaque outil qu'il est autorisé à utiliser. Cette découverte en direct fait référence pour les arguments de chaque outil.
### Profil d'annuaire public
La connexion vérifiée pour les annuaires ChatGPT et Claude utilise :
```text theme={null}
https://app.famulor.io/mcp?profile=assistant-history
```
Ce profil se limite aux informations sur les assistants et à l'historique des conversations, en lecture seule. Il exclut les modifications d'assistants, les appels sortants, les campagnes, la messagerie, la gestion des numéros de téléphone, la facturation, les intégrations et la découverte des groupes d'outils. Les connexions MCP personnalisées conservent les autorisations choisies lors de leur propre configuration.
## Exemples de prompts
Une fois un client connecté, le langage courant permet d'atteindre chaque outil pour lequel il est approuvé :
| Tâche | Exemple de demande |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Assistants | « Crée un assistant de support en dehors des heures d'ouverture et lance une conversation de test avant que je le mette en ligne. » |
| Appels | « Montre-moi les appels de la semaine dernière qui n'ont pas abouti, avec la transcription de chacun. » |
| Campagnes | « Démarre la campagne de renouvellement du T3 et dis-moi combien de contacts sont en file d'attente. » |
| Messagerie | « Rédige un modèle WhatsApp demandant à un client de confirmer son rendez-vous. » |
| Connaissances | « Ajoute notre page de politique de remboursement comme source de connaissances et dis-moi combien de pages elle a indexées. » |
| Automatisations | « Crée une automatisation qui envoie un SMS de relance 30 minutes après un appel manqué. » |
Un client bien conçu lit l'état actuel avant de le modifier, et vous demande de confirmer tout ce qui est difficile à annuler — un appel sortant, l'envoi d'un message, le démarrage d'une campagne, un achat. Utilisez des numéros de téléphone au format E.164 dans vos prompts, relisez un prompt système généré avant de demander au client de l'enregistrer, et gardez un seul workflow par prompt pour qu'une demande en plusieurs étapes reste facile à suivre.
## Tâches longues
Les imports de sites web, simulations, exports d'historique et préparations de grandes campagnes peuvent continuer sous forme de tâches MCP. Un client compatible peut afficher la progression, récupérer le résultat ou demander l'annulation. L'annulation arrête le travail restant lorsque c'est possible ; une action déjà acceptée par un service externe peut encore aboutir.
Les exports utilisent des liens de téléchargement privés de courte durée. Les tâches et leurs résultats restent limités à l'espace de travail et à l'identifiant qui les a créés.
Les outils d'historique des appels renvoient un objet `failure` indépendant du fournisseur lorsqu'un appel ne peut pas aboutir. Utilisez son code, son message adapté au client, son conseil de nouvelle tentative et l'action suggérée plutôt que de vous fier à des détails spécifiques à l'infrastructure.
## Erreurs
| Statut | Signification |
| ------ | -------------------------------------------------------------------------------- |
| `401` | Le jeton est manquant ou invalide ; reconnectez le client |
| `403` | Le forfait, le rôle ou les portées approuvées n'autorisent pas l'action demandée |
| `405` | Envoyez les requêtes MCP avec `POST` |
| `429` | Trop de requêtes ; patientez puis réessayez |
Les mêmes fonctionnalités client sont disponibles via l'[API REST](/fr/api-reference/introduction). Choisissez l'interface la mieux adaptée à votre intégration.