Czym jest platforma MCP

Platforma daje klientom AI (Claude Code, Claude Desktop, claude.ai) dostęp do firmowych systemów, takich jak GitLab, Jira, Confluence, OpenSearch i service desk, przez jeden adres MCP. Użytkownicy logują się kontem firmowym. Przy każdym wywołaniu platforma sprawdza politykę, dodaje poświadczenie, które użytkownik połączył w portalu, prosi o jednorazowy kod przed operacją destrukcyjną i zapisuje ślad audytowy. Stacja robocza nigdy nie trzyma tokenu, który działa w systemach.

Kim jesteś	Zacznij od
Użytkownik klienta AI	Logowanie do portalu
Administrator, który zatwierdza serwery i obsługuje incydenty	Serwery
Operator, który instaluje i utrzymuje platformę	Wymagania
Autor serwera MCP	Szybki start dla autorów

Części

Część	Co robi
Gateway	Jedyny adres MCP (https://<platform>/mcp). Waliduje token użytkownika, decyduje, czy wywołanie jest dozwolone, bierze poświadczenie użytkownika z brokera, przekazuje wywołanie do serwera MCP i zapisuje zdarzenie audytu.
Credential broker	Przechowuje poświadczenia każdego użytkownika do każdego systemu w OpenBao. Obsługuje authenticator potwierdzający operacje destrukcyjne. Wie, jak zdobyć poświadczenie do produktu, dzięki adapterowi.
Portal	Strona WWW, na której użytkownicy łączą swoje konta, a administratorzy dodają i zatwierdzają systemy i serwery, edytują scope mapping i używają kill switcha.
Serwery MCP	Programy udostępniające narzędzia jednego systemu (GitLab, Jira, Confluence, OpenSearch, service desk albo własnego). Nie przechowują poświadczeń użytkowników.
Keycloak	Dostawca tożsamości. Loguje użytkowników (hasło i OTP) i wystawia tokeny, które sprawdzają pozostałe części.
OpenBao	Magazyn sekretów za brokerem. Dostęp ma tylko broker.
nginx	Reverse proxy przed całością: portal pod /, gateway pod /mcp, Keycloak pod /auth. Jedyna część, która publikuje porty (443 i 80).

Paczka platformy uruchamia gateway, broker, portal, Keycloaka, OpenBao i nginx jako jeden projekt Docker Compose. Serwery MCP to osobne programy, uruchamiane obok paczki albo na innym hoście, a dodawane w czasie działania w portalu.

Jak przechodzi wywołanie narzędzia

Przykład: użytkownik prosi Claude Code o listę projektów w GitLabie.

1. Claude Code wysyła tools/call na https://<platform>/mcp z tokenem Keycloaka użytkownika.
2. Gateway waliduje token, znajduje narzędzie i sprawdza politykę oraz grupy użytkownika (scope mapping). Jeśli narzędzie jest wyłączone albo niezatwierdzone, wywołanie kończy się tutaj.
3. Jeśli narzędzie jest destrukcyjne, gateway wstrzymuje wywołanie i prosi użytkownika o kod potwierdzenia z aplikacji authenticator.
4. Gateway prosi broker o poświadczenie użytkownika do GitLaba. Broker czyta je z OpenBao (token albo token OAuth, który użytkownik połączył w portalu).
5. Gateway przekazuje wywołanie do serwera MCP GitLaba razem z poświadczeniem. Gateway przypina certyfikat TLS serwera po odcisku (fingerprint), chyba że certyfikat łączy się z zaufanym CA.
6. Serwer woła API GitLaba własnym tokenem użytkownika, więc GitLab stosuje uprawnienia samego użytkownika.
7. Wynik wraca tą samą drogą. Gateway zapisuje zdarzenie audytu.

Systemy, które nie wymagają osobistego poświadczenia, używają innego typu: wymiany tokenu w Keycloaku (OpenSearch) albo klucza konta serwisowego trzymanego przez platformę. Zobacz słownik.

System i serwer

System to dane w brokerze poświadczeń: jak zdobyć poświadczenie do produktu (adapter, adres bazowy, typy poświadczeń). Serwer to program udostępniający narzędzia. Manifest serwera wskazuje jego system. Bez systemu użytkownicy nie mają czego połączyć, a wywołania narzędzi kończą się błędem. Zobacz Systemy i Serwery.