Testowanie i debugowanie
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.
| Objaw | Prowadząca wskazówka |
|---|---|
| Brak listy narzędzi | Czy serwer działa? Czy adres kończy się na /mcp? |
| Dane ustrukturyzowane, ale brak komponentu | Czy 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 schematu | Czy Twoje modele w Pythonie lub TypeScript są zgodne z reklamowanym outputSchema? |
| Wolny komponent | Czy 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 mobilnych | Odczytaj window.openai.displayMode i window.openai.maxHeight; unikaj sztywnych wysokości i akcji po najechaniu myszą. |
| Narzędzie nigdy nie wybierane | Przepisz opis w formie „Używaj, gdy…“, przejrzyj prompty startowe. |
| Wybrane niewłaściwe narzędzie | Doprecyzuj sąsiednie narzędzia, określ wykluczone przypadki, podziel zbyt ogólne narzędzia. |
| Błędy 401 | Dołącz nagłówek WWW-Authenticate do odpowiedzi; zweryfikuj wystawcę i odbiorcę. |
invalid_client przy istniejącym połączeniu | Czy 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 proxy | Balanser 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