Zum Inhalt springen

MCP-Server in Claude Desktop einrichten

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

Form der Datei
Form der DateiJSON mit dem Wurzelschlüssel „mcpServers".
Dateinameclaude_desktop_config.json

Ablageort

Ablageort
macOS~/Library/Application Support/Claude/claude_desktop_config.json
Windows%APPDATA%\Claude\claude_desktop_config.json

Fundstelle: modelcontextprotocol.io, „Connect to local MCP servers", abgerufen am 2026-08-27

In drei Schritten

  1. Legen Sie die Datei claude_desktop_config.json an – bei Claude Desktop liegt sie unter ~/Library/Application Support/Claude/claude_desktop_config.json. Die vollständige Tabelle je Betriebssystem steht oben.
  2. 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 claude_desktop_config.json laden

    Zum Eintrag dieses Beispiels

  3. Beenden Sie Claude Desktop vollständig und starten Sie es neu. Die Anwendung liest die Datei beim Start; ein geschlossenes Fenster genügt nicht. So steht es in der oben genannten Fundstelle.
  4. 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 Claude Desktop erzeugen

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

Konfiguration für Claude Desktop 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 nichtsPrüfen Sie Dateipfad und Wurzelschlüssel gemeinsam. Die hier erzeugte Datei für Claude Desktop 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 ZugangsdatenDie 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 BlockDann 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/claude-desktop