Jak dodać i zatwierdzić serwer MCP

Gateway łączy się z serwerem MCP przez jego adres i pobiera manifest spod /.well-known/mcp-manifest. Serwery dodajesz w portalu w trakcie działania, bez restartu. Nowy serwer nie ma narzędzi dla nikogo, dopóki nie zatwierdzisz trzech rzeczy: jego połączenia, jego polityk i definicji każdego narzędzia.

Potrzebujesz grupy mcp-platform-admin. Zanim zaczniesz, dodaj system, którego serwer używa (zobacz Jak dodać i zarządzać systemami), i uruchom serwer (zobacz Instalacja serwerów MCP).

Dodaj serwer

1. Otwórz Administracja, Serwery i wybierz Dodaj serwer.
2. Wpisz Adres punktu końcowego MCP, na przykład https://<host-serwera>:8443/mcp. Działa dowolny host z dowolnym certyfikatem HTTPS. Identyfikator serwera (mcp-<system>) i system gateway bierze z manifestu.
3. Opcjonalnie wpisz System. Jeśli to pole zostanie wypełnione, gateway odmówi dodania serwera, którego manifest podaje inny system. Wypełnij je, gdy możesz: bez niego serwer może podać system, w którym użytkownicy mają już poświadczenia.
4. Jeśli adres zaczyna się od http://, zaznacz Zezwól na zwykły HTTP. Używaj tego tylko dla serwera w tej samej sieci Dockera co gateway: zwykły HTTP wysyła poświadczenia użytkowników bez szyfrowania. Bez tej opcji gateway odrzuca adres http (plain_http_not_allowed).
5. Wybierz Zapisz. Jeśli portal o to poprosi, potwierdź tożsamość u dostawcy tożsamości i zapisz jeszcze raz.

Gateway sprawdza adres, odczytuje certyfikat uzgadnianiem TLS, pobiera manifest i pokazuje serwer ze stanem połączenia Czeka na zatwierdzenie. Odrzuca adres, który wskazuje loopback, adresy link-local, nieokreślone, multicast albo adresy metadanych chmury, teraz i przed każdym połączeniem. Zakresy prywatne są dozwolone. Aby odrzucać więcej zakresów, ustaw MCP_SERVER_REFUSED_ADDRESSES (zobacz Konfiguracja).

Jeśli dodanie się nie uda, portal pokazuje powód:

Powód	Znaczenie
address_refused	Host wskazuje odrzucany zakres
plain_http_not_allowed	Adres http bez opcji Zezwól na zwykły HTTP
tls_handshake_failed	Nie udało się uzgodnić TLS z adresem
manifest_unreachable	Brak odpowiedzi 200 z /.well-known/mcp-manifest
manifest_invalid	Manifest nie przeszedł kontroli gatewaya
system_mismatch	Manifest podaje inny system niż wpisany przez Ciebie
system_reserved	System z manifestu to zarezerwowany identyfikator
namespace_conflict	Inny serwer jest już właścicielem przestrzeni nazw jego polityk

Lista serwerów

Kolumna Połączenie pokazuje stan łącza z serwerem:

Stan	Znaczenie	Co zrobić
Czeka na zatwierdzenie	Połączenie nigdy nie zostało zatwierdzone. Narzędzia są ukryte, cokolwiek jeszcze zatwierdzono	Zatwierdź połączenie (niżej)
Połączony	Połączenie jest zatwierdzone, a ostatnie sprawdzenie się udało	Nic
Niedostępny	Połączenie jest zatwierdzone, ale ostatnie sprawdzenie nie połączyło się. Wywołania są odrzucane jako upstream_unavailable	Sprawdź adres, port i log serwera. Szczegóły pokazują ostatni błąd
Certyfikat zmieniony	Serwer przedstawia inny certyfikat niż zatwierdzony. Wywołania są odrzucane, dopóki nie zatwierdzisz nowego	Porównaj nowy odcisk i zatwierdź go (niżej)
Manifest nieprawidłowy	Serwer jest połączony, ale ostatni manifest nie przeszedł kontroli. Gateway zachowuje poprzedni manifest	Popraw manifest na serwerze, potem wybierz Odśwież w Szczegóły

Obok stanu mogą się pojawić znaczniki Przypięty certyfikat, HTTP bez szyfrowania i Certyfikat zmieniony. Kolumna Stan pokazuje Włączony albo Wyłączony.

Przycisk	Skutek
Szczegóły	Adres, status, ostatnie sprawdzenie, ostatni błąd i zatwierdzone połączenie. Odśwież sprawdza serwer jeszcze raz i pobiera jego manifest. Niczego nie zatwierdza i nie wymaga MFA
Edytuj	Zmienia przyjmowane typy poświadczeń, używany typ, to, czy serwer wymaga poświadczenia użytkownika, oraz Włączony. Adresu nie można zmienić: usuń serwer i dodaj go ponownie
Wyłącz	Wyłącza narzędzia z użycia. Nie wymaga świeżego MFA, a inne zmiany serwera wymagają
Usuń	Usuwa serwer. Jego narzędzia znikają z katalogu i z tools/list, wywołania są odrzucane, a wpisy mapowania zakresów jego typów zasobów są usuwane. System i połączenia użytkowników zostają. Wymaga świeżego MFA

Zatwierdź połączenie

Oczekujące połączenie pojawia się na górze ekranu Administracja, Zatwierdzenia, w karcie Połączenie serwera z nazwą serwera. Wiersz Połączenia czekające na zatwierdzenie pokazuje, ile ich czeka.

1. Przeczytaj System podany przez serwer. Serwer sam podaje swój system w manifeście, a gateway wysyła temu serwerowi poświadczenia użytkowników do tego systemu. Zatwierdź tylko wtedy, gdy to system, który chciano dodać.
2. Porównaj Odcisk SHA-256 z tym, który serwer zapisuje w swoim logu (wiersz z event=tls_certificate i fingerprint=sha256:...). Wybierz Kopiuj, aby go skopiować. Przeczytaj też Podmiot, Wystawca, Nazwy (SAN) i Ważny do.
3. Przeczytaj Waliduje się jako certyfikat zaufanego CA. Jeśli widzisz Nie: można go tylko przypiąć, certyfikat nie łączy się z CA, któremu gateway ufa dla tego hosta, i jedynym trybem jest przypięty certyfikat.
4. Gdy karta daje wybór w Jak gateway ma ufać temu serwerowi, wybierz tryb:
   • Zaufane CA (łańcuch i nazwa hosta): odnowiony certyfikat nie wymaga zatwierdzenia.
   • Przypięty certyfikat: przyjmowany jest dokładnie ten certyfikat. Nowy trzeba zatwierdzić tutaj ponownie.
5. Wybierz Zatwierdź połączenie. Wymaga świeżego MFA.

Gateway przypina certyfikat przez skrót SHA-256 jego kodowania DER. Aby w trybie Zaufane CA ufać firmowemu CA, wpisz jego certyfikat w MCP_SERVER_TRUSTED_CAS w gatewayu (zobacz Konfiguracja). Certyfikat musi też zawierać nazwę hosta z adresu serwera.

Gdy przypięty serwer przedstawi później inny certyfikat, stan zmienia się na Certyfikat zmieniony i wywołania są odrzucane. Pojawia się karta z nowym odciskiem i wierszem Dotąd zatwierdzone ze starym. Upewnij się u właściciela serwera, że certyfikat wymieniono celowo, i dopiero zatwierdź.

Zatwierdzenie połączenia nie zatwierdza ani polityk, ani narzędzi. Czekają niżej na tym samym ekranie.

Zatwierdź polityki

Każdy serwer przynosi polityki Cedar i deklaracje typów zasobów (typów, których używasz w mapowaniu zakresów). Po pierwszym pobraniu i po każdej późniejszej zmianie jednego z nich serwer pokazuje Polityki i typy zasobów czekają na zatwierdzenie. Jego narzędzia pozostają zablokowane do czasu zatwierdzenia.

1. W Zatwierdzenia znajdź serwer i wybierz Pokaż różnice w wierszu Polityki i typy zasobów czekają na zatwierdzenie.
2. Przeczytaj Typy zasobów oraz Polityki i schemat. Lewa strona to Zatwierdzone, prawa to Oczekujące, a zmienione linie są oznaczone. Przy pierwszej rejestracji lewa strona jest pusta.
3. Jeśli źródło to Źródło: serwer, przeczytaj każdą politykę i deklarację ze szczególną uwagą: tę wersję podał działający serwer i nikt nie sprawdził jej w kodzie.
4. Wybierz Zatwierdź polityki. Wymaga świeżego MFA. Brak zatwierdzenia niczego, co dziś działa, nie psuje: narzędzia serwera pozostają zablokowane.

Jeśli zatwierdzenie unieważni wpisy mapowania zakresów, portal je wypisze, a ocena pomija je, dopóki nie poprawisz mapowania.

Zatwierdź narzędzia

Narzędzie jest widoczne i wywoływalne dopiero, gdy zatwierdzone są połączenie, polityki i definicja narzędzia. Gateway pobiera manifest co najmniej co 60 sekund i niczego, co pobierze, nie zatwierdza, także narzędzi do odczytu. Zmieniona definicja ponownie czyni narzędzie oczekującym i ukrywa je przed agentami (definition_changed).

Lista pokazuje dla każdego serwera wersję, Zmiany (na przykład nowe: 1, zmienione: 1) i Stan (Do zatwierdzenia, Aktywny, Wyłączony albo Wyłączony awaryjnie). Otwórz serwer, aby zobaczyć jego narzędzia. Każdy wiersz narzędzia pokazuje status i ryzyko:

Etykieta wiersza	Znaczenie
Zatwierdzone · Odczyt	Zatwierdzone
Nowe · Zapis	Narzędzie, którego nigdy nie zatwierdzono
Zmienione · Zapis	Definicja różni się od zatwierdzonej
Obniżenie ryzyka · Zapis	Nowa definicja ma niższe ryzyko niż poprzednio (niżej)
Wyłączone awaryjnie · Zapis	Włączony jest wyłącznik awaryjny

Poziomy ryzyka to Odczyt, Zapis i Usuwanie. Narzędzie z ryzykiem Usuwanie wymaga przy każdym wywołaniu kodu z Authenticatora użytkownika. Grupa, której użytkownik potrzebuje, wynika z ryzyka: mcp-<system>-read, -write albo -destructive (zobacz Dostęp).

Aby zatwierdzić jedno narzędzie:

1. Wybierz Pokaż różnice w wierszu narzędzia.
2. Przeczytaj definicję: opis, schemat, ryzyko, akcję i zasób. Linie oznaczone - są usunięte, linie oznaczone + dodane. Tekst Źródło: manifest pobrany przez gateway oznacza, że pobrał go gateway i nic jeszcze nie jest zatwierdzone.
3. Wybierz Zatwierdź definicję.

Jeśli pojawi się okno Zatwierdzić definicję zgłoszoną przez serwer?, definicja pochodzi od działającego serwera, a nie ze sprawdzonego potoku. Zatwierdź ją tylko, jeśli opis i schemat są zgodne z oczekiwanym. W przykładzie niżej nowy opis każe modelowi zignorować poprzednie instrukcje, co jest powodem do odmowy.

Portal zapisuje ukryte znaki definicji jako znaczniki [U+XXXX]. Jeśli skrót się zmienił, a żadne pokazane pole nie, okno Zatwierdzić zmianę, której nie widać? wymaga wyraźnego potwierdzenia. Jeśli skrót podany przez serwer nie zgadza się z pokazaną definicją, nie zatwierdzaj jej i zgłoś to administratorom platformy.

Zatwierdź wiele narzędzi naraz

Użyj przycisków nad listą narzędzi serwera:

• Zaznacz wszystkie do odczytu zaznacza każde oczekujące narzędzie z ryzykiem Odczyt.
• Zaznacz wszystkie zaznacza każde oczekujące narzędzie.
• Zatwierdź zaznaczone (n) zatwierdza zaznaczone narzędzia jedno po drugim, po pytaniu Zatwierdzić zaznaczone narzędzia? Okno wypisuje zmienione definicje i te zgłoszone przez działający serwer, bo ich różnic nie widać na liście.

Narzędzia obniżające ryzyko (Obniża ryzyko: sprawdź i zatwierdź je osobno.) i narzędzia wymagające klasyfikacji (Wymaga klasyfikacji: zatwierdź je osobno.) nie mają pola wyboru. Jeśli definicja zmieni się po zaznaczeniu, nic nie zostanie zatwierdzone i sprawdzasz ją ponownie. Jeśli w trakcie gateway zażąda świeżego potwierdzenia tożsamości, zatwierdzanie się zatrzymuje i mówi, ile narzędzi zatwierdziło. Resztę zatwierdź pojedynczo.

Obniżenie ryzyka

Jeśli nowa definicja ma niższe ryzyko niż zatwierdzona (na przykład Usuwanie na Zapis), narzędzie jest ukryte przed agentami do Twojej decyzji. Zatwierdzenie obniża obowiązujący poziom, a dla narzędzia, które było nieodwracalne, znika wymóg kodu z Authenticatora.

1. Wybierz Pokaż różnice i przeczytaj czerwony komunikat Obniżenie ryzyka. Sprawdź linie risk, action i hints (w interfejsie: ryzyko, akcja, wskazówki).
2. Wybierz Zatwierdź obniżenie ryzyka. Wymaga świeżego MFA.
3. Potwierdź w oknie Zatwierdzić obniżenie ryzyka? Zatwierdź tylko wtedy, gdy zmiana jest zamierzona.

Jeśli nie zatwierdzisz, nic się nie psuje: narzędzie zostaje ukryte.

Sklasyfikuj narzędzia obcego serwera

Narzędzie obsługiwane przez adapter (obcy serwer, który nie określa, jak groźna jest operacja) przychodzi bez ryzyka i bez akcji, a agenci nie widzą go, dopóki go nie sklasyfikujesz. Wiersz mówi Do klasyfikacji, a przycisk to Sklasyfikuj i zatwierdź.

1. Wybierz Pokaż różnice i przeczytaj definicję. Podpowiedzi serwera to niezaufany tekst i nie wpływają na wybór.
2. Wybierz Sklasyfikuj i zatwierdź.
3. W oknie Klasyfikacja narzędzia wybierz Ryzyko i Akcja, potem Zatwierdź z tą klasyfikacją.

Adapter jest tylko do odczytu, więc okno oferuje wyłącznie Odczyt i read. Narzędzie, które zapisuje albo usuwa dane, nie przejdzie przez adapter, więc go nie zatwierdzaj. Zmiana definicji odsyła narzędzie z powrotem do oczekujących.