Ce dont vous avez besoin
- Une boutique Shopware en version 6.7.11 ou supérieure (6.7.x).
- Le plugin Shopware Solution25 MCP Workflows en version 1.9.1 ou supérieure : [LIEN DE TÉLÉCHARGEMENT / SHOPWARE STORE].
- Un compte administrateur dans cette boutique.
- Un client d’IA compatible avec les connecteurs MCP distants :
- Claude (claude.ai, application de bureau, mobile, Claude Code) ;
- ChatGPT ;
- l’application Gemini (actuellement pour les comptes Google personnels aux États-Unis, en anglais) ;
- ou Gemini CLI.
Étape 1 : installer le plugin
- Dans Shopware, ouvrez Extensions > Mes extensions.
- Téléversez ou installez Solution25 MCP Workflows, puis activez-le.
- À l’activation, le serveur MCP de Shopware est activé et le rôle destiné aux clients d’IA est préparé.
Le plugin crée trois pages sous Paramètres > Système :
- MCP-Connector : connecter et gérer les clients d’IA.
- MCP-Protokoll : chaque action d’un client d’IA dans votre boutique.
- MCP-Storefront : la recherche IA optionnelle et le chat storefront.
Étape 2 : ajouter le connecteur dans le client d’IA
L’adresse du connecteur est :
[https://mcp.solution25.com/shopware]
- Claude (web, bureau, mobile) : ouvrez Paramètres > Connecteurs.
- Dès que le connecteur figure dans l’annuaire : Parcourir les connecteurs, puis Solution25 for Shopware, puis Connecter.
- D’ici là : Ajouter un connecteur personnalisé et collez l’adresse.
- Claude Code : exécutez la commande suivante :
claude mcp add --transport http solution25-shopware [https://mcp.solution25.com/shopware]
Connectez-vous ensuite avec /mcp.
- ChatGPT : ajoutez un connecteur personnalisé (application) avec l’adresse ci-dessus. [VÉRIFIER LE CHEMIN DE MENU ACTUEL ET LES ABONNEMENTS PRIS EN CHARGE.]
- Application Gemini : ouvrez Paramètres > Applications connectées > Ajouter une application personnalisée et collez l’adresse.
- Gemini CLI : ajoutez ce qui suit à
~/.gemini/settings.json ; Gemini CLI ouvre ensuite lui-même la page de connexion :
{ "mcpServers": { "shopware": { "httpUrl": "[https://mcp.solution25.com/shopware]" } } }
Étape 3 : définir ce que le client d’IA est autorisé à faire
Le client d’IA ouvre notre page de connexion. Elle affiche :
- Un code de connexion à usage unique, valable 30 minutes.
- Les autorisations : pour chaque domaine (Products, Categories, Manufacturers, Media, Reviews, Orders, Customers), vous choisissez View, Edit, Create ou Delete (consulter, modifier, créer, supprimer).
- Sélections prédéfinies :
- Read only (lecture seule, par défaut) ;
- Catalogue editor (gestion du catalogue) ;
- Order management (gestion des commandes) ;
- Everything (tout).
Laissez la page ouverte.
Étape 4 : confirmer la connexion dans Shopware
- Dans Shopware, ouvrez Paramètres > Système > MCP-Connector.
- Collez le code de connexion. La page indique :
- quel client d’IA demande l’accès ;
- si son domaine est vérifié ;
- vers quelle adresse la connexion redirige ;
- quelles autorisations il demande.
- Vérifiez qu’il s’agit bien de votre propre demande, puis cliquez sur Connecter.
Le client d’IA finalise lui-même la connexion. Vous ne pouvez accorder que les autorisations dont vous disposez vous-même.
Utilisation
Quelques exemples à essayer :
- « Quels produits sont en rupture de stock ou bientôt épuisés ? »
- « Montre-moi les commandes d’aujourd’hui et tout ce qui est bloqué. »
- « Passe le prix de SW10011 à 24,90 et le stock à 50. » (Vous voyez d’abord un aperçu.)
- « Trouve les avis en attente de validation. »
- « Montre-moi le chiffre d’affaires de cette semaine par rapport à la semaine dernière. »
Commandes prédéfinies : Daily report (rapport quotidien), Weekly sales (ventes de la semaine) et Connect another shop (connecter une autre boutique). Dans Claude, ChatGPT et les autres clients qui le prennent en charge, une carte boutique affiche dans le chat vos boutiques connectées et propose un bouton Add another shop.
Ce que le client d’IA peut faire
Les outils mis à la disposition du client d’IA dépendent des autorisations accordées.
| Domaine |
Outils |
| Boutiques |
Afficher les boutiques connectées, connecter une autre boutique, tester la connexion (ping) |
| Produits |
Rechercher des produits ; créer des produits ; modifier le nom, le prix, le stock, le statut ou la description ; ajouter des images à partir d’adresses web |
| Catégories et fabricants |
Rechercher des catégories ; affecter des produits à des catégories ou les en retirer ; rechercher des fabricants ; créer des fabricants |
| Avis |
Trouver des avis ; les publier ou les masquer et y ajouter votre réponse |
| Commandes et clients |
Rechercher des commandes, détails de commande, rapport de chiffre d’affaires, rechercher des clients, détails client |
| Processus de la boutique (plugin) |
Contrôle quotidien de la boutique, rapport sur les risques de stock, contrôle et correction de la qualité du catalogue, rapport sur les problèmes de commande, plan de résolution des commandes et son exécution, diagnostic |
Comment les modifications restent sécurisées
- D’abord l’aperçu : chaque modification commence par un aperçu. Rien ne change dans la boutique tant que vous n’avez pas donné votre accord et que le client d’IA n’a pas confirmé avec un jeton à usage unique valable 15 minutes.
- Nouvelle vérification : si la boutique a changé depuis l’aperçu, la modification est refusée et un nouvel aperçu est nécessaire.
- Journalisé : chaque action figure sous Paramètres > Système > MCP-Protokoll.
- Limité : le client d’IA ne voit que les outils autorisés par ses permissions, et la gestion des droits de Shopware contrôle en plus chaque appel.
Plusieurs boutiques
Une même connexion peut regrouper jusqu’à 10 boutiques.
- Demandez au client d’IA de connecter une autre boutique, ou utilisez le bouton Add another shop de la carte boutique. Vous recevez un lien à usage unique, valable 60 minutes.
- Ouvrez le lien, choisissez les autorisations et collez le code dans l’autre boutique sous Paramètres > Système > MCP-Connector.
Modifier les autorisations ou se déconnecter
- Modifier les autorisations : dans Shopware, sous Paramètres > Système > MCP-Connector, cliquez sur Modifier les autorisations au niveau de la connexion.
- Déconnecter : cliquez sur Déconnecter. La connexion est alors également supprimée sur notre serveur.
- Dans le client d’IA : vous pouvez y supprimer le connecteur.
- Durée d’une connexion : une connexion est valable 90 jours au maximum. Le client d’IA vous demande ensuite de vous reconnecter.
Dépannage
| Problème |
Solution |
| « Ce code est inconnu, déjà utilisé ou expiré » |
Les codes sont valables 30 minutes et une seule fois. Relancez la connexion dans le client d’IA. |
| Un outil est manquant |
Cette autorisation manque à la connexion. Dans Shopware, cliquez sur Modifier les autorisations et démarrez une nouvelle conversation. |
| Le serveur du connecteur n’atteint pas la boutique |
La boutique a besoin d’une adresse HTTPS publique. Si celle-ci diffère de l’adresse principale de la boutique, saisissez-la sous Paramètres > Système > MCP-Connector. Il doit s’agir de l’un des propres domaines de la boutique. |
| « Échec de l’enregistrement automatique » (Gemini) |
Vérifiez que vous avez bien utilisé l’adresse complète se terminant par /shopware. |
Protection des données et sécurité
- Ce que nous enregistrons : notre serveur n’enregistre que ce dont il a besoin pour la connexion. Les clés d’accès sont chiffrées, les codes et jetons ne sont stockés que sous forme de hachage.
- Ce que nous n’enregistrons pas : les données de la boutique, comme les produits, les commandes et les clients, sont transmises à votre client d’IA à votre demande et ne sont pas conservées chez nous.
- Détails : dans notre politique de confidentialité : Politique de confidentialité : Solution25 for Shopware.
Support
info@solution25.com · Page de contact · +49 421 438 1919-0