Tool overview
Qu'est-ce que Validateur Serveur MCP ?
Validateur Serveur MCP est un outil qui vous aide à valider les configurations JSON mcpServers.
Pourquoi utiliser Validateur Serveur MCP ?
Il améliore la lisibilité et accélère votre flux lorsque vous devez valider les configurations JSON mcpServers, sans envoi de données vers un serveur.
Fonctionnalités clés
Confidentialité côté client, résultats instantanés et copie en un clic pour validateur Serveur MCP. Valider les configurations JSON mcpServers
Mode d'emploi
Suivez ces étapes pour obtenir des résultats précis avec l'outil ci-dessus.
- Collez votre JSON Cursor ou Claude Desktop contenant un objet racine "mcpServers".
- Examinez le rapport : erreurs (bloquantes) et avertissements (non bloquants) avec chemins JSON pointer.
- Corrigez le transport : stdio nécessite command (+ args) ; distant nécessite une url http/https valide.
- Assurez-vous que env ne contient que des chaînes et que args est un tableau de chaînes.
- Supprimez les entrées duales command+url et les clés inconnues signalées en avertissement si possible.
- Revalidez jusqu’à ok = true — les avertissements seuls ne font pas échouer, mais traitez-les comme dette.
- Collez le JSON corrigé dans le fichier client et rechargez les serveurs MCP.
- Copiez le rapport dans une PR ou une checklist CI ; gardez les secrets en placeholders.
Validateur MCP — guide complet et cas d’usage
Guide autoritatif : erreurs vs avertissements, stdio vs HTTP, cas Cursor et Claude Desktop, règles env string, correctifs et hygiène des secrets.
Guide MCP Validator — commencez ici
Ce guide explique comment valider localement une configuration JSON mcpServers. Collez du contenu sans secrets et corrigez les problèmes avant Cursor ou Claude Desktop.
Ce que fait MCP Validator
MCP Validator analyse dans le navigateur les entrées mcpServers, leurs transports et leurs types JSON afin de détecter les configurations que les clients ne peuvent pas démarrer.
Rapport local avec chemins JSON et problèmes exploitables
- Rapport local avec chemins JSON et problèmes exploitables
- Rapport local avec chemins JSON et problèmes exploitables: mcpServers, command, args, url, env
- Rapport local avec chemins JSON et problèmes exploitables: stdio, http, https
- Rapport local avec chemins JSON et problèmes exploitables: JSON, ok
Utilisez-le avant de coller ou partager une configuration MCP
- Utilisez-le avant de coller ou partager une configuration MCP
- Utilisez-le avant de coller ou partager une configuration MCP: Cursor mcp.json
- Utilisez-le avant de coller ou partager une configuration MCP: Claude Desktop
- Utilisez-le avant de coller ou partager une configuration MCP: CI / PR
Préférez un outil associé pour créer des schémas ou prompts
- Préférez un outil associé pour créer des schémas ou prompts
- Préférez un outil associé pour créer des schémas ou prompts: AI Agent Builder
- Préférez un outil associé pour créer des schémas ou prompts: JSON Schema
Erreurs et avertissements — ce qui bloque le collage
Erreur : la configuration bloque la validation
Guide de sévérité
| Guide de sévérité | Effet sur ok | Causes typiques |
|---|---|---|
| Erreur : la configuration bloque la validation | Effet sur ok: ok = false | Causes typiques |
| Avertissement : vérifiez ce détail avant la production | Effet sur ok: ok | Causes typiques |
Avertissement : vérifiez ce détail avant la production
Pas à pas : coller, analyser, corriger, recoller
Comment cet outil aide
- Collez le JSON contenant mcpServers.
- Corrigez d’abord les erreurs.
- Vérifiez command, args, url et env.
- Choisissez un seul transport par serveur.
- Utilisez http:// ou https:// pour les serveurs distants.
- Convertissez les valeurs env en chaînes.
- Validez à nouveau jusqu’à ce que ok soit true.
- Collez le JSON corrigé dans le client.
Cas d’usage : corriger Cursor mcp.json avant rechargement
Erreur : la configuration bloque la validation Cursor mcp.json.
Comment cet outil aide
- Collez le JSON contenant mcpServers.
- Corrigez d’abord les erreurs.
- Vérifiez command, args, url et env.
- Choisissez un seul transport par serveur.
Résultat : une configuration MCP claire, validée et prête à l’emploi.
Cas d’usage : URL MCP distante de Claude Desktop
Erreur : la configuration bloque la validation Claude Desktop.
Comment cet outil aide
- Collez le JSON contenant mcpServers.
- Corrigez d’abord les erreurs.
- Vérifiez command, args, url et env.
- Choisissez un seul transport par serveur.
Résultat : une configuration MCP claire, validée et prête à l’emploi.
Cas d’usage : analyser les modèles MCP en revue de PR
Erreur : la configuration bloque la validation CI / PR.
Comment cet outil aide
- Collez le JSON contenant mcpServers.
- Corrigez d’abord les erreurs.
- Vérifiez command, args, url et env.
- Choisissez un seul transport par serveur.
Résultat : une configuration MCP claire, validée et prête à l’emploi.
Cas d’usage : hygiène des secrets pendant le débogage
Erreur : la configuration bloque la validation env.
Comment cet outil aide
- Collez le JSON contenant mcpServers.
- Corrigez d’abord les erreurs.
- Vérifiez command, args, url et env.
- Choisissez un seul transport par serveur.
Résultat : une configuration MCP claire, validée et prête à l’emploi.
Règles de transport stdio ou HTTP/HTTPS
Formes de transport
Formes de transport
| Formes de transport | Champs requis | Notes |
|---|---|---|
| stdio | command; args | Notes |
| HTTP / HTTPS | url (http:// or https://) | Notes |
Notes: env, headers, disabled.
Les valeurs env doivent être des chaînes
env: Champs requis
- env: Champs requis
- Champs requis
- JSON
- mcpServers
Correctif : command ou url manquant
Erreur : la configuration bloque la validation: command or url.
Pourquoi cela arrive
Pourquoi cela arrive
Diagnostic
Diagnostic
Correctifs
- Collez le JSON contenant mcpServers.
- Corrigez d’abord les erreurs.
- Vérifiez command, args, url et env.
Correctif : valeurs env non textuelles
Erreur : la configuration bloque la validation: env.
Pourquoi cela arrive
Pourquoi cela arrive
Diagnostic
Diagnostic
Correctifs
- Collez le JSON contenant mcpServers.
- Corrigez d’abord les erreurs.
- Vérifiez command, args, url et env.
Avertissement : vérifiez ce détail avant la production
Correctif : mauvaise enveloppe racine
Erreur : la configuration bloque la validation: mcpServers.
Pourquoi cela arrive
Pourquoi cela arrive
Diagnostic
Diagnostic
Correctifs
- Collez le JSON contenant mcpServers.
- Corrigez d’abord les erreurs.
- Vérifiez command, args, url et env.
Bonnes pratiques de validation MCP
- Validez avant de coller dans Cursor ou Claude Desktop.
- Utilisez command ou url, jamais les deux.
- Gardez args comme tableau de chaînes.
- Gardez env sous forme de chaînes.
- Utilisez des espaces réservés pour les secrets.
- Employez des chemins absolus à privilège minimal.
- Revalidez après chaque modification.
- Traitez les avertissements avant la production.
Foire aux questions
Réponses aux problèmes courants et questions de confidentialité.
Outils associés
Découvrez d'autres utilitaires associés qui complètent cet outil.
Documentation officielle et références
Spécifications et documentation de plateforme pour cet utilitaire.