# MCP e-commerce : votre IA aux commandes de la boutique

> MCP e-commerce d’Ondes PRO : votre IA consulte les commandes, met à jour les produits, crée des codes promo et suit les expéditions, en mode test par défaut.

Mis à jour le 2026-10-21 · L’équipe Ondes PRO · https://ondes.pro/fr/integrations/mcp/modules/boutique-en-ligne

Avec le **serveur MCP** d’Ondes PRO, votre assistant IA travaille directement dans votre boutique en ligne : il retrouve une commande, fait avancer son suivi, corrige une fiche produit, prépare un code promo ou vérifie une expédition. Il s’appuie sur les ressources réelles de l’API — `shop/commandes`, `shop/produits`, `orders/expeditions` — et ses écritures sur les commandes partent **en mode test** tant que vous ne demandez pas le réel.

## Un lundi matin, les commandes du week-end

_Exemple de conversation · données de démonstration (Atelier Lumen)_

> **Vous** : Quelles commandes payées depuis vendredi ne sont pas encore parties ? Passe-les en préparation.
>
> 🔧 `ondes_ressource` Lit la fiche `shop/commandes` : filtres disponibles, action `statut-lot/`, jumeau de test.
>
> 🔧 `ondes_appeler` `GET shop/commandes` filtré sur le statut payé et `paid_at` depuis vendredi — 7 commandes.
>
> **Assistant** : Sept commandes payées attendent leur préparation, dont deux Lampadaires Arc et une Suspension Laiton. Attention : sur cette ressource, mes écritures partent en **mode test** par défaut et ne toucheraient que des commandes d’essai. Pour vos vraies commandes, je dois écrire en réel. Je fais passer les sept en « préparation », sans e-mail au client ?
>
> **Vous** : Oui, en réel.
>
> 🔧 `ondes_appeler` `POST shop/commandes/statut-lot/` avec `reel: true` — 7 commandes mises à jour, écriture réelle annoncée.
>
> **Assistant** : C’est fait : les sept commandes sont en préparation dans votre suivi. Les clients n’ont pas été prévenus par e-mail, conformément à cette action.

## Ce que votre IA peut lire et faire dans la boutique

Un serveur MCP pour l’e-commerce n’a d’intérêt que s’il donne accès aux vraies données de vente, pas à un export de la veille. Par l’outil `ondes_appeler`, l’assistant interroge votre catalogue et vos commandes au moment où vous posez la question, avec les filtres, la recherche et le tri que la ressource propose.

Côté écriture, il passe par les mêmes gestes que l’administration : ajouter une étape au suivi d’une commande, enregistrer un paiement reçu hors ligne, créer une vente manuelle, mettre à jour un prix ou une description, téléverser une image de galerie, créer une expédition. Aucun de ces gestes n’est réimplémenté pour l’IA : c’est la vue réelle de l’API qui répond, avec ses contrôles.

## Les ressources e-commerce accessibles par MCP

| Ressource | Ce que l’IA lit | Ce que l’IA peut faire |
| --- | --- | --- |
| `shop/commandes` | Commandes, montants, client, statut, date de paiement | Créer, ajouter une étape de suivi (`statut/`, `statut-lot/`), `marquer-payee/`, vente `manuelle/` |
| `shop/produits` | Catalogue, prix, références, catégorie | Créer un produit, modifier prix et descriptions |
| `shop/images-produit` | Galerie de chaque produit | Ajouter ou retirer une image |
| `shop/codes-promo` | Codes existants | Créer un code de réduction |
| `shop/paniers` | Paniers en cours | Lecture seule : un panier naît du parcours d’achat |
| `orders/expeditions` | Expéditions et suivi | Créer ou mettre à jour une expédition |
| `orders/regles-livraison` | Règles de frais de port | Ajuster une règle |

L’assistant lit la fiche complète d’une ressource (champs obligatoires, filtres, actions) avec `ondes_ressource` avant de l’appeler.

## Commandes en mode test : les garde-fous de la boutique

Une erreur sur une commande touche un client réel. Le serveur en tient compte.

- **Mode test par défaut** : `shop/commandes` a un jumeau sous `/api/v1/test/`. Sans `reel: true`, une écriture ne touche que des commandes d’essai, invisibles du chiffre d’affaires et des exports.
- **Ni suppression ni réécriture complète** : une commande payée est une écriture comptable. Elle se corrige par une note ou un remboursement, jamais en l’effaçant.
- **Le compte d’encaissement ne se choisit pas** : il découle de la société concernée, avec repli sur la société mère. Une IA ne peut pas rediriger un paiement.
- **Suivi sans e-mail** : les actions `statut/` et `statut-lot/` n’écrivent pas au client, pour éviter qu’une mise à jour en série ne déclenche une rafale de messages.
- **Paiements simulés** : en mode test, `simuler-paiement/` confirme un paiement sans carte ni compte Stripe, de quoi valider tout un parcours avant d’ouvrir la boutique.

## Demandes types et ce qui se passe

| Vous demandez | Ce que fait l’assistant |
| --- | --- |
| « Où en est la commande de Maison Verdier ? » | Recherche dans `shop/commandes`, lit `shop/statuts-commande` et l’expédition liée. |
| « Passe le Lampadaire Arc à 449 € HT. » | Lit le produit, propose le `PATCH` sur `shop/produits`, l’exécute après votre accord. |
| « Crée un code de 15 % pour la newsletter, jusqu’à dimanche. » | Crée l’entrée dans `shop/codes-promo` et vous rappelle le code exact. |
| « Enregistre la vente du salon, réglée par chèque. » | Crée une commande `manuelle/`, puis `marquer-payee/`. |
| « Teste un achat complet sans rien encaisser. » | Crée une commande en mode test et confirme le paiement simulé. |

## Une vente ne s’arrête pas à la boutique

Un serveur MCP consacré au seul e-commerce s’arrête au paiement. Dans Ondes PRO, la même connexion continue le travail : une vente liée au stock décompte les pièces vendues dans [la gestion des stocks](https://ondes.pro/fr/integrations/mcp/modules/gestion-des-stocks), un client professionnel peut recevoir sa facture depuis [la facturation](https://ondes.pro/fr/integrations/mcp/modules/facturation), et sa fiche s’enrichit dans [le CRM](https://ondes.pro/fr/integrations/mcp/modules/crm).

Vous pouvez donc demander « les produits qui se vendent le mieux et dont le stock baisse » ou « organise les préparations de demain dans le tableau Logistique » : l’assistant croise boutique, stock et [Kanban](https://ondes.pro/fr/integrations/mcp/modules/kanban) dans la même réponse.

> **Les droits de la boutique s’appliquent aussi à l’IA** — Une connexion MCP agit avec votre rôle. Sans accès au module Boutique, l’assistant ne voit ni les commandes ni le catalogue. Pour un collaborateur qui ne doit que consulter, créez une clé API limitée à la lecture de la boutique. Tous les détails sur la page [sécurité du serveur MCP](https://ondes.pro/fr/integrations/mcp/securite).

## Pour aller plus loin

- [E-commerce](https://ondes.pro/fr/integrations/mcp/secteurs/e-commerce) — Commandes, stocks, promotions et service client : votre assistant IA tient la boutique avec vous.
- [Relier son site](https://ondes.pro/fr/integrations/mcp/guides/relier-son-site) — Afficher le catalogue et encaisser par Stripe depuis un site déjà en ligne, sans le reconstruire.
- [Stripe](https://ondes.pro/fr/integrations/stripe) — Encaissez les commandes de votre boutique sur votre propre compte Stripe, société par société.
- [Modules accessibles par MCP](https://ondes.pro/fr/integrations/mcp/modules) — Onze modules de gestion, un seul serveur MCP : ce que l’assistant peut lire et faire dans chacun.

## Questions fréquentes

### Qu’est-ce qu’un serveur MCP pour l’e-commerce ?

C’est un point d’accès standard qui permet à un assistant IA comme Claude de lire et de modifier les données d’une boutique en ligne : commandes, produits, codes promo, expéditions. Dans Ondes PRO, il est intégré à chaque espace à l’adresse `https://<espace>.ondes.pro/mcp/`.

### L’IA peut-elle modifier une vraie commande par erreur ?

Pas sans le demander explicitement. Les écritures sur `shop/commandes` partent en mode test par défaut ; il faut le drapeau `reel: true` pour toucher une vraie commande, et chaque réponse annonce le mode employé.

### Peut-on supprimer une commande par l’API ?

Non. Une commande ne se supprime pas et ne se réécrit pas en entier, parce qu’une commande payée est une écriture comptable. On la corrige par une note, une étape de suivi ou un remboursement.

### L’assistant peut-il encaisser un paiement ?

Il peut créer une commande, qui génère son paiement Stripe et renvoie de quoi le régler côté client, ou enregistrer un paiement reçu hors ligne. Le compte qui encaisse découle de la société concernée et ne se choisit pas dans la requête.

### Le serveur MCP de la boutique est-il payant ?

Non, il est inclus dans toutes les offres Ondes PRO, comme le module boutique lui-même. Voir [les tarifs](https://ondes.pro/fr/pricing).

### Mes clients reçoivent-ils un e-mail quand l’IA met à jour le suivi ?

Pas avec les actions `statut/` et `statut-lot/`, qui ajoutent une étape au suivi sans écrire au client. Cela évite qu’une mise à jour groupée envoie une série de messages.