Działanie narzędzia MCP
Sprawdzenie monitoruje, czy serwer MCP, z którego agent bierze narzędzia, odpowiada i potrzebne narzędzie jest na miejscu. Serwer zwykle żyje: częściej zmienia się jego zawartość — narzędzie zostało przemianowane lub usunięte z wynika. Zwykłe sprawdzenie HTTP zobaczy pracujący adres i nic nie zauważy.
Co dokładnie sprawdzać
Wybierany jest jeden poziom, a nie zestaw opcji: są zagnieżdżone — „narzędzie jest" bez „serwer odpowiada" się nie zdarza. Pierwsze dwa poziomy nic na serwerze nie wykonują i kosztują tyle samo, dlatego zaczynać warto od drugiego: to właśnie jest powód, dla którego się zakłada sprawdzenie.
| Poziom | Co się sprawdza | Cena |
|---|---|---|
| Serwer odpowiada | Serwer przyjął żądanie i odpowiedź jest analizowana. Chwyta niedostępny serwer, błędny adres i odrzucony token, a przy jawnie wybranej wersji protokołu — i przeniesienie serwera na inną. | Bezpłatnie |
| Narzędzie jest dostępne na serwerze | Na liście narzędzi serwera jest wskazane narzędzie. Chwyta przemianowane, usunięte z wyniku lub ukryte prawami narzędzie — to, co zdarza się zauważalnie częściej niż upadek samego serwera. | Bezpłatnie |
| Narzędzie się wykonuje | Narzędzie jest wywoływane z podanymi tobą argumentami i odpowiada bez błędu. Chwyta to, czego lista nie widzi: narzędzie jest na miejscu, ale co następuje po nim, jest uszkodzone — baza, zewnętrzny API, prawa. | Rzeczywiste wywołanie przy każdym sprawdzeniu |
Pola formularza
| Pole | Co oznacza | Co wpisać | Przykład |
|---|---|---|---|
| Nazwa | Nazwa sprawdzenia. | Wskaż, jaki serwer i po co jest ci potrzebny. | MCP wyszukiwania bazy |
| Grupa | Umożliwia przypisanie zadania do projektu lub sekcji. | Wybierz grupę, jeśli chcesz trzymać zadania razem po projekcie. | Projekt główny |
| Adres serwera | Adres punktu końcowego MCP — tego, który wpisujesz w ustawieniach agenta. | Wpisz cały adres ze ścieżką. Zwykle ścieżka kończy się na /mcp, ale może być dowolna. |
https://example.com/mcp |
| Wersja protokołu | Redakcja MCP, na którą liczy twój kod, albo „Automatycznie" — dowolna, którą trzyma serwer. | Zostaw „Automatycznie", jeśli ważne jest lylko, aby narzędzie odpowiadało. Wybierz tę samą wersję, którą ogłasza twój klient, jeśli chcesz wiedzieć o przeniesieniu serwera na inną. | Automatycznie |
| Token | Token Bearer, jeśli serwer jest chroniony autoryzacją. | Pozostaw puste, jeśli serwer jest otwarty. Zmieniając zadanie, puste pole oznacza „pozostaw poprzedni token"; przy przeniesieniu na inny host poprzedni token się nie przenosi — nowemu odbiorcy go nie wyślemy. | Token z ustawień serwera |
| Co sprawdzać | Poziom sprawdzenia z opisanych powyżej. | Bierz drugi: nic nie wykonuje na serwerze, jak pierwszy, i odpowiada na pytanie, dla którego się zakłada sprawdzenie. Trzeci — tylko dla czytającego narzędzia. | Narzędzie jest dostępne na serwerze |
| Narzędzie | Nazwa narzędzia, które monitorujemy. Pytane od drugiego poziomu. | Wskaż je dokładnie tak, jak serwer je zwraca na liście narzędzi: porównanie jest ścisłe. To ta sama nazwa, którą się narzędzie wzywa, a nie jego opis. | search_documents |
| Argumenty | Z czym wywoływać narzędzie. Pytane tylko na trzecim poziomie. | Obiekt JSON w takim postaci, w jakim narzędzie oczekuje argumentów. Dobierz bezpieczne zapytanie, na które narzędzie na pewno odpowie. Puste pole — wywołanie bez argumentów. | {"query": "test"} |
| Czas oczekiwania | Ile czasu zarezerwowane na całe sprawdzenie, na każdym poziomie. | Sprawdzenie dłużej niż podano to się traktuje jako odmowa: serwer, który odpowiada, ale wolno, też nie sprawny. Orientuj się na to, jak długo serwer zwykle odpowiada u ciebie, z zapasem. | 30 sekund |
| Interwał | Jak często wykonywać sprawdzenie. | Na pierwszych dwóch poziomach — jak chcesz, rozsądna częstość — pięć minut. Na trzecim — od 15 minut: każde sprawdzenie wywoła narzędzie. | 5 minut |
| Kanały powiadomień | Dokąd wysyłać wiadomości o problemie i odzyskaniu. | Zaznacz kanały, w których naprawdę czytasz powiadomienia. | Telegram i email |
| Raporty | Okresowe podsumowania zadania. | Włącz, jeśli chcesz otrzymywać przegląd bez ręcznego logowania do panelu. | Raport tygodniowy |
Kiedy przychodzi alarm
Alarm przychodzi, jeśli wybrane sprawdzenie nie przeszło:
- serwer jest niedostępny, odpowiedział błędem lub odrzucił token;
- serwer nie obsługuje wybranej wersji protokołu — w przyczynie będą wymienione te, które obsługuje;
- pod adresem odpowiada nie serwer MCP albo serwer na przestarzałym transporcie;
- wskazanego narzędzia nie ma na liście — na drugim i trzecim poziomie;
- narzędzie wykonało się z błędem lub zamiast wyniku poprosiło o wejście — na trzecim poziomie;
- całe sprawdzenie zajęło więcej czasu oczekiwania — na każdym poziomie.
Kiedy sprawdzenie jest pomijane
Jeśli serwer poprosił o kontaktowanie rzadziej, zadanie nie pada i nie unosi się — sprawdzenie jest pomijane, a status pozostaje poprzedni. To jedyny taki przypadek: ograniczenie częstości mówi o naszej własnej natarczywości, a nie o twoim serwerze. Wszystko inne — milcząca sieć, błąd serwera, odrzucony token — dla tego zadania oznacza, że narzędziem się nie da teraz posługiwać.
Jedno zadanie — jedno narzędzie
Monitorowanie trzech narzędzi jednego serwera to trzy zadania. Tak każde ma swój czas dostępności i swoją historię: mieszając kilka pytań w jednym zadaniu, otrzymasz czas dostępności, o którym nie wiadomo, czyj to. Jeśli narzędzia są ważne jednakowo, zgromadź zadania w grupę.
Konfiguracja powiadomień
Dla każdego kanału powiadomień w zadaniu można ustawić dodatkowe parametry. Działają one tylko dla zdarzeń DOWN.
| Parametr | Co robi |
|---|---|
| Włączony | Pozwala lub zabrania wysyłania powiadomień po tym kanale dla tego zadania. |
| Opóźnij na PRO | Opóźnia pierwsze powiadomienie o DOWN na wybrany czas (do 12 godzin). Wygodnie, aby nie otrzymywać powiadomienia o krótkotrwałych awariach. |
| Powtarzaj przez PRO | Okresowo powtarza powiadomienie, dopóki zadanie pozostaje w stanie DOWN (do 1 godziny między powtórzeniami). Przydaje się, gdy ważne jest nie przegapić długotrwałą awarię. |