Kontakt
(Poradnik)

OAuth w serwerze MCP:logowanie w ChatGPT i Claude

Aktualizacja · 5 min czytania

Gdy narzędzia serwera MCP działają na koncie użytkownika, ChatGPT i Claude logują go przez OAuth 2.1. Specyfikacja jest wspólna, ale obie aplikacje mają własne wymagania, a w kilku miejscach zachowują się odwrotnie. Oto jak to działa w 2026 roku i na czym najczęściej się wykłada.

Jak przebiega logowanie

  • Aplikacja AI wywołuje serwer bez tokenu. Serwer odpowiada 401 z nagłówkiem WWW-Authenticate, który wskazuje adres metadanych zasobu (resource_metadata).
  • Metadane zasobu (RFC 9728, /.well-known/oauth-protected-resource) mówią, który serwer autoryzacji wydaje tokeny i jakie są zakresy.
  • Aplikacja pobiera metadane serwera autoryzacji (RFC 8414 albo OpenID Connect discovery) i rejestruje się jako klient.
  • Użytkownik loguje się na twojej stronie i zatwierdza dostęp. Aplikacja wymienia kod na token z PKCE i parametrem resource.
  • Każde kolejne wywołanie niesie token, a serwer MCP sprawdza, czy token został wydany właśnie dla niego.

Rejestracja klienta: CIMD zamiast DCR

Twój serwer autoryzacji musi jakoś poznać ChatGPT i Claude jako klientów. Są trzy sposoby: klient zarejestrowany ręcznie, Client ID Metadata Document (CIMD) i Dynamic Client Registration (DCR).

W CIMD identyfikatorem klienta jest adres URL dokumentu z jego danymi, np. https://chatgpt.com/oauth/client.json. Serwer autoryzacji pobiera ten dokument i nie musi nikogo rejestrować. W wersji specyfikacji MCP z 28 lipca 2026 DCR jest oznaczone jako przestarzałe i zostaje tylko dla zgodności wstecz. Przy DCR każde nowe połączenie tworzy nowego klienta, więc przy dużym ruchu z katalogów baza klientów szybko rośnie.

Wymagania wspólne dla obu

  • PKCE z metodą S256. Serwer autoryzacji musi ją ogłaszać w code_challenge_methods_supported. Bez tego pola klient zgodny ze specyfikacją przerywa logowanie.
  • Parametr resource (RFC 8707) w żądaniu autoryzacji i tokenu, ustawiony na kanoniczny adres serwera MCP bez ukośnika na końcu.
  • Serwer MCP sprawdza odbiorcę (audience) tokenu i odrzuca tokeny wydane dla innych usług.
  • Zakaz przekazywania tokenu dalej: serwer MCP nie wysyła tokenu z ChatGPT czy Claude do innych API. Do wywołań dalej ma własne poświadczenia.
  • Brak zakresu: odpowiedź 403 z error="insufficient_scope". Aplikacja loguje wtedy użytkownika ponownie z szerszym zakresem.
  • Parametr iss w odpowiedzi autoryzacji (RFC 9207), zgodny z issuerem w metadanych. ChatGPT bez niego odrzuca logowanie.

ChatGPT

  • Rejestracja: najpierw CIMD, DCR jako zapas. Klient ChatGPT uwierzytelnia się bez sekretu (none) albo przez private_key_jwt.
  • Adres powrotu: https://chatgpt.com/connector_platform_oauth_redirect. Dokładny adres dla twojego pluginu skopiuj ze strony zarządzania.
  • Jeśli metadane ogłaszają zakresy openid, email i profile, ChatGPT prosi o nie domyślnie, więc muszą być włączone dla klienta u dostawcy tożsamości.
  • Każde narzędzie deklaruje w securitySchemes, czy wymaga logowania (oauth2 z zakresami), czy nie (noauth). Oba wpisy naraz oznaczają logowanie opcjonalne.
  • Nie są obsługiwane client credentials, konta serwisowe ani klucze API. Bez logowania OpenAI zaleca udostępniać tylko odczyt.
  • ChatGPT łączy się z certyfikatem mTLS (mtls.prod.connectors.openai.com) i ze znanych zakresów IP, więc możesz ograniczyć ruch tylko do niego.

Claude

  • Rejestracja: domyślnie DCR albo CIMD. CIMD Claude wybiera tylko wtedy, gdy metadane mają client_id_metadata_document_supported: true i metodę none w token_endpoint_auth_methods_supported.
  • Adres powrotu: https://claude.ai/api/mcp/auth_callback dla claude.ai, aplikacji desktopowej, mobilnej i Cowork. Claude Code używa http://localhost/callback i http://127.0.0.1/callback na dowolnym porcie.
  • Claude bierze tylko pierwszy serwer z listy authorization_servers i dodaje offline_access, jeśli serwer autoryzacji go ogłasza.
  • Odświeża token po 401 i z wyprzedzeniem, do 5 minut przed wygaśnięciem. Martwy refresh token zwracaj jako invalid_grant.
  • Endpointy discovery, rejestracji i tokenu mają 10 sekund na odpowiedź, odświeżanie 30. Ruch przychodzi z zakresu 160.79.104.0/21, także do serwera autoryzacji.
  • Klient z danymi przechowywanymi przez Anthropic albo stały klucz w nagłówku to opcje na zgłoszenie (mcp-review@anthropic.com) albo w becie. Więcej o konektorach dla SaaS w osobnym poradniku.

Część narzędzi bez logowania

Wyszukiwarka produktów czy dokumentacja mogą działać bez konta, a zamówienia już nie. Obie aplikacje to obsługują, ale logowanie uruchamia się w nich odwrotnie.

  • ChatGPT: narzędzie zwraca wynik z isError: true i polem _meta["mcp/www_authenticate"]. Wtedy ChatGPT pokazuje przycisk logowania.
  • Claude: serwer musi odpowiedzieć HTTP 401, zanim żądanie dojdzie do SDK MCP. Odpowiedź 200 z isError nie uruchamia logowania.
  • Jeśli serwer ma działać w obu, obsłuż oba przypadki. Wcześniej sprawdź je w MCP Inspectorze i na tunelu.

Gotowy dostawca tożsamości

Nie musisz pisać serwera autoryzacji od zera. Auth0, Microsoft Entra, Keycloak czy Supabase działają z MCP, ale każdy ma swoje haczyki:

  • Wielu dostawców publikuje tylko /.well-known/openid-configuration. To wystarczy, jeśli dokument zawiera code_challenge_methods_supported.
  • Auth0: DCR jest domyślnie wyłączone, a na produkcję Auth0 zaleca CIMD.
  • Microsoft Entra: adres serwera MCP trzeba dodać jako Application ID URI na zweryfikowanej domenie, inaczej token kończy się błędem AADSTS9010010.
  • Keycloak: DCR działa, ale anonimową rejestrację ograniczają polityki zaufanych hostów, a odbiorcę tokenu trzeba dodać mapperem.
  • Jeśli dostawca nie obsługuje CIMD, DCR ani parametru resource, zostaje ręcznie zarejestrowany klient albo cienka warstwa pośrednia przed nim.

Najczęstsze błędy

  • Przekierowanie na inny host gubi nagłówek Authorization i kończy się 401.
  • Issuer w metadanych różni się od tego w tokenie albo w odpowiedzi.
  • Token wydany dla API, a nie dla serwera MCP, więc odbiorca się nie zgadza.
  • Endpoint tokenu przyjmuje tylko JSON, a klienci wysyłają application/x-www-form-urlencoded.
  • Firewall albo WAF blokuje ruch z chmury OpenAI lub Anthropic i zwraca 403 albo 429, których aplikacja nie wysłała.
  • Klient z DCR został usunięty po stronie dostawcy tożsamości i ChatGPT dostaje invalid_client.
FAQ
Czy mogę użyć klucza API zamiast OAuth?
W ChatGPT nie: obsługiwane jest OAuth albo brak logowania. W Claude stały klucz w nagłówku, wpisywany raz przez właściciela organizacji, jest w becie i nie jest dostępny dla wszystkich. Do narzędzi działających na koncie użytkownika planuj OAuth.
CIMD czy DCR?
Jeśli twój serwer autoryzacji obsługuje CIMD, wybierz CIMD: specyfikacja MCP oznaczyła DCR jako przestarzałe, a ChatGPT i Claude wolą CIMD. DCR zostaw jako zapas dla klientów, które CIMD jeszcze nie obsługują.
Czy serwer MCP może przekazać token użytkownika do mojego API?
Nie. Specyfikacja tego zabrania: token jest wydany dla serwera MCP. Do swojego API serwer woła z własnymi poświadczeniami albo wymienia token na nowy, wydany dla API, i dalej pilnuje uprawnień użytkownika.
Poradniki

Potrzebujesz serwera MCP z logowaniem?

Serwery MCP

ZRÓBMYCOŚ, COZOSTAJE→W GŁOWIE

Napisz do nas