Note de référence

Shopify : UCP, Catalog MCP et WebMCP comparés

UCP, Catalog MCP et WebMCP sur Shopify : rôles, surfaces, outils et critères pour choisir la bonne architecture agentique.

Publiée le 12 août 2026 . Rattachée à la comparaison UCP et MCP.

Shopify expose désormais plusieurs surfaces pour les agents : UCP, Catalog MCP et WebMCP. Ces noms ne décrivent ni trois versions d’un même produit, ni trois protocoles concurrents. Ils séparent le contrat de commerce, l’accès distant au catalogue et les actions réalisées dans l’onglet du client.

En bref

UCP définit les capacités commerciales et leurs données.

Catalog MCP donne accès à la découverte produit via des outils distants.

WebMCP agit dans la session storefront visible par l’acheteur.

Cette distinction prolonge le comparatif UCP vs MCP : UCP décrit le commerce, tandis que MCP peut servir d’interface pour invoquer des outils structurés.

Pourquoi ces trois noms ne désignent-ils pas la même couche ?

La documentation Shopify présente deux interfaces de catalogue, Global Catalog et Storefront Catalog. Toutes deux implémentent la capacité Catalog d’UCP et exposent les mêmes trois outils. La documentation WebMCP décrit, elle, des outils enregistrés dans le navigateur pour agir sur la page que le client consulte.

Surface	Où agit-elle ?	Rôle principal
UCP	contrat marchand et plateforme	décrire les capacités commerciales
Catalog MCP	serveur distant Shopify ou storefront	chercher et résoudre des produits
WebMCP	onglet du navigateur de l’acheteur	lire et modifier la session en cours

La différence déterminante est donc la surface d’exécution. Un agent distant qui compare plusieurs enseignes n’a pas le même contexte qu’un assistant présent dans l’onglet d’une boutique. Une architecture peut utiliser plusieurs surfaces sans les confondre.

Quel est le rôle précis d’UCP ?

UCP fournit le vocabulaire et les règles du commerce agentique. Le protocole organise la découverte du profil marchand, la négociation des capacités et les services Catalog, Cart, Checkout et Orders. Il prévoit plusieurs transports, dont REST, MCP, A2A et un protocole embarqué.

Cela signifie qu’une opération exposée sous forme d’outil MCP peut rester conforme à une capacité UCP. MCP indique comment l’agent appelle l’outil. UCP précise le sens commercial des objets, les états attendus et les règles de compatibilité. Le guide d’implémentation UCP détaille cette négociation côté marchand.

UCP ne remplace pas l’interface storefront. Le protocole permet aussi des parcours sans navigateur, où la plateforme orchestre l’achat à distance. La présence d’une page web reste utile pour l’utilisateur, mais elle n’est pas le seul point d’entrée possible.

Que fournit Catalog MCP sur Shopify ?

Shopify documente deux périmètres. Global Catalog cherche parmi les marchands Shopify éligibles. Storefront Catalog limite les réponses à une seule boutique. Les deux implémentent la capacité Catalog d’UCP et utilisent une authentification fondée sur le profil de l’agent, sans clé API pour les requêtes documentées.

Les trois outils ont des intentions distinctes :

search_catalog répond à une demande formulée en langage naturel ;
lookup_catalog rafraîchit les données de produits ou variantes déjà identifiés ;
get_product charge le détail d’un produit et ses combinaisons d’options.

Shopify indique aussi des limites différentes pour lookup_catalog : jusqu’à 50 identifiants pour Global Catalog, contre 10 pour Storefront Catalog. Les résultats et images ne doivent pas être mis en cache. Certains champs peuvent être inférés par les systèmes Shopify et sont alors signalés par le libellé Inferred dans la référence.

Le guide GEO et lisibilité du catalogue explique comment préparer les données produit sans casser la continuité des identifiants.

En quoi WebMCP change-t-il l’expérience storefront ?

WebMCP sert les agents que l’acheteur apporte dans son navigateur. Shopify fournit ces outils sur chaque storefront Liquid et sur les storefronts Hydrogen en developer preview. Aucun ajout n’est requis côté boutique selon la documentation actuelle, mais le support agent est limité aux navigateurs fondés sur Chromium.

Les actions portent sur la session visible. Une mise à jour du panier change le panier affiché au client. Une navigation ouvre la page correspondante. Si le thème a relié l’action standard de panier à un tiroir, l’action de l’agent déclenche aussi ce comportement.

La référence liste dix outils répartis entre catalogue, panier, checkout, commandes et informations magasin. Elle inclut notamment search_catalog, browse_store, get_product, update_cart, proceed_to_checkout et search_shop_policies_and_faqs. WebMCP couvre donc une expérience locale, observable et liée à l’état courant du storefront.

Pourquoi Shopify fait-il converger le panier MCP vers UCP ?

Le 24 juin 2026, Shopify a annoncé la dépréciation des anciens outils panier du serveur Storefront MCP au profit de Cart MCP conforme à UCP. L’ancien endpoint /api/mcp laisse place à /api/ucp/mcp pour ces opérations. Shopify a annoncé le maintien des anciens outils jusqu’au 31 août 2026.

La migration ne consiste pas seulement à changer l’URL. update_cart adopte une sémantique PUT : chaque requête remplace l’état complet du panier. Shopify demande aussi un objet meta portant le profil agent et une clé d’idempotence UUID pour cancel_cart. Ces contraintes alignent l’appel d’outil sur le modèle Cart d’UCP.

Pour les états et la conversion vers le paiement, consulter la référence du protocole UCP.

Quelle surface faut-il choisir ?

Le choix dépend de l’endroit où vit l’agent et de la portée attendue. Un moteur de comparaison multi-enseignes utilise Global Catalog. Un agent distant propre à une boutique s’appuie sur Storefront Catalog et les capacités UCP. Un assistant qui aide le client dans son onglet utilise WebMCP pour conserver la session et rendre les actions visibles.

Trois contrôles évitent les erreurs d’architecture :

identifier si l’agent est distant ou présent dans le navigateur ;
séparer recherche globale, catalogue boutique et état transactionnel ;
garder les mêmes identifiants de variante entre découverte, panier et checkout.

UCP reste le contrat commercial commun. Catalog MCP est une interface distante conforme à ce contrat. WebMCP est une surface navigateur complémentaire. Les empiler est cohérent si chaque couche conserve son rôle et son état.

Sources

Revenir à la comparaison UCP et MCP · Toutes les notes · Read in English