Skip to main content
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 — assistants, appels, campagnes, bases de connaissances et plus encore — dans les limites de votre forfait, de votre rôle et des autorisations approuvées.
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.
Cette page explique comment connecter un client IA (Claude, ChatGPT et d’autres) à Famulor. Vous cherchez plutôt à connecter l’un de vos assistants vers l’extérieur, à un serveur MCP externe en cours d’appel — votre propre CRM ou vos outils internes ? Consultez plutôt Outils et webhooks.

​
Connexion des clients

Connectez votre espace de travail avec le connecteur Famulor de l’annuaire Claude.
  1. Ouvrez la page de l’annuaire et choisissez Connect.
  2. Connectez-vous à votre compte Famulor et approuvez l’accès demandé.
  3. Démarrez une conversation et demandez par exemple : « Examine mon assistant de support et résume ses derniers appels. »
Le connecteur de l’annuaire fournit les informations sur les assistants et l’historique des conversations en lecture seule. Voir Profil de l’annuaire public.
Pour créer et modifier des assistants, lancer des campagnes ou utiliser un domaine en marque blanche, ajoutez un connecteur personnalisé avec l’URL affichée dans Paramètres → API & MCP :
  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.
Connecter dans la barre latérale et Ajouter à Claude dans Paramètres → API & MCP proposent les deux options : le connecteur de l’annuaire ou un connecteur personnalisé prérempli.

​
Se connecter depuis Famulor

Choisissez Connect dans la barre latérale, ou Use with ChatGPT & Claude sur le tableau de bord. Choisissez votre application d’IA à gauche (Claude, ChatGPT, Cursor ou Windsurf) : la configuration s’affiche en trois étapes courtes, avec un bouton qui ouvre l’application ou installe le connecteur. Pour Claude, choisissez entre le connecteur de l’annuaire (lecture seule) et un connecteur personnalisé avec accès complet. Partout où un connecteur personnalisé est utilisé, la fenêtre affiche l’URL MCP adaptée à votre domaine actuel, vous permet de choisir les groupes d’outils à connecter (voir Outils et portées), 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. L’URL MCP et les mêmes boutons d’application sont disponibles à tout moment depuis Settings → API & MCP.
Si vous travaillez depuis un agent de code comme Claude Code, Cursor ou Codex, installez le 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 groupes d’outils demandés avant tout partage, et votre choix est mémorisé pour les connexions futures. Les connexions approuvées sont répertoriées sous Settings → API & MCP, où chacune peut être révoquée à tout moment. Pour une connexion manuelle ou serveur à serveur, envoyez plutôt une clé API d’espace de travail :
Utilisez les portées les plus restreintes possible. Les portées d’écriture incluent l’accès en lecture correspondant.
Formulaire de création de clé API avec un champ de nom vide et le bouton Create key

Pour votre propre intégration serveur, ouvrez Settings → API & MCP → Create a new API key, saisissez un nom reconnaissable et sélectionnez Create key.

​
Ce qu’un client connecté peut voir

Le plugin officiel ChatGPT utilise le profil d’annuaire public en lecture seule. Ses autorisations restent limitées aux informations des assistants et à l’historique des conversations. Une connexion OAuth personnalisée reçoit par défaut un ensemble organisé de 7 groupes d’outils — assistants, calls, campaigns, knowledge, telephony, billing et settings — plutôt que le catalogue complet. Il s’agit d’une limite volontaire, et non d’une restriction de forfait : le catalogue complet d’outils de Famulor est vaste, et le charger en une seule fois dépasse ce que ces clients prennent en charge de façon fiable. Sélectionner tous les groupes lors de la configuration vous amène malgré tout à cet ensemble organisé, pour cette même raison. Pour utiliser moins de groupes, décochez ceux dont vous n’avez pas besoin lors de la connexion, ou modifiez votre sélection à tout moment sous Settings → API & MCP. Voir Outils et portées pour le contenu de chaque groupe. Si votre intégration a réellement besoin du catalogue complet — les 14 groupes —, connectez-vous avec une clé API d’espace de travail plutôt qu’avec OAuth, et ajoutez ?toolsets=all à l’URL du point de terminaison. Cette voie est destinée à vos propres scripts et intégrations serveur à serveur, pas à un client IA généraliste.

​
Limites de débit

Les requêtes MCP sont soumises à une limite de débit afin de garder la plateforme réactive pour chaque espace de travail : Un client qui dépasse ces limites reçoit une réponse 429 et doit patienter avant de réessayer — voir Erreurs.
Les mêmes fonctionnalités client sont disponibles via l’API REST. Choisissez l’interface la mieux adaptée à votre intégration.