Qu'est-ce que MCP ?
MCP (Model Context Protocol) est un standard ouvert de connexion entre une IA et des logiciels. Le serveur décrit ses outils, le client IA (Claude Desktop, Claude Code, Cursor, Codex…) les appelle quand une question le demande.
Que doit faire un bon serveur MCP PrestaShop ?
- Lire sans ralentir le site : répondre depuis une copie des données plutôt que d'interroger la boutique en ligne à chaque question.
- Ne rien écrire sans validation : l'IA prépare, une personne vérifie et applique.
- Ne jamais exposer les mots de passe de la boutique ou du serveur à l'IA.
- Garder une trace et permettre d'annuler chaque modification.
Que contient le serveur MCP de One Shop Manager ?
Le serveur one-shop-manager expose 44 outils (version 0.4.56, liste complète dans docs/tools.md). Il tourne dans le logiciel One Shop Manager, qui copie la boutique sur l'ordinateur.
| Famille | Exemples d'outils | Ce qu'ils font |
|---|---|---|
| Boutique | shop_info, list_languages |
Boutique ouverte, langues |
| Catalogue | search_products, get_product, list_combinations |
Produits, textes par langue, catégories, attributs et déclinaisons |
| Clients et commandes | search_customers, list_orders, get_order |
Fiches clients, commandes avec marge brute |
| Analyse | sales_report, stock_report, restock, seo_report |
Ventes, valorisation du stock, réassort, audit SEO, tableaux |
| Comptabilité | accounting_summary, accounting_order |
Synthèse avec TVA par pays et par taux, écritures d'une commande |
| Journal | list_journal, list_proposals |
Opérations passées, statut des propositions |
| Propositions catalogue | propose_price_change, propose_texts, propose_product_create |
Prix, champs, textes et SEO, catégories, création de produits (désactivés) |
| Propositions déclinaisons | propose_combinations_create, propose_combination_stock |
Attributs, valeurs, déclinaisons, stock |
| Propositions commandes | propose_order_state, propose_order_tracking |
Statuts, numéros de suivi, nouvelle commande |
| Annulation | propose_undo |
Annuler une opération du journal |
Les outils propose_* n'écrivent rien sur la boutique : ils calculent le changement et le déposent comme proposition dans le Journal IA. Vous ouvrez l'aperçu avant/après, puis vous cliquez sur Appliquer. Le mode lecture seule masque toutes les propositions à l'IA.
Quelles garanties de sécurité ?
- Accès désactivé par défaut, activé depuis les réglages du logiciel ; « Tester l'accès » vérifie la connexion.
- Serveur local : il n'écoute que sur l'ordinateur (
127.0.0.1), et chaque requête demande une clé d'accès. « Nouveau jeton » révoque la clé en cours. - Identifiants hors de portée : les clés et mots de passe de la boutique restent dans le trousseau du système.
- Données limitées : seules les données nécessaires à la question partent vers le fournisseur d'IA ; avec votre propre Claude, elles vont directement chez Anthropic.
- Annulation : tout s'annule depuis le journal, sauf une commande créée par l'IA.
Détails dans docs/security.md.
Comment l'installer, client par client ?
Commencez par activer l'accès : dans One Shop Manager, IA › Configuration IA, carte Accès IA (MCP), cochez « Activer l'accès IA », puis cliquez sur « Tester l'accès ». Le logiciel doit rester ouvert sur la boutique.
Claude Desktop
Quittez complètement Claude Desktop, cliquez sur « Brancher Claude Desktop », puis rouvrez Claude. Autre possibilité : installer l'extension prestashop-mcp.mcpb publiée sur GitHub, qui demande la clé d'accès et le port.
Claude Code
Copiez la commande affichée par le logiciel et lancez-la dans un terminal, une fois par ordinateur :
claude mcp add --scope user --transport http one-shop-manager http://127.0.0.1:47715/mcp --header "Authorization: Bearer <CLÉ_D_ACCÈS>"
Dans Claude Code, /mcp affiche one-shop-manager connecté. Cela fonctionne aussi dans l'extension VS Code.
Application ChatGPT pour ordinateur et Codex
Choisissez ChatGPT (Codex) et cliquez sur « Brancher ChatGPT et Codex ». Dans l'application ChatGPT, installez ensuite une fois le plugin One Shop Manager depuis Plugins ; redémarrez Codex. ChatGPT dans le navigateur ne peut pas joindre un serveur local.
Cursor et autres clients MCP
Ajoutez dans ~/.cursor/mcp.json le bloc donné par le logiciel :
{
"mcpServers": {
"one-shop-manager": {
"url": "http://127.0.0.1:47715/mcp",
"headers": { "Authorization": "Bearer <CLÉ_D_ACCÈS>" }
}
}
}
Les autres clients se branchent de la même façon (HTTP), ou en stdio avec l'exécutable du logiciel. Le logiciel affiche la vraie clé et le port.
Où le trouver ?
- Registre officiel MCP :
io.github.oneshopmanager/prestashop-mcp. - Dépôt GitHub : oneshopmanager/prestashop-mcp, avec la documentation de chaque client et l'extension Claude Desktop.
Que peut-on lui demander ?
- « Quels produits en stock ne se sont pas vendus depuis 90 jours ? »
- « Baisse le prix de ces produits de 15 %, arrondi à x,90, sans passer sous 25 % de marge. »
- « Écris les meta descriptions manquantes de la catégorie Chaussures, en français et en anglais. »
- « Ajoute les déclinaisons S, M, L et XL à ce sweat. »
- « Quelles commandes payées ne sont pas encore expédiées ? »
- « TVA collectée par pays au troisième trimestre ? »
D'autres exemples dans examples/prompts.md.
Questions fréquentes
Faut-il installer un module sur la boutique ?
Oui. Un petit module PrestaShop fait le pont entre One Shop Manager et le webservice de la boutique. Le serveur MCP, lui, tourne sur votre ordinateur.
Le serveur fonctionne-t-il sans le logiciel ?
Non. Le serveur MCP fait partie de One Shop Manager : le logiciel doit rester ouvert sur la boutique pour que l'IA y accède.
Quelles versions de PrestaShop ?
PrestaShop 1.6, 1.7, 8 et 9, sur macOS 11+ et Windows 10+.
Le serveur MCP est-il payant ?
Il est inclus dans One Shop Manager, sans supplément : vous utilisez votre propre abonnement Claude ou ChatGPT. Le prix du logiciel est sur la page Tarif.