L'inspecteur de serveur

Vous venez d’écrire deux outils, et la question qui vient immédiatement est de savoir s’ils fonctionnent. Assembler toute une application cliente pour le vérifier serait absurde à ce stade : vous passeriez une heure à brancher Claude, la CLI et le client MCP simplement pour découvrir qu’un identifiant de document est mal orthographié dans votre dictionnaire. Le SDK MCP Python résout ce problème en fournissant un inspecteur basé sur le navigateur, qui vous permet de déboguer et de tester votre serveur en temps réel, sans écrire la moindre ligne de code de test.

Démarrer l’inspecteur

Vérifiez d’abord que votre environnement Python est activé — c’est l’oubli le plus fréquent, et l’erreur qui en découle ne pointe pas vers la vraie cause. Lancez ensuite l’inspecteur en lui indiquant le fichier de votre serveur :

mcp dev mcp_server.py

La commande démarre un serveur de développement et affiche une URL locale, généralement de la forme http://127.0.0.1:6274. Ouvrez cette adresse dans votre navigateur : vous accédez à l’inspecteur MCP, qui va se comporter exactement comme le ferait une application cliente réelle, à ceci près que c’est vous qui décidez de chaque appel.

Se repérer dans l’interface

L’interface de l’inspecteur est en développement actif et peut évoluer d’une version à l’autre, mais son organisation reste cohérente. Un bouton Connect démarre votre serveur MCP et établit la session ; tant que vous ne l’avez pas cliqué, rien ne s’affichera. Une barre de navigation propose ensuite trois onglets, Resources, Tools et Prompts, qui correspondent aux trois primitives du protocole — vous n’en utiliserez qu’un aujourd’hui, les deux autres se rempliront dans les leçons suivantes. Enfin, un panneau permet de lister les outils et de les tester un par un.

Commencez donc par cliquer sur Connect pour initialiser votre serveur. Le statut de connexion passe alors de « Disconnected » à « Connected », signe que le processus serveur a démarré et que la poignée de main du protocole s’est bien déroulée.

Tester vos outils

Rendez-vous dans la section Tools et cliquez sur « List Tools » : l’inspecteur envoie la requête de découverte et affiche tous les outils que votre serveur expose. C’est déjà une première vérification utile, puisque vous voyez ici exactement ce que Claude verrait. Sélectionnez ensuite un outil, et le panneau de droite affiche ses détails ainsi que des champs de saisie correspondant à ses paramètres.

Pour tester l’outil de lecture de documents, la procédure tient en quatre gestes :

1. Sélectionnez l'outil read_doc_contents
2. Entrez un identifiant de document (ex: "deposition.md")
3. Cliquez sur "Run Tool"
4. Vérifiez les résultats pour le succès et la sortie attendue

L’inspecteur affiche à la fois le statut de succès et les données retournées, ce qui rend la vérification immédiate : soit vous lisez le contenu attendu, soit vous voyez tout de suite ce qui cloche.

Vérifier les enchaînements et les erreurs

Un outil pris isolément ne dit pas tout : ce qui compte souvent, c’est l’effet d’un appel sur le suivant. Vous pouvez donc exécuter plusieurs outils en séquence pour valider un workflow complet. Appelez par exemple edit_document pour modifier un document, puis enchaînez immédiatement avec read_doc_contents sur le même identifiant afin de confirmer que le remplacement a bien été appliqué. L’inspecteur maintient l’état de votre serveur entre les appels, donc les modifications persistent d’une exécution à l’autre et vous observez le comportement réel de votre serveur MCP, pas une simulation.

Pensez également à tester les cas d’erreur, que l’on néglige presque toujours. Entrez un doc_id inexistant et vérifiez que votre serveur retourne bien une erreur explicite plutôt qu’une réponse vide. Ce détail a des conséquences directes en production : un bon serveur MCP signale ses erreurs de manière claire, car c’est ce message que Claude recevra et interprétera pour décider de la suite — redemander l’information, proposer une correction, ou signaler le problème à l’utilisateur.

Une boucle de retour très courte

L’inspecteur MCP finit par devenir une pièce centrale de votre processus de développement. Plutôt que d’écrire des scripts de test séparés ou de connecter des applications complètes, vous itérez rapidement sur vos implémentations d’outils, vous éprouvez les cas limites et les conditions d’erreur, vous vérifiez les interactions entre outils ainsi que la gestion d’état, et vous déboguez les problèmes au moment même où ils se produisent. Cette boucle de rétroaction immédiate rend le développement de serveurs MCP nettement plus efficace, et surtout elle déplace la détection des défauts très tôt dans le cycle, là où ils coûtent le moins cher à corriger.

Gardez l’inspecteur ouvert dans un onglet pour la suite du cours : vous y reviendrez à chaque nouvelle primitive ajoutée au serveur.