Przejdź do głównej treści
Polski— Wybierz język
Menu

Testowanie i debugowanie

Lekcja 9 z 14 Zaktualizowano 3 listopada 2026 Programista
Na tej stronie
  1. Testuj warstwami
  2. Serwer MCP
  3. Pełna wtyczka
  4. Diagnozuj warstwami
  5. Kluczowe wnioski

Lekcja przepisana 3 listopada 2026 r. na podstawie stron Connect and test your plugin oraz Troubleshooting z dokumentacji wtyczek OpenAI. Dawny „plac zabaw dla deweloperów“ i jego polecenia należały do nieistniejącego SDK z pierwszej wersji tego kursu. Źródła: Connect and test · Troubleshooting.

Testuj warstwami

OpenAI zaleca testowanie każdej funkcji przed wdrożeniem pełnej, zainstalowanej wtyczki: najpierw samodzielnego serwera MCP podłączonego do ChatGPT, a następnie spakowanej wtyczki z jej umiejętnościami. Przez cały proces rozwoju przechowuj swoje prompty ewaluacyjne i ich wyniki, aby móc porównywać zachowanie między wersjami.

Serwer MCP

Przygotuj punkt końcowy

Zanim przetestujesz działanie w ChatGPT, upewnij się, że serwer jest osiągalny przez publiczny HTTPS – lub przez Secure MCP Tunnel – że obsługuje streamable HTTP (zazwyczaj na /mcp), że nazwy narzędzi, opisy, schematy i adnotacje są obecne oraz że wykrywanie uwierzytelniania działa dla narzędzi wymagających konta. Tunel deweloperski wystarczy do prób, ale nie do zgłoszenia do publikacji.

Inspekcja

MCP Inspector wywołuje Twoje narzędzia bezpośrednio, bez udziału modelu:

npx @modelcontextprotocol/inspector@latest

Przetestuj każde narzędzie dokładnie: użyj reprezentatywnych danych wejściowych, przypadków brzegowych, scenariuszy z brakującymi poświadczeniami oraz pustych wyników. Sprawdź walidację schematu, błędy uwierzytelniania, adnotacje, zachowanie potwierdzeń oraz wyniki czytelne dla modelu.

Oceń wybór narzędzi

Gdy serwer zostanie podłączony jako wtyczka osobista (Lekcja 4), zainstaluj go, otwórz nową konwersację, wpisz @ i wybierz wtyczkę. Stwórz zestaw ewaluacyjny zawierający:

  • Żądania bezpośrednie, które powinny uruchomić konkretne narzędzie;
  • Żądania pośrednie, które wyrażają ten sam cel w inny sposób;
  • Żądania następcze, które wykorzystują identyfikatory uzyskane wcześniej;
  • Operacje zapisu wymagające autoryzacji lub potwierdzenia;
  • Żądania wykraczające poza zakres, które nie powinny uruchamiać żadnego narzędzia.

Dla każdego przypadku zapisz wybrane narzędzie, jego argumenty, wynik, wszelkie błędy oraz zachowanie potwierdzenia. Odtwarzaj cały zestaw za każdym razem, gdy zmienisz nazwę, opis, schemat lub adnotację. Jeśli serwer zwraca komponent UI, przetestuj zarówno sam komponent, jak i wynik czytelny dla modelu.

Zobacz surowe wymiany danych

Aby przeczytać pełne żądania i odpowiedzi, API Playground akceptuje serwer MCP: przejdź do Tools → Add → MCP Server, wprowadź adres HTTPS, połącz się, a następnie uruchom swoje prompty testowe.

Odśwież metadane

Po każdej zmianie nazwy, opisu, schematu, adnotacji, metody uwierzytelniania lub zasobu UI: wdróż ponownie lub uruchom serwer na nowo, otwórz połączenie na stronie chatgpt.com/plugins, wybierz Refresh, sprawdź, czy reklamowane metadane uległy zmianie, i odtwórz odpowiednie testy w nowej konwersacji. To odświeżenie dotyczy serwerów podłączonych bezpośrednio; w przypadku opublikowanej wtyczki aktualizacje narzędzi podlegają ciągłej recenzji (Lekcja 11).

Przed spakowaniem upewnij się, że lista narzędzi odpowiada reklamowanym możliwościom, że ustrukturyzowane wyniki są zgodne ze schematami wyjściowymi, że błędy uwierzytelniania zwracają użyteczne komunikaty, że właściwe prompty uruchamiają właściwe narzędzia, a niewłaściwe nie uruchamiają żadnych, oraz że interfejs użytkownika renderuje się bez błędów w konsoli, poprawnie przywracając swój stan.

Pełna wtyczka

Gdy serwer będzie gotowy – lub natychmiast w przypadku wtyczki składającej się wyłącznie z umiejętności – spakuj wtyczkę (Lekcja 10), dodaj ją do lokalnego marketplace, zainstaluj z katalogu wtyczek, a następnie odtwórz żądania ze swojego wykazu przypadków użycia: bezpośrednie, pośrednie, następcze, negatywne oraz celowo wykluczone przypadki brzegowe. Zweryfikuj, czy wtyczka przestrzega instrukcji dotyczących umiejętności, używa właściwych zasobów, kończy każdy krok i produkuje użyteczny wynik; czy umiejętności wywołują właściwe narzędzia; oraz czy uwierzytelnianie działa po instalacji.

Diagnozuj warstwami

Gdy coś pójdzie nie tak, zacznij od izolacji wadliwej warstwy: serwera, komponentu lub klienta ChatGPT.

ObjawProwadząca wskazówka
Brak listy narzędziCzy serwer działa? Czy adres kończy się na /mcp?
Dane ustrukturyzowane, ale brak komponentuCzy narzędzie zawiera _meta.ui.resourceUri wskazujące na zarejestrowany zasób typu text/html;profile=mcp-app, który ładuje się bez błędów CSP?
Błędy schematuCzy Twoje modele w Pythonie lub TypeScript są zgodne z reklamowanym outputSchema?
Wolny komponentCzy wywołania narzędzi przekraczają kilkaset milisekund? Profiluj i stosuj pamięć podręczną.
Komponent nie ładuje sięKonsola przeglądarki: naruszenie CSP, niekompletny bundle?
Utracony stan (przeciągnij-i-upuść, edycja)Wywołuj window.openai.setWidgetState po każdej aktualizacji i przywracaj stan z window.openai.widgetState podczas montowania.
Uszkodzony układ na urządzeniach mobilnychOdczytaj window.openai.displayMode i window.openai.maxHeight; unikaj sztywnych wysokości i akcji po najechaniu myszą.
Narzędzie nigdy nie wybieranePrzepisz opis w formie „Używaj, gdy…“, przejrzyj prompty startowe.
Wybrane niewłaściwe narzędzieDoprecyzuj sąsiednie narzędzia, określ wykluczone przypadki, podziel zbyt ogólne narzędzia.
Błędy 401Dołącz nagłówek WWW-Authenticate do odpowiedzi; zweryfikuj wystawcę i odbiorcę.
invalid_client przy istniejącym połączeniuCzy zarejestrowany klient OAuth nadal istnieje? Przywróć go, zamiast tworzyć nowego.
Tunel ngrok wygasłUruchom go ponownie, sprawdź, czy lokalny serwer działa; w środowisku produkcyjnym użyj stabilnego hostingu z sondami zdrowia.
Strumieniowanie przerwane za serwerem proxyBalanser obciążenia lub CDN musi przepuszczać strumieniowanie HTTP bez buforowania.

Jeśli problem nadal występuje, zbierz logi serwera, konsolę komponentu, transkrypt wywołań narzędzi i zrzuty ekranu. Zanotuj użyty prompt i wyślij wszystko do swojego kontaktu w OpenAI.

Kluczowe wnioski

  • Testuj warstwami: najpierw sam serwer (Inspector, potem ChatGPT), następnie pełną wtyczkę
  • Zbuduj zestaw ewaluacyjny: żądania bezpośrednie, pośrednie, następcze, zapisu i wykraczające poza zakres
  • API Playground pokazuje surowe wymiany danych MCP
  • Odświeżaj po każdej zmianie metadanych, a następnie rozpocznij nową konwersację
  • Gdy pojawią się problemy, najpierw izoluj warstwę: serwer, komponent lub klient