Outil gratuit

Validateur de configuration MCP pour Gemini CLI

Collez votre configuration et voyez ce que Gemini CLI en fera réellement. 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.

Collez la configuration JSON. Retirez d'abord le jeton si vous préférez : les vérifications n'en ont pas besoin.
Tout s'exécute dans votre navigateur. Rien de ce que vous collez n'est envoyé, stocké ou journalisé.

Connecté enfin. Montrez maintenant à quelqu'un ce qu'il fait.

Réussir la 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
Collez votre configuration

Rien n'est envoyé. La vérification s'exécute entièrement dans votre navigateur.

play_circle
Nous la lisons comme Gemini CLI la lirait

Clé racine, clé d'endpoint, type de transport et les champs spécifiques que Gemini CLI traite autrement que tous les autres.

checklist
Corrigez ce qui est trouvé

Chaque problème indique ce que Gemini CLI attend à la place : une modification que vous pouvez faire, plutôt qu'un symptôme à rechercher.

Pourquoi une configuration valide ne fait quand même rien

Presque toutes les configurations MCP cassées sont du JSON valide. Les clients ignorent les clés qu'ils ne reconnaissent pas : un fichier avec la mauvaise clé racine ou le mauvais champ d'endpoint s'analyse proprement, Gemini CLI démarre normalement, et aucun serveur n'apparaît. Il n'y a aucune erreur à rechercher. C'est ce silence qui fait durer ces erreurs si longtemps.

Ce qui est vérifié pour Gemini CLI

  • Clé racine — Gemini CLI lit mcpServers. Tout le reste est analysé puis ignoré.
  • Champ d'endpoint — les serveurs distants doivent utiliser httpUrl.
  • Forme des entrées — chaque serveur a besoin soit d'une commande à lancer, soit d'un endpoint auquel se connecter.
  • HTTP non chiffré — signalé, car tout jeton bearer envoyé à ce serveur circule en clair.
  • Champs propres à Gemini CLI — voir ci-dessous.

httpUrl et url désignent des transports différents

Gemini CLI distingue les deux : "httpUrl" correspond à Streamable HTTP, "url" à HTTP+SSE. Utiliser "url" pour un serveur en Streamable HTTP est un écart de transport, et cela se manifeste par une connexion qui s'ouvre puis n'aboutit à rien, plutôt que par une erreur claire.

Votre configuration n'est pas envoyée

La vérification s'exécute entièrement dans votre navigateur et ne fait aucune requête réseau. C'est délibéré et non accessoire : les configurations MCP contiennent couramment des jetons d'API, et « collez votre configuration sur ce site » est une demande qu'il est raisonnable de refuser. Vous pouvez le confirmer dans l'onglet réseau de votre navigateur.

Si la configuration est bonne mais le serveur vide

Alors le problème est sorti du fichier. Un client qui affiche le serveur mais aucun outil se connecte et échoue au handshake ou au transport ; il ne lit pas mal votre configuration. Le MCP Inspector montre sur quel transport le serveur répond et le journal brut des requêtes, et le MCP Server Tester réduit la même chose à une liste réussite/échec.

Outils liés

Une fois connecté, la partie difficile commence

Une configuration qui fonctionne est le minimum. Ce qu'elle ne fait pas, c'est aider quiconque à comprendre à quoi sert votre serveur vraiment — et si vous publiez un serveur MCP, c'est cela qui décide si quelqu'un le configure. MCP Showcase transforme le même endpoint en playground en direct avec une documentation par outil, pour que l'évaluer prenne un clic plutôt qu'un fichier de configuration et un redémarrage.

Questions fréquentes

Parce que les clients ignorent ce qu'ils ne reconnaissent pas. Une configuration avec la mauvaise clé racine, ou un endpoint distant sous le mauvais nom de champ, s'analyse parfaitement et donne un client qui ne voit aucun serveur et ne signale rien. Le silence est le mode d'échec normal ici.

Que la clé racine est celle que lit Gemini CLI ; que les serveurs distants utilisent le nom de champ attendu par Gemini CLI ; que chaque entrée a soit une commande, soit un endpoint ; que rien n'est servi en HTTP non chiffré ; et les particularités propres à Gemini CLI.

Non. Elle est analysée dans votre navigateur et ne quitte jamais votre machine, ce qui compte : les configurations MCP contiennent fréquemment des jetons d'API. Aucune requête réseau n'est faite.

Cela dépend entièrement du client, et c'est pour cela que tant de gens s'y trompent. Claude, Cursor, Windsurf et Cline utilisent mcpServers ; VS Code utilise servers ; Zed utilise context_servers ; Codex CLI utilise mcp_servers en TOML. Le résultat ci-dessous nomme celle dont Gemini CLI 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