Wybierz transport świadomie
Lokalny serwer stdio i zdalna usługa HTTP mają różne wymagania wdrożeniowe. Użyj obsługiwanego transportu zdalnego, TLS i uwierzytelnionej trasy. Sprawdź wersje klienta i serwera, zamiast zakładać, że każda implementacja obsługuje te same możliwości.
Traktuj każde narzędzie jako API
Waliduj argumenty, egzekwuj autoryzację właściwą dla użytkownika i ograniczaj zasoby. Nie udostępniaj dowolnego wykonywania poleceń powłoki jako narzędzia wygody. Ogranicz cele wychodzące, gdy narzędzie pobiera URL, i trzymaj sekrety poza opisami i odpowiedziami.
Zbieraj dane tożsamości proporcjonalnie
Host bez KYC może zminimalizować dane rejestracyjne u dostawcy, ale usługa MCP może nadal wymagać własnych użytkowników, bezpieczeństwa sesji i kontroli nadużyć. Wyjaśnij, co jest rejestrowane, i unikaj przechowywania danych wejściowych narzędzi bez określonego celu.
Wdrażaj dla przejrzystości operacyjnej
Uruchamiaj pod dedykowanym użytkownikiem, używaj kontroli kondycji, ograniczaj czasy żądań i utrzymuj buforowanie oraz limity czasu odwrotnego proxy zgodne z protokołem. Przetestuj uwierzytelnianie, unieważnianie, rozłączenia i ponowienia przed przyznaniem uprawnień zapisu.
Dopasuj uwierzytelnianie do obsługiwanego protokołu
W przypadku wdrożenia MCP opartego na HTTP sprawdź aktualne wymagania autoryzacyjne protokołu i obsługiwaną wersję klienta. Dostęp do zasobów oparty na OAuth obejmuje odbiorcę tokena, wykrywanie i zakres, a nie tylko hasło na stronie głównej. Użyj HTTPS, waliduj tokeny dla zamierzonego zasobu i trzymaj dane uwierzytelniające bearer poza ciągami zapytań. Serwer stdio używa innej lokalnej granicy poświadczeń.
- Przetestuj nieuwierzytelnione żądanie
- Przetestuj uwierzytelnione żądanie poza jego zakresem
- Unieważnij poświadczenie i sprawdź, czy przestaje działać
Oficjalna dokumentacja: Specyfikacja autoryzacji MCP
Opublikuj ograniczony pierwszy zestaw narzędzi
Zacznij od narzędzi tylko do odczytu, które zwracają ograniczoną ilość danych. Dodawaj zapisy plików, operacje cyklu życia serwera lub wiadomości zewnętrzne dopiero po zrozumieniu ich uprawnień i zachowania przy duplikatach. Traktuj zwracane strony internetowe i dokumenty jako niezaufane dane wejściowe; nie mogą one po cichu rozszerzać uprawnień serwera narzędzi.
Ustal zachowanie protokołu przed pisaniem reguł proxy
Zapisz zarówno wydanie serwera SDK, jak i rewizję MCP, której będzie używać klient. W rewizji 2026-07-28 Streamable HTTP żądania korzystają z punktu końcowego POST; starsze przykłady opierające się na sesjach protokołu lub samodzielnym strumieniu GET to inna rewizja. Nie usuwaj pozornego wymogu zgodności, dopóki nie wiesz, którego klienta obsługujesz. Odwrotne proxy musi zachować wymagane nagłówki, status HTTP i zachowanie strumieniowania odpowiedzi dla tej wersji.
- Zacznij od narzędzia tylko do odczytu na nasłuchu interfejsu pętli zwrotnej, a następnie umieść przed nim zamierzoną granicę HTTPS/uwierzytelniania.
- Przetestuj normalny wynik, wynik strumieniowy, przekroczenie limitu czasu i rozłączonego klienta przez publiczne proxy.
- Waliduj dozwolone wartości Origin zgodnie z wymaganiami transportu; sprawdzenie Origin nie zastępuje uwierzytelnienia wywołującego.
- Jeśli zdarzenia docierają dopiero na końcu, sprawdź buforowanie i zachowanie limitów czasu proxy, zanim zmienisz kod narzędzia.
Oficjalna dokumentacja: MCP 2026-07-28: Streamable HTTP
Testuj błędy autoryzacji równie celowo jak sukces
W przypadku dostępu do HTTP chronionego przez OAuth serwer MCP jest chronionym zasobem. Przetestuj wykrywanie metadanych, oczekiwanego wystawcę i odbiorcę tokenu oraz zakresy potrzebne do konkretnej operacji. Trzymaj token autoryzacji poza ciągami zapytań URL i nigdy nie przekazuj go bez zmian do niepowiązanej usługi podrzędnej. Błąd uwierzytelniania po stronie klienta musi zachować odpowiednie wyzwanie HTTP, aby klient mógł odzyskać dostęp przez obsługiwany przepływ.
- Brak tokenu lub wygasły token: chroniony punkt końcowy odrzuca dostęp zamiast zwracać prywatne dane narzędzia.
- Prawidłowy token z niewystarczającymi uprawnieniami: żądany zasób pozostaje niedostępny.
- Token dla innej grupy odbiorców: odrzuć go, nawet jeśli jego podpis jest poza tym prawidłowy.
- Nieoczekiwany zewnętrzny URL lub ścieżka pliku: zweryfikuj względem uprawnień narzędzia przed pobraniem lub zapisem.
- Logi i ślady błędów: zachowaj identyfikator operacji i wynik, usuwając tokeny i prywatne dane wejściowe narzędzi.
Oficjalna dokumentacja: MCP 2026-07-28: autoryzacja HTTP · MCP: najlepsze praktyki bezpieczeństwa