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

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

Les mêmes fonctionnalités client sont disponibles via l’API REST. Choisissez l’interface la mieux adaptée à votre intégration.