Configuration MCP : comprendre la structure, la connexion et les permissions
Trois étapes facilitent le diagnostic d’une configuration MCP : examiner la structure, tester la connexion, puis évaluer le serveur et les permissions demandées. Le contrôle de structure couvre la première étape ; connexion et confiance demandent des vérifications distinctes.
Ce sont 3 questions distinctes
L’application peut-elle lire la configuration ? La connexion fonctionne-t-elle ? L’origine et les permissions conviennent-elles à vos données ? Répondre oui à la première ne répond pas aux autres.
MCP relie un client à un serveur offrant des capacités. Il peut s’agir d’un programme local via stdio ou d’un service via HTTP ; le transport change les points à examiner.
Références: Model Context Protocol — Clients, servers and transports
Vérifier le format accepté par votre client
ToolRoof contrôle un sous-ensemble JSON sous mcpServers : command avec args et env facultatifs, ou url avec headers facultatif. command et url dans la même entrée constituent une erreur ; les champs inconnus produisent des avertissements.
Ce n’est pas le format de toutes les applications MCP. Consultez la documentation du client avant de supprimer des options valides hors périmètre. L’outil n’exécute aucune commande, ne visite aucune adresse et ne teste pas l’authentification.
Un avertissement ne détecte pas tous les secrets
Arguments, variables d’environnement et en-têtes peuvent contenir des données sensibles. Signaler ces endroits ne prouve pas que chaque valeur est secrète, ni qu’un fichier sans avertissement ne contient aucun secret.
Ne publiez pas votre vraie configuration dans un ticket public. Utilisez un exemple expurgé et examinez origine et permissions avant connexion. HTTPS et JSON valide ne suffisent pas à établir la confiance.
Exemple : un résultat valide, mais limité
{"mcpServers":{"notes":{"url":"https://example.com/mcp","type":"http"}}} décrit un serveur dans le sous-ensemble accepté. La réussite confirme seulement sa structure ; example.com est illustratif, pas un serveur MCP testé.
Ajouter command à cette entrée échoue, car le transport devient ambigu. Ajouter headers avec {"X-Mode":"demo"} conserve une structure valide, mais déclenche un avertissement à examiner. Cela ne signifie pas que demo est un identifiant secret.