Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Tesztelés és hibakeresés

9. lecke 14 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. Réteges tesztelés
  2. Az MCP szerver
  3. A teljes bővítmény
  4. Hibakeresés rétegenként
  5. Főbb megállapítások

A leckét 2026. november 3-án írtuk át az OpenAI Bővítmények dokumentációjának Connect and test your plugin és Troubleshooting oldalai alapján. Az eredeti kurzus első verziójában szereplő, nem létező SDK-hoz tartozó „fejlesztői játszótér“ és annak parancsai már elavultak. Források: Connect and test · Troubleshooting.

Réteges tesztelés

Az OpenAI azt javasolja, hogy a teljes bővítmény telepítése előtt minden egyes képességet külön-külön tesztelj le: először az önálló MCP szervert, amelyet közvetlenül a ChatGPT-hez csatlakoztatsz, majd a csomagolt bővítményt a hozzá tartozó készségekkel. A fejlesztés során őrizd meg az értékelési promptjaidat és azok eredményeit, hogy össze tudd hasonlítani a viselkedést a különböző verziók között.

Az MCP szerver

A végpont előkészítése

Mielőtt a ChatGPT-ben tesztelnéd, győződj meg arról, hogy a szerver elérhető nyilvános HTTPS-en keresztül – vagy egy Secure MCP Tunnel segítségével –, hogy támogatja a streamable HTTP protokollt (jellemzően az /mcp útvonalon), hogy jelen vannak az eszköznevek, leírások, sémák és annotációk, valamint hogy a hitelesítés felderítése működik azoknál az eszközöknél, amelyek fiókot igényelnek. Fejlesztési alagút kísérletezésre megfelel, de beküldéshez nem.

Ellenőrzés

Az MCP Inspector közvetlenül hívja meg az eszközeidet, modell nélkül:

npx @modelcontextprotocol/inspector@latest

Vizsgáld meg alaposan az összes eszközt: használj reprezentatív bemeneteket, szélsőséges eseteket, hiányzó hitelesítő adatokat és üres eredményeket. Ellenőrizd a sémaérvényesítést, a hitelesítési hibákat, az annotációkat, a megerősítési viselkedést és a modell által olvasható kimenetet.

Az eszközkiválasztás értékelése

Miután a szervert személyes bővítményként csatlakoztattad (4. lecke), telepítsd, nyiss egy új beszélgetést, írd be az @ jelet, és válaszd ki azt. Készíts egy értékelési készletet, amely tartalmazza:

  • Olyan közvetlen kéréseket, amelyeknek egy konkrét eszközt kellene aktiválniuk;
  • Olyan közvetett kéréseket, amelyek ugyanazt a célt másképpen fogalmazzák meg;
  • Olyan követő kéréseket, amelyek korábban kapott azonosítókat használnak fel;
  • Olyan írási műveleteket, amelyek engedélyt vagy megerősítést igényelnek;
  • Olyan hatókörön kívüli kéréseket, amelyeknek egyetlen eszközt sem szabadna aktiválniuk.

Minden egyes esetben jegyezd fel a kiválasztott eszközt, annak argumentumait, az eredményt, esetleges hibákat és a megerősítési viselkedést. Ismételd meg a teljes készletet valahányszor megváltoztatsz egy nevet, leírást, sémát vagy annotációt. Ha a szerver UI-komponenst ad vissza, teszteld le magát a komponenst és a modell által olvasható eredményt is.

A nyers adatcsere megtekintése

A teljes kérések és válaszok olvasásához az API Playground elfogad egy MCP szervert: menj a Tools → Add → MCP Server menüpontra, add meg a HTTPS címet, csatlakozz, majd futtasd le a tesztpromptjaidat.

Metaadatok frissítése

Bármilyen név, leírás, séma, annotáció, hitelesítési módszer vagy UI-erőforrás módosítása után: telepítsd újra vagy indítsd újra a szervert, nyisd meg a kapcsolatot a chatgpt.com/plugins oldalon, válaszd a Refresh lehetőséget, ellenőrizd, hogy a hirdetett metaadatok megváltoztak-e, majd egy új beszélgetésben ismételd meg a vonatkozó teszteket. Ez a frissítés a közvetlenül csatlakoztatott szerverekre vonatkozik; egy közzétett bővítmény esetén az eszközfrissítések a folyamatos felülvizsgálat alá esnek (11. lecke).

Csomagolás előtt ellenőrizd, hogy az eszközlista megfelel-e a hirdetett képességeknek, hogy a strukturált eredmények megfelelnek-e a kimeneti sémáknak, hogy a hitelesítési hibák hasznos hibaüzeneteket adnak-e vissza, hogy a megfelelő promptok a megfelelő eszközöket aktiválják, a helytelenek pedig egyet sem, valamint hogy a UI konzolhibák nélkül jelenik meg, és helyesen állítja vissza az állapotát.

A teljes bővítmény

Amint a szerver készen áll – vagy kizárólag készségekből álló bővítmény esetén azonnal –, csomagold be a bővítményt (10. lecke), add hozzá egy helyi piactérhez, telepítsd a bővítménykönyvtárból, majd ismételd meg a használati esetek listájából származó kéréseket: közvetlen, közvetett, követő, negatív és szándékosan kizárt szélsőséges eseteket. Ellenőrizd, hogy a bővítmény követi-e a készségek utasításait, a megfelelő erőforrásokat használja-e, végrehajtja-e az egyes lépéseket, és hasznos eredményt produkál-e; hogy a készségek a megfelelő eszközöket hívják-e meg; és hogy a hitelesítés a telepítés után működik-e.

Hibakeresés rétegenként

Ha valami hiba történik, kezdd a hibás réteg izolálásával: szerver, komponens vagy ChatGPT kliens.

TünetNyomozási irány
Nincsenek felsorolva eszközökFut a szerver? A cím /mcp-re végződik?
Strukturált adat van, de nincs komponensTartalmazza az eszköz a _meta.ui.resourceUri mezőt, amely egy regisztrált, text/html;profile=mcp-app típusú erőforrásra mutat, és betöltődik CSP-hibák nélkül?
Séma hibákMegfelelnek a Python vagy TypeScript modelljeid a hirdetett outputSchema-nak?
Lassú komponensTöbb száz milliszekundumot vesznek igénybe az eszköz hívások? Profilozz és használj gyorsítótárazást.
A komponens nem töltődik beBöngésző konzol: CSP-sértés, hiányos csomag?
Elveszett állapot (húzd és ejtsd, szerkesztés)Hívd meg a window.openai.setWidgetState függvényt minden frissítés után, és állítsd vissza az állapotot a window.openai.widgetState alapján a betöltéskor (mount).
A elrendezés mobilnézetben sérülOlvasd be a window.openai.displayMode és window.openai.maxHeight értékeket; kerüld a rögzített magasságokat és a rámutatós (hover) műveleteket.
Az eszközt sosem választja kiÍrd át a leírást „Akkor használd, ha…“ formátumra, és tekintsd át a kezdő promptokat.
Rossz eszköz kerül kiválasztásraTisztázd a szomszédos eszközöket, specifikáld a kizárt eseteket, bontsd fel a túl általános eszközöket.
401-es hibákFoglald bele a WWW-Authenticate fejlécet a válaszba; ellenőrizd a kibocsátót (issuer) és a célközönséget (audience).
invalid_client hiba egy meglévő kapcsolatonLétezik még a regisztrált OAuth kliens? Állítsd vissza inkább, mintsem hozz létre egy újat.
Az ngrok alagút lejártIndítsd újra, ellenőrizd, hogy a helyi szerver fut-e; éles környezetben használj stabil hosztingot állapotfigyelő próbákkal (health probes).
A streaming megszakad egy proxy mögöttA terheléselosztónak vagy CDN-nek pufferelés nélkül kell továbbítania a HTTP streaminget.

Ha a probléma továbbra is fennáll, gyűjtsd össze a szervernaplókat, a komponens konzolját, az eszköz hívások átiratát és a képernyőmentéseket. Jegyezd fel a használt promptot, és küldd el az egészet az OpenAI-nál lévő kapcsolattartódnak.

Főbb megállapítások

  • Tesztelj rétegesen: először a szervert önmagában (Inspector, majd ChatGPT), aztán a teljes bővítményt
  • Készíts értékelési készletet: közvetlen, közvetett, követő, írási és hatókörön kívüli kérésekből
  • Az API Playground megmutatja a nyers MCP adatcseréket
  • Frissíts minden metaadat-változtatás után, majd indíts egy új beszélgetést
  • Hiba esetén először izoláld a réteget: szerver, komponens vagy kliens