Une entrée de serveur MCP est un petit bloc de JSON au mode d'échec impitoyable : si une clé est fausse, il n'y a pas d'erreur, le serveur n'apparaît tout simplement pas. Chaque transport veut une forme différente — un serveur local veut une commande et ses arguments, un distant une URL et souvent un en-tête — et les mélanger produit un fichier qui a l'air complet et ne fait rien. Ce créateur ne demande que les champs utilisés par le transport choisi, avertit si un champ de l'autre est rempli, et signale sans doute l'erreur la plus courante en pratique : un identifiant réel écrit dans un fichier qui finit versionné. Il produit à la fois le fichier de configuration et la commande équivalente en une ligne.
Fonctionnalités
Seulement les champs utilisés par le transport choisi
Avertit quand un champ de l’autre transport est rempli
Signale un secret d’allure réelle écrit dans le fichier, mais pas un espace réservé
Avertit d’un HTTP non chiffré vers un hôte distant, silencieux pour localhost
Attrape les arguments glissés dans le champ de commande
Variables d’environnement et en-têtes en paires modifiables
Produit le fichier de projet et la configuration de l’application de bureau
La commande équivalente, correctement échappée
Comment utiliser Configuration de serveur MCP
Nommez le serveur — c’est ainsi que ses outils sont regroupés
Choisissez le transport qu’il utilise
Remplissez la commande et les arguments, ou l’URL et les en-têtes
Copiez le JSON dans votre configuration, ou lancez la commande
Exemple
Entrée
"command": "npx -y some-server"
Sortie
Warning: looked up as a single executable with that name
Le premier mot est la commande ; tout le reste est un argument.
Erreurs courantes et dépannage
Le serveur n’apparaît jamais. — Souvent une forme erronée : une entrée stdio avec une url, ou une entrée distante avec une command. Les deux sont signalées ici, car aucune ne produit d’erreur en soi.
La commande est introuvable. — Les arguments vont à part. Mettez npx dans la commande et le reste dans la liste d’arguments : une commande contenant des espaces est cherchée comme un exécutable de ce nom.
Cela marche chez moi et échoue chez les autres. — Souvent un chemin absolu de votre machine dans les arguments, ou un identifiant de votre environnement que personne d’autre n’a.
J’ai un jeton dans le fichier de configuration. — Référencez plutôt une variable d’environnement. Un secret d’allure réelle est signalé ici, car ces fichiers finissent versionnés.
Foire aux questions
Quel transport choisir ?
stdio pour tout ce que vous exécutez localement — le client le démarre comme processus et dialogue par son entrée et sa sortie standard. HTTP pour un serveur distant. SSE existe surtout pour des serveurs écrits avant que HTTP ne devienne l’usage courant.
Où va le fichier de configuration ?
Un fichier de projet vit dans le dépôt pour que toute l’équipe ait les mêmes serveurs ; l’application de bureau a sa propre configuration pour ceux que vous voulez partout. Les deux formes sont produites et le chemin affiché.
Comment garder un jeton hors du fichier ?
Écrivez une référence à une variable d’environnement plutôt que la valeur. La vérification regarde si la valeur ressemble à un identifiant réel ou à un espace réservé, et ne se plaint que du premier cas.
Le fichier ou la commande ?
Les deux font la même chose. Le fichier vaut mieux quand il doit être versionné avec le projet ; la commande est plus rapide pour un essai. Les deux sortent des mêmes champs.
Pourquoi le nom du serveur compte-t-il ?
C’est la clé sous laquelle l’entrée est stockée et l’espace de noms de ses outils : deux serveurs ne peuvent pas le partager, et le renommer change la façon de référencer ses outils partout ailleurs.
Outils associés
Schéma d'outil MCP — Définissez un outil et obtenez le JSON Schema, mode strict vérifié.
Vérificateur de schéma — Collez une définition et découvrez pourquoi elle est rejetée ou mal appelée.
Générateur de hooks — Créez des hooks settings.json et repérez les matchers qui ne se déclenchent jamais.