MCP-Fehlerbehebung: Übersicht
Übersicht und Einstieg in die MCP-Fehlerbehebungsanleitungen. Hier finden Sie alle Anleitungen zur Diagnose und Behebung von Verbindungsproblemen, Authentifizierung, Tool-Aufrufen, Timeouts und plattformspezifischen Themen.
Anleitungen nach Thema
Einrichtung und Konfiguration
- Claude Desktop: Server wird nicht angezeigt – MCP erscheint nicht in Claude Desktop
- MCP-Konfigurations-JSON-Fehler – Häufige Fehler in der config beheben
- Remote-MCP-Verbindung fehlgeschlagen – Netzwerk, TLS und Proxys diagnostizieren
Authentifizierung und Berechtigungen
- 401 Unauthorized bei MCP – API-Schlüssel und Auth-Header-Probleme beheben
- 403 Forbidden bei MCP – Berechtigungen und Zugriffskontrolle beheben
Tools und Aufrufe
- Tools-Liste leer (tools/list) – Warum tools/list leer zurückgibt
- MCP-Tool-Aufrufe schlagen fehl – Eingaben, Validierung und Fehler-Payloads debuggen
Timeouts und Verbindungsstabilität
- MCP-Timeouts und langsame Antworten – Setup stabilisieren
- Continue MCP SSE-Probleme – Verbindungsabbrüche, Streaming und Retries
Editor-spezifisch
- Cursor: Änderungen werden nicht übernommen – Konfiguration nach Bearbeitung neu laden
- Windsurf: Auth-Header werden nicht gesendet – Windsurf MCP-Fehlerbehebung
Plattform: Konfigurationspfade
- Windows MCP-Konfigurationspfade – Richtige Datei finden und bearbeiten
- macOS MCP-Konfigurationspfade – Richtige Datei finden und bearbeiten
API-Limits und Sicherheit
- 429 Rate Limited bei MCP – Weniger Tool-Aufrufe und sicheres Retry
- Versehentliche Schreibzugriffe vermeiden – Bestätigungs-Prompts, die funktionieren
Schnellzuordnung Symptom → Anleitung
| Symptom | Anleitung |
|---|---|
| Server erscheint nicht (Claude Desktop) | Server wird nicht angezeigt |
| Ungültiges JSON / Konfigurationsfehler | Konfigurations-JSON-Fehler |
| Verbindung schlägt fehl | Verbindung fehlgeschlagen |
| 401 Unauthorized | 401 Unauthorized |
| 403 Forbidden | 403 Forbidden |
| Keine Tools sichtbar | Tools-Liste leer |
| Tool-Aufruf schlägt fehl | Tool-Aufrufe schlagen fehl |
| Timeouts / langsame Antworten | Timeouts |
| Continue: SSE-Probleme | Continue SSE-Probleme |
| Cursor übernimmt Konfiguration nicht | Cursor: Änderungen nicht übernommen |
| Windsurf: Auth-Probleme | Windsurf Auth |
| Windows: Konfigurationsdatei finden | Windows-Pfade |
| macOS: Konfigurationsdatei finden | macOS-Pfade |
| 429 Rate Limited | 429 Rate Limited |
| Ungewollte Schreibzugriffe | Writes-Safety |
Corcava MCP erscheint nicht in Claude Desktop? Diese Anleitung hilft bei der Diagnose und Behebung von Konfigurationsproblemen. Folgen Sie den Schritten, um den Speicherort der Konfigurationsdatei zu...
Ungültiges JSON in Ihrer MCP-Konfigurationsdatei verhindert das Laden der Server. Diese fehlerorientierte Anleitung zeigt, wie Sie häufige JSON-Syntaxfehler, Schemafehler und Formatierungsprobleme erk...
Keine Verbindung zum Remote-MCP-Server? Diese Anleitung hilft bei der Fehlerbehebung von Netzwerkproblemen, DNS-Fehlern, Unternehmens-Proxy-Konfiguration, TLS-Inspektion und Firewall-Regeln. Arbeiten...
401 Unauthorized beim Nutzen von MCP? Diese Anleitung hilft, Authentifizierungsprobleme zu beheben: fehlende Authorization-Header, falsches Bearer-Format, widerrufene API-Schlüssel und Leerzeichen-Pro...
403 Forbidden-Fehler? Ihr API-Schlüssel ist gültig, aber Sie haben keine Berechtigung für die angeforderte Aktion. Diese Anleitung erklärt Zugriffsprobleme auf Kontoebene, Scope-/Berechtigungs-Konflik...
MCP-Server verbindet, aber es erscheinen keine Tools? Diese Anleitung hilft, Fälle zu beheben, in denen tools/list leer zurückgibt. So diagnostizieren Sie stille Auth-Fehler bei bestehender Verbindung...
MCP-Tools werden angezeigt, aber Aufrufe schlagen fehl? Diese allgemeine Anleitung hilft beim Debuggen von Tool-Aufruf-Fehlern: ungültige Argumente, fehlende Pflichtfelder, falsche IDs und serverseiti...
Timeouts oder langsame MCP-Tool-Aufrufe? Diese Performance-Anleitung hilft, Timeout-Ursachen zu finden, lange laufende Operationen zu optimieren, Retry-Muster einzusetzen und Antwortzeiten durch Pagin...
Probleme mit der SSE-Verbindung von Continue zu Corcava MCP? Diese Continue-spezifische Anleitung hilft bei SSE-Trennungen, Streaming-Fehlern und Verbindungsproblemen. So validieren Sie Ihre Konfigura...
Cursor MCP-Konfiguration bearbeitet, aber die Änderungen greifen nicht? Diese Cursor-spezifische Anleitung hilft, wenn Konfigurations-Updates nicht angewendet werden. Neustart-/Reload-Anforderungen, V...
Windsurf verbindet mit Corcava MCP, aber Tool-Aufrufe schlagen fehl? Diese Windsurf-spezifische Anleitung hilft, wenn der Server verbindet, Tool-Aufrufe aber wegen fehlender Authorization-Header mit 4...
MCP-Konfiguration unter Windows finden oder bearbeiten? Diese Windows-spezifische Anleitung zeigt, wo jeder MCP-Client seine Konfigurationsdateien speichert, wie Sie sie sicher öffnen und bearbeiten u...
MCP-Konfiguration unter macOS finden oder bearbeiten? Diese macOS-spezifische Anleitung zeigt, wo jeder MCP-Client seine Konfigurationsdateien speichert, wie Sie sie mit Finder oder Terminal sicher öf...
429 Rate-Limit-Fehler vom MCP-Server? Diese Anleitung hilft, Rate Limiting zu verstehen, Ursachen zu finden (Bursts, Schleifen, große Listen), sicheres Retry/Backoff umzusetzen und Tool-Aufrufe durch...
Sorgen, dass Assistenten versehentlich Aufgaben erstellen, aktualisieren oder löschen? Diese Sicherheits-Anleitung bietet wiederverwendbare Prompt-Vorlagen, die vor jedem Schreib-Tool eine Vorschau un...