Szybki start

To najkrótsza ścieżka. Każdy krok odsyła do strony ze szczegółami.

Zanim zaczniesz

• Host z Linuksem, Docker Engine 26 lub nowszy, Compose v2.23 lub nowszy i 8 GiB pamięci (zobacz Wymagania).
• Nazwa DNS platformy i certyfikat dla niej. Żeby wypróbować platformę na jednym komputerze bez domeny, użyj mcp.localhost i zamiast kroków 1-3 postępuj według Instalacji lokalnej.

Zainstaluj platformę

1. Umieść łańcuch certyfikatu w certs/tls.crt, a klucz w certs/tls.key. Jeśli Twoje CA nie jest publiczne, umieść jego certyfikat w certs/company-ca.crt.

2. Skopiuj plik środowiskowy i ustaw domenę:

   cp platform.env .env
   # edytuj .env: MCP_DOMAIN=<platform>

3. Uruchom platformę:

   docker compose up -d
   docker compose logs init

   Ostatnia linia logu init to ok configuration, certificates and secrets are in place. Pierwszy start trwa kilka minut.

4. Odczytaj początkowe hasło administratora mcp-admin:

   docker compose run --rm init show admin-password

5. Otwórz https://<platform>/auth/realms/mcp/account, zaloguj się jako mcp-admin, ustaw nowe hasło i zarejestruj OTP w aplikacji authenticator. Potem otwórz https://<platform>/, czyli portal.

Pełna procedura, certyfikaty i kontrola: Instalacja platformy.

Dodaj jeden serwer MCP

1. Uruchom serwer z katalogu deploy/ jego repozytorium albo jako usługę paczki. Zobacz Instalacja serwerów MCP.
2. W portalu otwórz Administracja, Systemy i dodaj system serwera (adapter, adres bazowy, typ poświadczenia). Zobacz Systemy.
3. Otwórz Administracja, Serwery, wybierz “Dodaj serwer” i wpisz adres serwera. Gateway pobiera manifest, a serwer pojawia się jako oczekujący na zatwierdzenie.
4. Zatwierdź połączenie (fingerprint), potem polityki, potem każde narzędzie. Każdy krok wymaga świeżego logowania z OTP. Zobacz Serwery.
5. Otwórz Administracja, Scope mapping i przypisz grupy użytkownika do zasobów systemu. Zobacz Dostęp.

Połącz Claude Code

1. W portalu, jako użytkownik, połącz swoje konto w systemie (Połączenia). Zobacz Jak połączyć konto.

2. Otwórz stronę portalu “Adres MCP” i skopiuj polecenie claude mcp add, które pokazuje. Wygląda tak:

   claude mcp add --transport http platform "https://<platform>/mcp"

3. Uruchom claude, wpisz /mcp, wybierz serwer i wybierz Authenticate. Zaloguj się w przeglądarce.

4. Poproś Claude Code o listę narzędzi serwera albo sprawdź /mcp.

Jeśli CA platformy nie jest publiczne, uruchom Claude Code z NODE_EXTRA_CA_CERTS=<ścieżka pliku CA>. Więcej: Claude Code.

Jeśli narzędzia się nie pojawiają, zobacz Rozwiązywanie problemów. Gateway 2.0.0 nie pokazywał narzędzi w Claude Code; użyj 2.0.1 lub nowszego.