Tester une connexion MCP
Section en cours de refonte
Les pages Intégrations seront retravaillées après la release v0.1.0 : parcours UX revus, captures d'écran ajoutées, contenu enrichi. Le contenu actuel reste correct sur la mécanique, mais peut diverger de l'UI finale.
Pour les operators qui veulent vérifier qu'un serveur MCP déjà connecté répond correctement et expose bien les outils attendus.
Prérequis
- Un serveur MCP déjà connecté (via le wizard, voyez la page Connecter un serveur MCP).
- L'outil métier distant est joignable (compte actif, token non expiré).
Étapes
Dans la sidebar, cliquez sur Connexions.
Sélectionnez le segment Mes connexions actives. Vous voyez la liste de toutes vos connexions MCP installées avec leur statut actuel.
[SCREENSHOT: page Connexions, segment Mes connexions actives, liste de cartes MCP avec voyant de statut à gauche]Cliquez sur la carte du MCP à tester. Le panneau de détail s'ouvre à droite.
Cliquez sur le bouton Tester la connexion en haut du panneau. Un spinner Test en cours… apparaît.
[SCREENSHOT: panneau de détail MCP, bouton "Tester la connexion" surligné, zone de résultat en dessous]Attendez le résultat (entre 1 et 5 secondes en général).
Si le test réussit, un voyant vert s'affiche avec la latence mesurée et la liste des outils exposés par le serveur.
Si le test échoue, un voyant rouge s'affiche avec un message d'erreur traduit selon la nature du problème :
- Authentification refusée — vérifiez votre clé API. → token invalide ou expiré (HTTP 401).
- Accès interdit — votre clé n'a pas les droits requis. → permissions insuffisantes (HTTP 403).
- Service introuvable — vérifiez l'URL ou le nom du serveur. → mauvaise URL ou serveur absent (HTTP 404).
- Erreur réseau — le service n'a pas répondu à temps. → timeout ou connexion impossible.
- Commande introuvable — le paquet n'est probablement pas installé. → transport stdio, binaire absent.
- La connexion a échoué. Vérifiez vos identifiants et réessayez. → erreur générique.
Un lien Voir le détail technique permet d'afficher le message brut du backend pour les utilisateurs avancés.
[SCREENSHOT: panneau résultat, voyant rouge avec message traduit, lien "Voir le détail technique" et bouton "Modifier l'authentification"]Vérifiez que les outils attendus apparaissent bien dans la liste. Si certains manquent, le serveur distant a peut-être désactivé des fonctionnalités côté compte.
Pour tester un outil concret, ouvrez un chat avec un agent autorisé à utiliser ce MCP et demandez en langage naturel une action simple (par exemple : Liste mes 3 dernières pages Notion).
Observez la réponse : si l'outil est appelé et renvoie un résultat cohérent, l'intégration est pleinement fonctionnelle.
Vérification
Le voyant est vert, la latence est inférieure à 1 seconde, tous les outils attendus sont listés, et un agent réussit à appeler l'un d'eux depuis un chat.
Si ça ne marche pas
- Voyant rouge — Authentification refusée : régénérez le token dans l'outil métier, puis cliquez sur Modifier l'authentification pour mettre à jour vos identifiants.
- Voyant rouge — Erreur réseau : vérifiez votre connexion internet et l'URL du transport (HTTP/SSE). Pour un transport stdio, vérifiez que la commande locale est encore installée.
- Test OK mais l'agent n'appelle pas l'outil : ouvrez la fiche de l'agent et vérifiez que ce MCP figure bien dans ses outils autorisés.
Référence technique : Briques-MCP