Ce que vous allez créer

Chaque plugin qui s’appuie sur MCP comprend trois éléments :

• Un serveur MCP qui définit les outils, renvoie les données, applique les règles d’authentification et indique à ChatGPT où trouver les éventuelles ressources de l’interface.
• Un composant web facultatif qui s’affiche dans une iframe de ChatGPT. Vous pouvez le créer avec React ou simplement avec HTML, CSS et JavaScript.
• Un modèle qui s’appuie sur les métadonnées que vous fournissez pour décider quand appeler les outils du plugin.

Codex est particulièrement utile lorsque vous lui confiez les tâches de développement répétitives liées à ces éléments :

• Définir les outils à exposer et leurs métadonnées.
• Générer la structure initiale du serveur et du widget.
• Configurer les scripts de lancement en local.
• Ajouter l’authentification et apporter les modifications nécessaires au déploiement, en traitant chaque sujet séparément.
• Mettre en place un cycle de tests pour vérifier que le plugin fonctionne dans ChatGPT.

Pourquoi utiliser Codex

• Les plugins qui s’appuient sur MCP se décomposent naturellement en un serveur, une interface facultative et des appels d’outils pilotés par le modèle.
• Codex répond mieux aux prompts lorsque la tâche est explicite, bien délimitée et facile à vérifier. Le développement d’un plugin se prête bien à cette approche.
• Les skills et le fichier AGENTS.md fournissent à Codex des instructions réutilisables et les règles du projet sur lesquelles s’appuyer.

Pour savoir comment installer et utiliser les skills, consultez notre documentation sur les skills.

Marche à suivre

Prérequis

• Commencez par une seule tâche essentielle pour l’utilisateur au lieu d’essayer de porter tout un produit dans une discussion.
• Choisissez vos technologies dès le départ : TypeScript ou Python pour le serveur, et React ou simplement HTML, CSS et JavaScript pour le widget.
• Choisissez comment vous rendrez le serveur accessible en HTTPS pendant le développement, par exemple avec ngrok ou Cloudflare Tunnel.
• Certains paramètres utilisent encore d’anciens termes pour la connexion à un serveur MCP. Lors des tests en local, ces libellés font référence au serveur enregistré.

1. Choisissez un objectif précis pour le plugin et demandez à Codex de proposer trois à cinq outils en précisant pour chacun son nom, sa description, ses entrées et ses sorties.
2. Déterminez si la première version peut se limiter aux données ou si elle nécessite un widget. Générez ensuite la structure initiale du serveur MCP et du widget éventuel en suivant les conventions du dépôt avant d’ajouter des dépendances.
3. Lancez le serveur MCP en local et rendez-le accessible en HTTPS. Connectez-le dans ChatGPT en suivant le guide Ajouter un serveur MCP personnalisé, puis testez-le avec quelques prompts directs, indirects et négatifs.
4. Ajustez les métadonnées, la gestion de l’état et le contenu de structuredContent et de _meta jusqu’à ce que le parcours de lecture principal fonctionne de manière fiable dans ChatGPT.
5. Ajoutez OAuth 2.1 uniquement si l’accès à des données propres à l’utilisateur ou des opérations d’écriture l’exigent, sans compliquer les parcours anonymes ou en lecture seule.
6. Préparez une version de prévisualisation hébergée avec un point de terminaison /mcp stable. Vérifiez la transmission des réponses en continu et l’hébergement des ressources de l’interface, puis passez en revue la liste de vérification avant de partager ou de soumettre le plugin.

Prompts suggérés

Les prompts efficaces pour ce workflow précisent les éléments suivants :

• Un objectif clair : indiquez ce que le plugin doit permettre à l’utilisateur de faire dans ChatGPT.
• Des technologies précises : indiquez si vous souhaitez utiliser TypeScript ou Python côté serveur, et si le widget doit utiliser React ou rester léger.
• Un rôle précis pour chaque outil : demandez à Codex de proposer ou de créer un petit nombre d’outils, chacun consacré à une seule tâche.
• Les besoins d’authentification : précisez si la première version peut fonctionner sans identification ou si elle nécessite des comptes associés et des opérations d’écriture.
• Les modalités de développement en local : précisez le tunnel ou la solution d’hébergement que vous comptez utiliser pour les tests en HTTPS dans ChatGPT.
• Les étapes de vérification : indiquez à Codex les commandes à exécuter, les prompts à tester et les éléments à fournir pour justifier les résultats.

Évitez de demander dans un seul prompt la planification, l’implémentation, l’authentification, le déploiement, la soumission et les finitions. Découpez le travail en étapes plus courtes.

Planifiez le plugin avant d’en créer la structure

Créez la structure d’une première version fonctionnelle

Ajoutez l’authentification une fois le parcours principal opérationnel

Préparez le plugin pour le déploiement et la revue

Vérifications avant le lancement

• Le plugin répond à un objectif précis que les utilisateurs peuvent comprendre.
• Les outils sont peu nombreux et leurs métadonnées, leurs entrées et leurs sorties sont clairement définies.
• Le serveur MCP fonctionne de bout en bout, renvoie un contenu concis dans structuredContent et réserve _meta aux données destinées uniquement au widget.
• Le widget, s’il est nécessaire, s’affiche correctement dans ChatGPT.
• Le cycle de tests en HTTPS fonctionne en local avec le serveur MCP personnalisé connecté dans ChatGPT.
• Les tests sur un petit jeu de prompts directs, indirects et négatifs réussissent : la conversation se déroule comme prévu et les outils échangent les données attendues.
• L’authentification intervient uniquement lorsque l’accès à des données propres à l’utilisateur ou les opérations d’écriture l’exigent.
• Avant le partage ou la soumission du plugin, le plan de déploiement et la revue préalable au lancement couvrent les métadonnées, les indications d’utilisation des outils, la confidentialité et les prompts de test.

Pièges courants

• Demander à Codex de porter tout le produit dans ChatGPT. Limitez votre demande à une tâche essentielle pour l’utilisateur, à trois à cinq outils et à un widget au rôle bien défini.
• Commencer par un seul prompt qui demande toute l’implémentation. Procédez par étapes : planification, création de la structure initiale, authentification, déploiement et revue.
• Créer l’interface avant d’avoir défini le contrat des outils. Définissez d’abord les outils à exposer et le schéma de réponse, puis créez le widget.
• Négliger l’ancrage dans la documentation officielle. Utilisez $chatgpt-apps avec $openai-docs pour que la structure initiale respecte les recommandations actuelles sur les plugins.
• Traiter les métadonnées en dernier. Rédigez dès le départ les descriptions des outils et la documentation des paramètres, puis relancez un jeu de prompts pour les tester.
• Ajouter l’authentification avant d’avoir vérifié le parcours anonyme ou en lecture seule. Faites d’abord fonctionner le parcours principal avec les outils, puis ajoutez OAuth pour ceux qui en ont réellement besoin.
• Considérer le plugin comme terminé avant de l’avoir testé dans ChatGPT. Connectez le serveur MCP personnalisé dans ChatGPT, examinez les données échangées par les outils et vérifiez le déroulement réel de la conversation.