Collez votre configuration et voyez ce que VS 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 VS Code traite autrement que tous les autres.
Chaque problème indique ce que VS 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, VS 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.
servers.
Tout le reste est analysé puis ignoré.url.
C'est le piège dans lequel presque tout le monde tombe : VS Code utilise "servers", alors que Claude, Cursor et Windsurf utilisent tous "mcpServers". Une configuration copiée depuis l'un d'eux est du JSON valide et ne fait strictement rien. VS Code prend aussi en charge un tableau "inputs" pour qu'un jeton soit demandé et stocké dans le trousseau du système plutôt que versionné dans le dépôt.
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.