Bezpieczeństwo MCP i rozwiązywanie problemów

MCP może zawieść podczas pracy w sieci, uwierzytelniania, wykrywania lub wykonywania.

Czego się dowiesz

  • Wyjaśnij: host, klient i serwer
  • Zastosuj tę ideę na przykładzie: bezpieczeństwo MCP i rozwiązywanie problemów
  • Rozpoznaj ograniczenia i zweryfikuj rezultaty ćwiczeń

MCP może zawieść podczas pracy w sieci, uwierzytelniania, wykrywania lub wykonywania. Oddziel te etapy, aby uniknąć przypadkowych zmian.

Kroki te odnoszą się do funkcji zidentyfikowanych w kodzie aplikacji. Ten materiał nie został sprawdzony na żywo; sprawdź dokumentację i opcje w swojej wersji.

Jak to działa, krok po kroku

Host, klient i serwer

MCP to protokół łączący aplikacje AI z możliwościami zewnętrznymi. Host zapewnia doświadczenie, klient zarządza połączeniem, a serwer udostępnia narzędzia, zasoby lub podpowiedzi zgodnie ze wsparciem. Narzędzia wykonują operacje; zasoby zapewniają adresowalną treść; monity udostępniają szablony. Nie każdy serwer implementuje wszystkie trzy. Transport przenosi wiadomości, uwierzytelnianie identyfikuje osoby dzwoniące, a autoryzacja kontroluje dostęp. Sprawdź wersję protokołu i obsługiwane rozszerzenia na obu końcach. Kompatybilności nie można wywnioskować na podstawie samej etykiety „MCP”.

Przed użyciem sprawdź dostęp

Uprawnienia muszą być egzekwowane przez serwery i warstwę danych. Nie pozwól, aby model decydował o tym, czy użytkownik może zobaczyć dokument. Filtruj źródła zanim wejdą w kontekst, a nie po wygenerowaniu odpowiedzi. Używaj poświadczeń o minimalnym dostępie, trzymaj je z dala od monitów, zrzutów ekranu i kodu przeglądarki oraz obracaj odsłonięte klucze. Lista dozwolonych domen widżetów nie zastępuje uwierzytelniania API. Uwierzytelnienie identyfikuje Cię; autoryzacja określa operacje i dane, których możesz użyć. Test również odmówił dostępu.

Błędy wymagają wyraźnych ścieżek

Limit czasu różni się od błędu uprawnień. Ponawiaj tylko błędy przejściowe, z ograniczonymi próbami i rosnącymi opóźnieniami. Operacja powodująca skutki uboczne może zostać wykonana przed utratą odpowiedzi; ponowna próba bez klucza idempotencji może zduplikować efekt. Przesyłanie strumieniowe pokazuje postęp, ale nie gwarantuje ukończenia. Punkty kontrolne mogą pozwolić na wznowienie nieudanych etapów w ramach limitów czasu wykonania. Przechowuj identyfikator przebiegu, etap, czas trwania i błąd podczas usuwania wpisów tajnych z dzienników. Mierz wolne ścieżki i średnie.

Schemat objaśniający

Bezpieczeństwo MCP i rozwiązywanie problemów Postępuj zgodnie ze strzałkami wskazującymi główny przepływ. Przerywane niebieskie strzałki przedstawiają dane lub kontekst; przerywane różowe strzałki pokazują opinie lub zwracane wyniki. Kolory i kształty wyróżniają modele, sklepy, decyzje i wyniki. Znajomości: Żądanie użytkownika → Klient MPK; Klient MPK → Sprawdź argumenty i uprawnienia; Sprawdź argumenty i uprawnienia → Serwer MPK; Serwer MPK → Osoba obsługująca narzędzia; Osoba obsługująca narzędzia → Wyniki narzędzi; Wyniki narzędzi → Kroki, błędy i czas; Transport i uwierzytelnianie → Klient MPK; Uprawnienia dostępu → Sprawdź argumenty i uprawnienia; Schemat wejścia/wyjścia → Sprawdź argumenty i uprawnienia; Sprawdź argumenty i uprawnienia → Odrzuć lub przestań (Nieprawidłowe/nieautoryzowane); Kroki, błędy i czas → Klient MPK (Zdiagnozuj i spróbuj ponownie). M03 · Mapa relacji Bezpieczeństwo MCP i rozwiązywanie problemów Wejście Żądanie użytkownika Decyzja / kontrola Transport i uwierzytelnianie Decyzja / kontrola Uprawnienia dostępu Przetwarzanie Klient MPK Decyzja / kontrola Sprawdź argumenty i uprawnienia Narzędzie / usługa Serwer MPK Dane Schemat wejścia/wyjścia Przetwarzanie Osoba obsługująca narzędzia Wyjście Odrzuć lub przestań Dane Wyniki narzędzi Dane Kroki, błędy i czas Nieprawidłowe/nieautoryzowane Zdiagnozuj i spróbuj ponownie Główny przepływ Dane i kontekst Informacje zwrotne i zwrot

Postępuj zgodnie ze strzałkami wskazującymi główny przepływ. Przerywane niebieskie strzałki przedstawiają dane lub kontekst; przerywane różowe strzałki pokazują opinie lub zwracane wyniki. Kolory i kształty wyróżniają modele, sklepy, decyzje i wyniki. Na małym ekranie przewijaj w poziomie, aby zobaczyć cały schemat.

Kompletny przykład

Zły klucz powoduje odmowę dostępu. Zły punkt końcowy może zwrócić stronę HTML. Limit czasu narzędzia nie świadczy o problemie ze schematem wykrywania.

Spróbuj sam

  1. Przetestuj nieprawidłowy klucz, zły punkt końcowy i nieprawidłowe argumenty, korzystając z danych demonstracyjnych.
  2. Przed rozpoczęciem eksperymentu zapisz dane wejściowe, źródło i oczekiwany wynik. W przykładzie użyj wyłącznie fikcyjnych danych.
  3. Postępuj zgodnie z etapami diagramu. Na każdym etapie zapisuj, jakie informacje zostały otrzymane i wyprodukowane; nie myl produktu pośredniego z efektem końcowym.
  4. Powtórz po usunięciu niezbędnych informacji lub wprowadzeniu niejednoznaczności. Sprawdź, czy system wyjaśnia, zatrzymuje lub wymyśla odpowiedź.
  5. Porównaj z objaśnionym rozwiązaniem. Zachowaj konfigurację, datę, wynik i wyjaśnienie różnic. Zmień jedną rzecz i przetestuj ponownie.

Wyjaśnione rozwiązanie

Sklasyfikuj błąd i popraw konfigurację bez kopiowania sekretów do logów lub zrzutów ekranu. Pomyślne ćwiczenie pozwala pokazać związek między danymi wejściowymi, etapami i wynikiem. Gdy brakuje informacji, bardziej użyteczna jest ostrożna odpowiedź niż wymyślane szczegóły. Porównaj więcej niż styl: sprawdź także warunki, źródła i operacje.

Kiedy to podejście pomaga i jakie ma ograniczenia

Podłączony serwer może nadal mieć niedostępne narzędzie. Wybierz to podejście, jeśli poprawia ono zmierzoną potrzebę. Zachowaj prostą linię bazową i porównaj wyniki, korzystając z identycznych danych wejściowych. Jeden udany przykład nie gwarantuje niezawodności w każdej sytuacji.

Sprawdź swoją wiedzę

Czy serwer z narzędziami automatycznie oferuje zasoby i podpowiedzi?

Nie. Możliwości są opcjonalne i należy je odkryć i sprawdzić.

Dlaczego usunięcie prywatnego źródła po udzieleniu odpowiedzi jest zbyt późne?

Dane weszły już w kontekst modelu i mogą zostać ujawnione.

Jaki wynik powinno dać to ćwiczenie?

Sklasyfikuj błąd i popraw konfigurację bez kopiowania sekretów do logów lub zrzutów ekranu.

Pojęcia do zapamiętania

  • Serwer MPK: Usługa udostępniająca możliwości poprzez protokół kontekstu modelu.
  • Autoryzacja / Autoryzacja: Sprawdzanie prawa dostępu do operacji lub zasobu.
  • Idempotencja: Kontrolowane powtarzanie bez powielania efektu.

Źródła i następny krok

Aby przygotować: M02 — Podłączenie serwera MCP w aplikacji