# Claude Desktop mit MCP erweitern: claude\_desktop\_config.json richtig konfigurieren

Mit dem Model Context Protocol (MCP) erweitern Sie Claude Desktop um externe Werkzeuge und Datenquellen. Über die Datei claude\_desktop\_config.json binden Sie lokale MCP-Server ein und legen deren Startparameter fest. So ermöglichen Sie Claude beispielsweise den Zugriff auf lokale Dateien, Entwicklungswerkzeuge oder Datenbanken und können zusätzliche Funktionen direkt im KI-Chat nutzen.

## Was ist die claude\_desktop\_config.json?

Die claude\_desktop\_config.json ist die zentrale Konfigurationsdatei für die **manuelle Einbindung und Steuerung** lokaler [MCP](https://www.ionos.at/digitalguide/server/knowhow/model-context-protocol/)-Server **in Claude Desktop**. Über die standardisierte [JSON](https://www.ionos.at/digitalguide/server/knowhow/was-ist-json/)-Syntax legen Sie fest, welche Server beim Anwendungsstart initialisiert werden, welche Startbefehle und Parameter sie verwenden und welche Umgebungsvariablen ihnen zur Verfügung stehen. So regeln Sie die Anbindung zusätzlicher KI-Werkzeuge und Datenquellen.

Die Datei ermöglicht es beispielsweise, Claude über einen MCP-Server **Zugriff** auf ausgewählte lokale Verzeichnisse, Entwicklungswerkzeuge oder Datenbanken zu geben. Die verfügbaren Funktionen hängen dabei vom jeweiligen MCP-Server und seinen Berechtigungen ab.

Hinweis Remote-MCP-Server werden dagegen regulär über [Connectors](https://claude.com/docs/connectors/overview "claude.com: Übersichtsseite zu Connectors") eingebunden. Die manuelle JSON-Konfiguration und die Einrichtung von Remote-Connectors sind daher unterschiedliche Integrationswege, wobei lokale Server aus der claude\_desktop\_config.json in Cowork und claude.ai nicht verfügbar sind.

## Wo befindet sich die claude\_desktop\_config.json?

Die JSON-Konfigurationsdatei für lokale Claude-MCP-Server liegt im benutzerspezifischen Anwendungsverzeichnis von Claude Desktop. Ihr Speicherort unterscheidet sich je nach Betriebssystem.

<table>
  <thead>
    <tr>
      <th>Betriebssystem</th>
      <th>Speicherort</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Windows</td>
      <td>`%APPDATA%\Claude\claude_desktop_config.json`</td>
    </tr>
    <tr>
      <td>macOS</td>
      <td>`~/Library/Application Support/Claude/claude_desktop_config.json`</td>
    </tr>
    <tr>
      <td>Linux</td>
      <td>`~/.config/Claude/claude_desktop_config.json` (Beta; nicht in der offiziellen MCP-Dokumentation ausgewiesen)</td>
    </tr>
  </tbody>
</table>

Die Datei lässt sich entweder über den Dateimanager des Betriebssystems oder **direkt über Claude Desktop öffnen**. Für die zweite Möglichkeit gehen Sie wie folgt vor:

1. Öffnen Sie nacheinander „Einstellungen“ → „Desktop-App“ → „**Entwickler (Developer)**“.
2. Klicken Sie auf „**Edit Config**“, um das Verzeichnis mit der Konfigurationsdatei aufzurufen.
3. Öffnen Sie die Datei claude\_desktop\_config.json mit einem Texteditor, um die Claude-MCP-Konfiguration zu bearbeiten.

Ist die Datei noch nicht vorhanden, können Sie sie im entsprechenden Verzeichnis selbst anlegen. Achten Sie darauf, dass die **Dateiendung .json** lautet und zum Beispiel nicht .json.txt. Erstellen Sie vor Änderungen an einer bestehenden Konfigurationsdatei in jedem Fall eine **Sicherungskopie**. So können Sie bei Fehlern jederzeit zur vorherigen Konfiguration zurückkehren.

## Wie ist die claude\_desktop\_config.json aufgebaut?

Die claude\_desktop\_config.json verwendet das Datenformat JSON (JavaScript Object Notation). Darin werden Konfigurationswerte als [Schlüssel-Wert-Paare gespeichert](https://www.ionos.at/digitalguide/hosting/hosting-technik/key-value-store/). Für die Einbindung lokaler MCP-Server ist das Objekt `mcpServers` entscheidend. Es enthält die Konfigurationen der einzelnen Server, die Claude Desktop starten soll.

Die wichtigsten Parameter sind:

<table>
  <thead>
    <tr>
      <th>Parameter</th>
      <th>Funktion</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>`mcpServers`</td>
      <td>Übergeordnetes Objekt mit den Konfigurationen der MCP-Server</td>
    </tr>
    <tr>
      <td>Servername</td>
      <td>Frei wählbarer Bezeichner, beispielsweise `filesystem`</td>
    </tr>
    <tr>
      <td>`command`</td>
      <td>Ausführbare Datei bzw. Befehl zum Starten des MCP-Servers</td>
    </tr>
    <tr>
      <td>`args`</td>
      <td>Liste der Argumente, die beim Start an den Befehl übergeben werden</td>
    </tr>
    <tr>
      <td>`env`</td>
      <td>Optionale Umgebungsvariablen für den Serverprozess, beispielsweise API-Schlüssel</td>
    </tr>
  </tbody>
</table>

Die Parameter `command` und `args` legen gemeinsam fest, wie der jeweilige MCP-Server gestartet wird. Über `env` lassen sich bei Bedarf zusätzliche Konfigurationswerte bereitstellen.

### Beispiel: MCP-Server für das Dateisystem konfigurieren

Mit einem MCP-Server für das Dateisystem ermöglichen Sie Claude den Zugriff auf ausgewählte lokale Verzeichnisse. Je nach bereitgestellten Funktionen kann Claude darin beispielsweise Dateien lesen, erstellen oder bearbeiten.

Für die folgende manuelle Einrichtung benötigen Sie eine funktionierende [Node.js](https://www.ionos.at/digitalguide/websites/web-entwicklung/einfuehrung-in-nodejs/)-Installation mit `npx`. Alternativ lassen sich lokale MCP-Server über Desktop Extensions installieren, ohne die JSON-Datei manuell zu bearbeiten oder Abhängigkeiten selbst zu verwalten. Claude Desktop stellt dafür eine eigene Node.js-Laufzeit bereit. Das folgende **Beispiel** zeigt die manuelle Konfiguration eines Filesystem-Servers **unter macOS**:

```json
{
    "mcpServers": {
        "dateisystem": {
            "command": "npx",
            "args": [
                "-y",
                "@modelcontextprotocol/server-filesystem",
                "/Users/max/Documents"
            ]
        }
    }
}
```

Die einzelnen Konfigurationseinträge erfüllen folgende Aufgaben:

- `dateisystem` bezeichnet den MCP-Server innerhalb der Konfiguration (Name frei wählbar).
- `npx` startet das angegebene Node.js-Paket.
- `-y` bestätigt die gegebenenfalls erforderliche Paketinstallation automatisch.
- `@modelcontextprotocol/server-filesystem` bezeichnet das auszuführende MCP-Server-Paket.
- `/Users/max/Documents` legt das Verzeichnis fest, auf das der Server zugreifen darf.

Verwenden Sie für freigegebene Verzeichnisse absolute Pfade. Relative Pfade können zu Fehlern führen, wenn der Server aus einem anderen Arbeitsverzeichnis gestartet wird. Unter Windows könnte das entsprechende Verzeichnis beispielsweise `C:\\Users\\Max\\Documents` lauten. In JSON müssen Backslashes innerhalb von Zeichenketten doppelt geschrieben werden.

Hinweis Falls Claude Desktop den Befehl `npx` nicht findet, können Sie für `command` den absoluten Pfad zur ausführbaren Datei angeben. Unter Windows kann beispielsweise `npx.cmd` erforderlich sein. Alternativ lässt sich `npx` über `cmd` mit den Argumenten `/c`, `npx`, `-y` und dem jeweiligen Serverpaket starten.

### Mehrere MCP-Server einbinden

Sie können mehrere MCP-Server innerhalb desselben `mcpServers`-Objekts konfigurieren. Jeder Server erhält einen eigenen Namen und seine individuellen Startparameter. Die einzelnen Servereinträge werden dabei **durch Kommata voneinander getrennt**. Hinter dem letzten Eintrag darf jedoch kein zusätzliches Komma stehen. Damit lassen sich beispielsweise ein Dateisystem-Server und ein weiterer MCP-Server für Entwicklungswerkzeuge parallel bereitstellen.

### Umgebungsvariablen mit `env` festlegen

Manche MCP-Server benötigen zusätzliche Angaben, beispielsweise API-Schlüssel für externe Dienste. Diese lassen sich über das optionale Objekt `env` an den jeweiligen Serverprozess übergeben. Die Struktur sieht beispielsweise folgendermaßen aus:

```json
{
    "mcpServers": {
        "beispielserver": {
            "command": "/absoluter/pfad/zum/server",
            "args": [],
            "env": {
                "API_KEY": "IHR_API_KEY"
            }
        }
    }
}
```

Die Serverkonfiguration ist ein Platzhalter. Ersetzen Sie den angegebenen Startbefehl durch den Pfad zu einem tatsächlich installierten MCP-Server. Auch der Name der Umgebungsvariablen richtet sich nach den Anforderungen des jeweiligen Servers.

Hinweis Speichern Sie echte [API-Keys](https://www.ionos.at/digitalguide/websites/web-entwicklung/api-key/) möglichst nicht ungeschützt in Konfigurationsdateien. Nutzen Sie nach Möglichkeit eine sichere Geheimnisverwaltung oder eine vom jeweiligen MCP-Server unterstützte Methode zur Übergabe von Zugangsdaten. Die Verwendung von `env` allein verschlüsselt die darin hinterlegten Werte nicht. Desktop Extensions können sensible Konfigurationswerte dagegen verschlüsselt speichern.

## MCP-Server in Claude Desktop aktivieren

Nach dem Speichern der claude\_desktop\_config.json müssen Sie Claude Desktop vollständig neu starten, damit die Anwendung die geänderte Konfiguration einliest und die konfigurierten MCP-Server startet. Für die Aktivierung sind daher folgende Schritte erforderlich:

1. **Claude Desktop beenden**: Schließen Sie die Anwendung vollständig. Das bloße Schließen des Fensters reicht gegebenenfalls nicht aus.
2. **Claude Desktop neu starten**: Öffnen Sie die Anwendung erneut, damit die MCP-Konfiguration eingelesen wird.
3. **MCP-Verbindung überprüfen**: Öffnen Sie einen neuen Chat und klicken Sie auf die Plus-Schaltfläche in der Eingabeleiste. Unter „Connectors“ sehen Sie die verbundenen MCP-Server und ihre Werkzeuge. In älteren Versionen werden verfügbare MCP-Tools durch ein Hammer-Symbol angezeigt. Alternativ können Sie den Verbindungsstatus in den Entwicklereinstellungen überprüfen.
4. **MCP-Server testen**: Bitten Sie Claude beispielsweise, die Dateien im freigegebenen Verzeichnis aufzulisten. So überprüfen Sie, ob der MCP-Server für das Dateisystem ordnungsgemäß funktioniert.

## Fehler bei der Claude-MCP-Konfiguration beheben

Wenn ein MCP-Server nicht startet oder Befehle fehlschlagen, sollten Sie zunächst die **JSON-Syntax**, die angegebenen **Dateipfade** und die **Verfügbarkeit des Startbefehls** überprüfen. Häufige Ursachen sind fehlerhafte Kommata, fehlende Abhängigkeiten oder unzureichende Zugriffsberechtigungen.

Für eine gezielte Fehlerdiagnose stellt Claude Desktop lokale MCP-Logdateien bereit:

<table>
  <thead>
    <tr>
      <th>Betriebssystem</th>
      <th>Verzeichnis der Logdateien</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td>Windows</td>
      <td>`%APPDATA%\Claude\logs`</td>
    </tr>
    <tr>
      <td>macOS</td>
      <td>`~/Library/Logs/Claude`</td>
    </tr>
    <tr>
      <td>Linux</td>
      <td>`~/.config/Claude/logs/` (Beta; nicht in der offiziellen MCP-Dokumentation ausgewiesen)</td>
    </tr>
  </tbody>
</table>

Die Datei mcp.log enthält Informationen zu den MCP-Verbindungen. Serverspezifische Fehlermeldungen finden Sie in Dateien nach dem Muster `mcp-server-<NAME>.log`, wobei `<NAME>` dem konfigurierten Servernamen entspricht.

Unter **Windows** können folgende weitere Fehler auftreten:

- **Fehlende APPDATA-Variable**: Verweist eine Fehlermeldung auf `${APPDATA}`, ergänzen Sie den vollständigen Wert der Umgebungsvariablen `APPDATA` im `env`-Objekt der Serverkonfiguration.
- **Probleme mit npm**: Schlägt der Start über `npx` weiterhin fehl, überprüfen Sie die npm-Installation. Mit `npm install -g npm` lässt sich npm bei Bedarf global aktualisieren.
- **Abweichender Konfigurationspfad**: Bei manchen Windows-Installationen über MSIX wurde beobachtet, dass Claude Desktop nicht die über „Edit Config“ geöffnete Datei einliest. Bleiben Änderungen wirkungslos, prüfen Sie den alternativen Speicherort `%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Roaming\Claude\`.

## Fazit: MCP-Server über die claude\_desktop\_config.json konfigurieren

Mit der claude\_desktop\_config.json binden Sie lokale MCP-Server **manuell** in Claude Desktop ein. Öffnen Sie dazu die Konfigurationsdatei, hinterlegen Sie den gewünschten Server im `mcpServers`-Objekt und starten Sie Claude Desktop anschließend vollständig neu.

Achten Sie auf eine **valide JSON-Syntax** und absolute Dateipfade. Vermeiden Sie abschließende Kommata am Ende von Objekten und Arrays (Trailing Commas). Übergeben Sie benötigte API-Schlüssel möglichst über sicher verwaltete Umgebungsvariablen oder eine geeignete Geheimnisverwaltung, statt sie ungeschützt in der JSON-Datei zu speichern.


This is a markdown version of: [https://www.ionos.at/digitalguide/server/konfiguration/claude-mcp/](https://www.ionos.at/digitalguide/server/konfiguration/claude-mcp/) for AI/LLM consumption.