MCP-Server in Windsurf einrichten

Welche Form der Konfigurationsdatei Windsurf liest, wie sie heißt und wo sie liegt – aus der Dokumentation des Herstellers, mit Fundstelle und Abrufdatum.

Form der Datei
Form der Datei	JSON mit dem Wurzelschlüssel „mcpServers".
Dateiname	`mcp_config.json`

Ablageort

Ablageort
alle Systeme	`~/.codeium/windsurf/mcp_config.json`

Fundstelle: docs.devin.ai/desktop/cascade/mcp, abgerufen am 2026-08-27

In drei Schritten

Legen Sie die Datei mcp_config.json an – bei Windsurf liegt sie unter ~/.codeium/windsurf/mcp_config.json. Die vollständige Tabelle je Betriebssystem steht oben.
Setzen Sie den Serverblock unter dem Schlüssel mcpServers ein. Genau dieser Schlüssel unterscheidet die Clients voneinander.
Beispiel aus dem heutigen Bestand, erzeugt vom Konfigurationsbaukasten dieser Seite. Eintrag: io.github.transloadit/mcp-server
```
{
  "mcpServers": {
    "io-github-transloadit-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@transloadit/mcp-server"
      ],
      "env": {
        "TRANSLOADIT_SECRET": ""
      }
    }
  }
}
```
als mcp_config.json laden

Zum Eintrag dieses Beispiels
Prüfen Sie, dass die Datei gültig bleibt und dass Sie die Werte der geheimen Variablen selbst eintragen: Das Register kennt sie nicht und schreibt nur ihre Namen.

Der Wurzelschlüssel

Eine Datei mit dem falschen Wurzelschlüssel wird gelesen und tut nichts – ohne Fehlermeldung. Deshalb steht die Form hier neben dem Ablageort.

Andere Clients lesen eine andere Form: Claude Code, Visual Studio Code, Codex CLI. Alle Clients im Vergleich

Konfiguration für Windsurf erzeugen

Der Baukasten baut den Block aus den Registerangaben eines ausgewählten Servers und gibt ihn in genau der Form aus, die Windsurf liest.

Konfiguration für Windsurf erzeugen

Wofür der Baukasten eine Datei erzeugen kann

16.884 der 47.245 veröffentlichten Einträge führen eine Paketkoordinate, aus der eine offengelegte Startvorlage einen Block bildet. Die übrigen 30.361 nennen kein Paket oder eine Quelle ohne offengelegte Vorlage; für sie erzeugt der Baukasten nichts und sagt warum.

Wenn es nicht läuft

Wenn es nicht läuft
Der Client liest die Datei und tut nichts	Prüfen Sie Dateipfad und Wurzelschlüssel gemeinsam. Die hier erzeugte Datei für Windsurf verwendet mcpServers. Gültiges JSON allein belegt nicht, dass die Datei am gewählten Ort im passenden Format vorliegt.
Der Server startet und meldet fehlende Zugangsdaten	Die erzeugten Variablen tragen ihren Namen und einen leeren Wert. Welche Werte hineingehören, steht beim Anbieter – das Register erhebt sie nicht.
Für einen Eintrag entsteht gar kein Block	Dann führt der Registereintrag kein Paket, seine Paketquelle hat hier keine offengelegte Vorlage, oder seine Kennung sieht nicht wie ein Paketname aus. Der Baukasten nennt den Grund; erfunden wird nichts.

Einrichten und verbinden

Alle Beiträge

Was hier NICHT steht

Dieses Register führt keine Angabe darüber, welcher Server mit welchem Client zusammenarbeitet. Kein Manifest erklärt eine Clientliste, und das Register erfindet keine. Was hier steht, ist die Form der Datei und ihr Ablageort laut der Dokumentation des Clients – nicht eine Zusage über einen Server.

Fassung der Clientkunde: 1

tracevero · https://tracevero.de/klient/windsurf