Wymagania
Host platformy
Dział zatytułowany „Host platformy”| Element | Wymaganie |
|---|---|
| System | Linux. Do testu na jednym komputerze: Docker Desktop na macOS lub Windows (zobacz Instalacja lokalna). |
| Docker | Docker Engine 26 lub nowszy z Compose v2.23 lub nowszym (pakiet montuje podścieżki wolumenów). Sprawdź: docker --version i docker compose version. |
| Pamięć | 8 GiB. Domyślne limity: gateway 2 GiB, Keycloak 2 GiB, broker 1 GiB, portal 1 GiB (zobacz Konfiguracja). |
| Dysk | 30 GB, na takim rozmiarze testujemy. Obrazy po załadowaniu zajmują około 1,5 GB. Instalacja offline potrzebuje dodatkowo około 1 GB na plik zip i drugie tyle na czas rozpakowania. Docker nie rotuje logów kontenerów, jeśli tego nie skonfigurujesz, więc zostaw na nie miejsce, tak jak na bazy danych. |
| CPU | 4 rdzenie, na takim rozmiarze testujemy. |
| Obrazy | Dostęp do ghcr.io/aiwcorpo, Docker Hub i quay.io, albo własny rejestr, albo pakiety offline. |
| Zegar | NTP na każdym hoście. Rozjechany zegar psuje tokeny i kody OTP. |
Hosty serwerów
Dział zatytułowany „Hosty serwerów”Serwer MCP działa na dowolnym hoście z Docker Engine i Compose v2.20 lub nowszym oraz 1 GiB pamięci. Hosty serwerów testujemy z 1-2 rdzeniami i 10 GB dysku; obraz jednego serwera ma około 190 MB. Serwer może działać także na hoście platformy. Zobacz Instalacja serwera MCP.
Platforma potrzebuje jednej nazwy, na przykład mcp.corp.test, wskazującej na host platformy. Ta sama nazwa obsługuje portal (/),
gateway (/mcp) i dostawcę tożsamości (/auth). Nazwa ma być zapisana małymi literami.
Każdy host serwera musi rozwiązywać tę nazwę na host platformy, bo serwer pobiera klucze publiczne gatewaya z
https://<platforma>/.well-known/mcp-jwks.json.
Certyfikaty
Dział zatytułowany „Certyfikaty”Plik w certs/ |
Zawartość | Wymagany |
|---|---|---|
tls.crt |
Łańcuch certyfikatów dla nazwy platformy. Certyfikat musi zawierać tę nazwę. | tak |
tls.key |
Klucz prywatny tego certyfikatu. | tak |
company-ca.crt |
Certyfikat lub certyfikaty CA, które podpisały tls.crt. |
tylko gdy CA nie jest publiczne |
Resztę (wewnętrzne CA, certyfikaty między komponentami, hasła, klucze) platforma generuje przy pierwszym starcie i trzyma w wolumenach Dockera. Serwery MCP nie potrzebują certyfikatu od platformy.
Porty i ścieżki sieciowe
Dział zatytułowany „Porty i ścieżki sieciowe”Na hoście platformy porty publikuje tylko nginx.
| Skąd | Dokąd | Port | Do czego |
|---|---|---|---|
| Użytkownicy, klienci AI | Host platformy | 443 (80 przekierowuje na https) | Portal, /mcp, /auth |
| Host serwera MCP | Host platformy | 443 | /.well-known/mcp-jwks.json, klucze publiczne gatewaya |
| Host platformy (gateway) | Host serwera MCP | domyślnie 8443 | Manifest, dane polityk, wywołania narzędzi |
| Host platformy (broker) | Systemy za brokerem (GitLab, Jira…) | 443 | Sprawdzanie tokenów i OAuth |
| Host serwera MCP | Jego system docelowy | 443 | API systemu |
Port 8443 na hoście serwera otwórz tylko dla hosta platformy. Poza tym nic nie przechodzi między hostami: nie ma certyfikatu klienta ani tokenu przekazywanego ręcznie.
Inne porty https lub http ustawisz przez MCP_HTTPS_PORT, MCP_HTTP_PORT i MCP_PUBLIC_ORIGIN w Konfiguracji.