Prüfe, ob dein MCP-Server über Streamable HTTP antwortet — den Transport, den aktuelle Clients zuerst versuchen und von dem manche nicht mehr zurückfallen.
Wenn der Transport stimmt, bleibt das Problem, dass niemand sieht, was dein Server kann. MCP Showcase macht aus derselben URL ein Live-Playground mit Doku für jedes Tool.
Bei einem Streamable-HTTP-Server meist der Pfad, der auf /mcp endet.
Derselbe initialize-Aufruf, den Claude, Cursor und VS Code machen, über denselben Transport.
Protokollversion, Transport, Server-Identität und die vollständige Tool-Liste.
Streamable HTTP hat das ältere HTTP+SSE-Design mit zwei Endpunkten ersetzt: Ein Endpunkt bedient beide Richtungen und wechselt nur dann in einen Stream, wenn der Server etwas schicken muss. Das macht das Deployment hinter Proxys, CDNs und Load Balancern deutlich weniger sperrig — und es ist das, was Claude, Cursor und VS Code vor allem anderen versuchen.
Füge deinen Endpunkt oben ein: Wir führen denselben initialize-Handshake aus wie sie und melden dann, welcher Transport geantwortet hat und was ausgehandelt wurde.
Das ist eine wichtige Information, und dieser Tester nennt sie ausdrücklich, statt stillschweigend Erfolg zu melden. Ein reiner SSE-Server funktioniert weiterhin mit vielen Clients — aber neuere fallen zunehmend nicht mehr zurück, er kann also für einen Client unsichtbar sein, der MCP einwandfrei beherrscht. Das Symptom ist ein leerer Server, kein Fehler, und genau deshalb dauert die Diagnose so lange.
Dann ist der Transport in Ordnung und das Problem liegt darüber. Die übliche Ursache ist die
Authentifizierung: Ein Server, der auf eine nicht authentifizierte Anfrage mit
401 antwortet, arbeitet korrekt und sagt dir, dass er ein Token braucht. Das
Request-Log unter dem Ergebnis zeigt genau das. Der
Auth-Checker behandelt diesen Fall ausführlicher.
Wenn ein Client deinen Server erreicht, bleibt das Problem, dass niemand erkennen kann, was er tut. Eine Tool-Liste ist keine Vorführung, und ein Interessent installiert keinen Client, um es herauszufinden. MCP Showcase richtet sich auf dieselbe URL und erzeugt ein Live-Playground mit generierter Doku für jedes Tool — damit die Bewertung deines Servers einen Klick kostet.