Kontakt
(Leitfaden)

MCP-Server testenin ChatGPT und Claude

Aktualisiert · 4 Min. Lesezeit

Ein Server, der lokal läuft, funktioniert nicht automatisch in ChatGPT und Claude. Beide verbinden sich aus ihrer eigenen Cloud, melden den Nutzer per OAuth an und wählen die Tools selbst aus. Hier ist die Testreihenfolge, die wir bei jedem Server verwenden, und die Fehler, die dabei am häufigsten auftauchen.

Testreihenfolge

  • MCP Inspector auf Ihrem Rechner: Protokoll, Tools, Anmeldung.
  • Eine öffentliche HTTPS-URL per Tunnel, denn ChatGPT und claude.ai können sich nicht mit localhost verbinden.
  • Claude und ChatGPT: Wählt das Modell die richtigen Tools und versteht es die Antworten?
  • Vor der Einreichung in den Verzeichnissen: Testkonto, jedes Tool in einem neuen Chat, Fehlermeldungen.

MCP Inspector

Der Inspector ist das offizielle Werkzeug zum Testen von MCP-Servern. Sie starten ihn mit „npx @modelcontextprotocol/inspector“ und öffnen die ausgegebene URL samt Token im Browser. Einen entfernten Server geben Sie mit „--server-url https://ihre-domain/mcp --transport http“ an.

  • Tools, Ressourcen und Prompts: Sie rufen sie von Hand auf und sehen genau, was das Modell bekommt, einschließlich der Annotationen.
  • Anmeldung: Antwortet der Server mit 401, durchläuft der Inspector den OAuth-Ablauf selbst, mit Client-Registrierung per DCR oder CIMD.
  • Oberfläche: Der Tab Apps zeigt Ansichten nach MCP Apps in einer Sandbox an.
  • Rohe JSON-RPC-Nachrichten, HTTP-Header und Serverlogs.
  • Ein Modus „--cli“ für Skripte und CI, etwa um nach jedem Deployment die Tool-Liste zu prüfen.

Eine öffentliche URL

ChatGPT und claude.ai verbinden sich aus ihrer Cloud mit Ihrem Server, Sie brauchen also eine öffentliche HTTPS-URL. Für Tests eines lokalen Servers genügt ein Tunnel, zum Beispiel Cloudflare Tunnel oder ngrok. Claude-Connectors verbinden sich nur über IPv4.

Prüft Ihr Server den Host-Header (createMcpExpressApp aus dem TypeScript-SDK tut das), tragen Sie den Hostnamen des Tunnels bei den erlaubten Hosts ein. Sonst erhalten Sie den Fehler 403 „Invalid Host“. ChatGPT bietet außerdem Secure MCP Tunnel, um einen nicht öffentlichen Server anzubinden.

Claude

  • claude.ai: Customize > Connectors > Add custom connector. Im kostenlosen Plan ist ein eigener Connector möglich, in Pro und Max mehr.
  • In Team und Enterprise fügt ein Organisationsinhaber den Connector in den Organisationseinstellungen hinzu.
  • Name und URL eines Connectors lassen sich ändern, die Anmeldeeinstellungen nicht. Dafür entfernen Sie den Connector und fügen ihn neu hinzu.
  • Claude Code: „claude mcp add --transport http name url“, danach zeigt der Befehl /mcp den Status und startet die Anmeldung.
  • Limits in claude.ai und der Desktop-App: ein Tool-Ergebnis von bis zu etwa 150 000 Zeichen und 240 Sekunden pro Aufruf. Claude Code nimmt standardmäßig bis zu 25 000 Tokens an (Variable MAX_MCP_OUTPUT_TOKENS).

ChatGPT

  • Auf chatgpt.com/plugins wählen Sie +, dann Add custom MCP server. Geben Sie die URL einschließlich /mcp an, richten Sie die Anmeldung ein und erstellen Sie das Plugin. In einem neuen Chat tippen Sie @ und wählen es aus der Liste.
  • Eigene Server fügen Sie in der Webversion hinzu. Vollen Zugriff, auch auf datenändernde Tools, haben die Pläne Business, Enterprise und Edu (in Business nur Admins und Inhaber). In Pro funktionieren nur lesende Tools.
  • Nach jeder Änderung deployen Sie den Server, klicken auf der Plugin-Seite auf Refresh und testen in einem neuen Chat, denn ein alter kennt noch die vorherige Tool-Liste.

Oberfläche im Chat

ChatGPT und Claude unterstützen beide den offenen Standard MCP Apps, dieselbe Ansicht (Produktkarte, Warenkorb, Formular) funktioniert also in beiden. Testen Sie zwei Dinge getrennt: die Ansicht, die der Nutzer sieht, und das Textergebnis, das das Modell liest. Die Ansicht sollte ohne Fehler in der Konsole laufen und ihren Zustand wiederherstellen, wenn der Chat erneut geöffnet wird.

Die häufigsten Fehler

  • Eine 401-Antwort ohne WWW-Authenticate-Header mit Verweis auf die Ressourcen-Metadaten (/.well-known/oauth-protected-resource). Ohne ihn startet die Anmeldung nicht.
  • Kein PKCE mit der Methode S256. ChatGPT und Claude verlangen es beide.
  • Eine Weiterleitung auf einen anderen Host verliert den Authorization-Header und endet mit 401.
  • Eine Firewall oder ein CDN blockiert die Adressen von Anthropic. Sie sehen dann 403-Fehler, die Ihre Anwendung nie gesendet hat.
  • OAuth-Endpunkte brauchen länger als 10 Sekunden und die Verbindung bricht ab.
  • Zu strenge Prüfungen des Origin-Headers lehnen Anfragen von Claude ab.
  • Tools ohne Titel und ohne Annotation readOnlyHint oder destructiveHint. Das Verzeichnis von Claude nimmt sie nicht an. Alle Anforderungen finden Sie in unserer Checkliste zur Einreichung.
FAQ
Brauche ich für Tests in Claude einen bezahlten Plan?
Nein. Im kostenlosen Plan können Sie einen eigenen Connector hinzufügen. Für die Einreichung im Verzeichnis ist ein bezahlter Plan nötig.
Der Server läuft im Inspector, aber nicht in claude.ai. Warum?
Meist, weil sich der Inspector von Ihrem Rechner aus verbindet und claude.ai aus der Cloud von Anthropic. Prüfen Sie, ob die URL öffentlich und über IPv4 erreichbar ist, ob keine Firewall den Verkehr blockiert und ob der Server den Host des Tunnels akzeptiert.
Lassen sich die Tests automatisieren?
Ja. Der Inspector ruft im Modus „--cli“ Methoden wie tools/list und tools/call auf und liefert JSON, er passt also in eine CI-Pipeline. Wie das Modell Tools auswählt, müssen Sie trotzdem in echten Chats prüfen.
Leitfäden

Sie brauchen Hilfe mit einem MCP-Server?

MCP-Server

MACHEN WIRETWAS, DASIM KOPF→BLEIBT

Schreiben Sie uns