Testiranje i otklanjanje grešaka
Na ovoj stranici
Lekcija je ponovno napisana 3. studenog 2026. na temelju stranica Connect and test your plugin i Troubleshooting iz dokumentacije o OpenAI dodacima. Bivši “razvojni poligon” i njegove naredbe pripadali su nepostojećem SDK-u iz prve verzije ovog tečaja. Izvori: Povezivanje i testiranje · Otklanjanje grešaka.
Testiranje po slojevima
OpenAI preporučuje testiranje svake mogućnosti prije implementacije cijelog instaliranog dodatka: prvo samostalni MCP poslužitelj povezan s ChatGPT-om, zatim upakirani dodatak sa svojim vještinama. Tijekom razvoja čuvaj svoje evaluacijske upite i njihove rezultate kako bi mogao usporediti ponašanje između različitih verzija.
MCP poslužitelj
Priprema krajnje točke
Prije testiranja u ChatGPT-u, provjeri je li poslužitelj dostupan putem javnog HTTPS-a—ili kroz Secure MCP Tunnel—da koristi streamable HTTP (obično na /mcp), da su nazivi alata, opisi, sheme i bilješke prisutni te da otkrivanje autentifikacije funkcionira za alate koji zahtijevaju račun. Razvojni tunel prikladan je za probna razdoblja, ali ne i za slanje u proizvodnju.
Inspekcija
MCP Inspector izravno poziva tvoje alate, bez modela:
npx @modelcontextprotocol/inspector@latest
Stavi svaki alat na kušnju: reprezentativni unosi, rubni slučajevi, nedostajuće vjerodajnice i prazni rezultati. Provjeri validaciju sheme, pogreške autentifikacije, bilješke, ponašanje potvrde i izlaz čitljiv modelu.
Evaluacija odabira alata
Nakon što je poslužitelj povezan kao osobni dodatak (Lekcija 4), instaliraj ga, otvori novi razgovor, upiši @ i odaberi ga. Izgradi skup za evaluaciju koji sadrži:
- Izravne zahtjeve koji bi trebali pokrenuti određeni alat;
- Neizravne zahtjeve koji izražavaju isti cilj na drugačiji način;
- Naknadne zahtjeve koji ponovno koriste identifikatore dobivene ranije;
- Operacije pisanja koje zahtijevaju autorizaciju ili potvrdu;
- Zahtjeve izvan opsega koji ne bi smjeli pokrenuti nijedan alat.
Za svaki od njih zabilježi odabrani alat, njegove argumente, rezultat, eventualne pogreške i ponašanje potvrde. Ponovno pokreni cijeli skup svaki put kada promijeniš naziv, opis, shemu ili bilješku. Ako poslužitelj vraća UI komponentu, testiraj i samu komponentu i rezultat čitljiv modelu.
Pregled sirove razmjene
Da bi pročitao pune zahtjeve i odgovore, API Playground prihvaća MCP poslužitelj: idi na Tools → Add → MCP Server, unesi HTTPS adresu, poveži se, a zatim pokreni svoje testne upite.
Osvježavanje metapodataka
Nakon bilo kakve promjene naziva, opisa, sheme, bilješke, metode autentifikacije ili UI resursa: ponovno implementiraj ili ponovno pokreni poslužitelj, otvori vezu na chatgpt.com/plugins, odaberi Refresh, provjeri jesu li se oglašavani metapodaci promijenili i ponovno pokreni relevantne testove u novom razgovoru. Ovo osvježavanje odnosi se na izravno povezane poslužitelje; za objavljene dodatke, ažuriranja alata podliježu kontinuiranom pregledu (Lekcija 11).
Prije pakiranja provjeri odgovara li popis alata oglašenim mogućnostima, da strukturirani rezultati zadovoljavaju izlazne sheme, da neuspjesi autentifikacije vraćaju korisne pogreške, da ispravni upiti pokreću ispravne alate dok pogrešni ne pokreću nijedan, te da se UI prikazuje bez pogrešaka u konzoli uz ispravno vraćanje stanja.
Cijeli dodatak
Kada je poslužitelj spreman—ili odmah za dodatak koji se sastoji samo od vještina—upakiraj dodatak (Lekcija 10), dodaj ga na lokalno tržište, instaliraj ga iz direktorija dodataka, a zatim ponovno pokreni zahtjeve iz svog popisa slučajeva uporabe: izravne, neizravne, naknadne, negativne i namjerno isključene rubne slučajeve. Provjeri slijedi li dodatak upute vještina, koristi li ispravne resurse, dovršava li svaki korak i proizvodi li koristan rezultat; da vještine pozivaju ispravne alate; i da autentifikacija funkcionira nakon instalacije.
Dijagnostika po slojevima
Kada nešto pođe po zlu, započni izolacijom neispravnog sloja: poslužitelj, komponenta ili ChatGPT klijent.
| Simptom | Smjernica |
|---|---|
| Nema navedenih alata | Radi li poslužitelj? Završava li adresa s /mcp? |
| Strukturirani podaci, ali nema komponente | Sadrži li alat _meta.ui.resourceUri koji pokazuje na registrirani resurs tipa text/html;profile=mcp-app koji se učitava bez CSP pogrešaka? |
| Pogreške sheme | Odgovaraju li tvoji Python ili TypeScript modeli oglašenoj outputSchema? |
| Spora komponenta | Prelaze li pozivi alata nekoliko stotina milisekundi? Profiliraj i keširaj. |
| Komponenta se ne učitava | Konzola preglednika: kršenje CSP-a, nepotpun paket? |
| Izgubljeno stanje (povuci-i-ispusti, uređivanje) | Pozovi window.openai.setWidgetState nakon svakog ažuriranja i vrati stanje iz window.openai.widgetState prilikom montaže. |
| Raspored slomljen na mobitelu | Pročitaj window.openai.displayMode i window.openai.maxHeight; izbjegavaj fiksne visine i radnje na lebdenje. |
| Alat nikada nije odabran | Prepiši opis kao “Koristi kada…”, pregledaj početne upite. |
| Odabran pogrešan alat | Pojasni susjedne alate, specificiraj isključene slučajeve, razdvoj preširoke alate. |
| 401 pogreške | Uključi WWW-Authenticate u odgovor; provjeri izdavatelja i publiku. |
invalid_client na postojećoj vezi | Postoji li još uvijek registrirani OAuth klijent? Obnovi ga umjesto stvaranja novog. |
| ngrok tunel istječe | Ponovno ga pokreni, provjeri radi li lokalni poslužitelj; u proizvodnji koristi stabilno hostanje s health probama. |
| Streamanje prekinuto iza proxyja | Load balancer ili CDN mora propustiti HTTP streamanje bez međuspremanja. |
Ako problem i dalje postoji, prikupi zapisnike poslužitelja, konzolu komponente, transkript poziva alata i snimke zaslona. Zabilježi korišteni upit i pošalji sve svom kontaktu u OpenAI-u.
Ključne točke
- Testiraj po slojevima: prvo sam poslužitelj (Inspector, zatim ChatGPT), potom cijeli dodatak
- Izgradi skup za evaluaciju: izravni, neizravni, naknadni, upisi i zahtjevi izvan opsega
- API Playground prikazuje sirove MCP razmjene
- Refresh nakon svake promjene metapodataka, zatim pokreni novi razgovor
- Kada se pojave problemi, prvo izoliraj sloj: poslužitelj, komponenta ili klijent