Comment configurer le Shopify AI Toolkit avec OpenAI Codex

Points clés à retenir

• Codex prend en charge la méthode par plugin (codex plugin add shopify@openai-curated), les skills manuels et MCP.
• L’installation manuelle des skills fonctionne, mais les schémas s’écartent de la plateforme en direct 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 sur la boutique s’exécutent immédiatement sur votre boutique en direct. Il n’y a pas d’étape de brouillon ni d’annulation (undo).

Pour configurer le Shopify AI Toolkit dans OpenAI Codex, exécutez codex plugin add shopify@openai-curated dans votre terminal, ou exécutez /plugins dans le CLI Codex, cherchez Shopify et sélectionnez Add to Codex. Posez ensuite une question sur l’API Shopify pour confirmer que Codex fait bien la recherche dans la documentation actuelle.

Une fois installé, Codex accède à la recherche dans la documentation Shopify, à la validation de code par rapport aux schémas API inclus, et au même ensemble de skills disponibles pour Claude Code et Cursor.

Pour une analyse complète de ce que fait la boîte à outils, 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 créons Fudge, l’opérateur IA pour les boutiques Shopify, avec une note de 4.9 sur le Shopify App Store et un badge Built for Shopify. Nous utilisons ces outils tous les jours.

Prérequis

• OpenAI Codex CLI installé et fonctionnel
• Node.js 18 ou supérieur, le minimum documenté par Shopify (utilisez node --version pour vérifier). Node 18 a atteint sa fin de vie en avril 2025, utilisez donc Node 20 LTS ou plus récent
• Shopify CLI installé (nécessaire pour les opérations sur la boutique)
• Une boutique Shopify à laquelle se connecter (nécessaire uniquement pour les opérations sur la boutique)

Installation : méthode par plugin

Dans votre terminal, exécutez la commande documentée par Shopify :

codex plugin add shopify@openai-curated

Ou, dans le CLI de Codex, 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 votre configuration ne peut pas utiliser le plugin, ou si vous préférez gérer le skill vous-même, installez-le directement :

npx skills add Shopify/shopify-ai-toolkit

Cela installe l’unique skill shopify du toolkit, qui couvre toutes les surfaces de développement Shopify : l’API GraphQL Admin, les Shopify Functions, Polaris, Liquid, Hydrogen et le Shopify CLI. Les versions précédentes proposaient un skill séparé par surface, comme shopify-admin et shopify-liquid. Ceux-ci sont obsolètes et ne sont plus mis à jour, donc si vous en avez installé un, supprimez-le (par exemple npx skills remove shopify-admin shopify-liquid) et installez le skill shopify à la place.

Les skills installés manuellement ne se mettent pas à jour automatiquement. Exécutez npx skills update régulièrement pour rester à jour avec les changements de l’API de Shopify. Sinon, les schémas inclus s’écarteront de la plateforme en direct.

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 tourne comme une intégration client/serveur locale mais effectue des appels réseau vers les endpoints Shopify pour la recherche de documentation.

Ajoutez ceci à votre fichier ~/.codex/config.toml, tel qu’indiqué dans la documentation du Shopify AI Toolkit :

[mcp_servers.shopify-dev-mcp]
command = "npx"
args = ["-y", "@shopify/dev-mcp@latest"]

Notez la clé mcp_servers en snake_case, là où les clients JSON utilisent mcpServers. Redémarrez Codex pour charger la nouvelle configuration.

Télémétrie et transmission de code

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

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 de validation réel inclut le code en cours de validation - vos requêtes GraphQL, templates Liquid, et tout autre code que vous faites passer par 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 (pas seulement la génération et validation de code), vous vous authentifiez via le Shopify CLI :

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

Le toolkit détecte les portées (scopes) minimales requises pendant la validation. Portées courantes :

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

Ce que vous pouvez faire

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

GraphQL validé - Requêtes et mutations validées par rapport au schéma de l’API Shopify inclus avant de les utiliser. Moins de champs hallucinés et de patterns obsolètes.

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

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

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

Opérations sur la boutique - Exécutez du GraphQL Admin sur une boutique en direct 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 champs méta (metafields) - Étendez le modèle de données de votre boutique avec des définitions de metafields et des données personnalisées.

Pour des exemples pratiques sur les thèmes, voir Comment ajouter une logique Liquid personnalisée dans Shopify.

Bonnes pratiques

Elles s’appliquent à tous les clients du toolkit, mais valent la peine d’être répétées.

1. Interrogez avant de muter. 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. “Optimise mes produits pour le SEO” est trop vague. “Mets à jour la meta description pour le produit avec le handle ‘classic-tee’ à ’…’” est suffisamment précis pour être sûr.

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

4. Une ressource à la fois pour les changements critiques. Limite le rayon d’impact si quelque chose tourne mal.

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

Limites

Elles sont structurelles 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 s’exécutent immédiatement sur votre boutique en direct
2. Pas d’aperçu - Vous ne pouvez pas voir à quoi ressembleront les changements avant qu’ils ne se produisent
3. Pas d’annulation/retour en arrière - Les changements sont permanents une fois exécutés
4. Pas de piste d’audit - Aucune trace au niveau du toolkit de ce qui a été modifié
5. Portées (scopes) trop larges - Les permissions OAuth s’appliquent à des types de ressources entiers, et non à 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 des skills manuels - Les installations sans plugin nécessitent des mises à jour manuelles régulières

Où Fudge intervient

Le AI Toolkit vous permet d’écrire plus rapidement du code Shopify : schémas, thèmes, Hydrogen, applications personnalisées. Ce n’est pas l’outil idéal pour l’équipe merchandising gérant les opérations quotidiennes, et il n’apporte pas le workflow dont les véritables changements sur la boutique ont besoin : brouillons, aperçus, approbations, historique des versions, retours en arrière (rollbacks). Le code vit dans git ; l’état de la boutique, non.

C’est la lacune que comble Fudge, l’opérateur IA pour les boutiques Shopify. Au lieu que chacun connecte Codex à la boutique et décide quoi modifier, votre équipe bénéficie d’un moyen clé en main pour continuer à l’améliorer : Fudge sélectionne les tâches qui valent la peine pour l’objectif que vous avez choisi, les prépare comme brouillons dans votre thème, et votre équipe prévisualise, approuve ou annule chaque changement.

Les requêtes liées au thème passent par son éditeur de boutique, et Codex reste utile pour le code personnalisé qu’écrivent vos développeurs.

Référence rapide

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

Nous avons revérifié les commandes de cette page par rapport à la documentation de Shopify pour la dernière fois en octobre 2026.

FAQ