MCP-Server in Windsurf hinzufügen (mcp_config.json)

Lokale und Remote-MCP-Server für den Cascade-Agenten von Windsurf in mcp_config.json einrichten: Speicherort, serverUrl für Remote-Server und Tools deaktivieren.

1. mcp_config.json öffnen

Klicken Sie im Cascade-Panel oben rechts auf das Menü … (Actions) und wählen Sie im Abschnitt MCPs Open MCP config file. Laut aktueller Dokumentation liegt die Datei unter macOS und Linux in ~/.config/devin/mcp_config.json und unter Windows in %APPDATA%\devin\mcp_config.json (Windsurf gehört inzwischen zu Devin Desktop; ältere Windsurf-Versionen nutzten ~/.codeium/windsurf/mcp_config.json). Über das Menü öffnen Sie immer die richtige Datei.

2. Lokalen (stdio-)Server hinzufügen

Fügen Sie unter mcpServers einen Eintrag hinzu – im selben Format wie bei Claude Desktop und Cursor:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-github"
      ],
      "env": {
        "GITHUB_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

3. Remote-Server hinzufügen

Remote-HTTP-Server verwenden serverUrl (oder url) statt eines Befehls. Beispiel mit dem kostenlosen Socketlist-Server:

{
  "mcpServers": {
    "socketlist": {
      "serverUrl": "https://socketlist.pages.dev/mcp"
    }
  }
}

Benötigt der Server einen API-Schlüssel, ergänzen Sie ein headers-Objekt.

4. Geheimnisse aus der Datei heraushalten

Die Konfiguration unterstützt ${env:VAR_NAME} und ${file:/path/to/file} in command, args, env, serverUrl, url und headers.

5. Server und Tools ein- oder ausschalten

Im Abschnitt MCPs des Actions-Menüs hat jeder Server einen Schalter. Um einzelne Tools auszublenden, ergänzen Sie "disabledTools": ["tool_name"] im Servereintrag. Cascade kann höchstens 100 Tools gleichzeitig nutzen.

Hinweise

Das gilt für den Cascade-Agenten. Der neuere Agent Devin Local speichert MCP-Server stattdessen in der Devin-CLI-Konfiguration. Quelle: die offizielle Cascade-MCP-Dokumentation.