Testen en debuggen
Op deze pagina
Les herschreven op 3 november 2026 op basis van de pagina’s Connect and test your plugin en Troubleshooting uit de OpenAI Plugins-documentatie. Het voormalige “development playground” en de bijbehorende commando’s behoorden tot de niet-bestaande SDK van de eerste versie van deze cursus. Bronnen: Connect and test · Troubleshooting.
Testen in lagen
OpenAI raadt aan elke functionaliteit te testen voordat u de volledige geïnstalleerde plug-in implementeert: eerst de zelfstandige MCP-server verbonden met ChatGPT, vervolgens de verpakte plug-in met zijn vaardigheden. Bewaar uw evaluatieprompts en de resultaten ervan tijdens de hele ontwikkelcyclus, zodat u het gedrag tussen versies kunt vergelijken.
De MCP-server
Het eindpunt voorbereiden
Voordat u test in ChatGPT, verifieert u dat de server bereikbaar is via publieke HTTPS—or via een Secure MCP Tunnel—dat deze streamable HTTP spreekt (doorgaans op /mcp), dat tool-namen, beschrijvingen, schema’s en annotaties aanwezig zijn, en dat authenticatie-ontdekking werkt voor tools die een account vereisen. Een ontwikkelingstunnel is prima voor proeven, maar niet voor indiening.
Inspecteren
MCP Inspector roept uw tools direct aan, zonder model:
npx @modelcontextprotocol/inspector@latest
Voer elke tool door zijn paces: representatieve inputs, randgevallen, ontbrekende inloggegevens en lege resultaten. Controleer schema-validatie, authenticatiefouten, annotaties, bevestigingsgedrag en voor het model leesbare output.
Tool-selectie evalueren
Zodra de server is verbonden als persoonlijke plug-in (Les 4), installeert u deze, opent u een nieuw gesprek, typt u @ en selecteert u de plug-in. Stel een evaluatieset samen die het volgende bevat:
- Directe verzoeken die een specifieke tool moeten activeren;
- Indirecte verzoeken die hetzelfde doel anders verwoorden;
- Vervolgverzoeken die eerder verkregen identificatiegegevens hergebruiken;
- Schrijfbewerkingen die autorisatie of bevestiging vereisen;
- Verzoeken buiten het toepassingsgebied die geen enkele tool mogen activeren.
Leg voor elk verzoek vast welke tool is geselecteerd, de argumenten, het resultaat, eventuele fouten en het bevestigingsgedrag. Speel de volledige set opnieuw af wanneer u een naam, beschrijving, schema of annotatie wijzigt. Als de server een UI-component retourneert, test u zowel de component zelf als het voor het model leesbare resultaat.
Ruwe uitwisselingen bekijken
Om volledige verzoeken en antwoorden te lezen, accepteert de API Playground een MCP-server: ga naar Tools → Add → MCP Server, voer het HTTPS-adres in, maak verbinding en voer vervolgens uw testprompts uit.
Metagegevens vernieuwen
Na elke wijziging in een naam, beschrijving, schema, annotatie, authenticatiemethode of UI-bron: implementeer de server opnieuw of start deze opnieuw, open de verbinding op chatgpt.com/plugins, selecteer Refresh, verifieer dat de geadverteerde metagegevens zijn gewijzigd en speel de relevante tests opnieuw af in een nieuw gesprek. Deze vernieuwing geldt voor direct verbonden servers; voor een gepubliceerde plug-in vallen tool-updates onder continue beoordeling (Les 11).
Controleer voordat u de plug-in verpakt of de tool-lijst overeenkomt met de geadverteerde mogelijkheden, of gestructureerde resultaten voldoen aan output-schema’s, of authenticatiefouten nuttige foutmeldingen retourneren, of de juiste prompts de juiste tools activeren terwijl verkeerde prompts niets activeren, en of de UI wordt weergegeven zonder console-fouten terwijl de staat correct wordt hersteld.
De volledige plug-in
Zodra de server gereed is—or onmiddellijk voor een plug-in die alleen uit vaardigheden bestaat—verpakt u de plug-in (Les 10), voegt u deze toe aan een lokale marketplace, installeert u deze vanuit de plug-in-map en speelt u vervolgens de verzoeken uit uw use-case-inventaris opnieuw af: direct, indirect, vervolg, negatief en opzettelijk uitgesloten randgevallen. Verifieer dat de plug-in de instructies voor vaardigheden volgt, de juiste bronnen gebruikt, elke stap voltooit en een nuttig resultaat produceert; dat vaardigheden de juiste tools aanroepen; en dat authenticatie werkt na installatie.
Diagnosticeren per laag
Wanneer er iets misgaat, begint u met het isoleren van de defecte laag: server, component of ChatGPT-client.
| Symptoom | Aanwijzing |
|---|---|
| Geen tools vermeld | Draait de server? Eindigt het adres op /mcp? |
| Gestructureerde data, maar geen component | Bevat de tool _meta.ui.resourceUri dat verwijst naar een geregistreerde bron van het type text/html;profile=mcp-app die laadt zonder CSP-fouten? |
| Schema-fouten | Kommen uw Python- of TypeScript-modellen overeen met het geadverteerde outputSchema? |
| Trage component | Overschrijden tool-aanroepen een paar honderd milliseconden? Profileer en cache. |
| Component laadt niet | Browserconsole: CSP-schending, onvolledig bundle? |
| Staat verloren (drag-and-drop, bewerken) | Roep window.openai.setWidgetState aan na elke update en herstel vanuit window.openai.widgetState bij het mounten. |
| Lay-out kapot op mobiel | Lees window.openai.displayMode en window.openai.maxHeight; vermijd vaste hoogtes en hover-acties. |
| Tool nooit geselecteerd | Herschrijf de beschrijving als “Gebruik wanneer…”, bekijk startprompts. |
| Verkeerde tool geselecteerd | Verduidelijk naburige tools, specificeer uitgesloten gevallen, splits te brede tools. |
| 401-fouten | Voeg WWW-Authenticate toe aan het antwoord; verifieer issuer en audience. |
invalid_client bij een bestaande verbinding | Bestaat de geregistreerde OAuth-client nog steeds? Herstel deze in plaats van een nieuwe aan te maken. |
| ngrok-tunnel verloopt | Start deze opnieuw, verifieer dat de lokale server draait; gebruik in productie stabiele hosting met health probes. |
| Streaming verbroken achter een proxy | De load balancer of CDN moet HTTP-streaming doorlaten zonder buffering. |
Als het probleem aanhoudt, verzamelt u serverlogs, de component-console, een transcriptie van tool-aanroepen en screenshots. Noteer de gebruikte prompt en stuur alles naar uw contactpersoon bij OpenAI.
Belangrijkste punten
- Test in lagen: eerst de server alleen (Inspector, daarna ChatGPT), vervolgens de volledige plug-in
- Bouw een evaluatieset: directe, indirecte, vervolg-, schrijf- en buiten-scope-verzoeken
- De API Playground toont ruwe MCP-uitwisselingen
- Refresh na elke wijziging in metagegevens, start daarna een nieuw gesprek
- Bij problemen: isoleer eerst de laag: server, component of client