Kontakt
(Leitfaden)

OAuth für MCP-Server:Anmeldung in ChatGPT und Claude

Aktualisiert · 5 Min. Lesezeit

Wenn die Tools eines MCP-Servers im Konto eines Nutzers arbeiten, melden ChatGPT und Claude diesen Nutzer per OAuth 2.1 an. Die Spezifikation ist gemeinsam, aber beide Apps haben eigene Anforderungen und verhalten sich an einigen Stellen genau umgekehrt. So funktioniert es 2026, und hier scheitert es am häufigsten.

So läuft die Anmeldung ab

  • Die KI-App ruft den Server ohne Token auf. Der Server antwortet mit 401 und einem WWW-Authenticate-Header, der auf seine Ressourcen-Metadaten (resource_metadata) verweist.
  • Die Ressourcen-Metadaten (RFC 9728, /.well-known/oauth-protected-resource) nennen den Autorisierungsserver, der Tokens ausstellt, und die verfügbaren Scopes.
  • Die App lädt die Metadaten des Autorisierungsservers (RFC 8414 oder OpenID Connect Discovery) und registriert sich als Client.
  • Der Nutzer meldet sich auf Ihrer Website an und gibt den Zugriff frei. Die App tauscht den Code mit PKCE und dem resource-Parameter gegen ein Token.
  • Jeder weitere Aufruf trägt das Token, und der MCP-Server prüft, ob das Token genau für ihn ausgestellt wurde.

Client-Registrierung: CIMD statt DCR

Ihr Autorisierungsserver muss ChatGPT und Claude als Clients kennen. Dafür gibt es drei Wege: einen manuell registrierten Client, ein Client ID Metadata Document (CIMD) und Dynamic Client Registration (DCR).

Bei CIMD ist die Client-ID die URL eines Dokuments mit den Daten des Clients, zum Beispiel https://chatgpt.com/oauth/client.json. Der Autorisierungsserver lädt dieses Dokument und muss niemanden registrieren. Die Version der MCP-Spezifikation vom 28. Juli 2026 erklärt DCR für veraltet und behält es nur für die Abwärtskompatibilität. Mit DCR erzeugt jede neue Verbindung einen neuen Client, bei viel Verkehr aus den Verzeichnissen wächst die Client-Liste also schnell.

Was beide verlangen

  • PKCE mit der Methode S256. Der Autorisierungsserver muss sie in code_challenge_methods_supported angeben. Fehlt das Feld, bricht ein spezifikationskonformer Client die Anmeldung ab.
  • Den resource-Parameter (RFC 8707) in der Autorisierungs- und der Token-Anfrage, gesetzt auf die kanonische URL des MCP-Servers ohne Schrägstrich am Ende.
  • Der MCP-Server prüft die Audience des Tokens und lehnt Tokens ab, die für andere Dienste ausgestellt wurden.
  • Keine Token-Weitergabe: Der MCP-Server schickt das Token aus ChatGPT oder Claude nicht an andere APIs weiter. Für weitere Aufrufe nutzt er eigene Zugangsdaten.
  • Fehlender Scope: eine 403-Antwort mit error="insufficient_scope". Die App meldet den Nutzer dann mit dem erweiterten Scope erneut an.
  • Der Parameter iss in der Autorisierungsantwort (RFC 9207), passend zum Issuer in den Metadaten. Ohne ihn lehnt ChatGPT die Anmeldung ab.

ChatGPT

  • Registrierung: zuerst CIMD, DCR als Rückfallebene. Der ChatGPT-Client authentifiziert sich ohne Secret (none) oder mit private_key_jwt.
  • Redirect-URI: https://chatgpt.com/connector_platform_oauth_redirect. Die genaue URI für Ihr Plugin kopieren Sie von dessen Verwaltungsseite.
  • Wenn Ihre Metadaten die Scopes openid, email und profile anbieten, fordert ChatGPT sie standardmäßig an. Sie müssen also für den Client bei Ihrem Identitätsanbieter aktiviert sein.
  • Jedes Tool gibt in securitySchemes an, ob es eine Anmeldung braucht (oauth2 mit Scopes) oder nicht (noauth). Beide Einträge zusammen bedeuten eine optionale Anmeldung.
  • Client Credentials, Service-Accounts und API-Schlüssel werden nicht unterstützt. Ohne Anmeldung empfiehlt OpenAI nur lesende Tools.
  • ChatGPT verbindet sich mit einem mTLS-Zertifikat (mtls.prod.connectors.openai.com) und aus veröffentlichten IP-Bereichen, Sie können den Zugriff also auf ChatGPT beschränken.

Claude

  • Registrierung: standardmäßig DCR oder CIMD. CIMD wählt Claude nur, wenn die Metadaten client_id_metadata_document_supported: true und die Methode none in token_endpoint_auth_methods_supported enthalten.
  • Redirect-URI: https://claude.ai/api/mcp/auth_callback für claude.ai, die Desktop- und Mobile-Apps und Cowork. Claude Code nutzt http://localhost/callback und http://127.0.0.1/callback auf beliebigem Port.
  • Claude verwendet nur den ersten Server aus authorization_servers und fügt offline_access hinzu, wenn der Autorisierungsserver ihn anbietet.
  • Tokens werden nach einem 401 und vorausschauend erneuert, bis zu 5 Minuten vor Ablauf. Ein ungültiges Refresh-Token beantworten Sie mit invalid_grant.
  • Discovery-, Registrierungs- und Token-Endpunkte haben 10 Sekunden Zeit, das Erneuern 30. Der Verkehr kommt aus 160.79.104.0/21, auch zum Autorisierungsserver.
  • Ein Client, dessen Zugangsdaten Anthropic verwahrt, oder ein fester Schlüssel im Header sind auf Anfrage (mcp-review@anthropic.com) oder in der Beta verfügbar. Mehr zu Connectors für SaaS in einem eigenen Leitfaden.

Einige Tools ohne Anmeldung

Eine Produktsuche oder Dokumentation kann ohne Konto funktionieren, Bestellungen nicht. Beide Apps unterstützen das, starten die Anmeldung aber auf entgegengesetzte Weise.

  • ChatGPT: Das Tool liefert ein Ergebnis mit isError: true und dem Feld _meta["mcp/www_authenticate"]. ChatGPT zeigt dann einen Anmeldebutton.
  • Claude: Der Server muss mit HTTP 401 antworten, bevor die Anfrage das MCP-SDK erreicht. Eine 200-Antwort mit isError startet keine Anmeldung.
  • Soll der Server in beiden laufen, behandeln Sie beide Fälle. Prüfen Sie sie vorher im MCP Inspector und über einen Tunnel.

Ein vorhandener Identitätsanbieter

Sie müssen keinen Autorisierungsserver von Grund auf schreiben. Auth0, Microsoft Entra, Keycloak und Supabase funktionieren mit MCP, aber jeder hat seine Tücken:

  • Viele Anbieter veröffentlichen nur /.well-known/openid-configuration. Das reicht, solange das Dokument code_challenge_methods_supported enthält.
  • Auth0: DCR ist standardmäßig deaktiviert, und für die Produktion empfiehlt Auth0 CIMD.
  • Microsoft Entra: Die URL des MCP-Servers muss als Application ID URI auf einer verifizierten Domain eingetragen sein, sonst scheitert die Token-Anfrage mit AADSTS9010010.
  • Keycloak: DCR funktioniert, aber Trusted-Host-Richtlinien schränken die anonyme Registrierung ein, und die Token-Audience braucht einen Mapper.
  • Unterstützt ein Anbieter weder CIMD noch DCR noch den resource-Parameter, bleibt ein manuell registrierter Client oder eine schlanke Zwischenschicht davor.

Die häufigsten Fehler

  • Eine Weiterleitung auf einen anderen Host verliert den Authorization-Header und endet mit 401.
  • Der Issuer in den Metadaten weicht von dem im Token oder in der Antwort ab.
  • Das Token wurde für die API ausgestellt, nicht für den MCP-Server, die Audience passt also nicht.
  • Der Token-Endpunkt akzeptiert nur JSON, die Clients senden aber application/x-www-form-urlencoded.
  • Eine Firewall oder WAF blockiert den Verkehr aus der Cloud von OpenAI oder Anthropic und liefert 403- oder 429-Fehler, die Ihre App nie gesendet hat.
  • Ein DCR-Client wurde beim Identitätsanbieter gelöscht, und ChatGPT bekommt invalid_client.
FAQ
Kann ich einen API-Schlüssel statt OAuth verwenden?
In ChatGPT nicht: Unterstützt werden OAuth oder keine Anmeldung. In Claude ist ein fester Schlüssel im Header, den ein Organisations-Owner einmal einträgt, in der Beta und nicht für alle verfügbar. Für Tools, die im Konto eines Nutzers arbeiten, planen Sie OAuth ein.
CIMD oder DCR?
Wenn Ihr Autorisierungsserver CIMD unterstützt, wählen Sie CIMD: Die MCP-Spezifikation hat DCR für veraltet erklärt, und ChatGPT wie Claude bevorzugen CIMD. Behalten Sie DCR als Rückfallebene für Clients, die CIMD noch nicht unterstützen.
Darf der MCP-Server das Token des Nutzers an meine API weitergeben?
Nein. Die Spezifikation verbietet es: Das Token ist für den MCP-Server ausgestellt. Der Server ruft Ihre API mit eigenen Zugangsdaten auf oder tauscht das Token gegen ein neues, für die API ausgestelltes, und setzt die Berechtigungen des Nutzers weiter durch.
Leitfäden

Brauchen Sie einen MCP-Server mit Anmeldung?

MCP-Server

MACHEN WIRETWAS, DASIM KOPF→BLEIBT

Schreiben Sie uns