Packager le plugin
På denna sida
Leçon réécrite le 3 novembre 2026 sur la base de la page Package your plugin de la documentation des plugins OpenAI. La leçon précédente décrivait la création d’un « paquet » pour un « ChatGPT Store » inexistant en utilisant un manifeste manquant. Un plugin est packagé avec un manifeste
plugin.jsonsuivant le schéma Agent Plugins. Source : Package your plugin.
Pourquoi packager
Une fois que tu as écrit tes compétences et, si nécessaire, construit le serveur MCP, l’étape finale consiste à les assembler en une unité installable. Le packagage donne à ton plugin une identité stable et indique à ChatGPT et Codex quelles compétences, connexions de serveurs MCP et ressources appartiennent ensemble. L’interface utilisateur et la logique d’authentification restent dans le serveur MCP ; le manifeste se contente de lier cette intégration au reste du bundle.
Structure d’un paquet portable
Un plugin portable possède un manifeste plugin.json à sa racine, déclarant le schéma Agent Plugins. Le dossier peut également contenir un répertoire skills/, un fichier mcp.json pour les serveurs MCP distribués avec le plugin, et des ressources visuelles dans assets/.
mon-plugin/
├── plugin.json
├── mcp.json
├── skills/
│ └── compte-rendu/
│ └── SKILL.md
└── assets/
├── icon.png
└── logo.png
Le manifeste minimal tient en quelques lignes. Le nom, stable et en kebab-case, sert à la fois d’identifiant et d’espace de noms pour les composants ; les compétences sont découvertes automatiquement dans skills/ sans avoir besoin d’une déclaration explicite.
{
"$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"
}
Chaque compétence réside dans skills/<nom>/SKILL.md, avec un en-tête fournissant son nom et sa description, suivi des instructions :
---
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.
Déclarer le serveur MCP
Les serveurs MCP distribués avec le plugin sont déclarés dans mcp.json à la racine, en utilisant le schéma correspondant et en spécifiant un type de transport pour chaque serveur :
{
"$schema": "https://agent-plugins.org/schemas/1.0.0/mcp.schema.json",
"mcpServers": {
"notes": {
"type": "streamable-http",
"url": "https://notes.example.com/mcp"
}
}
}
L’authentification du serveur est déclarée dans ce même fichier, sous extensions["com.openai"].auth pour chaque serveur : elle appartient au serveur, pas au manifeste. Pour une soumission publique, tu soumets le point de terminaison HTTPS distant ; les serveurs locaux suivent un chemin distinct réservé aux plugins de bureau.
Métadonnées spécifiques à OpenAI
La présentation du répertoire, les mappages vers des serveurs MCP déjà enregistrés et les hooks sont déclarés dans l’objet extensions.com.openai du fichier plugin.json racine, tandis que l’identité portable (name, version, description) reste à la racine :
{
"$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"
}
}
}
}
Les chemins dans cet objet sont relatifs à la racine du plugin et commencent par ./. Les ressources visuelles (composerIcon, logo, screenshots) doivent de préférence aller dans ./assets/. Le champ apps est utilisé uniquement pour pointer vers un fichier .app.json contenant les mappages vers des serveurs MCP déjà enregistrés dans ChatGPT.
Tu peux également déclarer une compétence d’intégration via extensions.com.openai.onboardingSkill (par exemple, ./skills/setup/SKILL.md) : elle guide l’utilisateur après l’installation pour choisir un espace de travail ou définir des préférences. Teste-la dans une nouvelle conversation et lors d’une installation en cours.
Un ancien format, avec un manifeste dans .codex-plugin/plugin.json, est toujours accepté pour la compatibilité : il n’est utilisé que si l’objet extensions.com.openai est absent, car les deux ne fusionnent pas. Les nouveaux paquets doivent utiliser le plugin.json racine.
La voie rapide : @plugin-creator
ChatGPT et Codex incluent une compétence, @plugin-creator, qui génère la structure pour toi — actuellement au format de compatibilité .codex-plugin/. Pour y attacher un serveur MCP, connecte d’abord ce serveur dans ChatGPT (Add custom MCP server, puis Create as a plugin), note l’ID de connexion technique depuis l’URL du navigateur — il commence par plugin_asdk_app — et fournis-le à @plugin-creator en mode Work (ou à $plugin-creator dans Codex). La compétence peut également créer une entrée de marché personnel, te permettant d’installer et de tester le plugin depuis ta source de répertoire local.
Marchés locaux
Un marché est un catalogue JSON de plugins. Il sert à l’écriture, aux tests et à la distribution en équipe parallèlement au répertoire public : en mode Work ou dans Codex, chaque marché apparaît comme une source sélectionnable dans le répertoire de plugins. C’est ainsi que tu testeras le plugin complet avant de le soumettre (Leçon 9).
Hooks : bureau uniquement
Les hooks de cycle de vie sont pris en charge uniquement pour les plugins installés manuellement dans l’application de bureau Codex, et un plugin les contenant n’est pas éligible pour le répertoire public. Si ton plugin vise la publication, laisse-les de côté.
Viktiga punkter
- Un paquet portable :
plugin.json(schéma Agent Plugins),skills/,mcp.json,assets/ - Le serveur MCP est déclaré dans
mcp.jsonavec son type de transport ; l’authentification y va aussi - La présentation, les mappages et la compétence d’intégration vont dans
extensions.com.openai @plugin-creatorgénère la structure ; un marché local sert aux tests- Un plugin avec des hooks n’est pas éligible pour le répertoire public