Claude Code MCP Logs: Finde die erste fehlgeschlagene Grenze

Wenn du nach Claude Code MCP Logs suchst , beginne mit dem aufgelösten Serverzustand und erziele dann eine Incident Scoped Debug Datei. Beginnen Sie nicht damit, das Claude Desktop Log Verzeichnis zu folgen: Die aktuelle MCP Dokumentation beschriftet diese Dateisystempfade speziell für den Desktop, während Claude Code Dokumente /mcp , claude mcp list , claude debug mcp und debug file verwenden. Das nützliche Ergebnis ist nicht "ein Protokoll finden". Es dient dazu, die erste fehlerhafte Grenze zu identifizieren: Konfiguration, Projektgenehmigung, Prozessstart, Werkzeugentdeckung, Werkzeugausführung oder das externe Ergebnis, das das Tool eigentlich erzeugen sollte. Ein Logbuch kann eine Grenze erklären. Es kann nicht alle sechs beweisen. Dieser Leitfaden verwendet die aktuelle Claude Code Dokumentation und die npm Release 2.1.220 , geprüft am 30. Juli 2026. Pinne deine installierte Version bei jedem Vorfall, denn MCP Verhalten und Diagnosen ändern sich weiterhin. Inspektiere den aufgelösten Zustand, bevor du die rohe Ausgabe liest Führen Sie diese Prüfungen aus demselben Arbeitsverzeichnis und Benutzerkonto durch, die das Problem aufwiesen: Innerhalb der betroffenen Claude Code Sitzung laufen Sie: Die Offizieller Konfigurations Debugging Leitfaden Es steht, /mcp konfigurierte Server, Verbindungsstatus und Projektgenehmigung anzeigen. Die MCP Referenz fügt zwei operative Details hinzu, die wichtig sind: Ein projektbezogener .mcp.json Server kann ausstehend bleiben, bis der Arbeitsbereich vertrauenswürdig ist und der Server genehmigt ist; Ein verbundener Server kann immer noch keine Tools offenstellen, und /mcp Berichte, die zählen. Diese Fakten schließen drei Klassen der Blindlog Suche aus: Gelöste Beweise Erste Entscheidung Warum Logs nicht an erster Stelle stehen Server fehlt CONFIG MISSING Es gibt noch keinen geladenen Serverprozess, den man diagnostizieren könnte. Überprüfe den Umfang und die Einstellungsquellen. Ausstehende Genehmigung APPROVAL WAIT Das ist eine legitime Autoritätsgrenze, kein Crash. Überprüfen und genehmigen Sie es interaktiv. Verbindung fehlgeschlagen Erfassung MCP Debug Beweise Der Befehl, Pfad, die Umgebung, die Authentifizierung oder der Transport könnten fehlgeschlagen haben. Verbunden, keine Werkzeuge Verbinden Sie sich wieder, dann erfassen Sie MCP Debugging Beweise Der Start war weit genug erfolgreich, um sich zu verbinden, aber die Entdeckung lieferte keine brauchbare Registrierung. Verbunden, vorhandene Werkzeuge Reproduzieren Sie einen beschränkten Aufruf Die Verbindungs Gesundheit sagt nichts über das ausgewählte Werkzeug oder dessen externe Wirkung aus. Relative Pfade verdienen besonderen Verdacht bei lokalen STDIO Servern. Claude Code Dokumente, die command und args Pfade auflösen, werden aus dem Verzeichnis aufgelöst, in dem Claude Code gestartet wurde, nicht vom Standort der .mcp.json . Ein Server kann daher in einem Repository arbeiten und von einem anderen mit identischem Konfigurationstext ausfallen. Erfassen Sie eine Scoped Claude Code MCP Debug Datei Die aktuelle Claude Code CLI Referenz Dokumentiert zwei relevante Flaggen: debug aktiviert den Debug Modus und akzeptiert Kategorienfilter wie mcp ; debug file <path schreibt Debug Ausgaben auf einen expliziten Pfad und aktiviert implizit den Debug Modus. Erstellen Sie ein privates Vorfallverzeichnis, starten Sie eine neue Sitzung mit nur der MCP Debug Kategorie und reproduzieren Sie ein begrenztes Symptom: Inspizieren Sie in dieser Sitzung /mcp . Wenn ein Server ohne Werkzeuge verbunden ist, nutze seine Aktion Wiederverbinden einmal. Wenn Werkzeuge vorhanden sind, rufen Sie nur das kleinste schreibgeschützte Werkzeug auf, das das Problem reproduziert. Versuchen Sie keinen schreibfähigen Aufruf erneut, nur um das Log interessanter zu machen. Behandle die Debug Datei als empfindlich. Es kann absolute Pfade, Servernamen, Umgebungsdetails, Anfragemetadaten oder Server STDERR enthalten. Trage abgeleitete Beweise im Vorfallbeleg auf und bewahre oder lösche dann die Rohdatei gemäß deiner Sicherheitsrichtlinie. Kopieren Sie keine Zugriffstoken, Prompt Bodys, Werkzeugargumente, Ergebnisse oder STDERR Text in ein Überwachungssystem, nur weil die Datei sie enthält. Eine Öffentlichkeit Claude Code Feature Anfrage für Logdateien pro MCP Server meldet, dass Nutzer Desktop ähnliche persistente Dateien für Claude Code wünschen. Dieses Problem ist ein nützlicher Grenzbeweis, keine Produktgarantie. Das unterstützte Incident Verfahren sollte auf der dokumentierten expliziten Debug Datei basieren und nicht auf einem angenommenen Standardpfad pro Server. Gleiche den Beweisweg mit dem Transport ab Die MCP Debugging Leitfaden für Protokollrevision 2026 07 28 zieht eine entscheidende Transportgrenze. Für einen lokalen stdio Server überträgt Stdout Protokollnachrichten. Server Diagnostik gehört auf stderr; Das Schreiben von Diagnosetext in Stdout kann den Protokollstrom beschädigen. Claude Code Fehlerbehebungsanleitung empfiehlt ausdrücklich claude debug mcp , wenn ein verbundener Server null Tools bereitstellt, da dies Server Stderr im Debug Nachweis verfügbar macht. Für Streamable HTTP kann der Client das STDERR des entfernten Serverprozesses nicht erfassen. Eine Claude Code Debug Datei kann weiterhin clientseitige Verbindungen und Anfragen anzeigen, aber der interne Serverausfall benötigt serverseitige Protokolle oder OpenTelemetry plus HTTP Inspektion. Ein leeres Client Debug Segment ist kein Beweis dafür, dass der entfernte Dienst nichts getan hat. Diese Unterscheidung verhindert eine häufige falsche Schlussfolgerung: Vermerk den Transport auf der Quittung. Ohne sie ist "no stderr" mehrdeutig. Erstellen Sie einen content minimierten Vorfall Empfang Das Rohprotokoll ist ein Beweis für die Untersuchung. Die Quittung ist die dauerhafte Gesundheitsakte. Es kann nützlich bleiben, ohne Inhalte zu speichern: Halte die Klassifikatorprädenz explizit: Ich habe diese Regel gegen acht synthetische Fälle wiederholt. Er trennte fehlerhafte Konfiguration, Genehmigungswarten, erfassten Startfehler, connected zero tools, Werkzeugfehler, erfolgreiche Tool Antwort ohne Ergebnis, bestätigtes Ergebnis und eine fehlgeschlagene Verbindung mit unzureichendem Debug Nachweis korrekt. Alle acht erwarteten Bundesstaaten wurden angenommen. Die letzten beiden Fälle sind die wichtige Grenze. Ein JSON RPC Erfolgs oder Fehlerfrei Tool Ergebnis ist der Aktivitätsnachweis. Wenn die Aufgabe ein erstelltes Problem, einen geänderten Datensatz, eine zugestellte Datei oder eine aktualisierte Zieladresse versprochen hat, überprüfen Sie dieses Ziel separat. Ohne diese Quittung ist der richtige Zustand OUTCOME UNVERIFIED , nicht gesund. Wählen Sie die kleinste sichere nächste Aktion Jeder Zustand sollte zu einer begrenzten Antwort führen: CONFIG MISSING : Inspektiere den Einstellungsumfang und die genaue Datei Claude Code geladen. Ändere den Servercode nicht. APPROVAL WAIT : Leite die Genehmigung an den verantwortungsvollen Menschen weiter. Beschreiben Sie das Warten nicht als Unfall. STARTUP FAILED : Repariere die erste Betonstart Ursache im Scoped Debug Beweis und verbinde dich dann einmal wieder. DISCOVERY EMPTY : Initialisierung und Werkzeugliste Beweise vergleichen; Teste den Server bei Bedarf unabhängig mit MCP Inspector. TOOL CALL FAILED : Erhalte die Anforderungsidentität, prüfe, ob ein erneuter Versuch sicher ist, und vermeide es, einen unsicheren Schreib erneut abzuspielen. OUTCOME UNVERIFIED : Abfrage des Ziels nach stabiler Kennung. Führe das Tool nicht erneut aus, bevor du weißt, ob der Effekt bereits eingetreten ist. UNCERTAIN : Sammle die fehlenden Grenzbeweise oder eskaliere. Unbekannt ist ein operativer Zustand, keine Einladung zum Raten. HEALTHY : Erfordern sowohl eine brauchbare MCP Kette als auch eine frische, deterministische Ergebnisquittung. Logs machen einen Fehler erklärbar. Der gelöste Status macht es lokalisiert. Eine Zielquittung macht die Rückgewinnung verifizierbar. Hält man diese Aufgaben getrennt, wird ein Claude Code MCP Vorfall zu einer kurzen Beweisübung statt zu einer Abfolge immer riskanterer Rücktritte. Sidewisp basiert auf dieser gesundheitsorientierten Unterscheidung zwischen Verbindung, nützlichem Fortschritt, Werkzeugen und Ergebnissen. Sidewisp befindet sich derzeit in einer privaten Vorschauphase. Die Produktionsüberwachungsadapter und der Wiederherstellungs Executor werden in der Regel nicht ausgeliefert.