# Connecter des serveurs MCP à votre bot Les serveurs MCP permettent à votre bot IA d'utiliser des outils provenant d'un autre système lors de conversations en direct, sans que vous ayez à créer chaque outil manuellement. Vous indiquez une seule fois l'adresse d'un serveur MCP au bot, et tous les outils proposés par ce serveur deviennent automatiquement disponibles pour le bot. Si vous avez déjà utilisé des fonctions personnalisées (Custom Functions), le principe est le même, mais poussé plus loin : une fonction personnalisée est un outil unique que vous configurez vous-même, tandis qu'un serveur MCP est un ensemble d'outils prêts à l'emploi que le bot peut découvrir et appeler de lui-même. --- ## Qu'est-ce qu'un serveur MCP ? Le MCP (Model Context Protocol) est un standard ouvert permettant aux assistants IA d'accéder à des outils externes. De nombreuses applications et services modernes publient désormais un « serveur MCP » — une adresse web unique qui expose un ensemble d'outils que l'IA peut appeler : effectuer une recherche, récupérer un enregistrement, exécuter une requête, créer un élément. Au lieu de décrire chaque outil au bot, vous donnez à Your AI Connector l'adresse du serveur et une clé d'accès. Your AI Connector demande au serveur « que pouvez-vous faire ? », récupère la liste des outils et les rend disponibles pour votre bot. Lorsqu'un nouvel outil est ajouté au serveur, votre bot peut l'utiliser sans configuration supplémentaire de votre côté. **Fonctions personnalisées vs serveurs MCP : lequel choisir ?** | | Fonctions personnalisées | Serveurs MCP | | ------------------ | --------------------------------------------------- | -------------------------------------------------------------- | | **Ce que vous configurez** | Un outil à la fois, entièrement manuellement (URL, entrées, mappage de réponse). | Une adresse de serveur — le bot découvre tous ses outils pour vous. | | **Idéal pour** | Un appel unique et spécifique vers votre propre système. | Se connecter à un service qui utilise déjà MCP et propose de nombreux outils. | | **Maintenance** | Vous mettez à jour la fonction lorsque l'outil change. | Les nouveaux outils du serveur apparaissent automatiquement. | Vous pouvez utiliser les deux en même temps sur le même Agent. --- ## Comment ça marche (version simplifiée) 1. Vous **enregistrez un serveur MCP** sur la page **Serveurs MCP** — son adresse web et un en-tête d'autorisation (généralement une clé API). 2. Your AI Connector **se connecte et découvre** les outils du serveur, puis mémorise la liste. 3. Vous **activez le serveur sur un Agent**. 4. Pendant une conversation, lorsque le client demande quelque chose auquel un outil peut répondre, **le bot appelle l'outil**, lit le résultat et répond naturellement. Le client ne voit jamais la machinerie — il obtient simplement une réponse basée sur des informations réelles et à jour. ### Coût d'un appel d'outil MCP Un appel d'outil depuis un serveur MCP est facturé exactement comme un appel de fonction personnalisée, au niveau de qualité IA de votre agent : | Niveau de qualité IA | Crédits par appel d'outil MCP | Avec votre propre clé Anthropic (BYOK) connectée | |---|---|---| | Pro | 1 crédit | 0 crédit — s'exécute avec votre clé | | Economy (obsolète) | 0,5 crédit | 0 crédit — s'exécute avec votre clé | | Max | 0,25 crédit | toujours 0,25 crédit, facturé même avec votre propre clé connectée, car Max s'exécute sur notre propre modèle | | Mini | 0,15 crédit | toujours 0,15 crédit, facturé même avec votre propre clé connectée, car Mini s'exécute sur notre propre modèle | --- ## Ajouter un serveur MCP (étape par étape) Dans la barre latérale principale, sous **AI Studio**, cliquez sur **Serveurs MCP**. Cliquez ensuite sur **+ Ajouter un serveur**. Remplissez le formulaire : | Champ | Ce qu'il faut saisir | Exemple | | -------------------- | ----------------------------------------------------------------------------- | --------------------------------- | | **Nom** | Une courte étiquette pour le serveur (également utilisée pour nommer ses outils pour le bot). | `Order System` | | **URL du serveur** | L'adresse MCP du serveur (parfois appelée « endpoint »), commençant par `https://`. | `https://tools.mystore.com/mcp` | | **Nom de l'en-tête d'auth** | L'en-tête attendu par le serveur pour l'authentification. Laissez tel quel `Authorization` sauf si la documentation du serveur indique le contraire. | `Authorization` | | **Valeur de l'en-tête d'auth**| La valeur d'identification elle-même, au format attendu par le serveur. | `Bearer sk_live_abc123` | ### Choisir comment se connecter : clé API ou OAuth Your AI Connector prend en charge deux méthodes pour s'authentifier auprès d'un serveur. Choisissez celle indiquée par la documentation du serveur, en utilisant l'option **Authentification** en haut du formulaire : - **Clé API / en-tête :** la méthode originale décrite ci-dessus. Vous collez un identifiant fixe (une clé API ou un jeton) dans le champ **Valeur de l'en-tête d'authentification**, et Your AI Connector l'envoie à chaque requête. Idéal pour les serveurs qui vous fournissent une clé à longue durée de vie. - **OAuth (connexion) :** pour les serveurs qui vous demandent de vous connecter au lieu de coller une clé. Avec OAuth, il n'y a aucune clé à copier — vous approuvez l'accès en vous connectant, de la même manière que fonctionne « Se connecter avec Google » sur d'autres sites. **Pour se connecter avec OAuth :** 1. Choisissez **OAuth** comme méthode d'authentification. Les champs d'en-tête d'authentification disparaissent, remplacés par une carte **Connecter** — vous n'aurez pas besoin de clé. 2. Remplissez le **Nom** et l'**URL du serveur**, puis cliquez sur **Enregistrer**. Le serveur est ajouté à votre liste, mais s'affiche comme **non connecté** pour le moment. 3. Cliquez sur **Connecter** sur le serveur. Une fenêtre de connexion sécurisée s'ouvre pour vous permettre d'approuver l'accès. 4. Approuvez, et la fenêtre se ferme d'elle-même. Le serveur s'affiche désormais comme connecté, et Your AI Connector charge ses outils. C'est tout. Your AI Connector maintient automatiquement la connexion active en arrière-plan, vous n'aurez donc normalement plus jamais à y toucher. Si un serveur perd la connexion (par exemple, si la session expire ou si quelqu'un la révoque côté serveur), il s'affichera comme déconnecté — cliquez simplement sur **Reconnecter** et connectez-vous à nouveau. Si le serveur ne peut pas être configuré automatiquement lorsque vous cliquez sur Connecter, il vous sera demandé de coller quelques détails (une adresse de connexion et un identifiant client) fournis par la documentation du serveur, puis la connexion terminera l'authentification. ### Tester la connexion Avant d'enregistrer, cliquez sur **Tester la connexion**. Your AI Connector contacte le serveur et vous montre la liste des outils qu'il propose. C'est le moyen le plus rapide de confirmer que votre URL et votre clé sont correctes — si la connexion échoue, vous verrez le message d'erreur immédiatement au lieu de le découvrir au milieu d'une conversation. Lorsque le test réussit, cliquez sur **Enregistrer**. Votre serveur apparaît dans la liste avec un point d'état vert et le nombre d'outils qu'il propose. ### Lire la liste des serveurs Chaque serveur dans la liste affiche : - Un **point d'état** — vert lorsque la dernière connexion a fonctionné, rouge lorsque la dernière tentative a échoué (survolez pour voir l'erreur), gris avant la première connexion réussie. - L'**adresse du serveur** et le nombre d'outils qu'il propose actuellement. - Un **interrupteur marche/arrêt** pour activer ou désactiver rapidement l'ensemble du serveur sans le supprimer. Your AI Connector actualise la liste des outils de chaque serveur en arrière-plan environ une fois par jour, afin que les nouveaux outils apparaissent d'eux-mêmes. Un serveur lent ou temporairement inaccessible ne bloque jamais une conversation — le bot utilise simplement la dernière liste d'outils connue et bascule gracieusement si un appel ne peut pas aboutir. ### Choisir les outils que le bot peut utiliser Un serveur propose souvent plus d'outils que ce que vous souhaitez laisser utiliser par le bot. Vous pouvez activer ou désactiver des outils individuellement sans déconnecter l'ensemble du serveur. 1. Cliquez sur l'icône **crayon (modifier)** correspondant au serveur dans la liste. 2. Faites défiler jusqu'à la section **Outils** : chaque outil proposé par le serveur y est listé, avec son propre interrupteur marche/arrêt. 3. Désactivez tout outil que vous ne souhaitez pas que le bot appelle, ou utilisez **Tout activer** / **Tout désactiver** pour les configurer en une seule fois. 4. Cliquez sur **Enregistrer les modifications**. Seuls les outils que vous laissez activés sont proposés au bot. Un outil désactivé est totalement invisible pour le bot : il ne peut pas l'appeler et il ne sera pas comptabilisé dans la limite de 40 outils. Deux points importants à connaître : - **Les nouveaux outils restent désactivés jusqu'à ce que vous les activiez.** Une fois que vous avez sélectionné les outils d'un serveur, tout outil ajouté ultérieurement par le serveur arrive désactivé, afin qu'aucun nouvel outil ne soit disponible pour le bot avant que vous ne décidiez de l'activer. (Les serveurs que vous n'avez jamais sélectionnés conservent tous leurs outils activés, exactement comme avant.) - **Ceci est distinct du choix de l'Agent ci-dessous.** Ici, vous décidez quels outils d'un serveur existent au niveau du compte ; sur l'Agent, vous décidez quels serveurs cet Agent peut atteindre — et, si vous le souhaitez, vous pouvez restreindre davantage ses outils spécifiquement pour cet Agent. ### Définition des limites d'exécution par outil À côté de l'interrupteur marche/arrêt de chaque outil, vous trouverez une commande **Limites**. Elle ouvre les mêmes limites d'exécution que celles que vous pouvez définir sur une [fonction personnalisée](custom-functions.md#execution-limits), appliquées uniquement à cet outil — utile lorsqu'un outil de serveur appelle un service tiers payant, ou lorsqu'un outil ne doit être exécuté qu'une seule fois par conversation. Tout ici est facultatif ; laissez vide et l'outil se comportera exactement comme avant. - **Lecture seule.** Certains serveurs déclarent pour chaque outil s'il ne fait que lire des données. **Automatique (paramètre du serveur)** fait confiance à cette déclaration ; vous pouvez la remplacer dans les deux sens — marquez un outil en **Lecture seule** lorsque vous savez qu'il ne crée ou ne modifie jamais rien (cela permet à l'IA de réessayer en toute sécurité une réponse interrompue au lieu de laisser le client sans réponse), ou en **Non lecture seule** lorsque vous ne faites pas confiance à la déclaration du serveur. - **Servir le résultat mis en cache lors d'appels répétés.** Lorsque l'IA appelle à nouveau l'outil avec les mêmes entrées, le résultat précédent est réutilisé (jusqu'à 24 heures) au lieu d'appeler à nouveau le serveur. - **Max d'exécutions par conversation** et **max d'exécutions par fenêtre temporelle** fonctionnent exactement comme pour les fonctions personnalisées : seules les exécutions réussies sont comptabilisées, et lorsqu'une limite est atteinte, l'IA est informée de la raison et répond avec les informations dont elle dispose déjà — le client n'est jamais laissé en plan. Les conversations de test sont exemptées. Une remarque honnête sur la confiance : les limites contrôlent si et à quelle fréquence *nous appelons* le serveur — elles ne peuvent pas changer ce que le serveur fait en interne une fois appelé. Et remplacer un outil tiers par Lecture seule est une affirmation plus forte que pour votre propre fonction personnalisée, car il s'agit du code de quelqu'un d'autre ; ne le faites que pour les outils que vous comprenez. --- ## Activer un serveur sur un Agent L'enregistrement d'un serveur le rend disponible ; vous choisissez toujours quels Agents peuvent l'utiliser. 1. Ouvrez l'[Agent](../ai-agents/ai-agents.md) et accédez à son onglet **Capacités IA**. (Pour une campagne qui conserve ses propres paramètres d'IA directement plutôt que via un Agent séparé, la même liste apparaît à l'étape **Capacités IA** de cette campagne.) 2. Trouvez la section **Serveurs MCP**. 3. Activez chaque serveur que vous souhaitez que le bot de cet Agent puisse utiliser. 4. Cliquez sur **Enregistrer les modifications** — les sélections ne s'appliquent qu'une fois enregistrées. Vous pouvez activer jusqu'à **5 serveurs par Agent**. Seuls les serveurs que vous activez sont disponibles pour le bot de cet Agent, ce qui permet au bot de rester concentré sur les outils pertinents. ### Choisir les outils qu'un Agent peut utiliser Une fois qu'un serveur est activé sur un Agent, vous pouvez également restreindre **lesquels de ses outils** cet Agent particulier peut appeler — pratique lorsqu'un Agent ne doit que lire des données tandis qu'un autre peut également créer des enregistrements. 1. Dans l'onglet **Capacités IA**, sous le serveur activé, cliquez sur la ligne **« … outils activés pour cet agent »** pour développer la liste des outils. 2. Désactivez tout outil que cet Agent ne devrait pas utiliser, puis cliquez sur **Enregistrer les modifications**. Deux règles permettent de garder cela prévisible : - **Un Agent peut seulement restreindre, jamais élargir.** Les outils que vous avez désactivés au niveau du compte (sur la page Serveurs MCP) n'apparaissent pas ici et ne peuvent pas être réactivés pour un seul Agent. - **Les Agents héritent par défaut.** Un Agent pour lequel vous n'avez pas touché à la liste d'outils suit simplement la sélection au niveau du compte — y compris les outils que vous y activez plus tard. Une fois que vous restreignez la liste d'un Agent, les nouveaux outils restent désactivés pour cet Agent jusqu'à ce que vous les activiez. --- ## Exemple prêt à l'emploi : connecter une boutique Shopify Chaque boutique Shopify est dotée d'un serveur MCP intégré — aucune application à installer, aucune clé à créer. Shopify l'héberge à l'adresse Web de la boutique avec `/api/mcp` ajouté à la fin. Ce que le bot en retire : - **Recherche de produits** — trouvez des produits en décrivant ce que le client souhaite (« une veste de running chaude à moins de 100 $ »), avec les prix en temps réel, les variantes et les stocks. - **Détails du produit** — informations complètes sur un produit spécifique, y compris les options et la disponibilité. - **Politiques de la boutique et FAQ** — réponses aux questions sur l'expédition, les retours, les remboursements et la confidentialité, basées sur les pages de la boutique elle-même. - **Panier** — créez un panier pour le client et fournissez-lui un lien de paiement. Pour en connecter une, ajoutez un serveur avec : | Champ | À saisir | |---|---| | **Nom** | `Shopify Store` (ou le nom de la boutique) | | **URL du serveur** | L'adresse Web de la boutique plus `/api/mcp` — par exemple `https://mystore.com/api/mcp`. L'adresse technique de la boutique fonctionne également : `https://mystore.myshopify.com/api/mcp`. | | **Authentification** | Laissez **Clé API / en-tête** sélectionné et laissez la **Valeur de l'en-tête d'authentification** vide — ce serveur ne nécessite aucune clé. | Enregistrez, cliquez sur **Tester la connexion** et activez le serveur sur votre agent — c'est tout ce qu'il y a à faire. Deux choses à savoir : - **Les commandes ne sont pas sur ce serveur.** Shopify exclut délibérément les données de commande de ce point de terminaison public. Pour les questions du type « où est ma commande ? », associez ce serveur à une fonction personnalisée — voir l'exemple [statut de commande Shopify](custom-functions.md#complete-example-shopify-order-status). - **Cela fonctionne pour n'importe quelle boutique Shopify** — y compris la boutique d'un client si vous gérez des comptes pour des tiers. Tout ce dont vous avez besoin est l'adresse Web de la boutique. --- ## Sécurité — Ne connectez que des serveurs de confiance Un serveur MCP que vous connectez peut être appelé par votre bot et peut renvoyer du texte que le bot lit et sur lequel il agit. Traitez-le comme toute autre intégration qui détient une clé d'accès à vos systèmes : - **Enregistrez uniquement les serveurs que vous contrôlez ou en lesquels vous avez entièrement confiance.** La description d'un outil est rédigée par la personne qui gère le serveur, et le bot lit ces descriptions pour décider quand utiliser un outil. - **Utilisez une clé API dédiée et limitée**, et non des identifiants d'administrateur. Votre clé est stockée de manière sécurisée et n'est jamais affichée dans les exportations de données. Il en va de même pour les connexions OAuth : les jetons d'accès sont stockés de manière sécurisée et masqués dans toute exportation. - **L'URL doit être une adresse `https://` publique.** Les adresses internes, localhost et celles de réseaux privés sont rejetées pour des raisons de sécurité. - **Désactivez un serveur dès que vous ne lui faites plus confiance** : désactivez-le ou supprimez-le, et il disparaîtra immédiatement de tous les Agents. --- ## Dépannage - **Point d'état rouge / échec de connexion :** Rouvrez le serveur et cliquez sur **Tester la connexion** pour voir l'erreur exacte. Les causes les plus fréquentes sont une clé incorrecte ou expirée, une faute de frappe dans l'URL, ou le fait que le serveur exige un nom d'en-tête autre que `Authorization`. - **Un serveur OAuth a cessé de fonctionner / vous demande de vous reconnecter :** Les connexions OAuth peuvent être révoquées ou expirer du côté du serveur. Ouvrez le serveur et cliquez à nouveau sur **Connecter** pour vous reconnecter. Notez que les connexions OAuth ne sont jamais copiées entre les comptes ; par conséquent, les serveurs d'un Agent ou d'une campagne copiés doivent être reconnectés dans le compte vers lequel vous les avez copiés. - **Le bot n'utilise pas un outil :** Vérifiez d'abord que l'outil est activé dans la section **Outils** du serveur (modifiez le serveur pour voir la liste) — un outil désactivé est invisible pour le bot. Assurez-vous ensuite que le serveur est activé sur cet Agent spécifique et que la demande du client correspond clairement à ce que fait l'outil. Comme pour les fonctions personnalisées, des noms et des descriptions d'outils clairs du côté du serveur aident le bot à choisir correctement. - **Un outil proposé par le serveur n'apparaît pas pour le bot :** Si vous avez sélectionné les outils de ce serveur, n'oubliez pas que tout outil ajouté après votre sélection arrive désactivé. Modifiez le serveur, ouvrez la section **Outils** et activez-le. - **Le connecteur gère-t-il les sessions HTTP MCP ?** Oui. Si votre serveur émet un en-tête `mcp-session-id` lors de l'établissement de la connexion, nous le stockons et le renvoyons à chaque requête suivante, avec l'en-tête `MCP-Protocol-Version`. Les serveurs avec état fonctionnent sans configuration supplémentaire de votre côté. - **Un outil a été ignoré :** Un Agent peut utiliser au maximum 5 serveurs et 40 outils MCP à la fois. Si un serveur propose un très grand nombre d'outils, certains peuvent ne pas être chargés — désactivez les outils dont vous n'avez pas besoin dans la section **Outils** du serveur, ou faites en sorte que chaque serveur se concentre sur les outils que vous utilisez réellement. --- ## Exigences du plan Les serveurs MCP font partie de la boîte à outils du développeur, aux côtés des fonctions personnalisées. Si vous ne voyez pas **Serveurs MCP** dans la section AI Studio de la barre latérale, votre forfait actuel ne l'inclut pas ; passez à un forfait avec outils de développement pour l'activer. --- ## Étapes suivantes - [Fonctions personnalisées](custom-functions.md) — configurez manuellement un outil unique au lieu de connecter un serveur entier. - [Agents IA](../ai-agents/ai-agents.md) — là où les serveurs MCP sont activés pour un bot. - [Agents IA](../ai-agents/ai-agents.md) — la page principale du groupe AI Studio où se trouvent les serveurs MCP.