Het plug-in pakketteren
Op deze pagina
Les herschreven op 3 november 2026 op basis van de pagina Package your plugin in de OpenAI Plugins-documentatie. De vorige les beschreef het bouwen van een “pakket” voor een niet-bestaande “ChatGPT Store” met behulp van een ontbrekend manifest. Een plug-in wordt gepakket met een
plugin.json-manifest volgens het Agent Plugins-schema. Bron: Package your plugin.
Waarom pakketteren
Zodra u uw vaardigheden hebt geschreven en, indien nodig, de MCP-server hebt gebouwd, is de laatste stap het samenvoegen ervan tot een installeerbare eenheid. Pakketteren geeft uw plug-in een stabiele identiteit en vertelt ChatGPT en Codex welke vaardigheden, MCP-serververbindingen en bronnen bij elkaar horen. De UI- en authenticatielogica blijven in de MCP-server; het manifest koppelt die integratie eenvoudigweg aan de rest van het bundel.
Structuur van een draagbaar pakket
Een draagbare plug-in heeft een plugin.json-manifest in de hoofdmap, waarin het Agent Plugins-schema wordt gedeclareerd. De map kan ook een skills/-directory bevatten, een mcp.json-bestand voor MCP-servers die met de plug-in worden gedistribueerd, en visuele assets in assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Het minimale manifest past in slechts een paar regels. De naam, stabiel en in kebab-case, dient zowel als identificatie als als naamruimte voor componenten; vaardigheden worden automatisch ontdekt in skills/ zonder dat expliciete declaratie nodig is.
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes"
}
Elke vaardigheid leeft in skills/<naam>/SKILL.md, met een koptekst die de naam en beschrijving levert, gevolgd door instructies:
---
name: compte-rendu
description: Drafts meeting minutes from team notes.
---
Retrieve meeting notes using list_notes, group them by topic,
then draft a summary: decisions, action items with owners, and open points.
De MCP-server declareren
MCP-servers die met de plug-in worden gedistribueerd, worden gedeclareerd in mcp.json in de hoofdmap, met gebruik van het bijbehorende schema en specificatie van een transporttype voor elke server:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Serverauthenticatie wordt in ditzelfde bestand gedeclareerd, onder extensions["com.openai"].auth voor elke server; dit behoort toe aan de server, niet aan het manifest. Voor openbare indiening dient u het externe HTTPS-eindpunt in; lokale servers volgen een apart pad dat gereserveerd is voor desktop-plug-ins.
OpenAI-specifieke metadata
Directory-weergave, koppelingen aan reeds geregistreerde MCP-servers en hooks worden gedeclareerd in het extensions.com.openai-object van het hoofd-plugin.json, terwijl de draagbare identiteit (name, version, description) in de hoofdmap blijft:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team notes and meeting minutes",
"extensions": {
"com.openai": {
"interface": {
"displayName": "Team Notes",
"shortDescription": "Notes and meeting minutes",
"developerName": "Your Team",
"category": "Productivity",
"capabilities": ["Read", "Write"],
"websiteURL": "https://example.com",
"privacyPolicyURL": "https://example.com/privacy",
"termsOfServiceURL": "https://example.com/terms",
"defaultPrompt": ["Use Team Notes to draft Monday's meeting minutes."],
"composerIcon": "./assets/icon.png",
"logo": "./assets/logo.png"
}
}
}
}
Paden in dit object zijn relatief ten opzichte van de plug-in-hoofdmap en beginnen met ./. Visuele assets (composerIcon, logo, screenshots) kunnen het beste in ./assets/ worden geplaatst. Het veld apps wordt alleen gebruikt om te verwijzen naar een .app.json-bestand dat koppelingen bevat naar MCP-servers die al in ChatGPT zijn geregistreerd.
U kunt ook een onboarding-vaardigheid declareren via extensions.com.openai.onboardingSkill (bijvoorbeeld ./skills/setup/SKILL.md): deze leidt de gebruiker na installatie bij het kiezen van een werkruimte of het instellen van voorkeuren. Test dit in een nieuw gesprek en tijdens een lopende installatie.
Een oudere indeling, met een manifest in .codex-plugin/plugin.json, wordt nog steeds geaccepteerd voor compatibiliteit: deze wordt alleen gebruikt als het extensions.com.openai-object ontbreekt, aangezien de twee niet samenvoegen. Nieuwe pakketten moeten het hoofd-plugin.json gebruiken.
De snelle weg: @plugin-creator
ChatGPT en Codex bevatten een vaardigheid, @plugin-creator, die de structuur voor u genereert—momenteel in het compatibele .codex-plugin/-formaat. Om hier een MCP-server aan te koppelen, verbindt u eerst die server in ChatGPT (Add custom MCP server, vervolgens Create as a plugin), noteert u de technische verbindings-ID uit de browser-URL—deze begint met plugin_asdk_app—en geeft u deze door aan @plugin-creator in Work-modus (of aan $plugin-creator in Codex). De vaardigheid kan ook een persoonlijke marketplace-invoer maken, waardoor u de plug-in kunt installeren en testen vanuit uw lokale directory-bron.
Lokale marketplaces
Een marketplace is een JSON-catalogus van plug-ins. Deze dient voor het schrijven, testen en distribueren binnen teams, naast de openbare directory: in Work-modus of in Codex verschijnt elke marketplace als een selecteerbare bron in de plug-in-directory. Zo test u de volledige plug-in voordat u deze indient (Les 9).
Hooks: alleen desktop
Lifecycle-hooks worden alleen ondersteund voor plug-ins die handmatig zijn geïnstalleerd in de Codex-desktopapp, en een plug-in die deze bevat, komt niet in aanmerking voor de openbare directory. Als uw plug-in gericht is op publicatie, laat u deze weg.
Belangrijkste punten
- Een draagbaar pakket:
plugin.json(Agent Plugins-schema),skills/,mcp.json,assets/ - De MCP-server wordt gedeclareerd in
mcp.jsonmet zijn transporttype; authenticatie hoort daar ook thuis - Weergave, koppelingen en de onboarding-vaardigheid gaan naar
extensions.com.openai @plugin-creatorgenereert de structuur; een lokale marketplace is voor testen- Een plug-in met hooks komt niet in aanmerking voor de openbare directory