L'inspecteur de serveur MCP

Mis à jour le 30 juillet 2026

Votre serveur MCP a des outils — encore faut-il prouver qu’ils fonctionnent. Quand vous construisez des serveurs MCP, vous avez besoin d’un moyen de tester vos fonctionnalités sans connecter une application complète : si le premier test passe par le chatbot entier, chaque bug devient une enquête à trois suspects — serveur, client ou conversation. Le SDK Python MCP règle le problème avec un inspecteur intégré, accessible depuis le navigateur, qui teste le serveur seul.

Démarrer l’inspecteur

mcp dev mcp_server.py

Cela démarre un serveur de développement et vous fournit une URL locale — affichée dans le terminal — à ouvrir dans votre navigateur. Détail conceptuel qui a son importance : l’inspecteur est lui-même un client MCP générique. Il parle à votre serveur avec les mêmes requêtes standardisées que n’importe quelle application — ce qu’il affiche est exactement ce que tout client verra, votre futur client Python compris.

Tester vos outils

Une fois connecté (bouton « Connect » sur la gauche) :

Naviguez vers la section Tools
Cliquez sur List Tools pour voir tous les outils disponibles
Sélectionnez un outil pour ouvrir son interface de test
Remplissez les paramètres requis
Cliquez sur Run Tool pour exécuter et voir les résultats

Deux vérifications méritent une attention particulière au passage. À l’étape 2, relisez les descriptions affichées avec l’œil de Claude : elles sont générées depuis vos Field et docstrings, et c’est tout ce que le modèle saura de vos outils — floues ici, floues partout. Et à l’étape 4, testez aussi les entrées invalides : un doc_id inexistant doit produire un message d’erreur exploitable, car c’est ce message que Claude recevra et devra interpréter pour se corriger.

Flux de développement recommandé

Modifier le code du serveur MCP
         ↓
Tester les outils individuellement via l'inspecteur
         ↓
Vérifier les résultats
         ↓
Déboguer les problèmes en isolation

Cette boucle courte est aux serveurs MCP ce que Postman est aux API REST : un banc d’essai qui isole le composant testé. Le mot important du diagramme est « en isolation » : un problème détecté ici est circonscrit au serveur par construction — ni le client, ni Claude ne sont encore dans l’équation. L’inspecteur élimine le besoin de brancher votre serveur à Claude ou à une autre application juste pour tester des fonctionnalités de base — et chaque bug attrapé maintenant est un bug que vous ne chercherez pas plus tard au milieu d’une conversation complète, où les suspects seraient trois fois plus nombreux.

Le rituel à adopter pour la suite du projet : chaque nouvel outil, chaque ressource, chaque prompt ajouté au serveur passe d’abord par l’inspecteur. Les leçons suivantes suivront ce rythme.

Points clés à retenir

mcp dev mcp_server.py : serveur de développement + inspecteur navigateur, sans client ni Claude
L’inspecteur est un client MCP générique — ce qu’il voit, tout client le verra
Relisez les descriptions générées avec l’œil de Claude : elles sont son seul mode d’emploi
Testez les entrées invalides : les messages d’erreur sont destinés au modèle, pas qu’au développeur
Boucle modifier → tester → vérifier → déboguer en isolation, à chaque ajout au serveur