MCP-Config-Generator — Claude, Cursor, VS Code, Windsurf & Codex

Definiere einen MCP-Server einmal und erhalte die exakte Konfigurationsdatei oder den Befehl für Claude Desktop, Claude Code, Cursor, VS Code, Windsurf und Codex.

Beliebten Server hinzufügen

Servername

Transport

Befehl

Nur die ausführbare Datei: npx, uvx, docker, node oder ein vollständiger Pfad.

Umgebungsvariablen

KEY=value pro Zeile. Schreib ${VAR}, um auf eine Variable aus deiner Shell zu verweisen.

Argumente (eines pro Zeile)

Jede Zeile wird zu einem Array-Element. Pfade mit Leerzeichen sind kein Problem.

Servername

Transport

Server-URL

Lass die Header bei Servern leer, die die Anmeldung per OAuth nutzen.

HTTP-Header

Name: Wert pro Zeile.

Halte Secrets aus der Datei heraus: Ersetze jeden Umgebungswert durch einen Verweis auf eine gleichnamige Shell-Variable (z. B. GITHUB_TOKEN=${GITHUB_TOKEN}).

claude_desktop_config.json

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-filesystem",
        "/Users/you/projects"
      ]
    },
    "github": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://api.githubcopilot.com/mcp/",
        "--header",
        "Authorization:${MCP_HEADER_1}"
      ],
      "env": {
        "MCP_HEADER_1": "Bearer ${GITHUB_PAT}"
      }
    }
  }
}

Datei: macOS ~/Library/Application Support/Claude/claude_desktop_config.json, Windows %APPDATA%\Claude\claude_desktop_config.json (öffnen über Settings > Developer > Edit Config). Beende Claude nach dem Speichern vollständig und öffne es neu.
Remote-Server werden über mcp-remote angebunden (benötigt Node.js). In kostenpflichtigen Tarifen kannst du die URL stattdessen unter Settings > Connectors hinzufügen; OAuth wird dann für dich erledigt.
Claude Desktop löst ${VAR} in dieser Datei nicht auf; ersetze diese Platzhalter durch echte Werte.

Läuft komplett in deinem Browser. Konfigurationen enthalten oft API-Tokens, deshalb wird nichts, was du eingibst oder einfügst, hochgeladen oder gespeichert. Alle kostenlosen Tools ansehen.

Ein Problem gefunden oder etwas, das besser sein könnte? Wir lesen jede Nachricht und beheben Fehler schnell.

Dieser MCP-Config-Generator schreibt die Servereinstellungen für das Model Context Protocol für jeden großen KI-Client aus einem einzigen Formular. Jeder Client will eine leicht andere Datei: Claude Desktop und Cursor nutzen ein Objekt "mcpServers", VS Code "servers" mit einem Pflichtfeld "type", Windsurf nennt die Remote-URL "serverUrl", Claude Code braucht "type" bei Remote-Einträgen, und Codex nutzt TOML-Tabellen. Gib den Befehl oder die URL einmal ein und kopiere die richtige Version für dein Tool.

Der Validator macht es umgekehrt: Füge eine Config ein, die nicht lädt, und er zeigt auf den JSON-Fehler, das fehlende Feld oder den Schlüssel, den der Client nicht liest; dann lädt er die Server ins Formular, damit du sie umwandeln kannst. Er prüft die Struktur, nicht ob das Serverpaket existiert oder der Token gültig ist; scheitert ein Server weiterhin, schau ins MCP-Log des Clients.

So funktioniert’s

Klicke auf eine Vorlage wie Filesystem oder GitHub oder füge einen leeren Server hinzu.
Für einen lokalen Server legst du den Befehl fest (npx, uvx, docker) und schreibst jedes Argument in eine eigene Zeile. Für einen Remote-Server gibst du die URL und eventuelle Header an.
Aktiviere optional die Option, die Secrets aus der Datei heraushält und Werte durch ${VAR}-Verweise ersetzt.
Wähle deinen Client, kopiere oder lade die Ausgabe herunter und speichere sie unter dem darunter angezeigten Pfad.
Starte den Client neu (Claude Desktop vollständig beenden), damit er die Config neu lädt. Um eine bestehende Datei zu reparieren, füge sie unter „Prüfen & umwandeln“ ein.

Häufige Fragen

Wo liegt claude_desktop_config.json?

Unter macOS unter ~/Library/Application Support/Claude/claude_desktop_config.json, unter Windows unter %APPDATA%\Claude\claude_desktop_config.json. Am einfachsten öffnest du sie in Claude Desktop über Einstellungen > Entwickler > Konfiguration bearbeiten. Beende Claude nach dem Speichern vollständig und öffne es neu, denn die Datei wird nur beim Start gelesen.

Was ist der Unterschied zwischen .mcp.json in Claude Code und claude mcp add?

claude mcp add registriert einen Server über das Terminal. Mit dem standardmäßigen Scope local wird er in ~/.claude.json gespeichert, nur für dich und das aktuelle Projekt; --scope user macht ihn in all deinen Projekten verfügbar; --scope project schreibt ihn in .mcp.json im Projektwurzelverzeichnis, sodass das Team ihn über die Versionsverwaltung teilt. Jeder Eintrag in .mcp.json sollte einen "type" haben (stdio, http oder sse); ein Eintrag mit url, aber ohne type wird als stdio gelesen und scheitert.

Warum ignoriert VS Code meine mcpServers-Config?

VS Code liest .vscode/mcp.json mit dem Schlüssel "servers" auf oberster Ebene, nicht "mcpServers", und jeder Server braucht "type": "stdio", "http" oder "sse". Eine Datei, die aus einer README für Claude oder Cursor kopiert wurde, lädt daher nichts. Füge sie in den Validator ein und wandle sie ins VS-Code-Format um.

Wie halte ich API-Schlüssel aus meiner MCP-Config heraus?

Verweise auf Umgebungsvariablen, statt Werte einzufügen. Claude Code löst ${VAR} und ${VAR:-default} auf; Cursor und Windsurf nutzen ${env:VAR}; VS Code unterstützt ${env:VAR} und ${input:id}-Abfragen, die das Secret sicher speichern; Codex reicht Variablen über env_vars, env_http_headers und bearer_token_env_var weiter. Claude Desktop löst in seiner Config keine Variablen auf, dort müssen die Werte also wörtlich stehen.

Wie füge ich Claude Desktop einen Remote-MCP-Server hinzu?

Die Config-Datei von Claude Desktop startet nur lokale Befehle. In kostenpflichtigen Tarifen kannst du unter Einstellungen > Konnektoren eine Remote-Server-URL hinzufügen, was auch die OAuth-Anmeldung übernimmt. Andernfalls überbrückst du mit mcp-remote: Der Befehl ist npx mit den Argumenten -y, mcp-remote und der Server-URL, dazu --header-Optionen für die Authentifizierung. Der Generator schreibt diese Brücke für dich, wenn du Claude Desktop wählst.

Was ist der Unterschied zwischen den Transporten stdio, HTTP und SSE?

stdio-Server laufen als lokaler Prozess, den der Client startet und mit dem er über Standardeingabe und -ausgabe spricht – passend für Tools, die Dateien lesen oder auf deinem Rechner laufen. Streamable-HTTP-Server laufen entfernt unter einer URL und sind der aktuelle Standard für gehostete Server. SSE ist der ältere Remote-Transport; Claude Code markiert ihn als veraltet und Codex unterstützt nur Streamable HTTP, nimm also HTTP, wenn ein Server beides anbietet.

Speicherorte und Formate der MCP-Configs

• Claude Desktop: claude_desktop_config.json in ~/Library/Application Support/Claude (macOS) oder %APPDATA%\Claude (Windows). Oberste Ebene "mcpServers"; Einträge haben command, args und env.

• Claude Code: .mcp.json im Projektwurzelverzeichnis (Scope project) oder ~/.claude.json (Scopes local und user, verwaltet über claude mcp add). Oberste Ebene "mcpServers" mit "type" bei jedem Eintrag.

• Cursor: .cursor/mcp.json im Projekt oder global ~/.cursor/mcp.json. "mcpServers"; Remote-Einträge nutzen "url" und "headers".

• VS Code: .vscode/mcp.json im Workspace oder die Datei auf Benutzerebene, die du mit „MCP: Open User Configuration“ öffnest. Oberste Ebene "servers" plus optional "inputs".

• Windsurf: ~/.codeium/windsurf/mcp_config.json. Die Windsurf-Dokumentation liegt inzwischen unter Devin Desktop, das ~/.config/devin/mcp_config.json (macOS/Linux) oder %APPDATA%\devin\mcp_config.json verwendet. Remote-Einträge nutzen "serverUrl".

• Codex: ~/.codex/config.toml oder .codex/config.toml in einem vertrauenswürdigen Projekt. Eine Tabelle [mcp_servers.<name>] pro Server, mit command/args/env oder url plus bearer_token_env_var und http_headers.

Häufige Gründe, warum ein MCP-Server nicht lädt

• Der ganze Befehl steht in "command" ("npx -y @scope/server"). Der Client sucht dann nach einem Programm mit genau diesem vollen Namen. Schreib npx in command und den Rest in args, jedes Element einzeln.

• Ein Komma am Ende oder ein //-Kommentar im JSON. Nur die mcp.json von VS Code akzeptiert Kommentare; die anderen Clients brauchen striktes JSON.

• npx oder uvx wird nicht gefunden. GUI-Apps unter macOS übernehmen nicht immer den PATH deiner Shell; nimm den vollständigen Pfad aus `which npx` als command.

• Der falsche Schlüssel auf oberster Ebene: "servers" in einer Datei für Claude oder Cursor oder "mcpServers" in VS Code.

• Ein Remote-Eintrag ohne "type" in der .mcp.json von Claude Code, der dann als lokaler Befehl behandelt wird.

• Der Client wurde nicht neu gestartet. Claude Desktop liest die Datei nur beim Start; Cursor und VS Code zeigen den Serverstatus in ihren MCP-Einstellungen an.

Sicherheitshinweise, bevor du einen Server hinzufügst

Ein MCP-Server läuft mit deinen Berechtigungen: Ein Dateisystem-Server kann jeden aufgeführten Ordner lesen und ändern, und ein Datenbankserver kann mit den Zugangsdaten, die du ihm gibst, Abfragen ausführen. Gewähre den engsten Rahmen, der funktioniert, etwa einen einzelnen Projektordner, einen Datenbanknutzer mit Leserechten oder einen fein abgestuften GitHub-Token, der auf die nötigen Repositorys beschränkt ist.

Installiere Server vom offiziellen Herausgeber, fixiere Versionen für alles, was mit der Produktion in Berührung kommt, und bevorzuge Remote-Server mit OAuth gegenüber langlebigen Tokens, die in eine Datei eingefügt werden. Behandle Tool-Ausgaben als nicht vertrauenswürdige Eingaben: Eine Webseite oder ein Issue, das ein Server abruft, kann Anweisungen enthalten, die auf das Modell zielen.