Die meisten kaputten MCP-Konfigurationen sind gültiges JSON — genau deshalb sagt dir niemand, dass sie falsch sind. Wähle deinen Client und finde heraus, was er wirklich mit deiner Datei macht.
Eine Konfiguration zu reparieren 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.
Die Prüfungen unterscheiden sich je nach Client, weil sich auch unterscheidet, was überhaupt als falsch gilt.
Wird in deinem Browser geparst. Nichts wird hochgeladen — wichtig, wenn Konfigurationen Tokens enthalten.
Zu jedem Problem steht dabei, was dieser Client stattdessen erwartet.
MCP standardisiert das Protokoll, nicht die Konfiguration. Diese zehn Clients lesen unterschiedliche Dateien, in drei unterschiedlichen Formaten, mit unterschiedlichen Key-Namen für dieselbe Sache. Die Tabelle unten ist das ganze Problem auf einen Blick — und der Grund, warum eine von einem Client in einen anderen kopierte Konfiguration sich meist sauber parsen lässt und sich mit nichts verbindet.
| Client | Format | Root-Key | Entfernter Endpunkt |
|---|---|---|---|
| Claude Desktop | JSON | mcpServers |
über lokale Bridge |
| Claude Code | JSON | mcpServers |
url |
| Cursor | JSON | mcpServers |
url |
| VS Code | JSON | servers |
url |
| Windsurf | JSON | mcpServers |
serverUrl |
| Codex CLI | TOML | mcp_servers |
url |
| Gemini CLI | JSON | mcpServers |
httpUrl |
| Cline | JSON | mcpServers |
url |
| Zed | JSON | context_servers |
url |
| Continue | YAML | mcpServers |
url |
mcpServers. VS Code
liest servers, Zed liest context_servers, Codex CLI liest
mcp_servers. Falscher Key, gültige Datei, keine Server, kein Fehler.url bei den meisten, serverUrl
bei Windsurf, httpUrl bei Gemini CLI, wenn der Transport Streamable HTTP ist.mcp-remote
gebrückt werden, und das ist eine völlig andere Konfigurationsform.Alles hier dient Leuten, die sich längst für deinen Server entschieden haben. MCP Showcase ist für die, die das noch nicht getan haben: Richte es auf dieselbe URL, und es entsteht ein Live-Playground mit Doku für jedes Tool — damit die Bewertung deines Servers einen Klick kostet statt einer Konfigurationsdatei und eines Neustarts.