Outil gratuit

Validateur de configuration MCP

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. Choisissez votre client et découvrez ce qu'il fera réellement de votre fichier.

Ça marche enfin. Montrez maintenant à quelqu'un ce qu'il fait.

Réparer une 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.

Comment ça marche

link
Choisissez votre client

Les vérifications diffèrent selon le client, parce que ce qui compte comme faux diffère selon le client.

play_circle
Collez votre configuration

Analysée dans votre navigateur. Rien n'est envoyé, ce qui compte quand les configurations contiennent des jetons.

checklist
Corrigez ce qui est trouvé

Chaque problème indique ce que ce client attend à la place.

Chaque client, et là où ils divergent

MCP normalise le protocole, pas la configuration. Ces dix clients lisent des fichiers différents, dans trois formats différents, avec des noms de clés différents pour la même chose. Le tableau ci-dessous rassemble tout le problème — et explique pourquoi une configuration copiée d'un client vers un autre s'analyse généralement proprement et ne se connecte à rien.

ClientFormatClé racineEndpoint distant
Claude Desktop JSON mcpServers via un pont local
Claude Code JSON mcpServers url
Cursor JSON mcpServers url
VS Code JSON servers url
Windsurf JSON mcpServers serverUrl
Codex CLI TOML mcp_servers url
Gemini CLI JSON mcpServers httpUrl
Cline JSON mcpServers url
Zed JSON context_servers url
Continue YAML mcpServers url

Les trois erreurs qui causent le plus d'ennuis

  • La clé racine. La plupart des clients lisent mcpServers. VS Code lit servers, Zed lit context_servers, Codex CLI lit mcp_servers. Mauvaise clé, fichier valide, aucun serveur, aucune erreur.
  • Le champ d'endpoint. url chez la plupart, serverUrl pour Windsurf, httpUrl pour Gemini CLI quand le transport est Streamable HTTP.
  • Supposer qu'une URL hébergée fonctionne partout. Claude Desktop ne lance que des processus locaux ; un serveur distant doit passer par mcp-remote, ce qui est une forme de configuration complètement différente.

Outils liés

Rien de tout cela n'est visible pour vos clients

Tout ici sert des gens qui ont déjà décidé d'utiliser votre serveur. MCP Showcase s'adresse à ceux qui ne l'ont pas fait : pointez-le sur la même URL et il produit un playground en direct avec une documentation pour chaque outil, pour qu'évaluer votre serveur prenne un clic plutôt qu'un fichier de configuration et un redémarrage.

Questions fréquentes

Parce que les clients ignorent les clés qu'ils ne reconnaissent pas. Une configuration avec la mauvaise clé racine s'analyse parfaitement, le client démarre normalement, et aucun serveur n'apparaît. Le silence est le mode d'échec standard, et c'est ce qui rend ces erreurs si lentes à trouver.

La clé racine, le nom de champ utilisé pour un endpoint distant, si chaque entrée a une commande ou une URL, si quoi que ce soit est servi en HTTP non chiffré, et les particularités propres au client que vous avez choisi.

Non. Elle est analysée dans votre navigateur et ne quitte jamais votre machine. Aucune requête réseau n'est faite.

Cela dépend du client : mcpServers pour Claude, Cursor, Windsurf et Cline ; servers pour VS Code ; context_servers pour Zed ; mcp_servers pour Codex CLI. Choisissez votre client et le résultat nommera celle dont il a besoin.

Alors le problème vient du serveur et non du fichier. Passez l'endpoint dans le MCP Inspector pour confirmer qu'il termine un handshake et voir ce qu'il expose.

Autres outils MCP gratuits