Kostenloses Tool

MCP-Config-Validator für Gemini CLI

Füge deine Konfiguration ein und sieh, was Gemini CLI tatsächlich damit macht. Die meisten kaputten MCP-Konfigurationen sind gültiges JSON — genau deshalb sagt dir niemand, dass sie falsch sind.

Füge die JSON-Konfiguration ein. Wenn dir wohler ist, entferne vorher das Token — die Prüfungen brauchen es nicht.
Läuft vollständig in deinem Browser. Nichts, was du einfügst, wird hochgeladen, gespeichert oder protokolliert.

Endlich verbunden. Jetzt zeig jemandem, was er kann.

Die Konfiguration hinzubekommen ist die langweilige Hälfte. MCP Showcase macht aus demselben Server ein Live-Playground, das deine Kunden ausprobieren können — mit Doku für jedes Tool.

So funktioniert es

link
Konfiguration einfügen

Nichts wird hochgeladen. Die Prüfung läuft vollständig in deinem Browser.

play_circle
Wir lesen sie so, wie Gemini CLI sie liest

Root-Key, Endpunkt-Key, Transporttyp und die clientspezifischen Felder, die Gemini CLI anders behandelt als alle anderen.

checklist
Beheben, was gefunden wird

Zu jedem Problem steht dabei, was Gemini CLI stattdessen erwartet — also eine Änderung, die du machen kannst, statt eines Symptoms, das du suchen musst.

Warum eine gültige Konfiguration trotzdem nichts tut

Fast jede kaputte MCP-Konfiguration ist gültiges JSON. Clients ignorieren Keys, die sie nicht kennen — eine Datei mit dem falschen Root-Key oder dem falschen Endpunkt-Feld lässt sich sauber parsen, Gemini CLI startet normal, und es erscheinen keine Server. Es gibt keinen Fehler, nach dem man suchen könnte. Genau diese Stille ist der Grund, warum solche Fehler so lange überleben.

Was für Gemini CLI geprüft wird

  • Root-Key — Gemini CLI liest mcpServers. Alles andere wird geparst und ignoriert.
  • Endpunkt-Feld — entfernte Server müssen httpUrl nutzen.
  • Form der Einträge — jeder Server braucht entweder ein Kommando zum Starten oder einen Endpunkt zum Verbinden.
  • Unverschlüsseltes HTTP — wird markiert, denn jedes Bearer-Token an diesen Server wird unverschlüsselt übertragen.
  • Felder speziell für Gemini CLI — siehe unten.

httpUrl und url meinen verschiedene Transporte

Gemini CLI unterscheidet die beiden: "httpUrl" ist Streamable HTTP, "url" ist HTTP+SSE. "url" für einen Streamable-HTTP-Server zu nutzen ist eine Transportabweichung — und sie zeigt sich als Verbindung, die aufgeht und dann ins Leere läuft, statt als klarer Fehler.

Deine Konfiguration wird nicht hochgeladen

Die Prüfung läuft vollständig in deinem Browser und stellt keine Netzwerkanfrage. Das ist Absicht und kein Zufall: MCP-Konfigurationen enthalten regelmäßig API-Tokens, und „füge deine Konfiguration in diese Website ein" ist etwas, das man vernünftigerweise ablehnt. Du kannst es im Netzwerk-Tab deines Browsers nachprüfen.

Wenn die Konfiguration stimmt, der Server aber leer ist

Dann ist das Problem aus der Datei herausgewandert. Ein Client, der den Server zeigt, aber keine Tools, verbindet sich und scheitert am Handshake oder am Transport — er liest deine Konfiguration nicht falsch. Der MCP Inspector zeigt, über welchen Transport der Server antwortet, und das rohe Request-Log; der MCP Server Tester reduziert dasselbe auf eine Pass/Fail-Checkliste.

Verwandte Tools

Wenn es verbindet, fängt der schwierige Teil an

Eine funktionierende Konfiguration ist die Grundvoraussetzung. Was sie nicht leistet: irgendwem verständlich zu machen, wofür dein Server überhaupt da ist — und wenn du einen MCP-Server veröffentlichst, entscheidet genau das darüber, ob ihn jemand einrichtet. MCP Showcase macht aus demselben Endpunkt ein Live-Playground mit Doku pro Tool, damit die Bewertung einen Klick kostet statt einer Konfigurationsdatei und eines Neustarts.

Häufig gestellte Fragen

Weil Clients ignorieren, was sie nicht kennen. Eine Konfiguration mit dem falschen Root-Key oder mit einem entfernten Endpunkt unter dem falschen Feldnamen lässt sich einwandfrei parsen — und führt zu einem Client, der keine Server sieht und nichts meldet. Stille ist hier der normale Fehlerfall.

Dass der Root-Key derjenige ist, den Gemini CLI liest; dass entfernte Server den Feldnamen nutzen, den Gemini CLI erwartet; dass jeder Eintrag entweder ein Kommando oder einen Endpunkt hat; dass nichts über unverschlüsseltes HTTP läuft; und die clientspezifischen Eigenheiten, die gerade für Gemini CLI gelten.

Nein. Sie wird in deinem Browser geparst und verlässt deinen Rechner nie — und das ist wichtig, denn MCP-Konfigurationen enthalten häufig API-Tokens. Es wird überhaupt keine Netzwerkanfrage gestellt.

Das hängt vollständig vom Client ab — genau deshalb tappen so viele in diese Falle. Claude, Cursor, Windsurf und Cline nutzen mcpServers; VS Code nutzt servers; Zed nutzt context_servers; Codex CLI nutzt mcp_servers in TOML. Das Ergebnis unten nennt den, den Gemini CLI braucht.

Dann liegt das Problem am Server und nicht an der Datei. Lass den Endpunkt durch den MCP Inspector laufen, um zu bestätigen, dass er einen Handshake abschließt, und um zu sehen, was er bereitstellt.

Weitere kostenlose MCP-Tools