Das Plugin verpacken
Auf dieser Seite
Lektion am 3. November 2026 neu formuliert basierend auf der Seite Package your plugin in der OpenAI Plugins-Dokumentation. Die vorherige Lektion beschrieb das Erstellen eines „Pakets” für einen nicht existierenden „ChatGPT Store” unter Verwendung eines fehlenden Manifests. Ein Plugin wird mit einem
plugin.json-Manifest verpackt, das dem Agent Plugins-Schema entspricht. Quelle: Package your plugin.
Warum verpacken
Sobald Sie Ihre Fähigkeiten geschrieben und ggf. den MCP-Server erstellt haben, besteht der letzte Schritt darin, diese zu einer installierbaren Einheit zusammenzufassen. Das Verpacken verleiht Ihrem Plugin eine stabile Identität und teilt ChatGPT und Codex mit, welche Fähigkeiten, MCP-Server-Verbindungen und Ressourcen zusammengehören. Die Benutzeroberfläche und die Authentifizierungslogik bleiben im MCP-Server; das Manifest verknüpft lediglich diese Integration mit dem Rest des Bündels.
Struktur eines portablen Pakets
Ein portables Plugin verfügt über ein plugin.json-Manifest an der Wurzel, das das Agent Plugins-Schema deklariert. Der Ordner kann zusätzlich ein skills/-Verzeichnis, eine mcp.json-Datei für mit dem Plugin verteilte MCP-Server und visuelle Assets im assets/-Ordner enthalten.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Das minimale Manifest passt in nur wenigen Zeilen. Der Name, stabil und in kebab-case, dient sowohl als Identifier als auch als Namespace für Komponenten; Fähigkeiten werden automatisch im skills/-Verzeichnis entdeckt, ohne dass eine explizite Deklaration erforderlich ist.
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team-Notizen und Protokolle"
}
Jede Fähigkeit lebt in skills/<name>/SKILL.md, mit einem Header, der ihren Namen und ihre Beschreibung liefert, gefolgt von Anweisungen:
---
name: compte-rendu
description: Entwirft Protokolle aus Team-Notizen.
---
Rufen Sie die Protokollnotizen mit list_notes ab, gruppieren Sie diese nach Thema,
und entwerfen Sie dann eine Zusammenfassung: Entscheidungen, Aufgaben mit Verantwortlichen und offene Punkte.
Der MCP-Server deklarieren
MCP-Server, die mit dem Plugin verteilt werden, werden in mcp.json an der Wurzel unter Verwendung des entsprechenden Schemas und der Angabe eines Transporttyps für jeden Server deklariert:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
Die Server-Authentifizierung wird in derselben Datei unter extensions["com.openai"].auth für jeden Server deklariert – sie gehört zum Server, nicht zum Manifest. Für die öffentliche Einreichung übermitteln Sie das entfernte HTTPS-Endpunkt; lokale Server folgen einem separaten Pfad, der für Desktop-Plugins reserviert ist.
OpenAI-spezifische Metadaten
Verzeichnispräsentationen, Zuordnungen zu bereits registrierten MCP-Servern und Hooks werden im Objekt extensions.com.openai des Wurzel-plugin.json deklariert, während die portable Identität (name, version, description) an der Wurzel bleibt:
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json",
"name": "notes-equipe",
"version": "0.1.0",
"description": "Team-Notizen und Protokolle",
"extensions": {
"com.openai": {
"interface": {
"displayName": "Team-Notizen",
"shortDescription": "Notizen und Protokolle",
"developerName": "Ihr Team",
"category": "Produktivität",
"capabilities": ["Read", "Write"],
"websiteURL": "https://example.com",
"privacyPolicyURL": "https://example.com/privacy",
"termsOfServiceURL": "https://example.com/terms",
"defaultPrompt": ["Verwenden Sie Team-Notizen, um das Protokoll für Montag zu entwerfen."],
"composerIcon": "./assets/icon.png",
"logo": "./assets/logo.png"
}
}
}
}
Pfade in diesem Objekt sind relativ zur Plugin-Wurzel und beginnen mit ./. Visuelle Assets (composerIcon, logo, screenshots) sollten bevorzugt im ./assets/-Ordner liegen. Das apps-Feld wird ausschließlich verwendet, um auf eine .app.json-Datei zu verweisen, die Zuordnungen zu MCP-Servern enthält, die bereits in ChatGPT registriert sind.
Sie können auch eine Onboarding-Fähigkeit über extensions.com.openai.onboardingSkill deklarieren (z. B. ./skills/setup/SKILL.md): Sie führt den Benutzer nach der Installation durch, um einen Arbeitsbereich auszuwählen oder Einstellungen festzulegen. Testen Sie sie in einem neuen Gespräch und während einer laufenden Installation.
Ein älteres Format mit einem Manifest in .codex-plugin/plugin.json wird weiterhin aus Kompatibilitätsgründen akzeptiert: Es wird nur verwendet, wenn das Objekt extensions.com.openai fehlt, da sich beide nicht verschmelzen. Neue Pakete sollten das Wurzel-plugin.json verwenden.
Der Expressweg: @plugin-creator
ChatGPT und Codex enthalten eine Fähigkeit, @plugin-creator, die die Struktur für Sie generiert – derzeit im Kompatibilitätsformat .codex-plugin/. Um einen MCP-Server daran anzuhängen, verbinden Sie diesen Server zunächst in ChatGPT (Benutzerdefinierten MCP-Server hinzufügen, dann Als Plugin erstellen), notieren Sie die technische Verbindungs-ID aus der Browser-URL – sie beginnt mit plugin_asdk_app – und geben Sie sie @plugin-creator im Arbeitsmodus (oder $plugin-creator in Codex) an. Die Fähigkeit kann auch einen Eintrag in einem persönlichen Marktplatz erstellen, sodass Sie das Plugin aus dem lokalen Verzeichnisquellcode installieren und testen können.
Lokale Marktplätze
Ein Marktplatz ist ein JSON-Katalog von Plugins. Er dient dem Schreiben, Testen und der Teamverteilung neben dem öffentlichen Verzeichnis: In Work-Modus oder in Codex erscheint jeder Marktplatz als auswählbare Quelle im Plugin-Verzeichnis. So testen Sie das vollständige Plugin, bevor Sie es einreichen (Lektion 9).
Hooks: Nur für Desktop
Lebenszyklus-Hooks werden nur für manuell in der Codex-Desktop-App installierte Plugins unterstützt, und ein Plugin, das diese enthält, ist nicht für das öffentliche Verzeichnis eligible. Wenn Ihr Plugin der Veröffentlichung dient, lassen Sie diese aus.
Kernaussagen
- Ein portables Paket:
plugin.json(Agent Plugins-Schema),skills/,mcp.json,assets/ - Der MCP-Server wird in
mcp.jsonmit seinem Transporttyp deklariert; die Authentifizierung erfolgt ebenfalls dort - Präsentation, Zuordnungen und die Onboarding-Fähigkeit befinden sich in
extensions.com.openai @plugin-creatorgeneriert die Struktur; ein lokaler Marktplatz dient zum Testen- Ein Plugin mit Hooks ist nicht für das öffentliche Verzeichnis eligible