Client ID Metadata Documents: co to jest i jak działa w MCP

Wdrożenia produkcyjneProtokoły i integracjeOpublikowano Zaktualizowano Autor: Simon Budziak

Client ID Metadata Documents (CIMD) pozwalają klientowi OAuth używać adresu HTTPS jako identyfikatora klienta. Pod tym adresem znajduje się dokument JSON opisujący klienta, który serwer autoryzacji pobiera przy pierwszym kontakcie. Specyfikacja autoryzacji MCP zaleca ten mechanizm w typowej sytuacji, gdy klient trafia na nieznany sobie serwer, bez kroku rejestracji.

Jak działa Client ID Metadata Document?

Klient udostępnia plik JSON pod adresem HTTPS zawierającym ścieżkę i używa tego adresu jako swojego client_id. Zgodnie ze specyfikacją autoryzacji MCP dokument musi zawierać co najmniej client_id, client_name i redirect_uris, a jego client_id musi dokładnie odpowiadać adresowi URL (MCP client registration, 2026-07-28, dostęp 16 listopada 2026). Skrócony przykład ze specyfikacji:

{
  "client_id": "https://app.example.com/oauth/client-metadata.json",
  "client_name": "Example MCP Client",
  "redirect_uris": ["http://127.0.0.1:3000/callback"],
  "token_endpoint_auth_method": "none"
}

Serwer autoryzacji ogłasza client_id_metadata_document_supported: true w swoich metadanych OAuth. Gdy przychodzi żądanie autoryzacji z client_id w postaci adresu URL, serwer pobiera dokument, sprawdza, czy client_id się zgadza, czy adres przekierowania jest na liście i czy JSON jest poprawny, a potem pokazuje użytkownikowi ekran zgody z nazwą klienta. Serwer powinien buforować dokument zgodnie z nagłówkami cache HTTP. Tożsamością klienta jest to, co serwuje jego własna domena, więc żaden serwer nie przechowuje dla niego wpisu rejestracyjnego. Mówi to serwerowi, które oprogramowanie pyta, czyli odpowiada na pytanie o tożsamość agenta, a nie o to, co wolno mu robić.

Czym CIMD różni się od Dynamic Client Registration?

CIMD zastępuje wywołanie rejestracji pobraniem dokumentu; to jeden z trzech mechanizmów, które wymienia specyfikacja MCP:

Client ID Metadata Documents Dynamic Client Registration Rejestracja z wyprzedzeniem
Skąd pochodzi client_id Adres HTTPS hostowany przez klienta Wydaje go endpoint rejestracji serwera Wydany wcześniej, poza protokołem
Zmiana serwera autoryzacji Przenośny, bez ponownej rejestracji Wymaga ponownej rejestracji Związany z serwerem, który go wydał
Status w MCP 2026-07-28 Powinien być obsługiwany (SHOULD) Wycofywany (deprecated), może być obsługiwany (MAY) Powinna być dostępna taka opcja (SHOULD)

Klient, który obsługuje wszystkie trzy, powinien najpierw spróbować wcześniej zarejestrowanych danych, potem CIMD, jeśli serwer go ogłasza, następnie Dynamic Client Registration, jeśli serwer ma registration_endpoint, a na końcu zapytać użytkownika. CIMD trafił do MCP w rewizji 2025-11-25 jako mechanizm zalecany (changelog, dostęp 16 listopada 2026). Rewizja 2026-07-28, ta sama, która uczyniła MCP bezstanowym, oznaczyła Dynamic Client Registration jako wycofywany na rzecz CIMD, z możliwym usunięciem od pierwszej rewizji wydanej 28 lipca 2027 lub później (deprecated features, dostęp 16 listopada 2026). Nowi klienci i serwery autoryzacji powinni budować najpierw CIMD, a Dynamic Client Registration zostawić tylko dla starszych serwerów.

Jakie ryzyka bezpieczeństwa CIMD zostawia otwarte?

Serwer autoryzacji pobiera adres URL podany przez kogoś obcego. Każde pobranie CIMD to żądanie wychodzące wykonane w czyimś imieniu, dlatego specyfikacja odsyła serwery do wskazówek szkicu IETF dotyczących server-side request forgery (SSRF) (MCP security considerations, dostęp 16 listopada 2026). CIMD sam nie powstrzyma też lokalnej aplikacji przed podszyciem się pod klienta, którego adresy przekierowania wskazują na localhost, więc serwery powinny ostrzegać przy adresach przekierowania prowadzących wyłącznie na localhost i muszą pokazywać nazwę hosta z adresu przekierowania podczas autoryzacji. Specyfikacja MCP cytuje wersję szkicu -00, a szkic IETF doszedł już do -03, ostatnio zaktualizowanej 2 listopada 2026 i wciąż mającej status Internet-Draft (IETF datatracker, dostęp 16 listopada 2026), więc sprawdź, której rewizji trzyma się Twoja biblioteka do autoryzacji. Szerszą powierzchnię ataku opisuje tekst MCP security in production (po angielsku).

Jak w Soba Labs obsługujemy rejestrację klienta, gdy łączymy naszych agentów z serwerami MCP?

Nasi agenci łączą się ze zdalnymi serwerami MCP przez HTTP, każdy uwierzytelniony osobno dla danego konta, zwykle przez OAuth. Zanim ręcznie utworzymy klienta OAuth, próbujemy wbudowanego przepływu autoryzacji w kliencie. W jednym przypadku dostawca opisywał w dokumentacji tylko przepływy wymagające naszego własnego, wcześniej zarejestrowanego klienta, a zwykły wbudowany przepływ zadziałał bez niego, bo dokumentacja dostawców nie nadąża za serwerami. Co do zasady klient, który rejestruje się sam przez CIMD lub Dynamic Client Registration, nie potrzebuje niczego utworzonego z góry. Serwer uznajemy za gotowy do użycia dopiero po udanym prawdziwym wywołaniu narzędzia, bo raz klient zgłosił stan „connected”, a wywołania narzędzi z działającej sesji kończyły się błędem „Incompatible auth server”.

Napisane z pomocą AI i sprawdzone przez Simona Budziaka. Uwagi z produkcji pochodzą z systemów, które Soba Labs buduje i utrzymuje.

Najczęściej zadawane pytania

Czy serwery MCP działające przez stdio potrzebują Client ID Metadata Documents?

Nie. Autoryzacja w MCP jest opcjonalna i napisana dla transportów HTTP; specyfikacja 2026-07-28 mówi, że implementacje stdio nie powinny jej stosować, tylko pobierać dane uwierzytelniające ze środowiska.

Czy client_id w CIMD jest tajny?

Nie. To publiczny adres HTTPS, który każdy może pobrać. Klient, który musi się uwierzytelnić w endpoincie tokenów, może użyć private_key_jwt z opublikowanymi kluczami, na co pozwala strona specyfikacji MCP o rejestracji klientów.

Podsumuj tę stronę w

Przeszkol zespół, aby sam to zbudował