Comment configurer le Shopify AI Toolkit avec OpenAI Codex

Points clés

• Codex prend en charge l’installation des skills et de MCP, mais pas la méthode par plugin disponible dans Claude Code et Cursor.
• L’installation manuelle des skills fonctionne, mais les schémas finissent par se désynchroniser de la plateforme en live sans mises à jour manuelles.
• La configuration MCP pour Codex utilise le format TOML, contrairement au JSON pour Cursor et Gemini CLI.
• Définissez OPT_OUT_INSTRUMENTATION=true avant votre première validation si vous travaillez avec du code propriétaire.
• Les opérations de boutique s’exécutent immédiatement sur votre boutique en ligne. Il n’y a pas d’étape de brouillon ni d’annulation possible.

Le Codex CLI d’OpenAI est l’un des outils de développement IA pris en charge par le Shopify AI Toolkit, avec son propre manifeste de plugin dans le dépôt. Une fois installé, Codex a accès à la recherche dans la documentation Shopify, à la validation du code par rapport aux schémas d’API intégrés et à la même gamme de skills disponible pour Claude Code et Cursor.

Ce guide couvre la configuration et ce qu’il faut savoir. Pour une analyse complète de ce que fait le toolkit, de son fonctionnement et des risques de gouvernance liés à l’exécution sur la boutique, consultez notre présentation du Shopify AI Toolkit.

Pourquoi vous pouvez nous faire confiance

Jacques a plus de 15 ans d’expérience en développement et a travaillé avec des centaines de boutiques Shopify. Nous avons créé Fudge - un constructeur de pages et éditeur de boutique Shopify natif pour l’IA avec une note de 5,0 et un badge Built for Shopify. Nous utilisons ces outils au quotidien.

Prérequis

• OpenAI Codex CLI installé et fonctionnel
• Node.js 18 ou supérieur (node --version pour vérifier)
• Shopify CLI installé (nécessaire pour les opérations sur la boutique)
• Une boutique Shopify à laquelle se connecter (requis uniquement pour les opérations sur la boutique)

Installation : méthode par plugin

Dans le Codex CLI, exécutez :

/plugins

Cherchez Shopify, puis sélectionnez Add to Codex.

Cela installe le plugin Shopify avec tous les skills d’agent disponibles.

Vérifier l’installation

Demandez à Codex quelque chose de spécifique à Shopify :

What's the correct GraphQL mutation to update a product's title in the Shopify Admin API?

Si le toolkit est actif, Codex cherchera dans la documentation actuelle de Shopify et validera sa sortie au lieu de l’halluciner à partir de ses données d’entraînement.

Alternative : installation manuelle des skills

Si vous préférez installer les skills manuellement :

Installer tous les skills

npx skills add Shopify/shopify-ai-toolkit

Installer un skill spécifique

npx skills add Shopify/shopify-ai-toolkit --skill shopify-admin

Les skills installés manuellement ne se mettent pas à jour tout seuls. Les schémas intégrés finiront par différer de la plateforme en ligne si vous ne les réinstallez pas périodiquement.

Alternative : configuration du serveur MCP

Pour une intégration MCP directe, Codex utilise la configuration TOML (contrairement à Cursor et Gemini CLI qui utilisent JSON). Le serveur Dev MCP fonctionne comme une intégration locale serveur/client mais fait des appels réseau vers les endpoints Shopify pour la recherche de documentation.

Consultez la documentation du Shopify AI Toolkit pour connaître le format de configuration TOML spécifique à Codex.

Télémétrie et transmission de code

Avant de commencer à valider du code : validate.mjs et search_docs.mjs envoient par défaut des payloads d’utilisation aux serveurs de Shopify.

Les fichiers SKILL.md décrivent cela comme des “résultats de validation anonymisés (succès/échec et nom du skill)”. Cependant, le payload réel de validation inclut le code en cours de validation - vos requêtes GraphQL, vos templates Liquid et tout autre code que vous passez dans le validateur.

Pour vous désinscrire (opt out) :

export OPT_OUT_INSTRUMENTATION=true

Définissez ceci avant de lancer Codex si vous travaillez avec du code propriétaire ou client.

Connexion à votre boutique

Pour les opérations sur la boutique (et pas seulement la génération et la validation de code), vous vous authentifiez via Shopify CLI :

shopify store auth --store votreboutique.myshopify.com --scopes write_products,read_products

Le toolkit détecte les scopes minimums requis pendant la validation. Scopes courants :

Utilisez les scopes minimaux nécessaires. write_products donne accès à toutes les opérations d’écriture sur les produits, pas seulement à la mutation spécifique que vous exécutez.

Ce que vous pouvez faire

Les capacités sont les mêmes pour tous les clients IA compatibles. Voici ce que permet le toolkit :

GraphQL validé - Requêtes et mutations validées par rapport au schéma d’API Shopify intégré avant de les utiliser. Fini les champs sortis de nulle part (hallucinés) ou les modèles obsolètes.

Développement de thèmes - Templates Liquid validés par rapport aux règles de thème de Shopify, y compris les blocs de schéma et les en-têtes LiquidDoc.

Lié : ajouter une logique Liquid personnalisée dans Shopify.

Vitrines Hydrogen - Génération de composants React avec des imports et des patterns validés.

Fonctions et extensions - Personnalisation du backend (réductions, validation du panier, règles de livraison) et du scaffolding d’extensions d’interface utilisateur (UI) avec les composants Polaris.

Lié : ajouter du JavaScript personnalisé dans Shopify.

Opérations sur la boutique - Exécutez de l’Admin GraphQL sur une boutique en ligne via shopify store execute --allow-mutations. Les changements sont immédiats - il n’y a pas d’étape de brouillon. Consultez notre guide principal pour l’analyse complète des risques.

Gestion des metafields - Étendez le modèle de données de votre boutique avec des définitions de metafields et des données personnalisées.

Lié : ajouter des metafields aux produits Shopify.

Bonnes pratiques

Celles-ci s’appliquent à tous les clients du toolkit, mais méritent d’être répétées.

1. Faites une requête avant la mutation. Lisez toujours l’état actuel d’une ressource avant de la mettre à jour. Cela évite les écrasements involontaires.

2. Soyez précis avec les mutations. “Optimiser mes produits pour le SEO” est trop vague. “Mettre à jour la meta description pour le handle de produit ‘classic-tee’ vers ’…’” est suffisamment précis pour être sûr.

3. Poussez les thèmes en mode non publié. Le toolkit prend en charge shopify theme push --unpublished mais ne l’impose pas. Prenez-en l’habitude.

4. Une ressource à la fois pour les changements critiques. Limite les dommages collatéraux (blast radius) si quelque chose se passe mal.

5. Gardez vos propres sauvegardes. Le toolkit n’a pas d’annulation (undo). Exportez les valeurs actuelles avant d’exécuter des mutations qui mettent à jour le contenu existant.

Limitations

Elles sont inhérentes au toolkit, et non spécifiques à Codex. Pour l’analyse complète des risques, consultez notre présentation du Shopify AI Toolkit.

1. Pas de mode brouillon - Les mutations sur la boutique s’exécutent immédiatement sur votre boutique en direct
2. Pas d’aperçu (preview) - Vous ne pouvez pas voir à quoi ressembleront les changements avant qu’ils ne se produisent
3. Pas d’annulation/rollback - Les changements sont permanents une fois exécutés
4. Pas d’historique d’audit - Aucune trace de ce qui a été modifié au niveau du toolkit
5. Scopes larges - Les permissions OAuth s’appliquent à des types entiers de ressources, pas à des éléments individuels
6. Code envoyé à Shopify - Les payloads de validation incluent votre code par défaut (désinscrivez-vous avec OPT_OUT_INSTRUMENTATION=true)
7. Obsolescence manuelle des skills - Les installations sans plugin nécessitent des mises à jour manuelles régulières

Où Fudge intervient

L’AI Toolkit vous permet d’écrire du code Shopify plus rapidement — schémas, thèmes, Hydrogen, applications personnalisées. Ce n’est pas l’interface idéale pour l’équipe merch qui gère les opérations quotidiennes, et il n’apporte pas le workflow dont les vraies modifications de boutique ont besoin : brouillons, aperçus, approbations, historique des versions, lancements programmés, rollbacks. Le code vit dans git ; l’état de la boutique, non. C’est ce vide que Fudge comble — un éditeur Shopify natif IA avec des brouillons, des aperçus et des rollbacks pour les membres de votre équipe qui ne devraient pas écrire de GraphQL.

Référence rapide

Résumé

Le Shopify AI Toolkit fonctionne avec Codex de la même manière qu’avec Claude Code et Cursor : recherche dans la documentation, validation des schémas, et exécutions optionnelles sur la boutique. La valeur réside dans la boucle de précision - Codex arrête de deviner les API de Shopify et commence à les valider par rapport aux véritables schémas.

Les mêmes avertissements de gouvernance s’appliquent : pas de brouillons, pas d’aperçu, pas d’annulation, et télémétrie du code activée par défaut. Définissez OPT_OUT_INSTRUMENTATION=true si vous travaillez sur des projets propriétaires, et soyez prudent avec les exécutions sur la boutique.

Pour avoir une vue d’ensemble des risques, lisez notre présentation du Shopify AI Toolkit. Pour les autres plateformes, consultez notre guide Claude Code et notre guide Cursor.

Cet article a été mis à jour pour la dernière fois en avril 2026 à la suite de la sortie de Shopify Editions Winter 2026.

FAQ

Pourquoi la config MCP de Codex est-elle en TOML au lieu du JSON comme sur les autres clients ?

Le CLI de Codex d’OpenAI utilise TOML comme format global de configuration, la configuration du serveur MCP suit donc cette convention. Cursor, le CLI de Gemini et la plupart des autres clients MCP utilisent JSON. Les capacités sont identiques — seule la syntaxe de la configuration diffère. Traduisez les exemples JSON de la doc de Shopify en TOML pour Codex.

Est-ce qu’OpenAI Codex peut exécuter des mutations en direct sur une boutique Shopify ?

Oui, grâce à l’intégration du CLI Shopify (shopify store execute --allow-mutations). Codex génère la mutation, la valide par rapport au schéma, puis déclenche le CLI pour l’exécuter sur votre boutique authentifiée. Mêmes avertissements que pour les autres clients : pas de mode brouillon, pas d’aperçu, pas d’annulation.

Codex met-il à jour automatiquement le Shopify AI Toolkit ?

L’installation par plugin se met à jour automatiquement avec les releases de Shopify. Les installations manuelles via npx skills add ne le font pas — vous devrez relancer la commande périodiquement pour garder vos schémas à jour. Codex n’a pas son propre mécanisme de mise à jour pour le toolkit ; il s’appuie sur la méthode d’installation sous-jacente.

Le Shopify AI Toolkit fonctionne-t-il avec plusieurs boutiques Shopify dans Codex ?

Oui — ré-authentifiez-vous via shopify store auth --store <domain> pour chaque boutique. Le CLI garde une trace de la boutique active et Codex utilise celle qui est actuellement authentifiée. Passer d’une boutique à l’autre se fait en une seule commande. Utile lorsque vous naviguez entre des environnements de dev/staging/production.

Comment Codex se compare-t-il à Claude Code pour le développement Shopify ?

Les deux prennent en charge le même toolkit et les mêmes skills. Les différences résident dans les capacités de l’agent (qualité du modèle, boucles agentiques, compréhension de la codebase) — choisissez celui que vous préférez pour le développement général. Claude Code a une intégration plus forte avec sa marketplace de plugins ; Codex a une config basée sur TOML. Les capacités sur Shopify sont équivalentes.