Claude Desktop reagiert nicht? Mein strukturierter Diagnose-Weg

Die Kurzantwort: Bevor Sie irgendetwas an der Konfiguration ändern, machen Sie drei Prüfungen. Logfile lesen, Anthropic-Status ansehen, Netzwerkpfad isolieren. Diese drei Schritte klären in meiner Praxis die große Mehrheit der Fälle in wenigen Minuten. Der teuerste Fehler bei Claude Desktop ist nicht das Problem selbst, sondern das planlose Herumschrauben an einer Konfiguration, die gar nicht die Ursache war.

Stand: August 2026. Claude Desktop ändert sich schnell, besonders bei der Connector-Oberfläche. Die Logpfade und Diagnoseschritte sind stabil, einzelne Menübezeichnungen können in Ihrer Version abweichen.

Kurzfassung im Video

Die drei Checks in 34 Sekunden

Wenn Sie gerade mitten im Problem stecken: Der Short zeigt die Reihenfolge — Logfile, Statusseite, Netzwerkpfad. Die Begründung zu jedem Schritt steht ausführlich weiter unten.

Auf YouTube ansehen ↗

Erst beim Klick wird eine Verbindung zu YouTube aufgebaut.

0:34

Das Wichtigste in Kürze

• Das Logfile beantwortet die Frage fast immer: und zwar das richtige: mcp.log für Verbindungsprobleme, mcp-server-NAME.log für einen einzelnen Server.
• Prüfen Sie zuerst, ob der Fehler überhaupt bei Ihnen liegt. Ein Blick auf status.anthropic.com kostet zehn Sekunden und spart im Ernstfall einen halben Tag.
• Im Firmennetz ist es fast immer das Netz, nicht die App: TLS-Inspection, authentifizierter Proxy, blockierte Hosts.
• Bei MCP-Servern sind drei Ursachen für fast alles verantwortlich: kaputtes JSON, relative statt absoluter Pfade, und Node beziehungsweise npx ist für die App nicht auffindbar.
• Neu installieren ist der letzte Schritt, nicht der erste. Wer zuerst neu installiert, verliert die Information, die im Log gestanden hätte.

Drei Diagnose-Schritte, bevor Sie etwas ändern

1. Das richtige Logfile öffnen

Claude Desktop schreibt seine Logs an einen festen Ort, je nach Betriebssystem:

• macOS: ~/Library/Logs/Claude
• Windows: %APPDATA%\Claude\logs
• Linux (Beta): ~/.config/Claude/logs

Wichtig ist die Unterscheidung, die viele übersehen: mcp.log enthält das allgemeine Protokoll über MCP-Verbindungen und gescheiterte Verbindungsversuche. Dateien nach dem Muster mcp-server-NAME.log enthalten dagegen die Ausgabe des jeweils benannten Servers. Wenn ein einzelner Server nicht läuft, steht die echte Fehlermeldung in seiner eigenen Datei, nicht in mcp.log.

Auf macOS und Linux verfolgen Sie beides live mit tail -n 50 -f ~/Library/Logs/Claude/mcp*.log. Unter Windows zeigt type "%APPDATA%\Claude\logs\mcp*.log" den bisherigen Inhalt an. Lassen Sie das Fenster offen und starten Sie Claude Desktop neu, dann sehen Sie den Fehler in dem Moment entstehen, in dem er passiert. Das ist deutlich aussagekräftiger, als hinterher in einer langen Datei zu suchen.

2. Prüfen, ob der Fehler überhaupt bei Ihnen liegt

status.anthropic.com zeigt Störungen an der API und an den Anwendungen. Wenn dort eine Störung läuft, hören Sie mit der Fehlersuche auf und warten Sie. Ich habe mehr als einmal erlebt, dass jemand eine funktionierende Konfiguration zerlegt hat, während der eigentliche Fehler zweitausend Kilometer entfernt in einem Rechenzentrum lag. Der Blick auf die Statusseite gehört deshalb an den Anfang und nicht ans Ende.

3. Den Netzwerkpfad isolieren

Hängen Sie das Gerät kurz an den Hotspot Ihres Telefons und starten Sie die App neu. Funktioniert sie dort, liegt das Problem im Firmennetz, an VPN, Proxy, Firewall oder TLS-Inspection. Funktioniert sie auch dort nicht, ist es lokal. Dieser eine Test halbiert den Suchraum und dauert zwei Minuten. Er ist der Grund, warum ich ihn vor jeder inhaltlichen Analyse mache.

Symptom-Index: was welches Fehlerbild bedeutet

Die folgende Tabelle deckt die Fehlerbilder ab, die mir in Projekten am häufigsten begegnen. Der erste Schritt ist jeweils der, mit dem ich tatsächlich anfange, nicht die vollständige Lösung, sondern der Griff, der die Ursache eingrenzt.

Wenn sich MCP-Server nicht verbinden

Das ist der Bereich, in dem ich die meiste Zeit verbringe, und der, in dem sich die Oberfläche zuletzt am stärksten verändert hat. Ältere Anleitungen sprechen vom „Hammer-Icon“, das die verfügbaren Werkzeuge anzeigt. In aktuellen Versionen finden Sie Ihre Server über die Schaltfläche für Anhänge und Connectors unten links im Eingabefeld und dort unter „Connectors verwalten“. Wenn eine Anleitung Sie ein Hammer-Symbol suchen lässt, das es nicht gibt, ist nicht Ihre Installation kaputt, sondern die Anleitung alt.

Die Konfigurationsdatei liegt auf macOS unter ~/Library/Application Support/Claude/claude_desktop_config.json und unter Windows unter %APPDATA%\Claude\claude_desktop_config.json. Sie erreichen sie am schnellsten über die Einstellungen im Entwickler-Bereich mit „Edit Config“. Wie ich die Datei aufbaue und welche Server bei mir dauerhaft im Einsatz sind, habe ich in MCP-Server für Claude Desktop konfigurieren beschrieben.

Wenn ein Server nicht auftaucht, arbeite ich diese Liste der Reihe nach ab:

1. JSON validieren. Ein einziges überzähliges Komma legt die gesamte Konfiguration lahm, nicht nur den betroffenen Server. Das erklärt das verwirrende Fehlerbild, bei dem plötzlich alle Server verschwunden sind, obwohl Sie nur einen angefasst haben.
2. Pfade absolut setzen. Relative Pfade funktionieren nicht, weil die App nicht aus dem Verzeichnis startet, aus dem Sie denken.
3. Die App vollständig beenden. Das Fenster zu schließen reicht nicht; die Konfiguration wird nur beim echten Start gelesen.
4. Den Server manuell im Terminal starten, mit exakt demselben Befehl und denselben Argumenten wie in der Konfiguration. Hier bekommen Sie die Fehlermeldung im Klartext, während sie in der App nur als stiller Ausfall sichtbar wird. Dieser Schritt spart mir mehr Zeit als jeder andere.
5. Node und npx prüfen. Viele Server laufen über Node. Wenn node --version im Terminal funktioniert, in der App aber nichts startet, findet die App die Installation nicht, sie erbt Ihre Shell-Umgebung nicht.

Ein Sonderfall verdient eine eigene Erwähnung, weil er unter Windows regelmäßig auftritt: Steht im Serverlog ein ENOENT-Fehler und taucht darin ${APPDATA} als unaufgelöster Text im Pfad auf, dann tragen Sie den ausgeschriebenen Wert in den env-Block der betroffenen Serverdefinition ein, also etwa "env": { "APPDATA": "C:\\Users\\ihrname\\AppData\\Roaming\\" }. Dazu muss npm global installiert sein, das erkennen Sie daran, ob das Verzeichnis %APPDATA%\npm existiert. Fehlt es, hilft npm install -g npm.

Was im Firmennetz häufig schiefläuft

TLS-Inspection. Lösungen wie Zscaler brechen den Datenverkehr auf und signieren ihn mit einem eigenen Zertifikat neu. Claude Desktop lehnt dieses Zertifikat ab, und der Fehler sieht für Anwender aus wie „die App geht nicht“. Es gibt zwei saubere Wege: die Anthropic-Hosts von der TLS-Inspection ausnehmen, oder das Wurzelzertifikat Ihres Proxys im System-Trust-Store hinterlegen, damit die App ihm vertraut. Welchen Weg Sie gehen, entscheidet Ihre Sicherheitsabteilung, nicht ich.

Authentifizierter Proxy. Hinterlegen Sie HTTPS_PROXY und HTTP_PROXY im Systemkontext, nicht nur in der Shell des angemeldeten Nutzers. Eine Desktop-Anwendung startet nicht aus Ihrer Shell und sieht deren Variablen nie. Genau deshalb läuft der Test im Terminal durch, während die App in Zeitüberschreitungen läuft, ein Widerspruch, der ohne diese Erklärung sehr lange rätselhaft bleibt.

Verteilung über Intune. Paketierte Installationen brauchen einen korrekten Detection-Pfad. Stimmt er nicht, meldet Intune Erfolg, und auf den Geräten passiert nichts. Prüfen Sie deshalb nicht den Verteilungsstatus, sondern ein echtes Gerät.

Wenn Sie ohnehin gerade klären, was im Unternehmen erlaubt ist und was nicht, gehört die Datenschutzseite gleich mit dazu, die habe ich in Claude Desktop im Unternehmen: Datenschutz und DSGVO in der Praxis aufgeschrieben.

Wenn nichts hilft: der saubere Neuaufsetz-Pfad

Neu installieren ist legitim, aber in dieser Reihenfolge, damit Sie nichts verlieren und hinterher wissen, was es war:

1. Konfiguration sichern. Kopieren Sie claude_desktop_config.json an einen sicheren Ort. Diese Datei ist Ihre Arbeit, alles andere ist ersetzbar.
2. Logs wegsichern. Ein Ordner mit den letzten Logdateien kostet nichts und ist das Einzige, was den Fehler später noch erklären kann.
3. App vollständig beenden und erst dann das Cache-Verzeichnis löschen.
4. Ohne Konfiguration starten. Benennen Sie die Konfigurationsdatei kurz um und starten Sie die App leer. Läuft sie jetzt, liegt der Fehler in der Konfiguration und nicht in der Installation, das ist die wichtigste Weiche im ganzen Ablauf.
5. Server einzeln zurückholen, statt die gesicherte Datei komplett zurückzukopieren. Nach spätestens drei Durchläufen wissen Sie, welcher Eintrag der Verursacher war.
6. Erst jetzt neu installieren, falls es immer noch klemmt. Unter Linux dabei über das Paket-Repository installieren statt über eine heruntergeladene .deb-Datei, sonst bekommen Sie keine Updates.

Wenn Sie bei diesem Punkt merken, dass die Installation von Anfang an unsauber war, ist ein Blick auf Claude Desktop installieren schneller als weiteres Reparieren.

Wann Sie aufhören sollten zu suchen

Es gibt Fehler, die nicht Ihre sind. Wenn das Log einen Serverfehler zeigt, die Statusseite eine Störung meldet oder ein Fehlerbild nach einem Update auf mehreren Geräten gleichzeitig auftritt, dann reparieren Sie nichts mehr, dann dokumentieren Sie. Ein Screenshot, die betroffene Version und die letzten Logzeilen sind alles, was der Anthropic-Support braucht, und sie ersparen Ihnen zwei Rückfragen.

Meine Faustregel aus der Praxis: Wer nach 30 Minuten strukturierter Suche keine Ursache gefunden hat, sucht meist an der falschen Stelle. Dann ist der Weg zurück zum Logfile richtig, oder der Weg zu jemandem, der dasselbe Fehlerbild schon einmal gesehen hat. Und wenn die Frage eigentlich lautet, ob Claude Desktop für Ihre Aufgabe überhaupt das richtige Werkzeug ist, klärt das Claude Desktop oder Claude Code schneller als jede Fehlersuche. Einen Überblick über alle Themen rund um die Anwendung finden Sie auf meiner Seite zu Claude Desktop.