PrestaShop MCP Server est le module officiel qui relie une boutique PrestaShop 8.2 ou 9 à un assistant d'IA comme ChatGPT, Claude ou Gemini, par le protocole MCP (Model Context Protocol). L'assistant peut alors lire et modifier les produits, les commandes et les clients, dans la limite des outils activés et des droits donnés à chaque membre.
Ce guide suit la documentation officielle de PrestaShop et la spécification du protocole, consultées le 21 novembre 2026. Il ajoute ce que la documentation laisse au commerçant : quels droits donner, quels outils couper, et ce qui part chez le fournisseur de l'assistant quand il lit une fiche client.
Qu'est-ce que PrestaShop MCP Server ?
Le Model Context Protocol (MCP) est un protocole ouvert qui permet à une application d'IA d'utiliser des données et des outils externes. Les échanges passent par des messages JSON-RPC 2.0 entre trois rôles : l'hôte (l'application d'IA, par exemple ChatGPT), le client (le connecteur à l'intérieur de cette application) et le serveur (le service qui fournit les données et les actions).
PrestaShop MCP Server est ce serveur, installé dans votre boutique comme un module. PrestaShop le présente comme un pont sécurisé entre les assistants d'IA et la boutique : vous écrivez une demande en français, l'assistant appelle les outils de la boutique, puis vous répond. Le module a été mis à disposition sur la Marketplace PrestaShop le 19 novembre 2025, gratuitement selon l'annonce relayée par e-commerce Nation.
| Terme | Ce que c'est dans PrestaShop MCP Server |
|---|---|
| Outil (tool) | Une action que l'assistant peut exécuter, par exemple créer un produit ou mettre à jour une commande |
| Ressource (resource) | Une donnée en lecture seule, à une adresse fixe comme shop://catalog/products |
| Modèle de ressource (resource template) | Une ressource à adresse variable, comme shop://orders/{orderId} |
| Prompt | Un modèle de conversation prédéfini qui guide l'assistant sur une tâche précise |
| Membre | Une personne autorisée à connecter son assistant à la boutique, avec le rôle Viewer ou Editor |
Que peut faire l'assistant sur la boutique ?
Par défaut, le module PrestaShop MCP Tools fournit des outils pour les produits, les images des produits, les commandes et les clients, ainsi que le multilingue. La documentation parle d'outils pour créer, récupérer et mettre à jour ces éléments. Retenez surtout ceci : une action qui n'est pas prédéfinie par un outil, l'assistant ne peut pas la faire. Il ne « navigue » pas dans le back-office.
La documentation ne publie pas de liste complète des outils : elle renvoie à la page de configuration du module, où chaque outil, prompt ou ressource a son propre interrupteur. D'autres modules installés peuvent y ajouter leurs outils. Avant de connecter un assistant, ouvrez cette page et lisez ce qui est réellement actif sur votre boutique.
Ce que l'assistant a le droit de faire dépend aussi du membre connecté :
| Rôle | Droits | Pour qui |
|---|---|---|
| Viewer | Lecture seule. Une écriture tentée est rejetée par le serveur, qui contrôle le rôle à chaque requête | Suivi des ventes, questions sur le stock, vérification du catalogue |
| Editor | Lecture et écriture | La personne qui gère vraiment le catalogue ou les commandes, et qui relit chaque modification |
Versions compatibles et prérequis
Le centre d'aide de PrestaShop indique PrestaShop 8.2 ou plus récent, PrestaShop 9 compris. L'annonce de lancement parlait de « PrestaShop 8 et plus » : vérifiez la compatibilité affichée sur la fiche de la Marketplace avant d'installer. Une boutique en 1.6 ou en 1.7 n'est pas concernée.
| Élément | Ce qu'il faut |
|---|---|
| Version de PrestaShop | 8.2 ou plus récent, ou 9 |
| PrestaShop MBO | Le module « Marketplace in your Back Office », qui installe les dépendances |
| PrestaShop Account | Un compte PrestaShop connecté dans le back-office : c'est lui qui authentifie les membres |
| PrestaShop EventBus | Synchronisation des données |
| PrestaShop MCP Tools | Les outils génériques (produits, images, commandes, clients) |
| Webservice | Activé : le module crée lui-même son jeton de webservice |
| Accès depuis l'extérieur | Les routes /.well-known/* et l'en-tête Authorization doivent atteindre la boutique, qui ne doit pas être en mode maintenance |
Installer PrestaShop MCP Server : les étapes
- Téléchargez le module sur la Marketplace PrestaShop (recherche « PrestaShop MCP Server »).
- Dans le back-office, allez dans Modules > Gestionnaire de modules, cliquez sur « Téléverser un module », choisissez le fichier, puis installez-le.
- Ouvrez la configuration de PrestaShop MCP Server.
- Installez PrestaShop MBO s'il n'est pas déjà présent.
- Laissez MBO installer PrestaShop Account, EventBus et MCP Tools, ou installez-les à la main depuis le gestionnaire de modules.
- Connectez-vous à PrestaShop Account. Notez l'adresse e-mail utilisée : elle servira à connecter l'assistant.
- Revenez dans la configuration du module et vérifiez que tous les modules requis sont actifs.
Faites cette installation d'abord sur une copie de la boutique. Le module ajoute plusieurs dépendances et touche à l'authentification : une préproduction permet de vérifier qu'aucun autre module ne casse, comme pour toute mise à jour. Si un module fait tomber la boutique après installation, notre méthode est décrite dans un module PrestaShop fait planter le site.
Connecter ChatGPT, Claude ou Gemini
La documentation liste dix applications compatibles. La connexion se fait une seule fois : on copie l'URL du serveur MCP affichée dans la configuration du module, on l'ajoute comme nouveau serveur MCP dans l'application, puis on s'authentifie.
| Éditeur | Applications citées par PrestaShop |
|---|---|
| OpenAI | ChatGPT (web), via son mode développeur |
| Anthropic | Claude Desktop, Claude Code |
| Gemini CLI | |
| Mistral | Le Chat |
| Autres | Dust, Cursor, Windsurf, VS Code (GitHub Copilot), GitHub Copilot CLI |
Deux réglages conditionnent la connexion. D'abord, l'adresse e-mail du compte doit figurer dans l'onglet Membres du module, sinon l'authentification échoue. Ensuite, Claude Code et Gemini CLI demandent de déclarer les scopes à la main : mcp.discover mcp.read mcp.write email. Si votre hébergement filtre les robots, la documentation demande aussi d'autoriser les user-agents des assistants dans le pare-feu.
Sécurité : jetons, permissions et journaux
Le module s'authentifie uniquement par PrestaShop OAuth, avec les comptes PrestaShop comme fournisseur et trois scopes : mcp.discover, mcp.read et mcp.write. L'e-mail contenu dans le jeton OAuth est comparé à la liste des membres à chaque requête.
Le jeton d'accès statique est la solution de repli pour les applications qui ne savent pas faire OAuth. Il s'envoie dans l'en-tête Authorization, il n'est affiché qu'une fois, et surtout il n'expire pas tout seul. Quiconque le récupère agit avec les droits du membre, jusqu'à ce que vous le régénériez.
Les réglages que nous appliquons avant d'ouvrir une boutique à un assistant :
| Réglage | Pourquoi |
|---|---|
| Un membre par personne, jamais d'adresse partagée | Savoir qui a donné quel ordre, et retirer un accès sans couper les autres |
| Viewer par défaut, Editor seulement pour qui modifie vraiment | Une erreur de compréhension de l'assistant ne peut rien écrire en lecture seule |
| Couper les outils inutiles, à commencer par les clients | Ce qui n'est pas actif ne peut ni être lu ni partir dans une conversation |
| OAuth plutôt que le jeton statique | Le jeton OAuth est lié au compte ; le jeton statique vit tant qu'on ne le régénère pas |
| Jeton rangé dans un gestionnaire de mots de passe, régénéré au départ d'une personne | La régénération invalide immédiatement l'ancien jeton |
| Confirmation des actions laissée active dans l'assistant | La spécification MCP demande l'accord de l'utilisateur avant tout appel d'outil ; ne pas valider les écritures d'office |
Module et dépendances à jour, ps_accounts compris | Recommandation de PrestaShop ; c'est ce module qui valide les jetons |
Deux pièges à connaître. Le module contient un mode sans authentification, verrouillé par défaut, qui se déverrouille par la constante _PS_MCP_SERVER_ALLOW_INSECURE_MODE_. Il sert aux tests en local : en production, le serveur accepterait alors n'importe quelle requête. Côté journalisation, le module propose des journaux de débogage dans son dossier .mcp/logs, pour diagnostiquer une panne. Nous n'avons pas trouvé dans la documentation de journal d'audit qui liste, membre par membre, les actions faites par l'assistant : pour les modifications sensibles (prix, statuts de commande), gardez l'historique côté boutique et relisez.
RGPD : ce qui part chez le fournisseur de l'assistant
Le fonctionnement de MCP est simple : ce qu'un outil renvoie entre dans la conversation, donc chez l'éditeur de l'assistant (OpenAI, Anthropic, Google, Mistral…). Demander « le suivi de la commande de Mme Martin » envoie son nom, son adresse et le contenu de sa commande à ce service. Notre règle est stricte : aucune donnée personnelle de client ne part vers un service d'IA sans base légale.
Avant d'activer les outils clients ou commandes, vérifiez ces points :
- Base légale (article 6 du RGPD) : pour quel usage les données des clients sont-elles traitées par l'assistant, et cet usage est-il couvert par ce que vous avez annoncé à vos clients ?
- Minimisation (article 5) : si l'assistant sert au catalogue, il n'a pas besoin des clients. Coupez ces outils.
- Contrat de sous-traitance (article 28) : l'éditeur de l'assistant traite des données pour votre compte. Vérifiez que votre offre comporte un contrat de traitement des données et ce qu'elle dit de la réutilisation des conversations.
- Transferts hors de l'Union européenne (chapitre V) : la plupart des assistants sont édités par des sociétés américaines. Le transfert doit reposer sur un des mécanismes prévus, que la CNIL détaille.
- Registre et information : ajoutez ce traitement à votre registre et à votre politique de confidentialité.
Ce point n'est pas propre à PrestaShop : la spécification MCP elle-même demande que l'utilisateur garde le contrôle des données partagées. Mais c'est le commerçant, responsable du traitement, qui répond de ce qui sort de sa base clients.
Cas d'usage réalistes pour un commerçant
Les exemples publiés par PrestaShop tournent autour du stock, des images et du suivi des commandes. Classés selon ce qu'ils exposent :
| Demande à l'assistant | Rôle suffisant | Données personnelles |
|---|---|---|
| « Quel est le stock du produit de référence TSHIRT-001 ? » | Viewer | Aucune |
| « Liste les produits dont le stock est inférieur à 5 et fais-en un tableau pour le fournisseur » | Viewer | Aucune |
| « Quelles fiches n'ont pas de description dans la langue anglaise ? » | Viewer | Aucune |
| « Mets la troisième image de ce produit en couverture » | Editor | Aucune |
| « Où en est la commande 1234, et rédige un e-mail au client » | Viewer | Oui : nom, adresse, contenu de la commande |
| « Exporte les abonnés à la lettre d'information du mois dernier » | Viewer | Oui : liste d'e-mails, base légale à vérifier |
Les trois premières lignes donnent déjà un gain réel sans aucun risque RGPD : interroger le catalogue en français plutôt que de filtrer des listes dans le back-office. C'est par là que nous conseillons de commencer.
Limites à connaître
- L'assistant se trompe parfois : il peut mal comprendre une référence ou une langue. En rôle Editor, une mauvaise compréhension devient une modification réelle.
- Seules les actions prévues existent. Un besoin propre à votre boutique demande un outil développé pour elle.
- Le module dépend d'un compte PrestaShop et de plusieurs modules de l'éditeur, qu'il faut garder à jour.
- Certains hébergements bloquent la connexion : Cloudflare qui filtre
/.well-known/*, un.htaccessqui ne transmet pas l'en-têteAuthorization, une protection par mot de passe du dossier. - Les versions 1.6 et 1.7 ne sont pas prises en charge : la migration vers PrestaShop 9 passe avant.
Ajouter ses propres outils MCP dans un module
Un module PrestaShop peut exposer ses propres actions à l'assistant. Il déclare d'abord qu'il est compatible avec une méthode isMcpCompliant() dans sa classe principale, puis il décrit chaque outil par des attributs PHP dans son dossier src :
use PrestaShop\Module\PsMcpServer\Server\Attributes\PsMcpTool;
use PrestaShop\Module\PsMcpServer\Server\Attributes\PsMcpSchema;
use PrestaShop\Module\PsMcpServer\Server\Attributes\PsMcpToolAnnotations;
#[PsMcpTool(
name: 'stock_magasin',
description: 'Stock en magasin d\'une référence',
annotations: new PsMcpToolAnnotations(readOnlyHint: true, destructiveHint: false)
)]
#[PsMcpSchema(properties: ['reference' => ['type' => 'string']], required: ['reference'])]
public function stockMagasin(string $reference): string { /* ... */ }
Pour l'autocomplétion pendant le développement, PrestaShop publie le paquet prestashop/ps-mcp-server-stubs (PHP 8.1 ou plus, en dépendance de développement seulement). C'est la voie propre pour un besoin métier : un outil qui lit votre caisse, votre ERP ou un stock fournisseur, en lecture seule si possible. Les échanges avec les logiciels externes passent souvent par l'API de la boutique, présentée dans notre article sur le Webservice et l'Admin API de PrestaShop.
PrestaShop MCP Server ou WebSentinel Atelier ?
Nous développons WebSentinel Atelier, un module IA pour PrestaShop 9, en accès anticipé. Les deux ne répondent pas au même besoin :
| PrestaShop MCP Server | WebSentinel Atelier | |
|---|---|---|
| Usage | Piloter la boutique en conversation depuis un assistant | Rédiger et reprendre des fiches produits, puis les visuels, depuis le back-office |
| Données lues | Selon les outils actifs : produits, commandes, clients | Les produits seulement, jamais les clients ni les commandes |
| Abonnement à un assistant | Il faut une application compatible | Aucun : crédits achetés à WebSentinel |
| Contrôle | Rôles Viewer / Editor, confirmation dans l'assistant | Devis en crédits avant lancement, relecture avant publication, retour en arrière |
| Versions | PrestaShop 8.2 et 9 | PrestaShop 9 |
Une boutique peut utiliser les deux : MCP Server en lecture seule pour interroger le catalogue, Atelier pour produire les fiches en nombre.
Et les serveurs MCP non officiels ?
D'autres projets existent, comme O'So MCP Server (paquet novalo/prestashop-mcp-server, module somcp), gratuit sous licence AFL-3.0, qui demande PHP 8.1 et propose une validation des actions par employé. Ce ne sont pas les mêmes instructions d'installation que le module de PrestaShop : ne mélangez pas les deux documentations, et appliquez à ces modules le même contrôle qu'à tout module tiers (éditeur, mises à jour, code lisible).
Se faire accompagner
Nous installons et réglons PrestaShop MCP Server sur une copie de votre boutique, avec les membres, les rôles et les outils réduits à votre usage, puis nous le passons en production. Si votre besoin dépasse les outils fournis, nous développons l'outil dans un module PrestaShop sur mesure. Le suivi des mises à jour du module et de ses dépendances peut entrer dans la maintenance PrestaShop. Envoyez-nous l'adresse de la boutique et ce que vous voulez demander à l'assistant : nous vous répondons avec un devis écrit.
Sources
- PrestaShop : introduction à MCP for PrestaShop (consulté le 21/11/2026)
- PrestaShop : installation de PrestaShop MCP Server (consulté le 21/11/2026)
- PrestaShop : configuration, membres et options développeur (consulté le 21/11/2026)
- PrestaShop : sécurité, OAuth et jetons (consulté le 21/11/2026)
- PrestaShop : connecter une application d'IA (consulté le 21/11/2026)
- PrestaShop : glossaire MCP (consulté le 21/11/2026)
- PrestaShop : créer ses propres outils MCP (consulté le 21/11/2026)
- PrestaShop : dépannage (consulté le 21/11/2026)
- Centre d'aide PrestaShop : visite guidée et prérequis (consulté le 21/11/2026)
- Blog PrestaShop : exemples d'usage de MCP Server (12/06/2026, consulté le 21/11/2026)
- e-commerce Nation : annonce du serveur MCP de PrestaShop (19/11/2025, source secondaire)
- Model Context Protocol : spécification (version 2026-07-28) (consulté le 21/11/2026)
- Packagist : prestashop/ps-mcp-server-stubs (consulté le 21/11/2026)
- Packagist : O'So MCP Server (novalo/prestashop-mcp-server) (consulté le 21/11/2026)
- EUR-Lex : règlement (UE) 2016/679, RGPD (consulté le 21/11/2026)
- CNIL : les bases légales (consulté le 21/11/2026)
- CNIL : transférer des données hors de l'UE (consulté le 21/11/2026)
