Kostenloses Tool

MCP-Config-Validator für Windsurf

Füge deine Konfiguration ein und sieh, was Windsurf 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 Windsurf sie liest

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

checklist
Beheben, was gefunden wird

Zu jedem Problem steht dabei, was Windsurf 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, Windsurf 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 Windsurf geprüft wird

  • Root-Key — Windsurf liest mcpServers. Alles andere wird geparst und ignoriert.
  • Endpunkt-Feld — entfernte Server müssen serverUrl 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 Windsurf — siehe unten.

Entfernte Server nutzen serverUrl, nicht url

Windsurf liest "serverUrl" für einen gehosteten Endpunkt. Eine Konfiguration mit "url" — also mit dem, was jeder andere JSON-basierte Client nutzt — wird kommentarlos akzeptiert, und der Server verbindet sich nie. Ein Unterschied von einem Wort, der keine einzige Fehlermeldung erzeugt.

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 Windsurf liest; dass entfernte Server den Feldnamen nutzen, den Windsurf 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 Windsurf 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 Windsurf 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