~/tools / MCP Config Checker
MCP Config Checker — Vérifiez un fichier de configuration MCP
Vérifiez un fichier de configuration de serveurs MCP (.mcp.json ou claude_desktop_config.json) : type manquant, mauvaise clé de premier niveau, noms réservés ou invalides, chemins relatifs, variables non définies et secrets écrits dans le fichier. Rien ne quitte votre navigateur.
Règles vérifiées au regard de la documentation le 2026-10-23.
Documentation : Claude Code / Model Context Protocol / VS Code
Non vérifié : l'existence d'une commande, l'installation d'un paquet, la réponse d'un serveur distant et les paramètres que d'autres applications interprètent différemment.
Tout s'exécute dans votre navigateur. La configuration n'est pas envoyée.
Les serveurs MCP se configurent dans un fichier JSON, et une petite erreur peut suffire pour qu'un serveur n'apparaisse tout simplement pas, sans message. Une entrée de serveur avec une url mais sans type est ignorée, un fichier qui utilise la clé servers de VS Code n'est lu ni par Claude Code ni par Claude Desktop, et une variable d'environnement non définie est transmise telle quelle, en texte brut. Cet outil lit la configuration que vous collez et indique ce que la documentation dit ne pas fonctionner, ce qui mérite d'être vérifié et ce qui n'est qu'une remarque. Il avertit aussi lorsqu'un jeton semble écrit directement dans le fichier, où il peut finir dans le gestionnaire de versions. Les règles proviennent de la documentation de Claude Code, du Model Context Protocol et de VS Code, vérifiée à la date indiquée sous l'outil.
Cas d'usage
- Comprendre pourquoi un serveur MCP n'apparaît pas après avoir modifié .mcp.json ou claude_desktop_config.json
- Contrôler une configuration copiée depuis un README avant de l'ajouter à un projet partagé
- Repérer les jetons et les mots de passe écrits dans un fichier de configuration avant de le valider dans le dépôt
Utilisation
- Collez le contenu de votre fichier de configuration MCP, ou chargez l'exemple.
- Lisez les serveurs trouvés et le type de chacun, puis la liste des constats. À corriger signifie que la documentation indique que l'entrée ne fonctionnera pas, À vérifier que cela mérite un coup d'œil, et Info que c'est donné à titre d'information.
- Modifiez le fichier, collez-le à nouveau, puis redémarrez l'application qui le lit.
FAQ
Quels fichiers et quelles applications sont couverts ?
Le format mcpServers utilisé par le fichier de projet .mcp.json dans Claude Code et par claude_desktop_config.json dans Claude Desktop. D'autres applications peuvent lire des champs différents ou une autre clé de premier niveau ; consultez leur propre documentation. VS Code, par exemple, utilise une clé de premier niveau nommée servers.
Mon entrée a une url mais pas de type. Pourquoi est-ce un problème ?
Claude Code lit une entrée sans type comme un serveur stdio ; une entrée qui a une url mais pas de type est donc une erreur de configuration et le serveur est ignoré. Ajoutez un type http, sse ou ws.
Que se passe-t-il avec une variable comme ${API_KEY} qui n'est pas définie ?
Claude Code développe ${VAR} et ${VAR:-default} dans command, args, env, url et headers. Si une variable n'est pas définie et n'a pas de valeur par défaut, la configuration se charge quand même, Claude Code affiche un avertissement et utilise le texte ${VAR} tel quel. Ajoutez une valeur par défaut avec ${VAR:-default} lorsque c'est sans risque.
Pourquoi signale-t-il un jeton dans le fichier ?
Un jeton écrit directement dans un fichier de configuration peut être divulgué lorsque le fichier est validé dans le dépôt ou envoyé à quelqu'un. La vérification est une heuristique fondée sur des formats de jetons connus et sur des noms tels que api-key, token et password ; elle peut donc passer à côté d'un secret ou signaler une valeur anodine. Utiliser ${VAR} garde la valeur hors du fichier.
Démarre-t-il le serveur ou teste-t-il la connexion ?
Non. Il lit uniquement le texte. Il ne peut pas savoir si une commande existe, si un paquet peut être installé ou si un serveur distant est joignable ; testez donc le serveur dans l'application une fois le fichier validé.
Ma configuration est-elle envoyée à un serveur ?
Non. La vérification s'exécute dans votre navigateur.