MCP-Tools werden nicht aufgelistet: Warum tools/list leer zurückgibt

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, falsche Serverauswahl, Client-Caching und wann Neustarts nötig sind.

Was „Tools werden nicht aufgelistet“ bedeutet

Wenn tools/list leer zurückgibt, hat Ihr MCP-Client sich zwar mit dem Server verbunden, der Server liefert aber keine Tools. Das unterscheidet sich von Verbindungsfehlern – die Verbindung funktioniert, die Tool-Erkennung schlägt fehl.

Häufige Ursachen

Authentifizierungsfehler bei bestehender Verbindung (stille Auth-Fehler)
Falscher Server ausgewählt oder konfiguriert
Client cached alte Tool-Liste
Client nach Konfigurationsänderungen nicht neu gestartet
Server noch nicht vollständig initialisiert

Schritt 1: Authentifizierung prüfen

Manche MCP-Clients verbinden sich auch bei fehlgeschlagener Authentifizierung, liefern dann aber eine leere Tool-Liste:

Stille Auth-Fehler

Verbindung vs. Authentifizierung

Einige Clients bauen auch bei ungültigen API-Schlüsseln eine Verbindung auf; der Server gibt dann eine leere Tool-Liste zurück, weil die Authentifizierung fehlgeschlagen ist.

Lösung: Prüfen, ob Ihr API-Schlüssel korrekt und aktiv ist (siehe 401 Unauthorized)

Authentifizierung testen

Prüfen Sie mit einem direkten Test, ob Ihr API-Schlüssel funktioniert:

Test mit curl

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

Bei 401 Unauthorized ist Ihr API-Schlüssel ungültig. Bei Tools oder 200 OK funktioniert die Authentifizierung.

Schritt 2: Serverauswahl prüfen

Stellen Sie sicher, dass der richtige MCP-Server ausgewählt und konfiguriert ist:

Server-Konfiguration prüfen

In Ihrer MCP-Konfiguration prüfen:

Servername entspricht dem Erwarteten (z. B. "corcava")
URL ist korrekt: https://app.corcava.com/mcp
Authorization-Header ist korrekt formatiert
Keine Tippfehler im Servernamen oder in der Konfiguration

Konfiguration mit mehreren Servern

Bei mehreren konfigurierten MCP-Servern prüfen Sie, ob der richtige aktiv ist:

Korrekte Multi-Server-Konfiguration

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

Sicherstellen, dass "corcava" aufgeführt und korrekt konfiguriert ist.

Schritt 3: Client-Cache leeren

MCP-Clients cachen oft Tool-Listen. Cache leeren, um eine neue Tool-Erkennung zu erzwingen:

Cache leeren je nach Client

Claude Desktop

Claude Desktop vollständig beenden
Cache leeren (Speicherort je nach OS unterschiedlich)
Claude Desktop neu starten
Prüfen, ob Tools erscheinen

Cache-Speicherorte:

macOS: ~/Library/Caches/Claude/
Windows: %APPDATA%\Claude\Cache\
Linux: ~/.cache/claude/

Cursor

Cursor vollständig schließen
Cursor-Cache/-Speicher leeren
Cursor neu starten
Fenster neu laden (Cmd/Ctrl+Shift+P → "Reload Window")

Windsurf

Windsurf vollständig schließen
Anwendungs-Cache leeren
Windsurf neu starten
MCP-Server-Status prüfen

Continue

Continue-Erweiterung neu starten
SSE-Verbindungs-Cache leeren
Erneut mit MCP-Server verbinden
Prüfen, ob Tools erscheinen

Schritt 4: MCP-Client neu starten

MCP-Clients erkennen Tools nur beim Start. Nach Konfigurationsänderungen ist ein vollständiger Neustart nötig:

Anforderungen an den Neustart

Vollständiges Beenden nötig: Nicht nur minimieren oder Fenster schließen
Einige Sekunden warten: Prozess vollständig beenden lassen
Systembereich prüfen: Sicherstellen, dass keine Hintergrundprozesse laufen
Anwendung neu öffnen: Frisch starten, damit die Konfiguration geladen wird

Prüfen, ob der Neustart gewirkt hat

Nach dem Neustart prüfen, ob Tools verfügbar sind:

Tool-Verfügbarkeit prüfen:

MCP-Server in der Serverliste des Clients suchen
Prüfen, ob Tools in den verfügbaren Tools aufgeführt sind
Einen minimalen Test-Prompt ausprobieren (siehe unten)

Schritt 5: Minimaler Test-Prompt

Nutzen Sie diesen minimalen Test-Prompt, um zu prüfen, ob Tools verfügbar sind:

Minimale Test-Prompts

"What MCP tools are available?" – Sollte mindestens ein Corcava-Tool auflisten
"List available MCP tools" – Sollte Tools wie list_tasks, get_task usw. anzeigen
"Show me my Corcava projects" – Sollte list_projects aufrufen und Ergebnisse liefern

Erwartete Antwort

Wenn die Tools funktionieren, sollten Sie sehen:

Liste verfügbarer Tools (list_tasks, get_task, create_task usw.)
Tool-Beschreibungen oder -Funktionen
Möglichkeit, Tools tatsächlich aufzurufen und Ergebnisse zu erhalten

Wenn der Test-Prompt fehlschlägt

Wenn der Test-Prompt nicht funktioniert:

Tools sind möglicherweise noch nicht geladen (Neustart-Schritte oben prüfen)
Authentifizierung schlägt möglicherweise still fehl (siehe Schritt 1)
Server ist möglicherweise falsch ausgewählt (siehe Schritt 2)

Schritt 6: Server-Initialisierung prüfen

Manchmal braucht der Server Zeit zur Initialisierung oder hat Probleme:

Server-Gesundheitsprüfung

Server-Endpunkt testen

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

Sollte eine Tool-Liste oder gültige Antwort liefern. Bei Fehler oder leerer Antwort kann der Server Probleme haben.

Warten und erneut versuchen

Initialisierungsverzögerung

Nach dem Neustart des Clients einige Sekunden warten, bis die MCP-Server-Verbindung vollständig steht, bevor Sie Tools testen.

Schnell-Checkliste

Systematische Fehlerbehebung

✅ API-Schlüssel mit curl getestet – werden Tools zurückgegeben?
✅ Servername und URL in der Konfigurationsdatei geprüft
✅ Client-Cache geleert (falls zutreffend)
✅ MCP-Client vollständig beendet und neu gestartet
✅ Nach dem Neustart einige Sekunden gewartet
✅ Minimalen Test-Prompt ausprobiert – erscheinen Tools?
✅ Client-Protokolle auf Fehlermeldungen geprüft

Client-spezifische Probleme

Claude Desktop

Wenn in Claude Desktop keine Tools erscheinen:

Claude-Desktop-Fehlerbehebung ansehen
Konfigurationsdatei-Speicherort und JSON-Gültigkeit prüfen
Claude-Desktop-Protokolle auf Fehler prüfen

Cursor

Wenn in Cursor keine Tools erscheinen:

Cursor-Fehlerbehebung ansehen
Nach Konfigurationsänderungen Fenster neu laden
Cursor-MCP-Einstellungen prüfen

Continue

Wenn in Continue keine Tools erscheinen:

Continue-SSE-Fehlerbehebung ansehen
Prüfen, ob SSE-Verbindung steht
Continue-Erweiterungs-Protokolle prüfen

Immer noch nicht in Ordnung?

Wenn Sie alle Schritte durchgeführt haben und die Tools weiterhin nicht erscheinen:

Client-spezifische Fehlerbehebungsanleitungen prüfen (Links oben)
401 Unauthorized bei Auth-Problemen ansehen
Client-Protokolle auf konkrete Fehlermeldungen prüfen
Einen neuen API-Schlüssel anlegen und damit testen