Podłączenie serwera MCP w aplikacji

Pomyślne połączenie wymaga kompatybilnego punktu końcowego, transportu i uwierzytelnienia. Następnie wybierz narzędzia przydatne agentowi.

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”.

Model proponuje, narzędzie wykonuje

Wywołanie narzędzia generuje żądanie wywołania z nazwą i argumentami. Aplikacja przed wykonaniem sprawdza schemat, uprawnienia i limity. Wynik powraca do kontekstu dla następnego kroku. Na przykład get_product_stock pobiera SKU i zwraca ilość; w jego opisie powinno być wyjaśnione, że nie rezerwuje produktów. Rozróżnij puste wyniki, błędy walidacji, brak dostępu i przekroczenia limitu czasu. Prawidłowy kod JSON nie dowodzi, że argumenty są poprawne lub że akcja jest autoryzowana. W przypadku efektów zewnętrznych należy również rozważyć wykonanie podwójne.

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.

Schemat objaśniający

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

W Serwerach MCP ustaw tożsamość i adres URL, wybierz opcję AUTO lub transport i uwierzytelnianie serwera. Testuj, sprawdzaj narzędzia i dołączaj do agenta tylko get_product_stock.

Spróbuj sam

1. Podłącz serwer testowy tylko do odczytu i sprawdź prawidłowe wywołanie jednostki SKU.
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

Połączenie zostanie sprawdzone, narzędzie zostanie wykryte i dozwolone wywołanie powiedzie się. 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

stdio to ogólna koncepcja, a nie dorozumiana opcja w formie zdalnej. 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ć.

Kto realizuje połączenie zaproponowane przez modelkę?

Aplikacja lub usługa hosta po sprawdzeniu poprawności. Model nie uzyskuje automatycznie nieograniczonego dostępu.

Jaki wynik powinno dać to ćwiczenie?

Połączenie zostanie sprawdzone, narzędzie zostanie wykryte i dozwolone wywołanie powiedzie się.

Pojęcia do zapamiętania

• Serwer MPK: Usługa udostępniająca możliwości poprzez protokół kontekstu modelu.
• Wywołanie narzędzia: Ustrukturyzowane żądanie użycia możliwości zewnętrznej.
• Autoryzacja / Autoryzacja: Sprawdzanie prawa dostępu do operacji lub zasobu.

Źródła i następny krok

• Model Context Protocol — specyfikacja
• LangGraph — Przepływy pracy i agenci
• OWASP — Wstrzykiwanie instrukcji

Aby przygotować: M01 — Co to jest serwer MCP?