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”.