Claude MCP

Pilotez Finn depuis Claude via le Model Context Protocol.

11 min read

Le Model Context Protocol (MCP) est un standard ouvert qui permet aux assistants IA comme Claude d'appeler des outils externes. Finn exécute un serveur MCP : vous pouvez donc connecter Claude à votre compte Finn et créer des agents vocaux en les décrivant au fil d'une conversation, au lieu de remplir le builder à la main.

Ce que fait ce serveur. Il lit vos Finns et crée ou modifie des brouillons. C'est tout. Il ne peut ni lancer un Finn, ni composer un numéro, ni dépenser votre solde, ni toucher aux contacts, ni lire les transcriptions : ces actions restent volontairement dans le tableau de bord. La section Périmètre ci-dessous explique pourquoi.

À qui cela s'adresse. À toute personne qui utilise déjà Claude et préfère décrire un agent plutôt que le construire clic par clic. Aucune compétence en code n'est nécessaire. Si vous n'utilisez pas Claude, vous ne manquez rien : le tableau de bord fait tout ce que propose ce serveur, et plus encore.

Il existe exactement deux façons de se connecter, et une seule suffit :

Si vous utilisez	Connexion via	Ce que vous collez
Claude sur claude.ai ou Claude Desktop	Un connecteur personnalisé	Un lien
Claude Code dans un terminal	Une commande `claude mcp add`	Une ligne

Périmètre : ce que le serveur peut et ne peut pas faire

Possible	Impossible
Lister vos Finns et en lire un en intégralité	Lancer, mettre en pause ou arrêter un Finn
Créer un nouveau Finn sous forme de brouillon	Passer, recevoir ou tester un appel
Modifier le nom, le persona, la voix, la langue et la phrase d'accueil d'un brouillon	Modifier un Finn déjà lancé
Indiquer à quelle organisation appartient votre clé	Acheter ou associer un numéro de téléphone
Parcourir le catalogue de voix	Lire les transcriptions, enregistrements ou analyses
	Ajouter ou supprimer des contacts et des audiences
	Consulter ou modifier la facturation, le portefeuille ou l'offre
	Supprimer quoi que ce soit

Ce choix est délibéré et appliqué à deux niveaux : le serveur refuse d'exposer ces outils, et le backend rejette les requêtes correspondantes même si quelque chose les demande. La raison tient au lien du connecteur décrit plus bas : ce lien constitue lui-même un identifiant. En cas de fuite, le pire qu'il permette est de lire vos Finns et de modifier vos brouillons, ce qui reste réparable. « Appeler mes clients et dépenser mon solde » ne l'est pas.

Conséquence pour vous : Claude le construit, vous le lancez. Chaque Finn arrive sous forme de brouillon ; vous le vérifiez dans le tableau de bord, puis vous appuyez sur le bouton.

Étape 1 : générer une clé

Dans le tableau de bord : Paramètres → Intégrations → Assistants IA (MCP) → Générer une clé.

Le nom donné à la clé est celui sous lequel le connecteur apparaît dans Claude. Nommez-la donc d'après l'endroit où vous comptez l'utiliser, par exemple « PC portable pro » ou « ordinateur perso ». Deux clés apparaîtront alors comme deux entrées distinctes, et non comme deux lignes identiques.

Votre clé se compose de finn_mcp_ suivi d'une longue chaîne. Elle ne s'affiche qu'une seule fois. Copiez ce dont vous avez besoin avant de fermer la boîte de dialogue ; si vous la perdez, révoquez-la et générez-en une nouvelle.

Quelques points à connaître sur les clés :

Une clé porte votre identité. Un Finn créé avec votre clé est ajouté à votre organisation, en votre nom. Si vous utilisez la clé d'un collègue, le Finn apparaît dans son compte et vous ne pourrez pas le retrouver.
Il n'existe ni périmètres ni niveaux. Chaque clé peut faire tout ce qui figure dans la liste « Possible » ci-dessus, et rien de ce qui figure dans la liste « Impossible ».
La révocation est immédiate. Le serveur revérifie la clé auprès de votre compte à chaque appel : une clé révoquée cesse donc de fonctionner dès la requête suivante, et non à la fin d'une session.

Étape 2 — Connecter Claude

La boîte de dialogue qui affiche votre nouvelle clé propose les deux options, chacune avec un bouton de copie. Choisissez celle qui correspond à votre usage de Claude.

Option 1 — Application Claude (claude.ai ou Claude Desktop)

C'est l'option qui convient à la plupart des utilisateurs. Rien à installer ni à modifier.

Copiez votre lien de connecteur depuis la boîte de dialogue. Il ressemble à ceci, avec votre propre clé à la fin :

https://finn-mcp-73965536364.asia-southeast1.run.app/mcp/finn_mcp_YOUR_KEY_HERE

Ensuite, dans Claude :

Ouvrez Personnaliser → Connecteurs, cliquez sur + et choisissez Ajouter un connecteur personnalisé.
Collez le lien comme URL du serveur MCP distant, puis cliquez sur Ajouter. Il apparaît sous le nom de votre clé.
Dans une nouvelle conversation, ouvrez + → Connecteurs et activez Finn, puis demandez à Claude de créer un Finn.

Deux points à connaître selon les forfaits : le forfait Free autorise un seul connecteur personnalisé, et sur les forfaits Team et Enterprise, seul un Owner peut en ajouter un, depuis Paramètres de l'organisation → Connecteurs ; les autres membres cliquent ensuite sur Connecter.

La contrepartie : un connecteur personnalisé se limite à un champ d'URL, sans emplacement pour un mot de passe, donc le lien fait office d'identifiant. Traitez l'URL complète comme le mot de passe de votre tableau de bord : ne la collez jamais dans une conversation, un ticket, une capture d'écran ou un dépôt.

Option 2 — Claude Code (terminal)

Copiez la commande depuis la boîte de dialogue. Elle tient sur une seule ligne et se colle donc sans problème dans bash, zsh, PowerShell comme dans cmd :

claude mcp add --transport http finn https://finn-mcp-73965536364.asia-southeast1.run.app/mcp --header "Authorization: Bearer finn_mcp_YOUR_KEY_HERE"

Collez la commande dans un terminal et exécutez-la.
Exécutez claude.
Demandez-lui de créer un Finn.

Cette méthode place la clé dans un en-tête plutôt que dans l'URL, ce qui en fait la plus sûre des deux.

Autres clients MCP

Le serveur utilise le HTTP streamable, et non stdio, et il est sans état : aucune session à ouvrir ni à expirer. Tout client prenant en charge un point de terminaison MCP HTTP fonctionne avec l'une ou l'autre des deux méthodes ci-dessus : la clé dans un en-tête Authorization: Bearer vers /mcp, ou la clé comme dernier segment du chemin de /mcp/<key>.

claude_desktop_config.json ne fait pas partie des options. Ce fichier configure des serveurs MCP locaux ; le serveur Finn est distant, il s'ajoute donc comme connecteur personnalisé.

Étape 3 — Vérifier le fonctionnement

Demandez à Claude :

« Quels Finns ai-je ? »

Si la connexion fonctionne, la réponse contient les noms réels de vos Finns. Si Claude indique ne disposer d'aucun outil de ce type, consultez la section Dépannage ci-dessous.

Les outils

Six outils, entre lesquels Claude choisit seul : vous n'avez jamais à en nommer un.

Outil	Rôle	Écriture ?
`list_finns`	Vos Finns, du plus récent au plus ancien, avec identifiant, nom, statut et cas d'usage	Non
`get_finn`	La configuration complète d'un Finn	Non
`list_orgs`	L'organisation à laquelle appartient votre clé, et votre rôle	Non
`list_voices`	Le catalogue de voix, filtrable par fournisseur et par terme de recherche	Non
`create_finn`	Crée un nouveau Finn en brouillon	Oui — crée un brouillon
`update_finn_draft`	Modifie le nom, la persona, le cas d'usage, la langue, la voix, la phrase d'accueil ou le vocabulaire d'un brouillon	Oui — brouillons uniquement

Créer un Finn en conversant

Formulez votre demande en langage courant. La boîte de dialogue propose celle-ci comme point de départ :

« Utilise le connecteur Finn pour créer un brouillon de Finn appelé Maya qui prend les rendez-vous d'un cabinet dentaire : ton aimable, réponses concises, en anglais. »

Une demande plus complète ressemble à ceci :

« Crée un Finn appelé Skylar qui planifie des appels de démo de 15 minutes pour notre équipe commerciale. Chaleureux et concis, il n'interrompt jamais et confirme toujours la date et l'heure à l'appelant. Il ne doit parler que des démos et de la planification — si quelqu'un pose une question sur les tarifs, il propose de le transférer à un humain. Utilise une voix féminine anglaise et aimable. »

Pour cela, Claude a besoin de quatre éléments et vous les demandera s'il en manque un :

Champ	Description
Nom	Le nom du Finn
Rôle et identité	Qui il est et quelle est sa mission
Ton et style	Sa façon de s'exprimer
Consignes de réponse	Ce qu'il doit faire et ne pas faire

Vous pouvez aussi indiquer un libellé de cas d'usage, une langue, une voix, une phrase d'accueil et une liste de vocabulaire personnalisée pour les noms qu'il prononcerait mal.

En retour, vous obtenez un lien vers le nouveau brouillon, son identifiant, ainsi que l'organisation et le compte dans lesquels il a été créé. Ensuite :

Ouvrez le lien et vérifiez le brouillon dans l'éditeur.
Demandez des modifications à Claude — « raccourcis la phrase d'accueil », « ajoute une branche pour la messagerie vocale » — et il modifie directement le brouillon.
Une fois satisfait, associez un numéro et lancez le Finn depuis le tableau de bord. Voir Déploiements.

Un onglet du tableau de bord déjà ouvert n'affichera le nouveau Finn qu'après avoir été rechargé.

Voix

Décrivez la voix souhaitée — « une voix masculine anglaise et posée » — et Claude cherchera dans le catalogue pour vous.

Point de vigilance : les nouveaux Finn sont créés sur Cartesia, et un identifiant de voix d'un autre fournisseur sera enregistré sans erreur, puis échouera lors d'un vrai appel. Si vous demandez un fournisseur précis, vérifiez que c'est bien celui qu'utilise votre Finn. Le catalogue complet se trouve dans Galerie de voix.

Sécurité

Le lien du connecteur est un mot de passe. Avec la configuration à lien unique, la clé figure dans l'URL : toute personne qui voit l'URL dispose de votre accès. Ne faites pas de capture d'écran, ne la collez pas dans une discussion partagée et ne la commitez pas.

Considérez que tout ce que vous collez est exposé. Si une clé est passée par une fenêtre de chat, un ticket ou un e-mail, révoquez-la et générez-en une nouvelle. Cela ne coûte rien.

Révoquez une clé dans Paramètres → Intégrations → Assistants IA → Révoquer. La révocation s'applique dès la requête suivante. Les Finns déjà créés restent intacts : révoquer une clé ne supprime rien de ce qu'elle a créé.

Une clé par emplacement. Avec des clés distinctes pour votre ordinateur portable, votre ordinateur de bureau et chaque collègue, vous pouvez en révoquer une sans toucher aux autres, et le nom du connecteur vous indique à quoi chacune correspond.

Vérifiez dans quel compte vous vous trouvez. Si vous appartenez à plusieurs organisations, demandez à Claude « dans quelle organisation Finn suis-je ? » avant de créer quoi que ce soit. Les nouveaux Finns sont créés dans l'organisation que vous avez rejointe le plus récemment.

Dépannage

« Claude ne dispose d'aucun outil Finn »

Dans l'application Claude, ouvrez + → Connecteurs dans la conversation et vérifiez que Finn est activé. Les connecteurs s'activent conversation par conversation.
Dans Claude Code, redémarrez l'application : elle lit sa configuration MCP au démarrage.
Avec un forfait Free, vérifiez que vous n'avez pas déjà utilisé votre unique emplacement de connecteur personnalisé pour autre chose.

« Ce lien de connecteur n'est pas valide »

La clé dans l'URL est mal formée. Elle doit être complète, commencer par finn_mcp_, sans rien de tronqué à la fin, et sans barre oblique ni espace final.

« Ce lien de connecteur a été révoqué »

Cette clé n'existe plus. Générez-en une nouvelle et mettez à jour le connecteur.

« Impossible de joindre le backend Finn pour vérifier votre clé »

Il s'agit d'un problème temporaire de notre côté, et non d'une erreur dans votre configuration. Réessayez ; si le problème persiste, contactez le support.

Claude a créé un Finn, mais vous ne le trouvez pas

C'est presque toujours une question de compte. Demandez à Claude « dans quelle organisation a-t-il été créé ? » : la réponse indique l'organisation et l'e-mail associé à la clé. S'il ne s'agit pas du vôtre, vous utilisez la clé de quelqu'un d'autre.

Claude indique qu'il ne peut pas modifier un Finn

Ce Finn a été lancé. Le serveur ne modifie que les brouillons ; un Finn en production se modifie dans le tableau de bord.

Étapes suivantes

Créer un Finn → : l'outil de création du tableau de bord et le rôle de chaque champ de persona.
Déploiements → : associer un numéro et mettre un brouillon en production.
Galerie de voix → : le catalogue complet des voix.
Intégrations → : les webhooks et les autres options d'intégration.

Was this page helpful?

Still stuck or have feedback?

Email [email protected] or use the chat bubble in the bottom-right corner — it's a Finn that knows the Academy cold.