MCP połączone, ale nie działa? Znajdź etap awarii w Mono
Sprawdź, czy problem MCP w Mono dotyczy transportu, autoryzacji, wykrywania funkcji, modelu czy wywołania narzędzia, a potem wykonaj bezpieczny test odczytu.
Zapisany serwer MCP nie oznacza, że narzędzie działa. Adres może być poprawny, choć logowanie się nie skończyło. Logowanie może się udać, a narzędzia serwera i tak się nie wczytają. A narzędzie może się wczytać, ale dostać błędne żądanie. Zanim zmienisz jakiekolwiek ustawienia, znajdź pierwszy krok, który zawodzi.
Ten poradnik dotyczy rozwiązywania problemów w Mono firmy Reunified, które nie jest jeszcze dostępne (dołącz do listy oczekujących). Przy pierwszym połączeniu skorzystaj z instrukcji konfiguracji MCP. Tutaj celem jest zamiana mglistego „nie działa” w jedną jasną obserwację, którą da się powtórzyć, bez przypadkowego powtórzenia zapisu.
1. Zapisz objaw i wstrzymaj niepewne ponowienia
Zapisz nazwę serwera, transport, urządzenie, wersję aplikacji, to, co próbowałeś zrobić, i dokładny błąd, bez sekretów. Zanotuj, czy ta sama konfiguracja działała wcześniej i co się od tego czasu zmieniło. „Lista narzędzi jest pusta po zalogowaniu” mówi więcej niż „MCP nie działa”.
Jeśli ostatnie żądanie mogło coś utworzyć, wysłać lub zmienić, sprawdź miejsce docelowe, zanim spróbujesz ponownie. Utracona odpowiedź nie oznacza, że działanie się nie wykonało. Do testów przejdź na małe żądanie tylko do odczytu, na przykład wyświetlenie jednej pozycji w projekcie testowym, który możesz sprawdzić.
Zachowaj prywatną kopię ostatnich działających ustawień. Nie wklejaj tokenów, kodów autoryzacji ani prywatnych wyników narzędzi do publicznego zgłoszenia do pomocy technicznej.
2. Sprawdź transport przed kontem
Połączenie HTTP w Mono wymaga adresu serwera MCP, a nie zwykłej strony głównej ani adresu API modelu. Porównaj pełny URL, razem ze ścieżką, z aktualną dokumentacją wydawcy serwera. Strona, która otwiera się w przeglądarce, dowodzi tylko, że ta strona jest osiągalna, a nie że działa tam MCP.
Przy transporcie Standardowe wejście/wyjście (stdio) sprawdź polecenie i argumenty na urządzeniu, które ma je uruchomić. Ponowne logowanie nie naprawi brakującego polecenia ani urządzenia, które nie może go uruchomić. Telefony i komputery się różnią, więc nie oczekuj, że polecenie z komputera zadziała na telefonie.
Adres z localhost wskazuje urządzenie, które wysyła żądanie. Testuj z właściwego urządzenia, przez obsługiwaną drogę i po zalogowaniu. Nie osłabiaj zabezpieczeń dostępu działającego serwera tylko po to, żeby test przeszedł.
3. Oddziel zapis ustawień od zakończenia autoryzacji
Sprawdź, jaką metodę uwierzytelniania wybrałeś. Token Bearer wymaga właściwego tokenu usługi w swoim polu. OAuth wymaga właściwego konta, spełnienia wymagań serwera i pełnego powrotu do Mono; zamknięcie przeglądarki zbyt wcześnie to nie jest udane logowanie.
Mono może zapisać serwer, zanim logowanie się skończy, więc zapisany serwer nie dowodzi, że logowanie się udało. Nawet po udanym logowaniu wczytywanie narzędzi serwera może przez jakiś czas zawodzić. Ani zapisany wpis, ani komunikat „Połączono z serwerem” nie dowodzą, że konkretne narzędzie jest gotowe.
Jeśli zmienisz URL lub transport serwera, Mono potraktuje go jako nowe połączenie, więc może być konieczne ponowne logowanie. Popraw prawdziwy błąd w adresie, ale nie zmieniaj w kółko działającego URL-a jako ogólnego resetu. Zamiast zgadywać wartości, trzymaj się ustawień klienta i przekierowania opisanych przez wydawcę serwera.
4. Sprawdź funkcje serwera i wybrany model
Architektura MCP rozróżnia narzędzia, zasoby i prompty. Serwer może udostępniać tylko część z nich, więc serwer oferujący wyłącznie zasoby nie da asystentowi żadnych narzędzi do wywołania.
W zainstalowanej umiejętności MCP otwórz sekcję Konfiguracja, aby zobaczyć narzędzia znalezione przez Mono. Jeśli jest pusta, sprawdź logowanie i to, czy serwer udostępnia listę narzędzi; nie zakładaj, że dostępne są wszystkie działania usługi. Zapisanie serwera to nie pełne sprawdzenie jego stanu.
Sprawdź też model używany w czacie. Nie każdy model potrafi wywoływać narzędzia, dotyczy to także niektórych modeli, które podłączasz sam. Model, który dobrze odpowiada tekstem, nadal może być powodem, dla którego podłączone narzędzie nigdy nie zostaje użyte. Wyjaśnia to Poradnik własnych punktów końcowych.
5. Przetestuj jedną znaną operację
Użyj nieszkodliwego żądania i porównaj wynik z oryginalną usługą:
Odczytaj tytuł wskazanej przeze mnie istniejącej pozycji demonstracyjnej.
Niczego nie twórz, nie edytuj, nie wysyłaj ani nie usuwaj.
Jeśli dostęp zawiedzie, zgłoś błąd zamiast zgadywać tytuł.| Co widzisz | Co sprawdzić dalej |
|---|---|
| Brak połączenia z adresem | Adres, transport, sieć urządzenia i to, czy serwer działa |
| Logowanie się nie kończy | Konto, metodę uwierzytelniania i wymagania OAuth wydawcy serwera |
| Nie pojawiają się żadne narzędzia | Co oferuje serwer, czy jego narzędzia się wczytały i czy model obsługuje narzędzia |
| Jedno narzędzie zawodzi | Wymagane dane, uprawnienia w usłudze i zwrócony błąd |
| Odczyt działa, zapis jest blokowany | Zamierzony dostęp i ustawienie uprawnień narzędzia; nie otwieraj wszystkiego |
Błąd samego narzędzia to co innego niż pusty, ale udany wynik. Przechowuj razem zwrócony status i istotny tekst, bez sekretów.
6. Potwierdź poprawkę i zachowaj notatkę diagnostyczną
Zmieniaj jedną rzecz naraz, powtarzaj ten sam test tylko do odczytu i zapisuj wynik. Jeśli później potrzebujesz zapisu, sprawdź jego dokładny cel i potwierdź wynik w usłudze, zanim spróbujesz ponownie.
Zachowaj krótką notatkę o kroku, który zawodzi, wersjach, wprowadzonej zmianie i ostatnim udanym teście. Usunięcie połączenia w Mono i cofnięcie dostępu u dostawcy to osobne kroki. Przy decyzjach o uprawnieniach w trakcie pracy przeczytaj poradnik uprawnień narzędzi; wielokrotne zatwierdzanie nie naprawi połączenia.
