Tester votre serveur MCP avec MCP Inspector

Lorsque vous développez votre serveur MCP localement, plusieurs options s’offrent à vous pour le tester. Vous pourriez le connecter à un client d’IA standard, mais cela masque souvent les détails du protocole sous-jacent, ce qui complique le débogage de requêtes précises. Vous pourriez aussi utiliser des outils en ligne de commande comme curl, mais cette approche peut s’avérer fastidieuse, surtout lorsqu’il faut gérer des flux d’authentification complexes et rédiger à la main des charges utiles JSON. C’est là que MCP Inspector prend tout son sens. Cet outil graphique, conçu spécialement pour cet usage, offre le meilleur des deux mondes. Il vous propose une interface claire et interactive pour consulter les outils disponibles sur votre serveur, gère pour vous les mécanismes d’authentification complexes et vous permet d’exécuter directement des outils avec des entrées précises, sans avoir à formuler d’invites en langage naturel. Grâce à cette approche directe, il s’avère un atout inestimable pour déboguer et développer efficacement.

Lancer MCP Inspector

Assurez-vous d’abord que votre serveur MCP est en cours d’exécution dans un autre terminal. Ouvrez ensuite une nouvelle fenêtre de terminal et exécutez la commande suivante pour lancer MCP Inspector :

npx @modelcontextprotocol/inspector@latest

L’interface de MCP Inspector s’ouvrira alors dans votre navigateur par défaut.

Page de MCP Inspector après son lancement

Se connecter à votre serveur MCP

Une fois l’Inspector ouvert, vous devez le configurer pour qu’il se connecte à votre serveur MCP local.

Réglez le Transport Type sur Streamable HTTP.
Saisissez l’URL de votre serveur, généralement http://localhost:3001/mcp.

Pour que le MCP Inspector puisse se connecter à votre serveur MCP, vous pouvez utiliser l’enregistrement statique du client (recommandé) ou le Dynamic Client Registration (DCR). Choisissez la méthode qui vous convient ci-dessous et suivez les instructions.

Static Client Registration
Dynamic Client Registration

Create an Application to Represent Your MCP Client

Run this command to create the client:

auth0 api post clients --data '{
  "name": "MCP Inspector",
  "app_type": "regular_web",
  "is_first_party": false,
  "callbacks": ["http://localhost:6274/oauth/callback"],
  "grant_types": ["authorization_code"],
  "token_endpoint_auth_method": "client_secret_post",
  "oidc_conformant": true,
  "jwt_configuration": { "alg": "RS256" },
  "logo_uri": "https://avatars.githubusercontent.com/u/182288589"
}' | jq -r '"\nClient ID:     " + .client_id + "\nClient Secret: " +  .client_secret'

Save the Client ID and Client Secret from the command output.In the left navigation menu, click on Authentication and enter the Client ID and Client Secret you obtained when you registered your application.

Enable Dynamic Client Registration (DCR)

Set the tenant-level flag required for Dynamic Client Registration (DCR):

auth0 tenant-settings update set flags.enable_dynamic_client_registration

Enabling enable_dynamic_client_registration allows MCP tools to register themselves as applications automatically through Dynamic Client Registration (DCR).

Auth0 supports Open Dynamic Registration, which means that if you enable this feature, anyone will be able to create applications in your tenant without a token. Read Securing an Open DCR Endpoint to learn strategies to mitigate risks with Open DCR.

Your MCP server is now ready to use!

Cliquez sur Connect.

Vous serez redirigé vers un écran de connexion et de consentement. Connectez-vous avec un compte utilisateur disposant des autorisations nécessaires pour utiliser les outils. Lors de votre première connexion au serveur, vous serez guidé tout au long du processus d’authentification par la connexion universelle d’Auth0. L’écran de consentement s’affichera alors et vous permettra de vérifier les outils auxquels vous avez accès :

Fenêtre modale de consentement lors de l'authentification

Après avoir cliqué sur Accept pour accorder les autorisations demandées, vous serez redirigé vers MCP Inspector. L’interface indiquera alors que votre serveur est connecté et affichera la liste des outils à votre disposition :

Page de MCP Inspector après son exécution

Exécuter vos outils

Une fois authentifié, vous pouvez exécuter les outils que le serveur MCP met à la disposition de votre utilisateur. Ces outils peuvent varier d’un utilisateur à l’autre selon la configuration de votre serveur.

Liste des outils pour un utilisateur ayant le rôle Tool Administrator — Liste des outils disponibles dans le serveur MCP

Pour exécuter un outil, cliquez dessus dans la liste, puis cliquez sur Run Tool.

Réponse à l'appel de l'outil WhoAmI dans MCP Inspector

Résolution des problèmes courants

Si vous éprouvez des difficultés, voici quelques points à vérifier d’abord :

Échec de la connexion :

Assurez-vous que votre serveur MCP est en cours d’exécution dans un terminal distinct.
Vérifiez que l’URL (http://localhost:3001/mcp) indiquée dans l’Inspector correspond bien au port et au terminal configurés pour votre serveur.

Erreurs d’authentification :

Vérifiez que l’identifiant du client et le secret client saisis dans l’Inspector sont exacts et ne contiennent aucun espace superflu.
Assurez-vous de vous connecter avec un compte utilisateur existant chez votre fournisseur d’authentification (p. ex., Auth0).

Cela signifie généralement que l’utilisateur avec lequel vous vous êtes connecté ne possède pas les rôles ou les autorisations nécessaires.
Vérifiez dans votre fournisseur d’authentification que les bons rôles ont été attribués à l’utilisateur (p. ex., « Tool User » ou « Tool Administrator »).
Assurez-vous que les permissions définies dans la configuration OAuth de votre serveur correspondent aux autorisations requises par les outils.

Conclusion

Vous avez maintenant parcouru l’ensemble du processus, du lancement de MCP Inspector jusqu’à la connexion à un serveur sécurisé et à l’exécution de votre premier outil. En intégrant Inspector à votre flux de production de développement, vous disposez d’un moyen direct et efficace de tester votre implémentation, de vérifier les règles de sécurité et de déboguer la logique de vos outils, sans la lourdeur d’un client d’IA complet. Gardez cet utilitaire essentiel dans votre coffre à outils pour continuer à créer et à faire évoluer en toute confiance vos applications propulsées par MCP.

Premiers pas

Guides

Exemples d’applications

Tester votre serveur MCP avec MCP Inspector

Lancer MCP Inspector

Se connecter à votre serveur MCP

Create an Application to Represent Your MCP Client

Enable Dynamic Client Registration (DCR)

Exécuter vos outils

Résolution des problèmes courants

Échec de la connexion :

Erreurs d’authentification :

Conclusion

​Lancer MCP Inspector

​Se connecter à votre serveur MCP

​Create an Application to Represent Your MCP Client

​Enable Dynamic Client Registration (DCR)

​Exécuter vos outils

​Résolution des problèmes courants

​Échec de la connexion :

​Erreurs d’authentification :

​Aucun outil n’apparaît après la connexion :

​Conclusion

Lancer MCP Inspector

Se connecter à votre serveur MCP

Create an Application to Represent Your MCP Client

Enable Dynamic Client Registration (DCR)

Exécuter vos outils

Résolution des problèmes courants

Échec de la connexion :

Erreurs d’authentification :

Aucun outil n’apparaît après la connexion :

Conclusion