Guide d'intégration · Mis à jour le 18 février 2026 · 5 min de lecture
Présentation générale
Spaces s'intègre au serveur MCP Storefront (Model Context Protocol) de Shopify pour offrir à vos clients une expérience d'achat pilotée par l'IA. Grâce à cette connexion, un assistant IA peut consulter votre catalogue de produits, gérer les paniers d'achat et guider les acheteurs jusqu'au paiement, le tout au sein d'une conversation naturelle.
Aucune installation requise. Spaces se connecte automatiquement aux données existantes de votre boutique via le point de terminaison MCP intégré de Shopify. Aucune application à installer, aucun code à écrire et aucune configuration nécessaire dans votre administration Shopify.
Fonctionnement
Voici ce qui se passe lorsqu'un client utilise Spaces pour faire des achats dans votre boutique :
1. Le client pose une question — Un visiteur parcourant votre boutique interroge l'assistant IA de Spaces au sujet de produits, un peu comme s'il s'adressait à un vendeur compétent.
2. L'IA interroge votre catalogue — L'assistant interroge le serveur MCP Storefront de votre boutique pour trouver les produits correspondants, avec leurs prix, images, descriptions et liens directs.
3. Le panier est géré dans la conversation — L'assistant peut créer un panier, ajouter des articles, modifier les quantités, supprimer des produits et partager un lien de commande.
4. Le client finalise sa commande — L'acheteur est redirigé vers le module de paiement natif de votre boutique Shopify pour finaliser son achat, en utilisant les modes de paiement et les options d'expédition que vous avez configurés.
Tout transite par l'infrastructure sécurisée de Shopify. Les données produit, les prix et les stocks sont fournis en temps réel, sans synchronisation ni duplication des données.
Recherche dans le catalogue de produits
L'outil search_shop_catalog permet à l'assistant IA de parcourir l'intégralité de votre catalogue de produits pour le compte du client. Il prend en charge les requêtes en langage naturel, de sorte que les acheteurs peuvent décrire ce qu'ils recherchent comme ils le feraient auprès d'une personne réelle.
Ce que les clients peuvent faire
- Rechercher des produits par nom, catégorie ou description
- Demander des recommandations basées sur leurs préférences ou leur cas d'usage
- Parcourir des résultats incluant les noms de produits, les prix, les images et les liens directs vers votre boutique
Ce qui est retourné au client
| Champ | Description |
|---|---|
| Nom du produit | Le titre du produit correspondant |
| Prix et devise | Le prix actuel dans la devise de votre boutique |
| Identifiant de variante | La variante spécifique (utilisée en interne pour les opérations liées au panier) |
| URL du produit | Lien direct vers la page du produit dans votre boutique |
| URL de l'image | L'image du produit |
| Description du produit | La description du produit renseignée dans votre administration Shopify |
Exemple d'interaction
Client : « Je cherche des grains de café bio, de préférence issus du commerce équitable. »
Spaces IA : « J'ai trouvé 3 options dans la boutique ! Voici les meilleures correspondances :
- — 18,99 $
- Origine unique éthiopienne — 22,50 $
- — 16,99 $
Souhaitez-vous en ajouter un à votre panier ? »
Gestion du panier
Spaces propose une gestion complète du panier grâce à deux outils : get_cart et update_cart.
Récupération du panier
get_cart récupère le contenu actuel du panier d'un client, y compris tous les articles, les quantités, les prix et un lien de commande direct. L'assistant IA peut montrer à tout moment son panier au client au cours de la conversation.
Important : le panier est géré par Spaces ; il n'est pas partagé avec Shopify.
Mise à jour du panier
update_cart gère toutes les modifications apportées au panier :
- Création d'un nouveau panier — Lorsqu'un client ajoute son premier article, un panier est créé automatiquement.
- Ajout d'articles — Les produits trouvés lors de la recherche dans le catalogue sont ajoutés à l'aide de leur identifiant de variante.
- Mise à jour des quantités — Les clients peuvent modifier la quantité de n'importe quel article du panier.
- Suppression d'articles — Définir une quantité à 0 supprime entièrement l'article.
Paiement
Lorsque le client est prêt à acheter, l'assistant lui fournit un lien direct vers le module de commande Shopify de votre boutique. Le paiement est traité via votre flux de paiement standard, avec l'ensemble des personnalisations, méthodes de paiement et options d'expédition que vous avez configurées.
Exemple d'interaction
Client : « Ajoutez 2 sachets de Fair Trade Organic Blend à mon panier. »
Spaces IA : « C'est fait ! J'ai ajouté 2× Fair Trade Organic Blend (18,99 $ l'unité) à votre panier. Total du panier : 37,98 $. Prêt à commander, ou souhaitez-vous continuer vos achats ? »
Client : « En fait, mettez-en 3. »
Spaces IA : « Panier mis à jour ! Vous avez maintenant 3× Fair Trade Organic Blend. Nouveau total : 56,97 $. Voici votre lien de paiement dès que vous êtes prêt → »
Le point de terminaison MCP de votre boutique
Chaque boutique Shopify dispose d'un point de terminaison MCP dédié auquel Spaces se connecte automatiquement. Aucune configuration n'est nécessaire.
Format du point de terminaison
https://{your-store}.myshopify.com/api/mcpRemplacez {your-store} par votre domaine Shopify. Par exemple, si votre boutique est cool-beans-coffee.myshopify.com, votre point de terminaison est :
https://cool-beans-coffee.myshopify.com/api/mcp
Points clés
- Aucune authentification requise — Le point de terminaison est accessible publiquement, comme votre vitrine. Il expose uniquement les données déjà visibles sur votre boutique en ligne.
- Données en temps réel — Les modifications effectuées dans votre administration Shopify sont répercutées immédiatement.
- Sécurisé par conception — Accès en lecture seule au catalogue et opérations standard sur le panier uniquement. Aucun accès administrateur, aucun compte client, aucun historique de commande.
Référence
Le tableau ci-dessous récapitule l'ensemble des outils MCP Storefront et leur statut au sein de l'intégration Spaces :
| Outil | Fonction | Statut |
|---|---|---|
search_shop_catalog |
Recherche dans votre catalogue de produits à l'aide de requêtes en langage naturel et renvoie les produits correspondants avec tous les détails. | Actif |
get_cart |
Récupère le contenu actuel du panier, y compris les articles, les quantités et le lien de commande. | Actif |
update_cart |
Crée des paniers, ajoute des articles, met à jour des quantités et supprime des articles. | Actif |
search_shop_policies_and_faqs |
Répond aux questions sur les politiques de la boutique, les FAQ et les informations générales sur la boutique. | Non utilisé |
La recherche dans les politiques et les FAQ n'est pas active. L'outil
search_shop_policies_and_faqsest disponible sur le serveur MCP Storefront de Shopify, mais n'est actuellement pas utilisé par Spaces. Cette fonctionnalité pourrait être ajoutée dans une future mise à jour.
Foire aux questions
Dois-je installer quelque chose ? Non. Le point de terminaison MCP Storefront est intégré à chaque boutique Shopify. Spaces s'y connecte automatiquement — aucune application, aucun code, aucune configuration d'administration n'est nécessaire.
Cela va-t-il affecter ma boutique en ligne existante ? Pas du tout. Le point de terminaison MCP fonctionne parallèlement à votre vitrine. Il lit les mêmes données de produits déjà visibles publiquement et ne modifie ni les paramètres de la boutique, ni les thèmes, ni les données clients.
Quelles données de produits sont partagées ? Uniquement les données déjà visibles publiquement sur votre vitrine : noms de produits, descriptions, prix, images, informations sur les variantes et URL. Aucune donnée privée ou administrative n'est exposée.
L'assistant IA peut-il traiter les paiements ? Non. L'assistant aide les clients à constituer leur panier, puis les redirige vers votre module de commande Shopify standard. L'ensemble du traitement des paiements passe par votre flux de paiement existant.
À quelle vitesse les changements de produits sont-ils répercutés ? En temps réel. Lorsque vous mettez à jour le prix, le titre, la description ou la disponibilité d'un produit dans votre administration Shopify, ces modifications sont immédiatement accessibles via le point de terminaison MCP.
Est-ce sécurisé ? Oui. Le point de terminaison offre un accès en lecture seule au catalogue et des opérations standard sur le panier. Il ne peut accéder ni à votre panneau d'administration, ni à vos comptes clients, ni à l'historique des commandes, ni à aucune donnée privée.
Obtenir de l'aide
Si vous avez des questions sur l'intégration de Spaces ou si vous avez besoin d'aide :
- Centre d'aide Shopify — pour les questions générales de gestion et de configuration de boutique.
- Documentation développeur Shopify — pour les détails techniques sur le serveur MCP Storefront, visitezshopify.dev/docs/apps/build/storefront-mcp/servers/storefront
- Assistance Spaces — pour les questions spécifiques à l'intégration Spaces et à l'expérience d'achat par IA.