Erreurs de soumission des plugins

Les plugins soumis à l’annuaire public doivent respecter des exigences plus strictes que ceux installés dans un espace de travail. Pour figurer dans l’annuaire, un plugin doit réussir les contrôles communs à tous les paquets ainsi que les contrôles supplémentaires portant sur les champs de la fiche, les éléments fournis pour l’examen du plugin, les outils MCP, les skills, les ressources et les images. Cette référence couvre également les contrôles communs, notamment ceux des références aux serveurs MCP, dont les erreurs peuvent apparaître en dehors du portail de soumission.

Utilisez le code d’erreur renvoyé lors de la soumission pour retrouver l’exigence correspondante. Les erreurs bloquent la soumission. Les avertissements ne la bloquent pas, mais examinez-les avant de poursuivre.

Lorsqu’une valeur doit être non vide, elle doit contenir au moins un caractère autre qu’un caractère d’espacement. Le texte accepté exclut les caractères de contrôle, les séparateurs de ligne ou de paragraphe Unicode et les caractères de mise en forme invisibles non pris en charge. Les URL HTTPS doivent inclure un hôte et ne doivent contenir ni identifiants de connexion intégrés ni caractères non pris en charge.

Soumission finale à l’annuaire

Un paquet peut réussir la validation lors de l’importation, puis échouer lors de la soumission finale à l’annuaire. À cette étape, le portail applique des limites plus strictes aux champs de la fiche et vérifie la configuration MCP, les analyses des skills, les cas de test et les attestations de conformité aux politiques applicables.

Pour toute soumission de plugin, les exigences suivantes s’appliquent également :

• Chaque skill inclus dans le paquet doit réussir les contrôles de sûreté et de sécurité. Les analyses peuvent prendre jusqu’à 2 heures.
• L’identité du développeur ou de l’entreprise doit être vérifiée et toutes les attestations de conformité requises doivent être fournies.

Pour la soumission finale d’un plugin MCP distant, fournissez également les éléments suivants :

• Des URL conformes aux règles ci-dessus pour le site web, l’assistance, la politique de confidentialité et les conditions d’utilisation.
• Un lien vers une vidéo de démonstration présentant les principaux cas d’utilisation et outils sur les plateformes prises en charge.
• Exactement cinq cas de test positifs, trois cas de test négatifs et des notes de version.
• Une URL HTTPS pour le serveur MCP de production, une vérification de domaine réussie et une analyse des outils à jour et réussie.
• Des valeurs explicites pour readOnlyHint, openWorldHint et destructiveHint sur chaque outil MCP, avec une justification pour chaque valeur.
• Si le serveur utilise OAuth, des identifiants de démonstration utilisables par les personnes chargées de l’examen.

Erreurs de métadonnées lors de la soumission finale

Dans ces noms d’erreur, subtitle correspond à la description courte et description à la description longue.

Erreurs liées à MCP et à l’examen du plugin

Ces erreurs concernent les soumissions de serveurs MCP distants.

Erreurs d’archive

Erreurs et avertissements lors de l’importation d’un ZIP

L’option Skills uniquement du portail accepte les paquets ZIP de skills et les plugins MCP locaux approuvés. Ces derniers peuvent être dépourvus de skills. Les erreurs bloquent l’importation. En cas d’avertissement, vous devez confirmer l’importation.

Erreurs liées à la structure et aux limites du ZIP

Erreurs liées à la racine du plugin

Erreurs du manifeste du plugin

Erreurs de fiche et d’interface

L’objet interface du manifeste du plugin définit la fiche publique présentée aux utilisateurs. Il se trouve dans .codex-plugin/plugin.json et utilise notamment les champs displayName et shortDescription :

{
  "interface": {
    "displayName": "Example Plugin",
    "shortDescription": "Summarize documents",
    "longDescription": "Summarize and organize documents.",
    "developerName": "Example",
    "category": "Productivity",
    "capabilities": ["Summarize documents"]
  }
}

Les quatre URL de la fiche (site web, politique de confidentialité, conditions d’utilisation et assistance) sont facultatives pour les imports ZIP de plugins contenant uniquement des skills. Elles sont obligatoires pour les soumissions de serveurs MCP distants. Chaque URL est limitée à 2 048 caractères lors de la validation du paquet et à 1 024 caractères lors de la soumission finale à l’annuaire.

Erreurs liées au contenu du plugin

Erreurs du manifeste MCP

Ces erreurs concernent le fichier de compatibilité .mcp.json. Lors de l’importation d’un paquet portable, le système génère ce fichier et .codex-plugin/plugin.json à partir des fichiers plugin.json et mcp.json situés à la racine. Les erreurs de chemin des composants décrites ci-dessus peuvent également concerner ces fichiers générés. Corrigez la configuration source du paquet portable. Ne renommez pas mcp.json en .mcp.json simplement parce qu’un diagnostic de compatibilité mentionne ce dernier nom.

Erreurs liées aux skills

Erreurs liées aux métadonnées d’agent d’un skill

Un skill inclus dans le paquet peut définir sa propre interface dans skills/<skill>/agents/openai.yaml. Cette configuration détermine la présentation du skill aux utilisateurs et est distincte de l’objet interface du manifeste du plugin. Les noms des champs d’interface du skill suivent la convention snake_case :

interface:
  display_name: "Summarize documents"
  short_description: "Summarize a document"
  icon_small: "./assets/icon.png"
  default_prompt: "Summarize the selected document."

Erreurs liées aux chemins des ressources

Erreurs liées aux images

Les images de marque utilisées dans l’annuaire doivent être dans un format pris en charge et respecter les limites de taille et de dimensions ci-dessous. Ces règles s’appliquent aux ressources de marque incluses dans le paquet.

Erreurs de référence aux serveurs MCP

Les contrôles communs aux paquets valident .app.json lorsqu’un plugin référence des serveurs MCP enregistrés. Le portail de soumission ne publie pas les références à des intégrations existantes. Un import via Skills uniquement supprime .app.json. Utilisez Avec MCP pour soumettre directement le serveur MCP.

Dans les paquets locaux ou destinés à un espace de travail, l’objet apps situé à la racine associe chaque alias de serveur MCP à l’entrée d’un serveur enregistré. Ces noms de configuration et ces codes d’erreur conservent la graphie app.

Avertissements liés au paquet

Ces avertissements signalent les éléments du paquet que le processus de validation ignore ou normalise. Ils ne bloquent pas la soumission. Examinez-les pour vérifier que le plugin soumis contient les fichiers et les paramètres attendus.

Étapes suivantes

Après avoir corrigé toutes les erreurs de validation, revenez à la page Soumettre des plugins pour terminer la soumission.