Claude Desktop MCP-Fehlerbehebung: Server wird nicht angezeigt

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 prüfen, JSON zu validieren, korrekt neu zu starten und zu bestätigen, dass der Server verfügbar ist.

Schnellreferenz Symptom → Lösung

Schritt 1: Speicherort der Konfigurationsdatei prüfen

Stellen Sie zuerst sicher, dass Sie die richtige Konfigurationsdatei bearbeiten. Der Speicherort hängt vom Betriebssystem ab:

macOS

Pfad zur Konfigurationsdatei:

~/Library/Application Support/Claude/claude_desktop_config.json

Zur Prüfung:

1. Finder öffnen
2. Cmd+Shift+G drücken
3. Einfügen: ~/Library/Application Support/Claude
4. Prüfen, ob claude_desktop_config.json existiert

Windows

Pfad zur Konfigurationsdatei:

%APPDATA%\Claude\claude_desktop_config.json

Zur Prüfung:

1. Win+R drücken
2. Eingeben: %APPDATA%\Claude
3. Enter drücken
4. Prüfen, ob claude_desktop_config.json existiert

Linux

Pfad zur Konfigurationsdatei:

~/.config/Claude/claude_desktop_config.json

Zur Prüfung:

1. Terminal öffnen
2. Ausführen: ls -la ~/.config/Claude/claude_desktop_config.json
3. Prüfen, ob die Datei existiert und lesbar ist

Datei existiert nicht?

Wenn die Konfigurationsdatei nicht existiert, erstellen Sie sie:

1. Bei Bedarf das Verzeichnis anlegen (z. B. ~/.config/Claude/ unter Linux)
2. claude_desktop_config.json anlegen
3. Mit {} beginnen
4. MCP-Server-Konfiguration hinzufügen

Schritt 2: JSON-Syntax validieren

Ungültiges JSON verhindert, dass Claude Desktop die Konfiguration lädt. Prüfen Sie auf häufige Fehler:

Häufige JSON-Fehler:

• Nachgestellte Kommas: Kein Komma nach dem letzten Element in einem Objekt oder Array
• Fehlende Anführungszeichen: Alle Schlüssel und Zeichenkettenwerte müssen in doppelten Anführungszeichen stehen
• Falsche Verschachtelung: Klammern und geschweifte Klammern müssen korrekt zusammengehören
• Kommentare: JSON unterstützt keine Kommentare (alle // oder /* */ entfernen)

Korrektes Konfigurationsformat

Ihre Konfiguration sollte so aussehen (ersetzen Sie YOUR_API_KEY durch Ihren echten Schlüssel):

{
  "mcpServers": {
    "corcava": {
      "url": "https://app.corcava.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

JSON online validieren

Nutzen Sie einen Online-JSON-Validator für die Syntaxprüfung:

1. Gesamten Inhalt Ihrer Konfigurationsdatei kopieren
2. In JSONLint oder einen ähnlichen Validator einfügen
3. Gemeldete Fehler beheben
4. Korrigierte Datei speichern

Schritt 3: API-Schlüssel prüfen

Stellen Sie sicher, dass Ihr API-Schlüssel korrekt und aktiv ist:

API-Schlüssel-Checkliste:

• ✅ Schlüssel korrekt kopiert (keine zusätzlichen Leerzeichen oder Zeilenumbrüche)
• ✅ Schlüssel enthält das Präfix "Bearer " (mit Leerzeichen) im Header
• ✅ Schlüssel ist in Corcava unter Einstellungen → Integrationen aktiv
• ✅ Schlüssel wurde nicht widerrufen oder ist abgelaufen
• ✅ Schlüssel hat die erforderlichen Berechtigungen

API-Schlüssel testen

Testen Sie den Endpunkt, um zu prüfen, ob Ihr API-Schlüssel funktioniert:

export CORCAVA_API_KEY="YOUR_API_KEY"
curl -H "Authorization: Bearer $CORCAVA_API_KEY" \
  https://app.corcava.com/mcp

Hinweis: Wenn Geheimnis-Scanner dieses Beispiel weiterhin melden, erwägen Sie, den Endpunkt einer Allowlist hinzuzufügen oder einen Test-API-Schlüssel nur für Dokumentationszwecke zu verwenden.

Bei einem 401 Unauthorized-Fehler siehe unsere 401-Fehlerbehebungsanleitung.

Schritt 4: Claude Desktop neu starten

Claude Desktop liest die Konfigurationsdatei nur beim Start. Nach Änderungen müssen Sie neu starten:

macOS

1. Claude Desktop vollständig beenden (Cmd+Q oder Rechtsklick auf Dock-Symbol → Beenden)
2. Einige Sekunden warten
3. Claude Desktop erneut öffnen
4. Prüfen, ob Corcava MCP in der Serverliste erscheint

Windows

1. Claude Desktop vollständig schließen (Systembereich prüfen)
2. Einige Sekunden warten
3. Claude Desktop erneut öffnen
4. Prüfen, ob Corcava MCP in der Serverliste erscheint

Linux

1. Claude Desktop vollständig beenden
2. Einige Sekunden warten
3. Claude Desktop erneut öffnen
4. Prüfen, ob Corcava MCP in der Serverliste erscheint

Nicht nur minimieren

Stellen Sie sicher, dass Sie Claude Desktop vollständig beenden, nicht nur minimieren. Unter einigen Systemen müssen Sie den Systembereich oder den Aktivitätsmonitor/Task-Manager prüfen, um sicherzugehen, dass die Anwendung vollständig geschlossen ist.

Schritt 5: Verifizierungsaufforderungen

Nach dem Neustart können Sie prüfen, ob der MCP-Server verfügbar ist, indem Sie Claude Desktop fragen:

Verifizierungsaufforderungen

Versuchen Sie diese Aufforderungen, um zu bestätigen, dass Corcava MCP funktioniert:

• "What MCP servers are available?"
• "List the available MCP tools"
• "Can you access Corcava tasks?"
• "Show me my Corcava projects"

Erwartete Antwort

Wenn Corcava MCP funktioniert, sollte Claude:

• Corcava als verfügbaren MCP-Server auflisten
• Verfügbare Tools wie list_tasks, create_task usw. anzeigen
• Tool-Aufrufe an Corcava ausführen können

Wenn Tools nicht erscheinen

Wenn der Server erscheint, aber die Tools nicht laden:

• Tools werden nicht aufgelistet prüfen
• Prüfen, ob Ihr API-Schlüssel die richtigen Berechtigungen hat
• Claude-Desktop-Protokolle auf Verbindungsfehler prüfen

Funktioniert immer noch nicht?

Wenn Sie alle obigen Schritte ausgeführt haben und Corcava MCP weiterhin nicht erscheint:

• Claude-Desktop-Protokolle auf Fehlermeldungen prüfen (Speicherort je nach OS unterschiedlich)
• Prüfen, ob Sie die neueste Version von Claude Desktop verwenden
• MCP-Server-Konfiguration entfernen und erneut hinzufügen
• Bei Netzwerkproblemen Verbindung fehlgeschlagen ansehen
• Bei Syntaxproblemen Konfigurations-JSON-Fehler prüfen

Verwandte Fehlerbehebung

• Konfigurations-JSON-Fehler – Ungültige JSON-Syntax und Schemafehler beheben
• Verbindung fehlgeschlagen – Netzwerk- und Verbindungsprobleme diagnostizieren
• Tools werden nicht aufgelistet – Probleme beheben, wenn Tools nicht erscheinen
• Fehlerbehebungs-Übersicht – Alle Fehlerbehebungsanleitungen durchsuchen