Comment piloter toute votre boutique Shopify depuis Claude Code : le guide d'installation pour marchand non technique
Guide pas à pas pour les propriétaires de boutique Shopify : installer Claude Code avec Shopify CLI, Shopify Dev MCP, Nano Banana pour les images IA et Google Search Console — et exécuter mises à jour produits, correctifs SEO et génération d'images en autonomie.
Si vous opérez une boutique Shopify et que vous suivez la conversation IA depuis le banc en vous demandant quand elle devient enfin utile pour vous — pas pour les développeurs, pas pour le « vous du futur qui apprendra à coder », mais pour l’opérateur qui met à jour des produits et rédige des descriptions un mardi après-midi —, ce moment est arrivé.
Ces six derniers mois, trois choses sont devenues vraies en même temps :
- Claude Code d’Anthropic (l’outil terminal qui permet à Claude de faire réellement des choses sur votre ordinateur au lieu d’en parler) est devenu suffisamment stable pour que les non-développeurs l’utilisent en sécurité.
- Shopify a livré un serveur Dev MCP officiel qui donne à Claude un accès direct à la documentation, aux schémas GraphQL et aux meilleures pratiques API de Shopify.
- L’écosystème MCP a explosé — il existe désormais des serveurs communautaires pour gérer votre boutique Shopify, générer des images avec Nano Banana de Google, tirer des données Google Search Console, publier sur Klaviyo et une centaine d’autres choses, parlant tous le même protocole.
Branchez-les ensemble et vous obtenez un setup où vous pouvez taper « trouve les 20 produits avec le plus faible CTR dans Search Console, réécris leurs meta descriptions, génère de nouvelles images héros lifestyle pour le top 5 et place tout en brouillon pour que je relise avant publication » — et partir pendant que ça tourne.
Ce guide vous emmène de zéro logiciel installé à ce workflow exact. Il est écrit pour un marchand Shopify à l’aise pour copier-coller des commandes mais qui n’écrit pas de code. Temps de setup total : environ 60 à 90 minutes la première fois. Après, chaque nouvelle automatisation prend des minutes.
Ce que vous aurez à la fin
À la fin de ce guide, vous aurez Claude Code qui tourne sur votre ordinateur avec quatre superpouvoirs connectés :
- Shopify Dev MCP — la doc officielle Shopify et la connaissance API intégrées, pour que Claude n’invente jamais de faux champs ni de syntaxe dépassée
- Un MCP de gestion de boutique Shopify — contrôle réel sur produits, commandes, clients, collections et images de votre boutique en ligne
- Nano Banana MCP — génération et édition d’images propulsées par Google Gemini (le même modèle derrière certaines des meilleures photographies produits IA que vous avez vues cette année)
- Google Search Console MCP — données SEO en direct que Claude peut lire et exploiter sans que vous n’exportiez de CSV
C’est la boucle complète : voir ce qui ne va pas, le corriger, générer les assets, pousser sur Shopify, vérifier dans Search Console. Le tout depuis une seule fenêtre de chat.
Pourquoi cela compte maintenant (contexte avril 2026)
Quelques choses à savoir avant de démarrer, parce que le paysage a bougé le trimestre dernier et que la plupart des tutos en ligne sont périmés :
- Depuis le 1er janvier 2026, les nouvelles apps Shopify sont créées dans le Dev Dashboard et utilisent des identifiants client OAuth (un client ID et un secret) au lieu des anciens tokens d’accès statiques
shpat_. Si vous suivez un tuto plus ancien qui vous dit de copier un tokenshpat_xxxxx, cela ne marchera que pour les anciennes custom apps. Les nouveaux setups utilisent des paires clientId/clientSecret, et le serveur MCP les échange contre des tokens à courte durée automatiquement. - La version d’API Shopify par défaut que ciblent la plupart des MCP est
2026-01. Tout tuto faisant référence à2024-04ou antérieur est dépassé. - Nano Banana 2 (Gemini 3.1 Flash Image) est désormais le défaut pour la plupart des MCP image — il vous donne une qualité de niveau Pro à la vitesse du Flash et tourne à environ 0,04 à 0,05 $ par image en résolution standard, jusqu’à environ 0,15 $ par image en 4K.
- Il existe deux MCP Shopify et ils font des choses différentes. Shopify Dev MCP est un outil développeur qui tourne en local et donne accès à la documentation Shopify et aux schémas API. Il ne contrôle pas votre boutique. Pour les actions réelles en boutique (créer des produits, mettre à jour les prix, gérer les collections), vous avez besoin d’un MCP communautaire séparé. Nous installerons les deux.
Compris ? Bien. Installons.
Étape 1 : installer la fondation (Node.js et Claude Code)
Vous aurez besoin de Node.js 18 ou supérieur pour presque tout dans cette stack. Si vous ne l’avez jamais installé :
- Allez sur nodejs.org et téléchargez la version LTS pour votre système d’exploitation.
- Lancez l’installeur avec les paramètres par défaut.
- Ouvrez Terminal (Mac) ou Invite de commandes / PowerShell (Windows) et tapez
node --version. Vous devriez voir quelque chose commev20.x.xou supérieur.
Ensuite, installez Claude Code :
npm install -g @anthropic-ai/claude-code
Puis lancez-le une fois pour vous connecter :
claude
Cela ouvrira un navigateur, vous demandera de vous connecter à votre compte Anthropic, et vous reviendrez au terminal avec une session Claude Code fonctionnelle. Tapez /exit pour la quitter pour l’instant.
Avertissement : Claude Code sous Windows peut être capricieux avec les serveurs MCP — beaucoup de serveurs communautaires présupposent des chemins Mac/Linux. Si vous êtes sous Windows et que c’est votre première fois, le chemin le plus fluide consiste à installer WSL2 (Windows Subsystem for Linux) et faire tourner tout depuis Ubuntu. Cela prend 15 minutes de plus mais économise des heures de débogage.
Étape 2 : installer le Shopify CLI
Le Shopify CLI est l’outil en ligne de commande officiel pour travailler avec thèmes, apps et données de boutique. Claude Code l’utilisera en dessous.
npm install -g @shopify/cli@latest
Vérifiez avec shopify version — vous devriez voir un numéro de version. Si vous voulez vous connecter à votre boutique maintenant (optionnel mais utile), lancez shopify auth login et suivez l’invite du navigateur.
Étape 3 : ajouter le Shopify Dev MCP officiel
C’est celui qui donne à Claude accès à la documentation, aux schémas GraphQL et à la validation de code de Shopify. Il n’a pas besoin d’authentification et tourne entièrement sur votre machine.
claude mcp add --scope user shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest
Voilà. Redémarrez Claude Code (/exit puis claude à nouveau), et vous pouvez immédiatement demander des choses comme :
- « Montre-moi la mutation GraphQL pour mettre à jour le metafield d’un produit en version d’API 2026-01 »
- « Quels scopes mon app a-t-elle besoin pour lire les commandes brouillons ? »
Le Dev MCP inclut un outil appelé learn_shopify_api qui doit être appelé avant tout autre outil Shopify dans une conversation donnée — il génère un conversationId dont les autres outils ont besoin. Claude le sait et l’appellera automatiquement. Vous n’avez pas à y penser.
Étape 4 : ajouter un MCP de gestion de boutique Shopify
C’est le MCP qui fait réellement les choses dans votre boutique — crée des produits, met à jour les stocks, traite les commandes, gère les collections. Il y a deux voies principales.
Option A : MCP communautaire (gratuit, plus de setup)
L’option open source la plus populaire est shopify-mcp de GeLi2001. C’est un package Node, tourne en local et supporte à la fois les anciens tokens d’accès et les nouvelles credentials OAuth.
Pour les nouvelles apps Shopify (post-janvier 2026) :
- Depuis votre admin Shopify, allez dans Settings > Apps and sales channels > Develop apps (ou le nouveau Dev Dashboard si votre boutique l’a activé).
- Créez une custom app, configurez les scopes API que vous voulez donner à Claude (commencez petit —
read_products,write_products,read_ordersest un trio de départ sensé) et copiez le Client ID et Client Secret. - Ajoutez le MCP à Claude Code :
claude mcp add shopify -- npx shopify-mcp \
--clientId YOUR_CLIENT_ID \
--clientSecret YOUR_CLIENT_SECRET \
--domain your-store.myshopify.com
Le serveur échangera ces credentials contre des tokens à courte durée (valables environ 24 heures) automatiquement.
Pour les anciennes custom apps avec un token shpat_ statique :
claude mcp add shopify -- npx shopify-mcp \
--accessToken YOUR_ACCESS_TOKEN \
--domain your-store.myshopify.com
Important : assurez-vous d’installer shopify-mcp et non shopify-mcp-server — ce sont des packages différents avec des noms d’arguments différents, et les confondre cause des erreurs.
Option B : Composio (payant, presque zéro setup)
Si les commandes terminal vous donnent de l’urticaire, Composio propose un MCP hébergé qui gère tout l’OAuth pour vous. Vous vous connectez une fois sur composio.dev, connectez votre boutique Shopify via leur UI et ils vous donnent une URL MCP unique à ajouter à Claude Code. Cela coûte de l’argent mais économise environ une heure de bricolage. Pour les marchands qui opèrent plusieurs boutiques ou qui ne veulent pas gérer des credentials, cela en vaut la peine.
De toute façon, redémarrez Claude Code après ajout du serveur. Vérifiez qu’il est chargé avec claude mcp list.
Étape 5 : ajouter Nano Banana pour la génération d’images IA
Nano Banana est le nom convivial des modèles de génération d’images Gemini de Google. Nano Banana 2 (Gemini 3.1 Flash Image) est le défaut actuel — il vous donne une sortie capable de 4K, de la cohérence de personnage à travers plusieurs générations et un rendu de texte net dans les images, ce qui est la partie qui rend enfin l’IA utilisable pour la véritable photographie produit.
Vous aurez besoin d’une clé API Gemini d’abord. Allez sur Google AI Studio (aistudio.google.com), connectez-vous avec votre compte Google et créez une clé API. La génération d’images exige que la facturation soit activée — les modèles texte sont gratuits, mais la génération d’images est à l’usage. Il n’y a pas de minimum mensuel.
Puis ajoutez le MCP :
claude mcp add nano-banana \
--env GEMINI_API_KEY=your_api_key_here \
-- npx @rafarafarafa/nano-banana-pro-mcp
Redémarrez Claude Code et vous pouvez maintenant demander des choses comme :
- « Génère une image héros pour la nouvelle collection rideaux en lin — lumière naturelle de matin entrant par une fenêtre dans un salon scandinave, tons beiges doux, ratio 16:9, 4K »
- « Prends cette photo produit et édite-la pour montrer le rideau sur un mur de couleur différente »
Le MCP supporte text-to-image, édition image-vers-image et images de référence pour le style transfer. Attente de coût pour une boutique active : générer 50 à 100 images par mois pour variations produit, plans lifestyle et bannières héros coûte environ 5 à 15 $.
Étape 6 : ajouter Google Search Console MCP
C’est là que la boucle SEO se referme. Avec Claude Code qui lit vos données Search Console en direct, il peut identifier les pages sous-performantes, proposer des correctifs, les appliquer à vos produits Shopify et à votre thème, et resoumettre les URLs pour indexation — le tout en une session.
L’option la plus activement maintenue est mcp-gsc de AminForou. Si vous avez uvx installé (l’équivalent Python de npx), le setup le plus simple est :
claude mcp add gsc -- uvx --from git+https://github.com/AminForou/mcp-gsc mcp-gsc
Vous aurez aussi besoin d’un compte de service Google avec accès en lecture à votre propriété Search Console :
- Allez sur Google Cloud Console, créez un projet et activez l’API Search Console et (optionnellement) l’API Web Search Indexing.
- Créez un compte de service, générez une clé JSON et téléchargez-la.
- Dans Search Console, ajoutez l’e-mail du compte de service comme utilisateur sur votre propriété avec au minimum un accès Restricted.
- Définissez le chemin vers cette clé JSON comme variable d’environnement au lancement du MCP.
Si vous voulez un chemin sans code à la place, Better Search Console (de Houtini) et le connecteur MCP hébergé de Windsor.ai offrent tous deux des chemins de setup plus simples — Better Search Console est particulièrement sympa parce qu’il synchronise vos données dans une base SQLite locale, ce qui veut dire que Claude peut faire de véritables requêtes SQL sur vos données historiques au lieu d’être limité par le plafond de 1 000 lignes par requête de l’API Search Console.
Trois workflows à lancer dès le jour un
Le setup est la partie ennuyeuse. Voici ce qui rend toute la chose digne de l’heure que vous venez de passer.
Workflow 1 : réécriture SEO en masse de produits sous-performants
Ouvrez Claude Code et tapez :
« Utilise le MCP GSC pour trouver les 20 pages produit de ma boutique avec les plus fortes impressions mais le plus faible CTR sur les 28 derniers jours. Pour chacune, tire le titre et la meta description actuels depuis Shopify, regarde les requêtes de recherche réelles pour lesquelles ces pages apparaissent, et réécris le titre et la meta description pour mieux correspondre à l’intention de recherche. Ne publie rien — mets toutes les modifications en attente sous forme de liste que je peux relire. »
Ce qui se passe en coulisses : Claude appelle le MCP GSC pour tirer l’analytique de recherche, appelle le MCP Shopify pour récupérer les champs SEO actuels de chaque produit, utilise son propre raisonnement pour rédiger des versions améliorées et les imprime dans un tableau pour votre approbation. Quand vous dites « ça me va, applique-les », il pousse les changements via le MCP Shopify.
C’est le type de tâche qui prend une après-midi entière à un humain en SEO. Claude le fait en environ 4 minutes. Le coût : environ 0,30 à 0,80 $ d’usage API Claude pour 20 produits.
Workflow 2 : générer des images héros lifestyle pour une nouvelle collection
« Je viens de créer une nouvelle collection appelée « Lin de printemps ». Tire les 8 produits qu’elle contient depuis Shopify, lis les descriptions produit, puis génère une image héros lifestyle pour chaque produit via Nano Banana — lumière naturelle de matin, intérieur scandinave, style visuel cohérent sur les 8 pour qu’elles ressemblent à une campagne. Sauvegarde-les dans un dossier local et prépare un brouillon pour les uploader comme images produit principales, mais ne publie pas avant que je confirme. »
Claude lit vos produits via le MCP Shopify, formule des prompts descriptifs en utilisant les attributs réels du produit (couleur, matière, dimensions), génère les images via Nano Banana avec des instructions de style cohérentes, les sauvegarde en local et met en attente l’upload. Coût total pour 8 images haute résolution : environ 0,30 à 1,20 $ selon le palier de résolution.
La chose qui était impossible auparavant — garder un style visuel cohérent sur un ensemble multi-produits — est exactement ce pour quoi la cohérence de personnage/objet de Nano Banana 2 a été construite. C’est là que cela se concrétise sur votre marge.
Workflow 3 : check santé SEO quotidien
Ajoutez une instruction sauvegardée à votre projet Claude Code — un fichier CLAUDE.md dans le dossier de votre projet — qui dit :
« Chaque matin quand j’ouvre ce projet, lance un check santé Search Console : tire les clics d’hier vs la moyenne des 7 jours précédents, signale toute page qui a chuté de plus de 30 %, vérifie le statut d’indexation des nouveaux produits ajoutés dans les 48 dernières heures et alerte-moi si toute soumission de sitemap a échoué. Puis propose des correctifs spécifiques. »
Maintenant, à chaque démarrage d’une session Claude Code, il fait cela automatiquement. C’est ce qui se rapproche le plus d’avoir un SEO junior qui n’oublie jamais et ne prend jamais de jour de congé.
Attentes de coût (réalistes, pas marketing)
Pour une petite-à-moyenne boutique Shopify qui fait tourner cette stack activement :
- Usage Claude Code (Anthropic) : 20 à 80 $/mois selon la fréquence à laquelle vous le lancez. La plupart des marchands atterrissent autour de 30 à 50 $.
- Nano Banana (API Gemini) : 5 à 25 $/mois pour les besoins typiques de photographie produit.
- Google Search Console MCP : gratuit (utilise votre compte Google existant).
- Shopify Dev MCP : gratuit.
- MCP boutique Shopify : gratuit si auto-hébergé, environ 20 à 50 $/mois en utilisant Composio.
Donc quelque part entre 25 et 150 $ par mois, tout compris, pour remplacer des tâches qui prenaient 10 à 20 heures par semaine de travail manuel ou un VA à mi-temps à 600 à 1 200 €/mois.
Conseils de sécurité (lisez ceci avant de lancer quoi que ce soit)
Quelques règles que j’ai apprises à la dure en travaillant avec des marchands sur cette stack :
- Ne donnez jamais à un MCP des scopes en écriture que vous ne feriez pas confiance à un stagiaire au jour un. Commencez en lecture seule, regardez ce que Claude fait, puis étendez les permissions au fur et à mesure que vous bâtissez la confiance. Vous pouvez toujours ajouter des scopes plus tard. Vous ne pouvez pas désupprimer une collection de produits.
- Utilisez toujours le mode staging ou brouillon les premières semaines. Dites à Claude explicitement « mets tout en brouillon et laisse-moi relire avant publication ». La plupart des ressources Shopify supportent les états brouillon.
- Gardez un export de sauvegarde de vos produits. Lancez l’export produit intégré à Shopify chaque semaine. Cinq minutes d’assurance contre un mauvais prompt.
- Utilisez un fichier
CLAUDE.mddans votre dossier de projet pour documenter votre voix de marque, vos sujets interdits, vos règles tarifaires et toute contrainte. Claude le lit au démarrage de chaque session. Sans cela, vous obtiendrez une sortie incohérente qui dérive de votre marque dans le temps. - Auditez les MCP que vous installez. Ils tournent sur votre machine avec accès à votre boutique. Tenez-vous-en à des projets activement maintenus par des auteurs crédibles. Vérifiez les étoiles GitHub, la date du dernier commit et si le mainteneur répond aux issues.
Ce que cela change vraiment pour votre boutique
Le pitch honnête n’est pas « l’IA remplace votre équipe ». C’est que les 70 % ennuyeux de la gestion d’une boutique en ligne — les mises à jour SEO, les rafraîchissements d’images, les inventaires, les réécritures de descriptions — deviennent quelque chose que vous supervisez au lieu de quelque chose que vous faites. Vous récupérez vos week-ends, et les parties du métier qui ont réellement besoin d’un humain (positionnement, relations fournisseurs, empathie client, décisions de marque) reçoivent plus de votre attention parce qu’elles ne sont plus écrasées par le travail répétitif.
Ce n’est pas une prédiction sur le futur du travail. C’est une stack que vous pouvez installer cet après-midi.
FAQ
Faut-il savoir coder ? Non. Tout dans ce guide utilise des commandes terminal en copier-coller. Vous devez être à l’aise pour ouvrir un terminal et coller une ligne — c’est tout. Claude Code gère les parties techniques.
Combien coûte la stack complète par mois ? Entre 25 et 150 $ selon l’usage. La plupart des petites boutiques Shopify atterrissent autour de 50 à 80 $/mois. Cela remplace 10 à 20 heures de travail manuel hebdomadaire.
Est-il sûr de donner à Claude Code accès à ma boutique en ligne ? Oui, avec précautions. Commencez avec des scopes en lecture seule, utilisez le mode brouillon pour tous les changements et gardez des sauvegardes produit hebdomadaires. Étendez les permissions progressivement au fur et à mesure que vous bâtissez la confiance.
Quel plan Shopify me faut-il ? Tout plan qui supporte les custom apps — soit tous les plans payants. Le Dev MCP fonctionne avec n’importe quel plan. Le MCP de gestion de boutique a besoin de la fonctionnalité custom apps.
Puis-je utiliser cela avec plusieurs boutiques Shopify ? Oui. Ajoutez une instance MCP séparée pour chaque boutique avec des credentials différents. Claude Code peut basculer entre elles dans la même session.
Que se passe-t-il si un serveur MCP arrête de fonctionner ?
Les serveurs MCP sont maintenus par la communauté. Si l’un casse après une mise à jour d’API Shopify, vous pouvez temporairement le retirer avec claude mcp remove [nom] et le ré-ajouter quand il est mis à jour. Le Shopify Dev MCP est officiel et maintenu par Shopify.
Besoin d’aide pour mettre cela en place ?
Si vous avez fait une partie de ce guide et frappé un mur — problèmes de chemins Windows, maux de tête OAuth, serveurs MCP qui refusent de charger —, c’est normal. La première installation est la plus dure.
Chez areza.digital, nous mettons en place exactement cette stack pour les marchands Shopify européens comme service produitisé. Nous gérons l’auth, la rotation des credentials, le setup du CLAUDE.md de marque et les trois premiers workflows d’automatisation adaptés à votre boutique. Vous repartez avec un système fonctionnel et un appel de formation de 30 minutes pour que vous puissiez l’opérer vous-même.
Réservez un appel découverte de 30 minutes →
Rédigé par Nikita Janockin, fondateur d’areza.digital. Sources : documentation officielle Shopify Dev, docs Anthropic Claude Code, Google AI Studio, AminForou/mcp-gsc, GeLi2001/shopify-mcp, ConechoAI/Nano-Banana-MCP, Composio et tests directs sur des boutiques Shopify en production. Dernière mise à jour le 8 avril 2026.