MCP-Fehlerbehebungs-Index: Fehler, Lösungen und Quick-Links
Lösungen für häufige MCP-Probleme schnell finden. Dieser Index ordnet Probleme nach Symptom und verlinkt auf detaillierte Anleitungen. Zuerst die Kurz-Checkliste durchgehen, dann die passenden Lösungen nutzen.
Schnelle Fehlerbehebungs-Checkliste
Vor dem Einstieg in konkrete Themen diese Punkte prüfen:
Schnelle Diagnose-Schritte
- Konfigurationsdatei prüfen: Ist die MCP-Config gültiges JSON? Siehe Config-JSON-Fehler
- API-Key prüfen: Ist der API-Key aktiv und korrekt formatiert? Siehe 401 Nicht autorisiert
- Verbindung testen: Erreichen Sie den MCP-Server-Endpoint? Siehe Verbindung fehlgeschlagen
- Tool-Liste prüfen: Werden Tools im Client angezeigt? Siehe Tools werden nicht gelistet
- Client neu starten: Haben Sie den MCP-Client nach Config-Änderungen neu gestartet?
- Berechtigungen prüfen: Hat der API-Key die nötigen Rechte? Siehe 403 Forbidden
Fehlerbehebung nach Symptom
Verbindungsprobleme
Probleme bei der Verbindung zum MCP-Server:
Remote-MCP-Verbindung fehlgeschlagen
Netzwerk-, DNS-, Proxy-, TLS- und Firewall-Probleme bei der Verbindung zu Remote-MCP-Servern diagnostizieren.
Claude Desktop: Server wird nicht angezeigt
Beheben, wenn Corcava MCP in Claude Desktop nicht erscheint. Config-Checks, JSON-Validierung, Neustart.
Authentifizierungsprobleme
Probleme mit API-Keys und Autorisierung:
401 Nicht autorisiert
Fehlender Authorization-Header, falsches Bearer-Format, widerrufene Keys, Leerzeichen-Probleme beheben.
403 Forbidden
Berechtigungs- und Zugriffskontroll-Probleme. Konto-Zugriff, Scope, Workspace-Validierung.
Konfigurationsprobleme
Probleme mit MCP-Config-Dateien:
Config-JSON-Fehler
Ungültiges JSON, Schema-Fehler, Tippfehler, trailing commas, falsche Verschachtelung, Header-Format beheben.
Cursor: Änderungen werden nicht übernommen
Wenn Cursor Config-Änderungen nicht anwendet. Neustart, Config-Pfad, Server-Verifizierung.
Windsurf: Auth-Header werden nicht gesendet
Wenn Windsurf verbindet, Tool-Aufrufe aber wegen fehlender Auth-Header fehlschlagen.
Windows-Config-Pfade
MCP-Config-Dateien unter Windows finden und bearbeiten. Typische Orte und Tipps.
macOS-Config-Pfade
MCP-Config-Dateien unter macOS finden und bearbeiten. Typische Orte und Tipps.
Tools fehlen
MCP-Tools werden nicht angezeigt oder sind nicht verfügbar:
Tool-Aufruf-Fehler
Probleme beim Aufruf von MCP-Tools:
Performance-Probleme
Langsame Antworten, Timeouts und Rate Limiting:
Timeouts und langsame Antworten
Timeouts, lange Tool-Aufrufe, Retry-Muster. Kleinere Abfragen, Paginierung, weniger parallele Aufrufe.
429 Rate Limited
Rate Limiting handhaben. Ursachen, sicheres Retry/Backoff, Prompt-Muster zur Reduktion von Aufrufen.
Client-spezifische Probleme
Probleme mit bestimmten MCP-Clients:
Claude-Desktop-Probleme
Server erscheint nicht, Config-Pfad, JSON-Validierung, Neustart.
Cursor-Probleme
Änderungen nach Config-Bearbeitung werden nicht übernommen, Neustart/Reload.
Windsurf-Probleme
Auth-Header werden nicht gesendet, Verbindungsprobleme.
Continue-SSE-Probleme
Verbindungsabbrüche, Streaming-Fehler, Retries. Config-Validierung, Netzwerk/Proxy prüfen.
Immer noch Hilfe nötig?
Wenn Sie die Schritte oben durchgegangen sind und weiterhin Probleme haben:
- Für erweiterte Fehlersuche: MCP-Inspector-Guide
- Für Authentifizierungs-Best-Practices: MCP-Sicherheits-Guide
- Für client-spezifische Konfiguration: Client-Setup-Guides
- Support mit konkreten Fehlermeldungen und Diagnose-Infos kontaktieren
MCP-Setup zum Laufen bringen
Mit diesen Fehlerbehebungs-Guides Verbindung, Auth und Konfiguration beheben