Tech & Performance
Shopify AI Toolkit dans Claude Code : installer
Shopify AI Toolkit avec Claude Code : plugin, skill ou serveur Dev MCP, ce que l’outil valide, la gestion de boutique et les limites à relire avant de s’en servir.
Shopify publie un kit pour brancher un agent de programmation, dont Claude Code, à ses ressources de développement : documentation, schémas d'API, validation de code et tâches de gestion de boutique. À notre avis, il s'adresse à qui touche au thème, aux extensions ou aux apps d'une boutique. Ce guide reprend la documentation de Shopify, pour l'installation, ce que le kit valide et ce qu'il ne dispense pas de relire. Il s'insère dans notre guide Claude et MCP pour le marketing e-commerce.
Ce que le kit apporte à l'agent
Shopify écrit que le kit donne à l'outil d'IA un point de départ qui connaît Shopify, et le relie à trois ressources.
- La documentation pour développeurs et les schémas d'API, pour travailler sur des références à jour plutôt que sur la seule mémoire du modèle ou une recherche web large.
- La validation de code : requêtes GraphQL, templates Liquid et extensions Shopify, contrôlés par rapport aux schémas de Shopify.
- La gestion de boutique : préparer et exécuter des tâches prises en charge, par le contexte authentifié de Shopify CLI, l'utilisateur choisissant le moment de l'exécution.
Trois façons de l'installer dans Claude Code
Prérequis indiqués par Shopify : Node.js 18 ou supérieur, et un outil d'IA pris en charge, Claude Code figurant dans la liste.
Le plugin, méthode recommandée
Shopify recommande le plugin, qui regroupe l'ensemble en une installation et se met à jour automatiquement. La commande donnée pour Claude Code est :
claude plugin install shopify-ai-toolkit@claude-plugins-officialPour comprendre ce qu'un plugin regroupe et comment en publier un pour votre équipe, voir notre article sur les plugins Claude Code.
Les skills, si vous gérez vous-même
Si l'outil ne gère pas les plugins, ou si vous préférez tenir les skills à la main, Shopify donne la commande ci-dessous. Le skill shopify couvre les surfaces pour développeurs : GraphQL Admin API, Shopify Functions, Polaris, Liquid, Hydrogen et Shopify CLI. L'agent ne lit les consignes d'une surface que lorsque la tâche l'exige.
npx skills add Shopify/shopify-ai-toolkitInstallés ainsi, les skills ne se mettent pas à jour seuls : Shopify indique de lancer npx skills update. La page précise aussi que les anciens skills par surface, comme shopify-admin ou shopify-liquid, sont dépréciés et ne reçoivent plus de mises à jour ; elle demande de les remplacer par le skill shopify. Pour la logique d'un skill, voir Skills Claude pour le marketing.
Le serveur Dev MCP
Si vous préférez MCP, Shopify propose le serveur Dev MCP, qui s'exécute en local et ne demande pas d'authentification. Pour Claude Code :
claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latestLa page demande ensuite de redémarrer Claude Code pour charger la configuration.
Un exemple donné par Shopify : migrer une extension
La documentation prend le cas des extensions de checkout et de comptes clients écrites pour des versions d'API antérieures à 2025-10, qui doivent passer aux composants web Polaris lors d'une montée de version. Elle liste le travail répétitif concerné : version d'API dans shopify.extension.toml, passage de React à Preact quand c'est requis, remplacement des composants historiques, mise à jour des API d'extension et des imports propres à chaque cible, lecture du guide de migration, test en local. L'exemple de demande est de migrer une extension vers la version d'API 2026-04. Shopify ajoute que le kit ne supprime pas le besoin de relire et de tester le résultat.
Ne pas confondre avec l'ancien MCP de boutique
Shopify a proposé un serveur MCP de boutique, Storefront MCP, pour chercher dans le catalogue et gérer des paniers. La page « Migrate from Storefront MCP » indique que les outils catalogue et panier de https://{shop}/api/mcp ont été retirés, et renvoie vers le Universal Commerce Protocol (UCP), disponible à https://{shop}/api/ucp/mcp. Elle précise que le serveur Customer Accounts MCP est inchangé. Si une procédure que vous suivez s'appuie sur l'ancienne adresse, rouvrez la page de Shopify avant de l'appliquer.
Garde-fous
- Relire et tester chaque modification de code avant de l'envoyer sur une boutique en ligne : Shopify écrit que le kit ne supprime pas ce besoin pour la migration d'extension, et nous l'étendons à tout changement de thème ou d'extension.
- À notre avis, tester d'abord sur une boutique de développement ou un thème de travail, pas sur le thème publié.
- À notre avis, laisser Claude Code demander une autorisation pour les commandes qui touchent la boutique. Pour limiter les outils accessibles, voir nos hooks de garde-fous.
- À notre avis, ne pas ranger de jeton d'accès dans un fichier de contexte partagé : voir CLAUDE.md.
- Garder en tête les risques liés aux textes que lit l'agent : voir injection de prompt et MCP.
Questions fréquentes sur Shopify AI Toolkit
Que faut-il pour installer Shopify AI Toolkit ?
Selon la documentation de Shopify, Node.js 18 ou une version supérieure, et un outil d’IA pris en charge, dont Claude Code. Le plugin est présenté comme la méthode recommandée.
Le serveur Dev MCP demande-t-il une authentification ?
Non d’après Shopify : la page indique qu’il s’exécute en local et ne demande pas d’authentification. Il donne accès aux ressources pour développeurs de Shopify.
Le plugin se met-il à jour tout seul ?
Oui pour le plugin, d’après Shopify, qui précise qu’il se met à jour automatiquement à mesure que de nouvelles capacités sortent. Les skills installés avec npx skills add ne se mettent pas à jour seuls : il faut lancer npx skills update.
Cet outil sert-il à analyser les ventes d’une boutique ?
Le skill shopify comprend une rubrique ShopifyQL pour préparer des requêtes sur les ventes, les commandes et les conversions. Son fichier officiel prévoit de passer par Shopify CLI pour exécuter ces requêtes sur la boutique.
Sources documentaires
- Shopify : Shopify AI Toolkit, Migrate from Storefront MCP