MCP-Server in Claude Desktop installieren (Schritt für Schritt)

So fügst du Claude Desktop einen MCP-Server hinzu: wo claude_desktop_config.json unter macOS und Windows liegt, Beispielkonfiguration und Fehlerbehebung.

Bevor du anfängst

Du brauchst die App Claude Desktop. Die meisten Server benötigen außerdem Node.js (für npx-Befehle) oder Python mit uv (für uvx-Befehle); was genau, steht in der README des Servers.

1. Konfigurationsdatei öffnen

Klicke in der Menüleiste deines Systems auf das Claude-Menü (nicht auf die Einstellungen im Chatfenster), wähle Settings… und öffne Developer → Edit Config. Dadurch öffnet sich claude_desktop_config.json. Unter macOS liegt sie unter ~/Library/Application Support/Claude/claude_desktop_config.json, unter Windows unter %APPDATA%\Claude\claude_desktop_config.json.

2. Server hinzufügen

Füge unter mcpServers einen Eintrag hinzu. Dieses Beispiel fügt den offiziellen Filesystem-Server mit Zugriff auf einen Ordner hinzu:

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

3. Neu starten und prüfen

Beende Claude Desktop vollständig und öffne es erneut. Klicke im Chatfeld auf Add files, connectors, and more, öffne Connectors → Manage connectors und wähle deinen Server, um seine Tools zu sehen. Wenn er sich nicht verbindet, sieh in die Logs (mcp.log und mcp-server-NAME.log) unter ~/Library/Logs/Claude (macOS) bzw. %APPDATA%\Claude\logs (Windows).

Tipps

Verwende absolute Pfade.
Lege API-Schlüssel in einem env-Objekt im Servereintrag ab.
Viele Serverseiten auf Socketlist zeigen eine fertige Konfiguration aus der README.