Sur cette page
Le Shopify AI Toolkit est un ensemble d’outils pour les développeurs ; le protocole Universal Commerce Protocol (UCP) de Shopify et ses points de terminaison de commerce sont des éléments connexes, mais distincts, de la plateforme. Ce guide présente le Toolkit actuel, les points de terminaison UCP décrits dans la documentation de développement de Shopify et ce que ces interfaces permettent aux exploitants de boutiques. L’analyse de Revize a établi que 5,2 % des commandes sont modifiées après le paiement (Revize, 2026) ; ce chiffre donne du contexte sur les opérations après achat, sans constituer une affirmation sur les commandes passées par l’IA.
Le Toolkit peut aider les développeurs à trouver la documentation Shopify à jour et des conseils sur les API depuis les outils de programmation IA pris en charge. Les marchands doivent évaluer les intégrations de commerce en fonction de leurs propres besoins, de la documentation actuelle des points de terminaison de Shopify et du comportement de chaque fournisseur d’agent. Ce guide se concentre sur ces éléments vérifiables.

Qu’est-ce que le Shopify AI Toolkit ?
L’AI Toolkit de Shopify fournit un plugin, des compétences d’agent et un serveur Dev MCP local pour les outils de développement IA pris en charge. Shopify mentionne actuellement Claude Code, Codex, Antigravity CLI, Cursor, OpenClaw, Pi, VS Code et Hermes pour le plugin ; OpenClaw, Pi et Hermes sont disponibles uniquement via le plugin. Consultez la documentation officielle de l’AI Toolkit pour les étapes de configuration actuelles et les outils pris en charge. Le Dev MCP s’exécute localement et ne nécessite pas d’authentification à une boutique Shopify pour ses outils de documentation et de schéma.
Le Dev MCP utilise le Model Context Protocol (MCP) pour exposer des outils de développement. La documentation Shopify définit ses outils disponibles et la configuration des clients pris en charge ; ne supposez pas qu’il peut effectuer n’importe quelle action de l’Admin API ou exécuter des commandes sur une boutique en production.

Utilisez les outils répertoriés dans la documentation Shopify pour le client Dev MCP que vous avez installé. Le Toolkit est destiné à faciliter le développement sur Shopify ; vérifiez la disponibilité des outils dans votre client et examinez le code et les requêtes API générés avant de les utiliser.
- Trouver la documentation actuelle : identifiez l’interface API et la version appropriées avant de générer une intégration.
- Inspecter les schémas GraphQL : vérifiez les noms de champs, arguments et types de retour avant de rédiger une requête ou mutation.
- Valider le code : vérifiez le code GraphQL, Liquid et d’extension généré par rapport aux schémas Shopify, puis testez son comportement localement.
- Gérer une boutique via CLI : préparez une opération à périmètre limité, authentifiez la boutique choisie, vérifiez la requête et les variables, puis choisissez quand l’exécuter. Les mutations nécessitent une activation explicite.
Le Toolkit peut faciliter l’utilisation de la documentation et un développement tenant compte des schémas ; les développeurs restent responsables de la vérification du code généré et de ses tests dans l’environnement de développement approprié. Il est distinct des points de terminaison de commerce de Shopify.
Les interfaces Commerce MCP et UCP de Shopify
Shopify documente des interfaces de commerce distinctes pour la découverte de produits dans les catalogues, le paiement et l’accès aux commandes. Leurs modèles de points de terminaison, leur authentification et leurs opérations diffèrent ; aucune ne doit être considérée comme une interface universelle pour les agents.
1. Storefront Catalog via UCP
Le point de terminaison du catalogue propre à une boutique est https://{shop}.myshopify.com/api/ucp/mcp, avec search_catalog, lookup_catalog et get_product, et un profil d’agent dans meta.ucp-agent.profile. Le guide de migration Storefront MCP déplace les outils de catalogue et de panier vers UCP, mais laisse search_shop_policies_and_faqs sur /api/mcp. Utilisez la référence Storefront Catalog pour le contrat de découverte.
Ne supposez pas que ce point de terminaison couvre le paiement ou la modification des commandes. Shopify documente le paiement et les commandes comme des interfaces distinctes pour les agents, chacune avec sa propre authentification, ses autorisations et ses opérations prises en charge.
2. Global Catalog
Shopify documente un point de terminaison Global Catalog à l’adresse https://catalog.shopify.com/api/ucp/mcp pour la découverte de produits dans les catalogues de Shopify. Ses outils et ses conditions d’accès diffèrent de ceux du point de terminaison de catalogue propre à la boutique d’un marchand. Consultez la présentation des catalogues pour agents de Shopify avant de développer votre intégration ; ne réutilisez pas d’anciens exemples de points de terminaison ou d’outils Storefront MCP.
3. Order MCP — accès aux commandes provenant de l’agent
La documentation actuelle d’Order MCP de Shopify décrit un outil get_order permettant de récupérer l’état actuel des commandes provenant de l’agent. Il ne donne pas un accès général à l’ensemble de l’historique des commandes d’un client et ne modifie pas les commandes. L’outil nécessite les autorisations pertinentes d’accès aux commandes et de profil d’agent. Lisez la documentation Order MCP de Shopify avant de vous appuyer sur cet outil pour un processus.
Shopify documente également des fonctions de paiement distinctes via Checkout MCP. Une authentification ou une requête signée est obligatoire, et le parcours peut renvoyer l’acheteur vers une interface où vérifier ou finaliser son paiement. Consultez la documentation Checkout MCP pour le contrat d’interface actuel.
4. Customer Accounts MCP : demandes client authentifiées
Customer Accounts MCP reste pris en charge. Découvrez mcp_api via https://{shop}/.well-known/customer-account-api ; son modèle de point de terminaison est https://{shop}/customer/api/mcp. Le flux OAuth avec code d’autorisation et PKCE donne un accès propre au client aux détails et statuts de commande et aux préférences de compte dans cette boutique. L’application nécessite la configuration de l’authentification client, un domaine personnalisé et l’accès aux données client protégées. Utilisez tools/list pour découvrir les opérations prises en charge. Ce périmètre est distinct des commandes provenant de l’agent dans Order MCP ; aucun de ces noms n’implique une modification arbitraire des commandes.

| Interface | Utilité | Documentation actuelle |
|---|---|---|
| Shopify AI Toolkit / Dev MCP | Documentation développeur et outils de schéma | AI Toolkit |
| Storefront Catalog | Découverte des produits d’un marchand | Storefront Catalog |
| Politiques et FAQ | Questions publiques sur les politiques d’un marchand | Outil de politiques et FAQ — /api/mcp |
| Global Catalog | Découverte des catalogues à travers Shopify | Présentation des catalogues pour agents |
| Checkout MCP | Session de paiement et transfert à l’acheteur | Checkout MCP |
| Order MCP | Lire l’état des commandes prises en charge provenant de l’agent | Order MCP |
| Customer Accounts MCP | Demandes de commande et de compte autorisées par le client | Customer Accounts MCP — /customer/api/mcp, OAuth PKCE |
Universal Commerce Protocol (UCP) : la couche qui relie les autres
Shopify décrit UCP comme un protocole de commerce ouvert pour les interactions entre agents, marchands, prestataires de paiement et fournisseurs d’identifiants. Sa documentation précise les parcours de découverte, de paiement et ceux liés aux commandes. Les implémentations conservent des points de terminaison, des formats de requête, des authentifications et des autorisations distincts ; l’appellation UCP ne signifie pas que chaque client peut appeler chaque outil. Consultez la documentation des profils d’agent de Shopify et les références propres à chaque point de terminaison avant d’implémenter un parcours.
Les principaux domaines couverts par le protocole sont les suivants :
- Découverte dans les catalogues — trouver des produits et récupérer les informations produit prises en charge via les points de terminaison de catalogue documentés.
- Paiement — créer ou poursuivre un paiement via le parcours documenté, qui peut nécessiter une authentification ou un transfert de l’acheteur.
- Accès aux commandes — récupérer les informations de commande prises en charge conformément aux règles documentées de profil et d’accès ; cela n’implique pas qu’un agent puisse modifier ou rembourser une commande.

En tant que marchand, confirmez que le point de terminaison de catalogue pertinent est disponible et configuré pour votre boutique. Son existence ne garantit pas qu’un produit IA particulier l’utilise ou présente tous les articles. Consultez notre guide développeur Universal Commerce Protocol et la documentation actuelle du point, puis testez avec le client que vous comptez prendre en charge.
Ce que les marchands peuvent vérifier aujourd’hui
1. Le trafic issu de la recherche IA augmente, mais cela ne prouve pas que MCP en est la cause. En juin 2026, Shopify a indiqué que les commandes provenant de la recherche IA étaient 13 fois plus nombreuses sur un an, avec un taux de conversion supérieur de 49 % et une valeur moyenne de commande supérieure de 14 %. Ce sont des chiffres de recherche IA communiqués par Shopify, pas une prévision pour chaque marchand ni la preuve qu’un point de terminaison MCP précis a généré les commandes. Consultez la publication de juin 2026 de Shopify.
2. Vérifiez le processus réel après achat. L’Order MCP documenté par Shopify peut lire les informations des commandes prises en charge provenant de l’agent ; il ne modifie pas les commandes. Les marchands doivent vérifier le parcours proposé à leurs clients pour corriger les commandes admissibles, plutôt que supposer qu’un point de terminaison pour agents le couvre.
3. Gardez les informations produit exactes. Des titres, des options, des disponibilités et des politiques clairs aident les clients et les systèmes de commerce à interpréter un catalogue. Mesurez les résultats dans votre propre boutique plutôt que supposer qu’un format de données donné garantit le classement ou la conversion.
Utiliser le AI Toolkit en tant que développeur ou agence
Commencez par une tâche de développement : inspectez le schéma, générez une requête, validez-la et vérifiez son résultat dans une boutique de développement.

Installez le plugin Shopify pour votre client pris en charge ou suivez le parcours documenté d’installation des compétences ou de Dev MCP. Les plugins se mettent à jour automatiquement ; les compétences installées manuellement nécessitent des mises à jour. Suivez les instructions du client que vous utilisez réellement.
Pour la gestion de boutique, authentifiez-vous avec Shopify CLI avec uniquement les autorisations nécessaires. La commande store execute exécute une opération Admin GraphQL vérifiée avec cette authentification enregistrée. Cet exemple lit les dix premiers produits d’une boutique de développement :
shopify store auth --store YOUR-DEV-STORE.myshopify.com --scopes read_products
shopify store execute --store YOUR-DEV-STORE.myshopify.com --query '{ products(first: 10) { nodes { id title } } }'Remplacez l’espace réservé par votre boutique de développement. Les lectures fonctionnent sans activer les mutations ; les écritures nécessitent --allow-mutations et les autorisations correspondantes. Vérifiez la mutation complète et les variables avant l’activation, confirmez la boutique cible et testez le comportement prévu avant tout changement en production.
Activer les achats par agent dans votre boutique
Si vous développez une intégration avec un point de terminaison de catalogue Shopify, suivez le format actuel des requêtes Storefront Catalog, notamment meta.ucp-agent.profile. Une recherche produit réussie n’établit pas l’accès au paiement ou aux commandes. Notre guide Shopify Catalog MCP explique les outils de découverte et leurs limites.
Pour un agent aux couleurs de votre marque, utilisez les projets d’exemple actuels de Shopify et la documentation de paiement propre au point de terminaison. Prévoyez un déploiement progressif en fonction de votre catalogue et de vos exigences d’authentification, de paiement et d’assistance ; un projet d’exemple n’est pas une liste de vérification pour une intégration en production. Testez les informations produit visibles par les clients et les transferts vers le paiement avant le lancement.
La place des outils après achat dans une stack d’agents
La découverte de produits, le paiement, le suivi des commandes et les modifications client nécessitent leurs propres interfaces prises en charge. Notre guide des points de terminaison Shopify MCP et UCP précise ces responsabilités.
Shopify documente Order MCP comme une interface de lecture pour les commandes prises en charge provenant de l’agent, avec des webhooks de commande UCP pour les mises à jour du cycle de vie. Il ne propose pas de parcours général de modification des commandes. Revize offre un portail client pour les changements d’adresse, de variante et de quantité et les annulations admissibles avant traitement, pendant la période configurée par le marchand. L’ajout de produits, le changement vers un autre produit, l’application de réductions et les remboursements en crédit en boutique sont des fonctions Pro. La modification par le personnel est en développement. Le portail nécessite le bloc Revize sur la page de statut de commande et peut aussi s’ouvrir depuis le lien Edit Order de l’e-mail. Consultez Revize sur le Shopify App Store pour les détails du produit.
Questions fréquentes
Qu’est-ce que le Shopify AI Toolkit en une phrase ?
L’AI Toolkit de Shopify est un ensemble d’outils pour les développeurs, comprenant un plugin, des compétences d’agent et un serveur Dev MCP local. Les points de terminaison de commerce pour agents de Shopify et UCP sont documentés séparément.
Le Shopify AI Toolkit est-il gratuit ?
La documentation de l’AI Toolkit de Shopify ne mentionne pas de prix d’abonnement distinct pour le Toolkit. Consultez les conditions actuelles du forfait Shopify, du client IA, de l’application et du point de terminaison pour connaître les éventuels frais ou exigences de compte.
Ma boutique doit-elle être sur Shopify Plus pour utiliser MCP ?
Ne supposez pas que chaque point de terminaison ou fonction pour agents est disponible sur tous les forfaits. Consultez la documentation actuelle des points de terminaison et des forfaits Shopify pour votre boutique et l’intégration concernée.
Quelle est la différence entre Storefront Catalog et Global Catalog ?
Le point de terminaison actuel du catalogue propre à une boutique est documenté à /api/ucp/mcp ; Global Catalog dispose d’un point de terminaison distinct. Leurs outils et exigences de requête diffèrent. Consultez la présentation des catalogues Shopify.
Qu’est-ce que l’Universal Commerce Protocol ?
UCP est un protocole de commerce ouvert décrit dans la documentation de développement de Shopify. Lisez la spécification actuelle et la documentation propre à chaque point de terminaison avant de supposer qu’une autre plateforme ou un autre agent prend en charge le même parcours.
ChatGPT, Claude et Gemini utiliseront-ils tous les serveurs MCP de Shopify ?
Les intégrations des fournisseurs évoluent indépendamment. Consultez la documentation actuelle de chaque fournisseur et ne supposez pas que ChatGPT, Claude ou Gemini prend en charge tous les points de terminaison ou outils UCP de Shopify.
L’activation des achats par agent nuit-elle à mon taux de conversion ?
Il n’existe pas d’effet universel. Mesurez la conversion, la finalisation du paiement et les contacts avec l’assistance pour le canal et le parcours client que vous activez.
Comment le AI Toolkit protège-t-il les données personnelles des clients ?
Consultez la documentation actuelle de Shopify et du fournisseur d’IA sur la confidentialité, l’authentification et le traitement des données pour chaque outil utilisé. Les exigences dépendent du point de terminaison, du client et des informations demandées ; ne supposez pas que tous les appels sont locaux ou ne contiennent aucune donnée personnelle.
L’agent d’un concurrent peut-il effectuer une transaction dans ma boutique via MCP ?
L’accès d’un agent dépend du point de terminaison, du profil d’agent, de l’authentification et des contrôles actuels de Shopify. Consultez la documentation Shopify pertinente et vos propres paramètres d’accès avant d’activer un processus tiers ; ne supposez pas que la compatibilité du protocole suffit à accorder l’accès au paiement.
Dois-je faire quelque chose pour que ma boutique apparaisse dans les résultats de recherche des agents ?
Gardez les informations produit exactes et complètes, puis vérifiez les règles d’éligibilité et de découverte du canal que vous voulez utiliser. Shopify ne promet pas qu’une modification de contenu donnée fera apparaître un article dans les résultats d’un agent.
Quel est le lien entre le AI Toolkit et Shopify Functions ?
Shopify Functions et l’AI Toolkit ont des rôles différents. Functions implémente une logique de commerce prise en charge ; le Toolkit aide les développeurs. Consultez la documentation du point de terminaison et de Functions pour confirmer comment une intégration donnée interagit avec votre configuration. Nous détaillons la migration vers Functions ici.
Comment savoir ce qu’un agent fait dans ma boutique ?
Utilisez les journaux, les diagnostics et les outils d’observabilité documentés pour le point de terminaison Shopify et le client concernés. Un agent tiers peut exposer séparément ses propres journaux de conversation ; vérifiez ce que votre intégration enregistre et comment ces données sont traitées.
À lire aussi
Statistiques sur la modification des commandes Shopify · Vendre sur ChatGPT avec les vitrines agentiques Shopify · Permettre aux clients de modifier leurs commandes Shopify