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

  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.

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, 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. Le même sélecteur est disponible à 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.

Ce qu’un client connecté peut voir

Par défaut, un client connecté via OAuth (Claude, ChatGPT et similaires) reçoit un ensemble organisé de 7 groupes d’outilsassistants, 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 13 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.