Collez votre configuration et voyez ce que Claude Code en fera réellement. La plupart des configurations MCP cassées sont du JSON valide : c'est exactement pour cela que rien ne vous signale qu'elles sont fausses.
Réussir la configuration est la moitié ennuyeuse. MCP Showcase prend le même serveur et en fait un playground en direct que vos clients peuvent essayer, avec une documentation pour chaque outil.
Rien n'est envoyé. La vérification s'exécute entièrement dans votre navigateur.
Clé racine, clé d'endpoint, type de transport et les champs spécifiques que Claude Code traite autrement que tous les autres.
Chaque problème indique ce que Claude Code attend à la place : une modification que vous pouvez faire, plutôt qu'un symptôme à rechercher.
Presque toutes les configurations MCP cassées sont du JSON valide. Les clients ignorent les clés qu'ils ne reconnaissent pas : un fichier avec la mauvaise clé racine ou le mauvais champ d'endpoint s'analyse proprement, Claude Code démarre normalement, et aucun serveur n'apparaît. Il n'y a aucune erreur à rechercher. C'est ce silence qui fait durer ces erreurs si longtemps.
mcpServers.
Tout le reste est analysé puis ignoré.url.
Claude Code a trois portées de configuration : local (vous seul, ce projet seulement), project (versionnée dans .mcp.json et partagée avec tout le dépôt) et user (vous, partout). La même structure de fichier signifie donc que la même configuration se comporte différemment selon l'endroit où vous la placez, et un serveur ajouté en portée project est partagé avec votre équipe, identifiants compris, si vous ne faites pas attention à sa méthode d'authentification.
La vérification s'exécute entièrement dans votre navigateur et ne fait aucune requête réseau. C'est délibéré et non accessoire : les configurations MCP contiennent couramment des jetons d'API, et « collez votre configuration sur ce site » est une demande qu'il est raisonnable de refuser. Vous pouvez le confirmer dans l'onglet réseau de votre navigateur.
Alors le problème est sorti du fichier. Un client qui affiche le serveur mais aucun outil se connecte et échoue au handshake ou au transport ; il ne lit pas mal votre configuration. Le MCP Inspector montre sur quel transport le serveur répond et le journal brut des requêtes, et le MCP Server Tester réduit la même chose à une liste réussite/échec.
Une configuration qui fonctionne est le minimum. Ce qu'elle ne fait pas, c'est aider quiconque à comprendre à quoi sert votre serveur vraiment — et si vous publiez un serveur MCP, c'est cela qui décide si quelqu'un le configure. MCP Showcase transforme le même endpoint en playground en direct avec une documentation par outil, pour que l'évaluer prenne un clic plutôt qu'un fichier de configuration et un redémarrage.