Ajouter votre propre serveur MCP

Connectez un serveur MCP distant par URL et choisissez ce que l'Agent Runner peut faire avec chacun de ses outils.

Si un service que vous utilisez a un serveur MCP, vous pouvez donner ses outils à l’Agent Runner. Collez l’URL du serveur. Runner trouve les outils du serveur. Vous choisissez ensuite ce que l’Agent peut faire avec chaque outil.

Utilisez cette option pour un service absent de Connectez vos outils, comme votre propre ERP, un système de gestion des stocks ou un outil géré par votre équipe.

Avant de commencer

Chemin d’entrée : Projet → Agent → Outils → Ajouter votre propre serveur MCP

Vous avez besoin :

du rôle de propriétaire de la boutique ou d’administrateur. Les autres membres ne peuvent pas ajouter, modifier ou retirer un serveur ;
de l’URL d’un serveur MCP distant, par exemple https://example.com/mcp ; et
de la clé API et du nom de son en-tête, si le serveur demande une clé.

Le serveur doit remplir ces conditions :

Il doit être sur l’internet public. Runner ne se connecte pas à localhost ni à une adresse de réseau privé.
Il doit utiliser le transport HTTP de MCP (Streamable HTTP). Runner n’exécute pas pour vous un serveur local en ligne de commande (stdio).
Il doit fonctionner sans connexion ou avec une clé API dans un en-tête de requête. OAuth n’est pas encore disponible.

Une boutique peut avoir jusqu’à 10 serveurs MCP. Runner conserve jusqu’à 100 outils par serveur.

Important : Runner ne peut pas vérifier ce qu’un serveur personnalisé fait de vos données. Ajoutez uniquement des serveurs que vous gérez ou connaissez bien.

Ajouter un serveur

Ouvrez votre projet et sélectionnez Agent → Outils.
Sur la ligne Ajouter votre propre serveur MCP, sélectionnez Ajouter un serveur.
Saisissez l’URL du serveur. Ou collez la configuration JSON de la documentation du serveur dans Coller la configuration JSON. Runner remplit l’URL et l’en-tête de la clé à partir de la configuration.
Facultatif : saisissez un Nom. Si vous le laissez vide, Runner utilise le nom du serveur. Runner affiche ce nom dans le chat quand il utilise un outil.
Sous Comment Runner se connecte, sélectionnez Sans connexion ou Clé API. Pour Clé API, saisissez le Nom de l’en-tête et la Clé, par exemple Authorization et Bearer sk-…. Runner enregistre la clé chiffrée. Personne, pas même vous, ne peut la relire.
Quels agents peuvent l’utiliser affiche Tous les agents. Vous pourrez le modifier par agent plus tard.
Sélectionnez J’ai confiance en ce serveur.
Sélectionnez Se connecter et trouver les outils. Runner se connecte au serveur et liste ses outils.
Choisissez une règle pour chaque outil. Sélectionnez ensuite Ajouter suivi du nom du serveur.

Une fois le serveur ajouté, il apparaît sous Connectés avec l’étiquette MCP personnalisé.

Choisir ce que chaque outil peut faire

Chaque outil reçoit l’une de trois règles :

Autoriser : l’Agent utilise l’outil sans vous demander.
Demander d’abord : l’Agent vous montre l’appel dans le chat. L’outil ne s’exécute qu’après votre approbation.
Désactivé : l’Agent ne peut pas utiliser l’outil.

Runner devine une règle de départ à partir du nom de chaque outil, et regroupe les outils selon cette règle :

Groupe	Règle de départ	Noms d’outils que Runner place ici
Lit des données	Autoriser	Les noms qui commencent par un mot de lecture, comme `list`, `get` ou `search`. Aussi tout nom que Runner ne reconnaît pas.
Modifie des données	Demander d’abord	Les noms qui contiennent `send`, `reply`, `remove`, `publish`, `pay`, `charge`, `refund` ou `price`.
Supprime des données	Désactivé	Les noms qui contiennent `delete` ou `trash`.

Vérifiez la règle de chaque outil avant d’ajouter le serveur. Runner lit seulement le nom de l’outil, pas ce que fait l’outil. Un outil comme update_inventory ou create_customer démarre en Autoriser dans Lit des données, donc l’Agent pourrait modifier des données sans vous demander. Passez ces outils en Demander d’abord ou Désactivé.

Vous pouvez modifier la règle de n’importe quel outil avant d’ajouter le serveur. Plus tard, modifiez-la sous Ce que tout agent peut faire sur la page du serveur. Un outil que le serveur ajoute plus tard démarre en Demander d’abord, ou en Désactivé si son nom contient delete ou trash.

Les règles s’appliquent à toutes les conversations de ce projet. Runner les vérifie à chaque appel d’outil.

Gérer un serveur

Ouvrez le serveur depuis Connectés dans Agent → Outils. Sa page contient ces contrôles :

Contrôle ou information	Ce qu’il fait
URL du serveur et bouton de copie	Sous Connexion. Copier l’URL du serveur copie l’URL.
État	Indique quand le serveur a répondu pour la dernière fois, ou Pas encore vérifié.
Connexion	Indique Sans connexion ou les quatre derniers caractères de la clé. Ajouter une clé ou Remplacer modifie la clé.
Tester la connexion ou Actualiser les outils	Se reconnecte au serveur et récupère sa liste d’outils actuelle. Les nouveaux outils démarrent en Demander d’abord, ou en Désactivé pour les outils de suppression.
Retirer le serveur	Retire le serveur. Les agents perdent ses outils et ses règles d’outils sont supprimées. Vous pourrez l’ajouter de nouveau plus tard.

En cas de problème

Message	Que faire
Saisissez l’URL complète du serveur, par exemple https://example.com/mcp.	Saisissez l’URL complète, chemin compris.
Runner ne peut joindre que des serveurs publics. Cette URL pointe vers un réseau privé.	Utilisez une URL accessible depuis internet.
Cette URL a répondu, mais pas comme un serveur MCP. Vérifiez le chemin.	Cherchez le chemin MCP dans la documentation du serveur. Il se termine souvent par `/mcp`.
Runner ne peut pas joindre ce serveur. Vérifiez l’URL et qu’il est en ligne.	Vérifiez que le serveur fonctionne et que l’URL est correcte.
Le serveur a refusé la clé. Vérifiez le nom de l’en-tête et la clé.	Vérifiez les deux valeurs. Certains serveurs demandent `Bearer` avant la clé.
Le serveur a répondu mais n’a aucun outil.	Le serveur n’a aucun outil pour cette clé. Vérifiez les paramètres du serveur.
Cette boutique a déjà le nombre maximal de serveurs MCP. Retirez-en un d’abord.	Retirez un serveur que vous n’utilisez pas.

Sous Connectés, un serveur qui ne fonctionne plus affiche Injoignable ou Clé refusée. Sélectionnez Corriger pour ouvrir le serveur, puis remplacez la clé ou vérifiez le serveur.