MCP-Fehlerbehebung: Häufige Probleme und Fehler beheben
MCP-Verbindungs-, Authentifizierungs-, Konfigurations- und Tool-Aufruf-Probleme lösen. Dieser Hub ordnet Lösungen nach Symptom mit Schritt-für-Schritt-Anleitungen für die häufigsten Fälle.
Kurze Diagnose-Checkliste
Hier starten, bevor Sie in konkrete Themen einsteigen:
Erste Schritte
- Konfigurationsdatei prüfen: Ist Ihre MCP-Konfiguration gültiges JSON? Achten Sie auf fehlende Anführungszeichen oder Tippfehler.
- API-Schlüssel prüfen: Ist der API-Schlüssel korrekt kopiert, ohne Leerzeichen am Ende?
- Client neu starten: Die meisten Konfigurationsänderungen erfordern einen vollständigen Neustart (nicht nur Reload).
- Verbindung testen: Erreichen Sie api.corcava.com von Ihrem Rechner?
- Berechtigungen prüfen: Hat Ihr API-Schlüssel den nötigen Zugriff?
Fehlerbehebung nach Symptom
Verbindungsprobleme
Probleme bei der Verbindung zum MCP-Server:
Verbindung fehlgeschlagen
Netzwerk-, DNS-, Proxy-, TLS- und Firewall-Probleme.
Server wird nicht angezeigt (Claude)
Lösung, wenn Corcava MCP in Claude Desktop nicht erscheint.
Timeouts
Langsame Antworten, große Payloads und Timeout-Fehler.
Authentifizierungsprobleme
Probleme mit API-Schlüsseln und Autorisierung:
401 Nicht autorisiert
Fehlender Authorization-Header, falsches Bearer-Format, widerrufene Schlüssel.
403 Forbidden
Berechtigungs- und Zugriffskontroll-Probleme, Scope-Abweichungen.
Konfigurationsprobleme
Probleme mit MCP-Konfigurationsdateien:
Ungültiges Config-JSON
JSON-Syntaxfehler, falsche Verschachtelung.
Cursor-Änderungen werden nicht übernommen
Lösung, wenn Cursor Konfigurationsänderungen nicht anwendet.
Windsurf Auth-Header
Windsurf verbindet, aber Tool-Aufrufe schlagen wegen fehlender Auth fehl.
Windows-Konfigurationspfade
MCP-Konfigurationsdateien unter Windows finden und bearbeiten.
macOS-Konfigurationspfade
MCP-Konfigurationsdateien unter macOS finden und bearbeiten.
Tool-Aufruf-Fehler
MCP-Tools schlagen fehl, wenn Sie sie nutzen wollen:
Tools werden nicht angezeigt
Behebung, wenn tools/list leer ist oder Tools nicht erscheinen.
Tool-Aufruf schlägt fehl
Ungültige Argumente, falsche IDs, Validierungsfehler.
Performance-Probleme
Rate-Limits und Performance-Probleme:
429 Rate Limited
Rate-Limit-Fehler und Wiederholungsstrategien.
Timeouts
Langsame Antworten und Timeout-Lösungen.
Client-spezifische Probleme
Claude Desktop
Server wird nicht angezeigt, Speicherort der Konfigurationsdatei.
Cursor
Konfigurationsänderungen werden nicht übernommen, Reload-Probleme.
Windsurf
Auth-Header werden nicht gesendet, Verbindungsprobleme.
Continue
SSE-Stream-Fehler, Verbindungsabbrüche.
Weitere Ressourcen
- Vollständige Fehlerbehebungs-Übersicht – Alle Fehlerbehebungsanleitungen an einem Ort
- MCP-Debugging-Checkliste – Systematischer Debugging-Workflow
- Quickstart-Guide – Von Grund auf mit korrekter Einrichtung starten
- Client-Einrichtungsanleitungen – client-spezifische Konfigurationsanweisungen