Corcava logoDas einzige Business-Tool, das Sie brauchenCorcava
Menü
Lösungen
Branchen
DesignerPersonal & RecruitingKanzleienImmobilienBeratungMarketing DigitalBuchhaltungE-CommerceSoftwareentwicklung
Produkt
FunktionenIntegrationen
BlogHerunterladen
Ressourcen
TemplatesDokuMCPFAQAPIVergleicheRoadmapNeues$ Partnerprogramm
Preise
14-tägige kostenlose Testversion

Keine Kreditkarte erforderlich

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

  1. Konfigurationsdatei prüfen: Ist Ihre MCP-Konfiguration gültiges JSON? Achten Sie auf fehlende Anführungszeichen oder Tippfehler.
  2. API-Schlüssel prüfen: Ist der API-Schlüssel korrekt kopiert, ohne Leerzeichen am Ende?
  3. Client neu starten: Die meisten Konfigurationsänderungen erfordern einen vollständigen Neustart (nicht nur Reload).
  4. Verbindung testen: Erreichen Sie api.corcava.com von Ihrem Rechner?
  5. 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