pletzenauer — digital consulting

MCP-Server für Claude Desktop konfigurieren: was ich wirklich nutze

MCP ist der Steckdosen-Standard zwischen Claude Desktop und Ihren Werkzeugen. Statt zehn proprietärer Integrationen sprechen App und Tool über dasselbe Protokoll – und Sie binden Mail, Kalender oder Filesystem direkt an, statt per Copy-Paste.

Die Konfigurationsdatei verstehen

Eine einzige Datei steuert, welche Server Claude Desktop kennt: claude_desktop_config.json. Sie liegt auf macOS unter ~/Library/Application Support/Claude, auf Windows unter %APPDATA%Claude, auf Linux unter ~/.config/Claude.

Pro Server ein Eintrag mit Name, Befehl und Argumenten. Optional Umgebungsvariablen, optional ein anderer Transport. Nach jeder Änderung muss die App vollständig neu gestartet werden – auf macOS reicht das Schließen des Fensters nicht.

Vor dem Aktivieren ein JSON-Lint laufen lassen. Ein einzelnes fehlendes Komma bringt die komplette Server-Liste zum Verschwinden.

Sechs Server, mit denen ich am häufigsten starte

Filesystem-Server. Claude liest und schreibt in einem klar abgegrenzten Ordner. Nur auf einen explizit gewählten Pfad freischalten.

GitHub- oder GitLab-Server. Repository-Kontext, Pull-Requests, Issues – ein dedizierter Bot-Account mit minimalen Rechten ist dabei Pflicht.

Notion- oder Confluence-Server. Wissensdatenbank lesen und befüllen. Page-Berechtigungen vorher klären, sonst überschreibt Claude Bereiche.

Gmail- oder Outlook-Server. Postfach durchsuchen und Entwürfe ablegen. Read-only starten, Versand erst wenn die Spielregeln stehen.

Google-Drive- oder OneDrive-Server. PDFs zusammenfassen, Tabellen abfragen, Versionen vergleichen. Niemals den ganzen Drive freigeben.

JIRA- oder Linear-Server. Tickets als Kontext mitnehmen. Lese-Token bevorzugen, Schreiben nur für klar umrissene Aufgaben.

Wenn das Hammer-Icon leer bleibt

Vier Fehlerbilder machen in der Praxis 90 % der Fälle aus.

JSON-Syntaxfehler. Ein vergessenes Komma oder eine doppelte Klammer reicht. Vor dem Speichern in einen JSON-Linter werfen.

Falscher Pfad zur ausführbaren Datei. Absolute Pfade verwenden, nicht relative. Auf macOS und Linux Ausführungsrechte prüfen.

Fehlende Umgebungsvariablen. Tokens und Pfade gehören in den env-Block der Server-Konfiguration. Auf das Shell-Profile verlässt sich die App nicht.

Server hängt beim Start. Im Logfile prüfen, ob der Prozess auf eine Eingabe wartet. Häufige Ursache: ein interaktiver OAuth-Flow, der einmalig durchlaufen werden muss.

Häufige Fragen

Was ist MCP bei Claude Desktop?

MCP ist der gemeinsame Standard zwischen Claude Desktop und Ihren Werkzeugen. Statt vieler proprietärer Integrationen sprechen App und Tool über dasselbe Protokoll.

Welche Datei steuert die MCP-Server?

Die Datei claude_desktop_config.json. Pro Server ein Eintrag mit Name, Befehl und Argumenten. Nach jeder Änderung muss die App vollständig neu starten.

Warum verschwindet meine Server-Liste nach einer Änderung?

Meist wegen eines Syntaxfehlers in der JSON-Datei. Ein einzelnes fehlendes Komma reicht. Lassen Sie vor dem Aktivieren immer einen JSON-Lint laufen.

Welche MCP-Server sind ein guter Start?

Häufig Filesystem, GitHub oder GitLab, Notion oder Confluence sowie Gmail oder Outlook. Schalten Sie jeden Server nur mit minimalen Rechten und klar abgegrenztem Zugriff frei.