Zum Inhalt springen

MCP-Server in Claude Code einrichten

Welche Form der Konfigurationsdatei Claude Code 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", je Server zusätzlich „type": "stdio" – so steht es in der Anleitung dieses Clients.
Dateiname.mcp.json

Ablageort

Ablageort
alle Systeme.mcp.json

Fundstelle: code.claude.com/docs/en/mcp, abgerufen am 2026-08-27

In drei Schritten

  1. Legen Sie die Datei .mcp.json an – bei Claude Code liegt sie unter .mcp.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": {
          "type": "stdio",
          "command": "npx",
          "args": [
            "-y",
            "@transloadit/mcp-server"
          ],
          "env": {
            "TRANSLOADIT_SECRET": ""
          }
        }
      }
    }

    als .mcp.json laden

    Zum Eintrag dieses Beispiels

  3. 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 Desktop, Cursor, Visual Studio Code, Windsurf, Codex CLI. Alle Clients im Vergleich

Konfiguration für Claude Code erzeugen

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

Konfiguration für Claude Code 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 Code 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-code