Erreurs de soumission de plugins

Les plugins soumis à l’annuaire public doivent respecter des exigences plus strictes que les plugins installés dans un espace de travail. Les soumissions à l’annuaire doivent réussir les contrôles communs des packages ainsi que les contrôles supplémentaires portant sur les champs de la fiche, les éléments fournis pour la révision, les outils MCP, les skills, les ressources et les images. Cette référence couvre également les contrôles communs des packages, comme ceux des références aux serveurs MCP, qui peuvent intervenir en dehors du portail de soumission.

Utilisez le code d’erreur renvoyé lors de la soumission pour trouver l’exigence correspondante. Les erreurs bloquent la soumission. Les avertissements ne la bloquent pas, mais vous devez les examiner avant de continuer.

Les valeurs non vides ne peuvent pas contenir uniquement des caractères d’espacement. Le texte pris en charge 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 contenir ni identifiants intégrés ni caractères non pris en charge.

Soumission finale à l’annuaire

Un package peut réussir la validation lors du téléversement et échouer à la soumission finale à l’annuaire. Cette dernière impose des limites plus strictes à la fiche et vérifie la configuration MCP, les analyses des skills, les cas de test et les attestations de conformité aux politiques.

Toute soumission de plugin nécessite également :

• La réussite de toutes les analyses de sécurité pour chaque skill inclus. Ces analyses peuvent prendre jusqu’à 2 heures.
• Une identité de développeur ou d’entreprise vérifiée et toutes les attestations de conformité aux politiques requises.

Pour un plugin MCP à distance, la soumission finale nécessite également :

• Des URL du site web, de l’assistance, de la politique de confidentialité et des conditions d’utilisation conformes aux règles ci-dessus.
• L’URL d’un enregistrement 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 du serveur MCP en production, un défi de vérification du domaine réussi et une analyse des outils réussie et à jour.
• Des valeurs explicites pour readOnlyHint, openWorldHint et destructiveHint, ainsi qu’une justification de chaque valeur pour chaque outil MCP.
• Des identifiants de démonstration prêts à l’emploi pour les personnes chargées de la révision lorsque le serveur utilise OAuth.
• Des captures d’écran uniquement lorsque le serveur MCP fournit une interface personnalisée. Si vous ajoutez des captures d’écran, fournissez une image PNG ou JPEG pour chaque prompt de démarrage. Chaque capture d’écran doit mesurer exactement 706 pixels de large et entre 400 et 860 pixels de haut.

Erreurs de métadonnées à la soumission finale

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

Erreurs MCP et de révision

Ces erreurs s’appliquent aux soumissions MCP à distance.

Erreurs d’archive

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

Le parcours Skills uniquement du portail accepte les packages ZIP de skills. Les erreurs bloquent l’importation ; les avertissements nécessitent une confirmation.

Erreurs de structure et de limites du ZIP

Erreurs de racine du plugin

Erreurs du manifeste de 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 des champs tels que 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 envois de fichiers ZIP de plugins contenant uniquement des skills. Elles sont obligatoires pour les soumissions MCP distantes. Leur longueur est limitée à 2 048 caractères pour la validation du package et à 1 024 caractères pour la soumission définitive à l’annuaire.

Erreurs de contenu du plugin

Erreurs du manifeste MCP

Ces erreurs concernent le fichier de compatibilité .mcp.json. Pour les packages portables, l’ingestion génère ce fichier ainsi que .codex-plugin/plugin.json à partir des fichiers plugin.json et mcp.json situés à la racine. Les erreurs de chemin de composant ci-dessus peuvent également concerner ces fichiers générés. Corrigez la configuration portable source ; ne renommez pas mcp.json en .mcp.json simplement parce qu’un diagnostic de compatibilité mentionne ce nom.

Erreurs des skills

Erreurs de métadonnées d’agent des skills

Une skill incluse dans le package peut définir sa propre interface dans skills/<skill>/agents/openai.yaml. Cette configuration détermine la présentation de la skill aux utilisateurs et reste distincte de l’interface du manifeste du plugin. Les champs de l’interface de la skill utilisent la notation snake_case :

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

Erreurs de chemin des ressources

Erreurs d’image

Les images de marque destinées à l’annuaire doivent utiliser un type de fichier 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 package ; les captures d’écran des prompts de démarrage sont soumises aux limites distinctes du portail indiquées plus haut.

Erreurs de référence aux serveurs MCP

Les vérifications communes des packages valident .app.json lorsqu’un plugin référence des serveurs MCP enregistrés. Le portail de soumission ne publie pas de références à des intégrations existantes. Un envoi via Skills uniquement supprime .app.json. Utilisez Avec MCP pour soumettre directement le serveur MCP.

Pour les packages locaux ou d’espace de travail, l’objet apps de premier niveau associe chaque alias de serveur MCP à une entrée de serveur enregistré. Ces noms de configuration et codes d’erreur conservent la graphie littérale app.

Avertissements relatifs au package

Ces avertissements signalent le contenu du package que la 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 à Soumettre des plugins pour finaliser la soumission.