--- lastModified: 2026-11-13 title: Ajouter votre propre serveur MCP description: Connectez un serveur MCP distant par URL et choisissez ce que l'Agent Runner peut faire avec chacun de ses outils. seo: description: "Connectez votre propre serveur MCP distant à Runner par URL, avec ou sans clé API, et réglez chaque outil sur Autoriser, Demander d'abord ou Désactivé avant que l'Agent puisse l'utiliser." --- 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 1. Ouvrez votre projet et sélectionnez **Agent → Outils**. 2. Sur la ligne **Ajouter votre propre serveur MCP**, sélectionnez **Ajouter un serveur**. 3. 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. 4. 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. 5. 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. 6. **Quels agents peuvent l’utiliser** affiche **Tous les agents**. Vous pourrez le modifier par agent plus tard. 7. Sélectionnez **J'ai confiance en ce serveur**. 8. Sélectionnez **Se connecter et trouver les outils**. Runner se connecte au serveur et liste ses outils. 9. 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. ## Guides connexes - [Connecter et contrôler les Apps Agent](./agent-apps) - [Aperçu des applications et intégrations](../apps-and-integrations) - [Dépanner une connexion d'application](./troubleshooting)