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.
- 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.
- Integracja MCP: ERP, sklep i CRM w ChatGPT i Claude
- Strona kliniki medycyny estetycznej
- Rejestracja online dla prywatnej kliniki
- Asystent AI dla kliniki: co wolno w 2026
- Feed produktowy dla ChatGPT
- Reklama kliniki w 2026: co wolno na stronie i w sieci
- Twoja klinika w ChatGPT i Google
- Pacjenci z zagranicy: strona kliniki dla turystyki medycznej
- Konektory Claude: czym są i jak je dodać
- Serwer MCP w ChatGPT: jak go podłączyć
- WooCommerce w ChatGPT: jak połączyć sklep w 2026
- MCP Apps: interfejs w ChatGPT i Claude
- Bezpieczeństwo serwera MCP: co sprawdzić przed startem
- Jak przetestować serwer MCP w ChatGPT i Claude
- Serwer MCP czy API? Kiedy potrzebujesz obu
- Zlecenie projektu studiu z Polski
- Sklep na Shopify albo WooCommerce w ChatGPT
- Czym jest serwer MCP? Wyjaśnienie dla sklepów
- Konektor Claude dla SaaS: czego wymaga
- Jak sprzedawać w ChatGPT w 2026
- Serwer MCP, plugin ChatGPT czy konektor Claude?
- Jak trafić do katalogów ChatGPT i Claude
Potrzebujesz serwera MCP z logowaniem?
Serwery MCP