Sur cette page
Shopify MCP couvre plusieurs interfaces aux rôles différents. Le guide de migration Storefront MCP transfère les anciens outils de catalogue et de panier vers UCP, tout en conservant l’outil de politiques et FAQ et Customer Accounts MCP. Choisissez une interface selon la tâche de l’acheteur, puis vérifiez son schéma et son autorisation. Ce guide explique aussi la place d’un parcours client de modification après achat.
La couche technique en bref
MCP (Model Context Protocol) est une interface d’outils utilisée par les clients IA. La documentation actuelle de Shopify sur le commerce décrit aussi des points de terminaison UCP (Universal Commerce Protocol) pour la découverte de produits, le paiement et l’accès aux commandes. Un client doit utiliser le schéma, l’authentification et les autorisations actuels du point de terminaison ; les noms et les capacités des points de terminaison ne sont pas interchangeables.
| Interface | Utilité | Documentation actuelle |
|---|---|---|
| Catalogue propre à la boutique | Découverte des produits d’un marchand | Storefront Catalog — https://{shop}.myshopify.com/api/ucp/mcp |
| Global Catalog | Découverte de produits dans les catalogues de Shopify | Présentation des catalogues pour agents |
| Politiques et FAQ | Réponses aux questions sur les politiques et FAQ d’un marchand | Outil de politiques et FAQ — https://{shop}/api/mcp |
| Checkout MCP | Session de paiement et transfert de l’acheteur | Checkout MCP |
| Order MCP | Lecture des informations des commandes prises en charge provenant de l’agent | Order MCP |
| Customer Accounts MCP | Demandes client authentifiées sur les commandes et le compte | Customer Accounts MCP — https://{shop}/customer/api/mcp découvert, code d’autorisation OAuth avec PKCE |
| Dev MCP | Documentation de développement et outils de schéma | Shopify AI Toolkit |
La documentation Storefront Catalog répertorie search_catalog, lookup_catalog et get_product et exige le profil d’agent dans meta.ucp-agent.profile. Checkout MCP et Order MCP ont des règles d’accès et opérations différentes. Pour les outils de découverte et leurs limites, consultez notre guide Shopify Catalog MCP.
Notre recommandation : développez avec le point de terminaison actuellement documenté
Associez les anciennes intégrations outil par outil : la découverte produit utilise Storefront Catalog, le panier utilise Cart MCP et le paiement Checkout MCP. Conservez les requêtes de politiques sur /api/mcp. Testez les schémas et règles d’accès de chaque remplacement en développement avant de déplacer le trafic.
Le point de terminaison de catalogue peut permettre la découverte de produits, mais ne prouve pas à lui seul qu’un agent peut créer un paiement, lire une commande de l’acheteur ou la modifier. Ce sont des processus distincts. Le Dev MCP de l’AI Toolkit est destiné aux développeurs et se distingue des points de terminaison de commerce utilisés côté acheteur.
Ce qu’un agent IA fait réellement dans votre boutique
La séquence dépend de l’agent et de l’interface Shopify qu’il utilise. Une requête de catalogue peut rechercher ou récupérer des données produit. Un parcours de paiement peut exiger une authentification ou une requête signée et renvoyer l’acheteur vers une interface où vérifier ou finaliser l’achat. Shopify documente get_order dans Order MCP pour les commandes prises en charge provenant de l’agent ; ce n’est pas une API générale d’historique des commandes multicanal. Lisez le périmètre de chaque point de terminaison avant de le connecter à l’assistance client ou au traitement des commandes.
L’accès client authentifié est une intégration distincte
Customer Accounts MCP permet à un assistant de gérer les détails et statuts de commande et les préférences du client connecté pour cette boutique. Découvrez mcp_api depuis https://{shop}/.well-known/customer-account-api, puis authentifiez-vous avec le code d’autorisation OAuth 2.0 et PKCE. La configuration nécessite un domaine personnalisé, l’authentification client et l’accès approprié aux données client protégées. Après authentification, utilisez tools/list pour inspecter les outils et schémas réels ; ne supposez pas des modifications arbitraires ou un accès aux comptes de plusieurs marchands.
Order MCP utilise au contraire les identifiants d’agent pour lire les commandes passées via cet agent. Le guide des webhooks de commande décrit les mises à jour UCP du cycle de vie et l’enregistrement côté Shopify par un responsable partenaire. Notre guide opérationnel des commandes agentiques couvre la livraison et le rapprochement.
Le parcours après achat est distinct
Un point de terminaison de découverte de produits ou de paiement ne fournit pas d’opération générale de modification des commandes. La documentation actuelle d’Order MCP de Shopify décrit la lecture de l’état des commandes prises en charge provenant de l’agent ; il ne les modifie pas. Cette distinction compte lorsqu’un client doit corriger une adresse, une quantité ou une variante après le paiement.
Une boutique doit proposer un parcours client pour les changements admissibles selon ses règles et l’état de traitement. L’application de modification Revize permet les changements d’adresse, de quantité, de variante et les annulations avant traitement pendant la période configurée par le marchand. Le changement vers un autre produit, les ajouts, les réductions et les remboursements en crédit en boutique sont Pro. Le portail nécessite le bloc Revize sur la page de statut et est aussi accessible par le lien Edit Order de l’e-mail. Consultez notre guide de modification des commandes Shopify pour le parcours et les limites de l’éditeur natif.
Ce que Shopify documente aujourd’hui
Voici les fonctions documentées à vérifier dans les références Shopify actuelles :
- La découverte de produits dans le catalogue d’une boutique via le point de terminaison UCP, avec les outils de catalogue documentés et un profil d’agent.
- Un point de terminaison Global Catalog distinct pour une découverte de produits plus large.
- Checkout MCP avec ses propres exigences d’authentification ou de requête signée et un éventuel transfert de l’acheteur.
- Order MCP avec un outil
get_orderpour les commandes prises en charge provenant de l’agent. - Customer Accounts MCP pour les demandes autorisées propres au client et l’outil de politiques et FAQ pour les questions publiques sur la boutique.
- Un ensemble d’outils de développement locaux via le Shopify AI Toolkit et Dev MCP.
Le nom d’un point de terminaison ne signifie pas un accès illimité à la boutique, un historique universel des comptes ou des autorisations de modification. Utilisez le périmètre documenté de chaque interface. Notre guide Shopify AI Toolkit explique séparément les outils développeur.
Ce que nous ferions ce trimestre
- Choisissez le point de terminaison selon la tâche. Utilisez la documentation actuelle Storefront Catalog pour la découverte de produits, celle de Checkout MCP pour le paiement et celle d’Order MCP pour la lecture des commandes prises en charge.
- Vérifiez les exigences de profil et d’accès. Les requêtes Storefront Catalog incluent
meta.ucp-agent.profile; vérifiez séparément les exigences exactes de chaque autre point de terminaison. - Testez dans un environnement de développement. Validez le schéma de requête, les champs renvoyés, l’authentification et le transfert de l’acheteur avant de prévoir un lancement auprès des clients.
- Auditez séparément l’après-achat. Assurez-vous que les clients disposent d’un parcours pour consulter ou demander les modifications admissibles de leurs commandes ; n’attendez pas de MCP qu’il modifie une commande finalisée.
- Revérifiez la documentation avant la mise en production. Les API d’agents de Shopify et leur prise en charge par les clients peuvent évoluer ; utilisez la documentation primaire actuelle plutôt que des exemples copiés.
Ce qu’il faut retenir
Définissez les données nécessaires au client logiciel et l’autorisation qui donne accès. La découverte, le paiement, les politiques publiques, les comptes clients et les lectures de commandes issues de l’agent ont des contrats distincts. Notre guide développeur Universal Commerce Protocol explique la négociation des capacités sous les interfaces UCP.
Pour les marchands, le service client et la modification après achat doivent faire explicitement partie de la conception. L’Order MCP documenté par Shopify peut lire les commandes prises en charge provenant de l’agent ; il ne fournit pas de parcours général de modification des commandes. Un portail de modification pour les clients, la politique du marchand et la limite liée au traitement restent des considérations distinctes.
Questions fréquentes
Quel est le point de terminaison Shopify MCP actuel ?
Utilisez /api/ucp/mcp pour Storefront Catalog et les outils documentés de panier et de paiement. Les requêtes publiques de politiques restent sur /api/mcp ; les demandes client authentifiées utilisent le point de terminaison Customer Accounts MCP découvert. Choisissez celui qui prend en charge la tâche précise.
Quel point de terminaison Shopify utiliser pour la découverte de produits ?
Utilisez le point de terminaison documenté propre à la boutique pour le catalogue d’un marchand, ou Global Catalog pour une découverte plus large. Vérifiez les outils et exigences actuels dans la présentation des catalogues.
Qu’est-ce qu’UCP ?
UCP est le protocole de commerce ouvert de Shopify pour les interactions documentées entre agents, marchands, fournisseurs d’identifiants et prestataires de paiement. Utilisez les références propres à chaque point de terminaison, car les opérations de découverte, de paiement et de commande ne partagent pas un modèle universel d’autorisations.
Ai-je besoin d’un profil d’agent ?
La documentation Storefront Catalog exige le profil dans meta.ucp-agent.profile. Consultez la documentation de chaque autre point de terminaison plutôt que supposer que la même exigence ou autorisation s’applique partout.
Un agent IA peut-il finaliser un paiement ?
Shopify documente Checkout MCP séparément. Son parcours actuel exige une authentification ou une requête signée et peut demander à l’acheteur de vérifier ou terminer le paiement. Consultez la référence Checkout MCP pour le parcours pris en charge.
Shopify MCP est-il disponible sur tous les forfaits ?
La disponibilité et l’accès dépendent du point de terminaison et de la configuration de la boutique. Consultez la documentation actuelle des forfaits et des points de terminaison Shopify pour l’intégration concernée ; ne déduisez pas l’accès d’un forfait d’un exemple MCP.
En quoi Global Catalog diffère-t-il de Storefront Catalog ?
Storefront Catalog est limité à un marchand. Global Catalog est un point de terminaison de découverte distinct pour la recherche de produits dans les catalogues de Shopify. Leurs points de terminaison et leurs contrats d’outils diffèrent.
Que fait Order MCP ?
Shopify documente un outil get_order pour lire l’état actuel des commandes prises en charge provenant de l’agent. Ce n’est pas un point de terminaison général d’historique des commandes couvrant tous les canaux d’un client.
En quoi Customer Accounts MCP diffère-t-il d’Order MCP ?
Customer Accounts MCP utilise l’autorisation OAuth du client pour les demandes de compte et de commande de cette boutique. Order MCP utilise un accès limité à l’agent et ne récupère que les commandes passées via celui-ci. Découvrez le schéma de chaque outil avant de choisir une opération de service client.
Shopify MCP permet-il de modifier une commande après achat ?
Non. La documentation actuelle d’Order MCP décrit la lecture des commandes, pas leur modification. Les modifications de commande proposées aux clients nécessitent un processus distinct et restent soumises à la politique de la boutique et à l’état de traitement.
Comment tester un point de terminaison Shopify ?
Suivez la référence officielle de ce point de terminaison et testez la requête documentée dans un environnement de développement. Vérifiez son authentification, les données de profil requises, les champs renvoyés et tout transfert vers le paiement avant la mise en production.
Qu’a indiqué Shopify sur la croissance de la recherche IA ?
En juin 2026, Shopify a indiqué que les commandes issues de la recherche IA étaient 13 fois plus nombreuses sur un an, avec une conversion supérieure de 49 % et une valeur moyenne de commande supérieure de 14 %. Ces chiffres concernent les données de recherche IA de Shopify, pas la performance d’un point de terminaison MCP particulier. Consultez le rapport de Shopify.
Quelle étape de mise en œuvre est prioritaire ?
Choisissez une tâche précise, suivez la documentation actuelle du point de terminaison Shopify correspondant et testez l’ensemble de la requête et de l’expérience client. Gardez distincts les processus de catalogue, de paiement, de lecture des commandes et de modification après achat.
À lire aussi
Vendre sur ChatGPT avec les vitrines agentiques Shopify · Permettre aux clients de modifier leurs commandes Shopify