MCP connecté mais inutilisable ? Diagnostique chaque étape dans Mono
Repère les problèmes de transport, d’autorisation, de découverte, de modèle ou d’appel d’outil dans Mono, puis vérifie une opération sans effet de bord.
Un serveur MCP enregistré ne veut pas dire que l’outil fonctionne. L’adresse peut être bonne alors que la connexion au compte n’est pas terminée. La connexion peut réussir alors que les outils du serveur ne se chargent pas. Et un outil peut se charger mais recevoir quand même une requête incorrecte. Trouve la première étape qui échoue avant de changer le moindre réglage.
Ce guide porte sur le dépannage dans Mono by Reunified, qui n’est pas encore disponible (rejoins la liste d’attente). Pour une première connexion, utilise le guide de configuration MCP. Ici, l’objectif est de transformer un vague « ça ne marche pas » en une observation claire que tu peux reproduire, sans répéter par erreur une écriture.
1. Note le symptôme et suspends les tentatives incertaines
Note le nom du serveur, le transport, l’appareil, la version de l’app, ce que tu essayais de faire et l’erreur exacte, sans les secrets. Indique si la même configuration marchait avant et ce qui a changé depuis. « La liste des outils est vide après la connexion » est plus utile que « MCP est cassé ».
Si la dernière requête pouvait créer, envoyer ou modifier quelque chose, vérifie la destination avant de réessayer. Une réponse perdue ne veut pas dire que l’action n’a pas eu lieu. Pour tester, passe à une petite requête en lecture seule, comme lister un élément d’un projet de test que tu peux vérifier.
Garde en privé une copie des derniers réglages qui fonctionnaient. Ne colle pas de jetons, de codes d’autorisation ni de résultats d’outils privés dans une demande d’aide publique.
2. Vérifie le transport avant le compte
Une connexion HTTP dans Mono a besoin de l’adresse d’un serveur MCP, pas d’une page d’accueil ordinaire ni de l’adresse de l’API d’un modèle. Compare l’URL complète, chemin compris, avec la documentation actuelle de l’éditeur du serveur. Une page qui s’ouvre dans ton navigateur montre seulement que cette page est accessible, pas que MCP y fonctionne.
Avec Entrée/sortie standard (stdio), vérifie la commande et les arguments sur l’appareil qui doit les lancer. Te reconnecter ne réparera pas une commande absente ni un appareil incapable de l’exécuter. Téléphones et ordinateurs sont différents : ne t’attends pas à ce qu’une commande de bureau tourne sur un téléphone.
Une adresse avec localhost désigne l’appareil qui envoie la requête. Teste depuis l’appareil réel, par une voie prise en charge et connectée. N’affaiblis pas les contrôles d’accès d’un serveur qui fonctionne juste pour faire passer un test.
3. Distingue réglages enregistrés et autorisation terminée
Vérifie la méthode d’authentification choisie. Un Jeton Bearer demande le bon jeton du service dans son champ. OAuth demande le bon compte, les exigences du serveur et un retour complet vers Mono ; fermer le navigateur trop tôt n’est pas une connexion réussie.
Mono peut enregistrer un serveur avant la fin de la connexion : un serveur enregistré ne prouve donc pas que la connexion a marché. Même après une connexion réussie, le chargement des outils du serveur peut échouer pendant un moment. Ni une entrée enregistrée ni un message « Connecté à » ne prouvent qu’un outil précis est prêt.
Si tu changes l’URL ou le transport du serveur, Mono le traite comme une nouvelle connexion, et tu devras peut-être te reconnecter. Corrige une vraie erreur d’adresse, mais ne change pas sans cesse une URL qui fonctionne en guise de remise à zéro. Suis les réglages de client et de redirection documentés par l’éditeur au lieu de deviner des valeurs.
4. Vérifie les capacités et le modèle choisi
L’architecture MCP distingue outils, ressources et prompts. Un serveur peut n’en proposer qu’une partie : un serveur qui ne propose que des ressources ne donnera à l’assistant aucun outil à appeler.
Pour une compétence MCP installée, ouvre sa section Configuration pour voir les outils trouvés par Mono. Si elle est vide, vérifie la connexion et si le serveur liste ses outils ; ne suppose pas que toutes les actions du service sont disponibles. Enregistrer un serveur n’est pas un bilan de santé complet.
Vérifie aussi le modèle utilisé dans la conversation. Tous les modèles ne savent pas appeler des outils, y compris certains que tu connectes toi-même. Un modèle qui répond très bien en texte peut quand même être la raison pour laquelle un outil connecté n’est jamais utilisé. Le guide des endpoints personnalisés l’explique.
5. Teste une opération connue
Utilise une requête sans risque et compare le résultat avec le service d’origine :
Lis le titre de l’élément de démonstration existant que je désigne.
Ne crée, ne modifie, n’envoie et ne supprime rien.
Si l’accès échoue, signale l’échec au lieu de deviner le titre.| Ce que tu vois | Piste suivante |
|---|---|
| Impossible de joindre l’adresse | Adresse, transport, réseau de l’appareil et disponibilité du serveur |
| La connexion ne se termine pas | Compte, méthode d’authentification et exigences OAuth de l’éditeur |
| Aucun outil n’apparaît | Ce que propose le serveur, chargement de ses outils et prise en charge des outils par le modèle |
| Un outil échoue | Données requises, permissions du service et erreur retournée |
| Lecture réussie, écriture bloquée | L’accès que tu voulais donner et le réglage d’autorisation de l’outil ; n’ouvre pas tout |
L’erreur propre à un outil n’est pas la même chose qu’un résultat vide mais réussi. Garde ensemble le statut renvoyé et le texte utile, sans les secrets.
6. Vérifie la correction et garde une trace
Change une seule chose à la fois, refais le même test en lecture seule et note le résultat. Si tu as besoin plus tard d’une écriture, vérifie sa cible exacte et confirme le résultat dans le service avant un nouvel essai.
Garde une courte note de l’étape qui échoue, des versions, du changement effectué et du dernier test réussi. Supprimer une connexion dans Mono et révoquer l’accès chez le fournisseur sont deux étapes séparées. Pour les décisions d’autorisation pendant l’usage, lis le guide des permissions ; approuver encore et encore ne répare pas une connexion.
