README

Talk to your PrestaShop shop from Claude, ChatGPT or the assistant built into your back office.

Free and open source - PrestaShop 8.0 to 9.x - English, French, Spanish, German

Download the latest version · Documentation · Ask a question

OSo-MCP-Server-presentation-v2.mp4

Ask your AI assistant to find an order, change a status, check your stock or audit a product page, and it does it in your back office - with the rights of the employee who connected it, and never more.

In the back office the module is called O'So MCP Server.

What you can ask

"Which orders are still waiting for shipment since Monday?"

"Mark order #1042 as shipped."

"Which products are almost out of stock?"

"Show me last month's sales."

"Audit the SEO of my best-selling product and fix its meta description."

"Who is the customer behind order #1042, and what else did they buy?"

More than 90 tools cover orders, catalogue, stock, customers, statistics, SEO, content pages, modules and appearance, and more than 10 ready-made prompts guide the assistant through the usual jobs. See them all.

Requirements


PrestaShop	8.0 to 9.x
PHP	8.1 or later, with the cURL extension
Address	the shop reachable from the internet over HTTPS, so online assistants can connect to it
Friendly URLs	enabled (Shop Parameters > Traffic & SEO)
Location	the shop enabled, and installed at the root of a domain or subdomain, not in a subfolder
Multistore	supported: each shop has its own address and settings
Languages	English, French, Spanish, German

The Run the diagnostic button in the module checks all of this from the outside: certificate, SSL setting, friendly URLs, location, the addresses an assistant calls and the sign-in page where you approve it. No line should be red before you connect an assistant.

Install in 4 steps

Download OSo-MCP-Server-x.y.z.zip from the latest release. Do not unzip it.
In your back office, open Modules > Module Manager, click Upload a module and drop the zip, then Configure.
In the Access and security tab, turn on Consent page - it is off unless you are connecting an assistant.
Copy the address to give to your assistant - it looks like https://your-shop.example/module/somcp/mcp - and paste it into Claude, ChatGPT or another assistant (where to paste it).

The first time, the assistant opens a page of your shop: you sign in with your back office email and password, type the code e-mailed to you, check where the answer goes, and approve what it may do. Then turn Consent page off again: the assistant keeps working. Step by step with screenshots: Installation.

With Composer, on PrestaShop 9, for agencies and automated deployments, from the shop's root folder:

composer config allow-plugins.composer/installers true
composer require novalo/prestashop-mcp-server
php bin/console prestashop:module install somcp

The module lands in modules/somcp, as with the zip, and its dependencies join the shop's own vendor/. Then carry on from step 3. On PrestaShop 8, use the zip: some packages of its core declare PHP 8.0 at most, and the module needs 8.1, so Composer refuses to install them together.

Or use the assistant built into your back office

No account to connect: a chat button at the top of every back office page opens an assistant that works with the same tools, with the rights of the employee signed in, and asks for your approval before any change.

Bring your own key from Claude, ChatGPT, Gemini, Mistral, DeepSeek, Grok or Cohere - each link opens the page where that provider gives out keys.
Or run an AI on your own computer, such as Ollama or LM Studio, with O'So AI Relay: no key, and nothing opened on your network.
Deep thinking, web search and memory can be switched on or off for each conversation, from the + menu. Several assistants can share the work by role.

Compatible assistants

Any assistant that connects to a remote MCP server with OAuth can use your shop's address. These can:

Chat: Claude (web, desktop, mobile), ChatGPT, Le Chat (Mistral), Dust
Command line: Claude Code, Codex (OpenAI), Gemini CLI (Google), GitHub Copilot CLI
Code editor: Cursor, VS Code (GitHub Copilot), Windsurf (Devin Desktop), Zed
Automation: n8n (Cloud and self-hosted), Make

Where to paste the address in each of them: Connect an assistant.

Your shop stays protected

Each employee decides. An assistant only gets the rights of the employee who connected it, page by page, exactly as set in Team > Permissions, and only on the shops that employee is attached to.
No password and no all-powerful API key. Assistants sign in with OAuth 2.1, and every connection can be withdrawn in one click from the module.
A connection takes your password and a code by e-mail, on a page that stays closed - the shop's "page not found" - until you open it in Access and security > Consent page.
You choose what is offered. Each tool and prompt, or a whole group of them such as Orders - changes, can be switched off for connected assistants, for the built-in assistant, or both. A group switched off also holds back the tools a later update adds to it. Changes are flagged as such, which assistants use to ask you before making them.
Every refusal is logged, in a security log that never contains a token or a secret.
Tested before every release. Each version is installed and run on more than 30 PrestaShop versions (more than 70 PrestaShop and PHP combinations), attacked by more than 35 security tests on a live shop and driven through the back office by a real browser. The report is attached to every release.

Found a security issue? Please do not open an issue: report it privately, see SECURITY.md.

Tools

Grouped by back office page, each object's reads before its writes. ● reads only and is safe to repeat; ✎ changes data, one thing per call, and is flagged so assistants ask you before running it. The last column is the right the employee needs in Team › Permissions for the assistant to use the tool. Details of every tool are in docs/TOOLS.md.

🔌 Connection

Tool	What it does	Needs, in Team › Permissions
`somcp_ping`	● Test the connection	nothing

🧾 Orders

Tool	What it does	Needs, in Team › Permissions
`somcp_search_orders`	● Search orders	Orders › view
`somcp_get_order`	● Get an order	Orders › view
`somcp_list_order_statuses`	● List order statuses	Statuses › view
`somcp_list_return_statuses`	● List return statuses	Statuses › view
`somcp_list_carriers`	● List carriers	Carriers › view
`somcp_set_order_status`	✎ Change the status of an order	Orders › edit
`somcp_set_order_tracking`	✎ Set the tracking number of an order	Orders › edit
`somcp_add_order_message`	✎ Add a message to an order	Orders › edit
`somcp_set_order_note`	✎ Set the private note of an order	Orders › edit
`somcp_add_order_payment`	✎ Record a payment for an order	Orders › edit
`somcp_create_return_status`	✎ Create a return status	Statuses › add
`somcp_update_return_status`	✎ Change a return status	Statuses › edit
`somcp_delete_return_status`	✎ Delete a return status	Statuses › delete
`somcp_create_order_status`	✎ Create an order status	Statuses › add

📦 Catalog - Products

Tool	What it does	Needs, in Team › Permissions
`somcp_search_products`	● Search products	Products › view
`somcp_get_product`	● Get a product	Products › view
`somcp_create_product`	✎ Create a product	Products › add
`somcp_update_product`	✎ Change a product	Products › edit
`somcp_set_product_active`	✎ Switch a product on or off	Products › edit
`somcp_delete_product`	✎ Delete a product	Products › delete

🗂️ Catalog - Categories

Tool	What it does	Needs, in Team › Permissions
`somcp_list_categories`	● List categories	Categories › view
`somcp_get_category`	● Get a category	Categories › view
`somcp_create_category`	✎ Create a category	Categories › add
`somcp_update_category`	✎ Change a category	Categories › edit
`somcp_set_category_active`	✎ Show or hide a category	Categories › edit

🏷️ Catalog - Brands

Tool	What it does	Needs, in Team › Permissions
`somcp_list_manufacturers`	● List brands	Brands › view
`somcp_get_manufacturer`	● Get a brand	Brands › view
`somcp_create_manufacturer`	✎ Create a brand	Brands › add
`somcp_update_manufacturer`	✎ Change a brand	Brands › edit
`somcp_set_manufacturer_active`	✎ Enable or disable a brand	Brands › edit
`somcp_list_manufacturer_addresses`	● List brand addresses	Brands › view
`somcp_get_manufacturer_address`	● Get a brand address	Brands › view
`somcp_create_manufacturer_address`	✎ Add a brand address	Brands › edit
`somcp_update_manufacturer_address`	✎ Change a brand address	Brands › edit
`somcp_delete_manufacturer_address`	✎ Delete a brand address	Brands › delete

🚚 Catalog - Suppliers

Tool	What it does	Needs, in Team › Permissions
`somcp_list_suppliers`	● List suppliers	Suppliers › view
`somcp_get_supplier`	● Get a supplier	Suppliers › view
`somcp_create_supplier`	✎ Create a supplier	Suppliers › add
`somcp_update_supplier`	✎ Change a supplier	Suppliers › edit
`somcp_set_supplier_active`	✎ Enable or disable a supplier	Suppliers › edit

🎨 Catalog - Attributes

Tool	What it does	Needs, in Team › Permissions
`somcp_list_attributes`	● List attributes	Attributes › view
`somcp_get_attribute_group`	● Get an attribute group	Attributes › view
`somcp_create_attribute_group`	✎ Create an attribute group	Attributes › add
`somcp_update_attribute_group`	✎ Change an attribute group	Attributes › edit
`somcp_get_attribute_value`	● Get an attribute value	Attributes › view
`somcp_create_attribute_value`	✎ Create an attribute value	Attributes › add
`somcp_update_attribute_value`	✎ Change an attribute value	Attributes › edit

📋 Catalog - Features

Tool	What it does	Needs, in Team › Permissions
`somcp_list_features`	● List features	Features › view
`somcp_get_feature`	● Get a feature	Features › view
`somcp_create_feature`	✎ Create a feature	Features › add
`somcp_update_feature`	✎ Change a feature	Features › edit
`somcp_get_feature_value`	● Get a feature value	Features › view
`somcp_create_feature_value`	✎ Create a feature value	Features › add
`somcp_update_feature_value`	✎ Change a feature value	Features › edit

📎 Catalog - Files and taxes

Tool	What it does	Needs, in Team › Permissions
`somcp_list_attachments`	● List files	Files › view
`somcp_list_tax_rules`	● List tax rules	Tax Rules › view

📊 Stock

Tool	What it does	Needs, in Team › Permissions
`somcp_get_stock`	● Get the stock of a product	Stock › view
`somcp_list_low_stock`	● List low stock	Stock › view
`somcp_set_stock_quantity`	✎ Set the stock of a product	Stock › edit

👥 Customers

Tool	What it does	Needs, in Team › Permissions
`somcp_search_customers`	● Search customers	Customers › view
`somcp_get_customer`	● Get a customer	Customers › view
`somcp_create_customer`	✎ Create a customer	Customers › add
`somcp_update_customer`	✎ Change a customer	Customers › edit
`somcp_list_customer_groups`	● List customer groups	Groups › view

📈 Statistics

Tool	What it does	Needs, in Team › Permissions
`somcp_get_sales_summary`	● Get a sales summary	Stats › view
`somcp_list_best_sellers`	● List best-selling products	Stats › view

📄 Content

Tool	What it does	Needs, in Team › Permissions
`somcp_list_cms_pages`	● List content pages	Pages › view
`somcp_get_cms_page`	● Get a content page	Pages › view

🧩 Modules

Tool	What it does	Needs, in Team › Permissions
`somcp_list_modules`	● List modules	Module Manager › view
`somcp_get_module`	● Get a module	Module Manager › view
`somcp_install_module`	✎ Install a module	Module Manager › add
`somcp_set_module_active`	✎ Enable or disable a module	Module Manager › edit

🖌️ Appearance

Tool	What it does	Needs, in Team › Permissions
`somcp_list_menu_links`	● List main menu entries	Module Manager › view
`somcp_add_menu_link`	✎ Add a main menu entry	Module Manager › edit
`somcp_update_menu_link`	✎ Change a main menu custom link	Module Manager › edit
`somcp_get_theme`	● Get the theme and page layouts	Theme & Logo › view
`somcp_update_theme_setting`	✎ Change the layout of a page	Theme & Logo › edit

⚙️ System

Tool	What it does	Needs, in Team › Permissions
`somcp_get_cache_status`	● Read the performance settings	Performance › view
`somcp_clear_cache`	✎ Clear the cache	Performance › delete

🔎 SEO

Tool	What it does	Needs, in Team › Permissions
`somcp_get_seo_settings`	● Read the SEO and URL settings	SEO & URLs › view
`somcp_list_meta_pages`	● List the shop pages and their SEO	SEO & URLs › view
`somcp_audit_page`	● Audit a public page of the shop	SEO & URLs › view
`somcp_check_links`	● Check the links of the shop's public pages	SEO & URLs › view
`somcp_audit_sitemap`	● Audit the shop's sitemaps	SEO & URLs › view
`somcp_audit_product_seo`	● Audit the SEO of products	Products › view
`somcp_audit_category_seo`	● Audit the SEO of categories	Categories › view
`somcp_audit_cms_seo`	● Audit the SEO of CMS pages	Pages › view
`somcp_audit_brand_seo`	● Audit the SEO of brands	Brands › view
`somcp_update_cms_seo`	✎ Change the SEO of a CMS page	Pages › edit
`somcp_update_meta_page`	✎ Change the SEO of a shop page	SEO & URLs › edit
`somcp_get_robots_txt`	● Read the robots.txt file	SEO & URLs › view
`somcp_generate_robots_txt`	✎ Generate the robots.txt file	SEO & URLs › add, edit, delete

🤖 AEO

Tool	What it does	Needs, in Team › Permissions
`somcp_audit_product_schema`	● Compare a product page with its structured data	Products › view
`somcp_audit_product_entities`	● Audit how complete products are for answer engines	Products › view
`somcp_check_ai_crawler_access`	● Check whether AI crawlers can read the shop	SEO & URLs › view
`somcp_audit_store_policies`	● Audit the store policy pages	Pages › view
`somcp_get_llms_txt`	● Read the llms.txt file	SEO & URLs › view
`somcp_generate_llms_txt`	✎ Generate the llms.txt file	SEO & URLs › add, edit, delete

🛒 Sales

Tool	What it does	Needs, in Team › Permissions
`somcp_list_abandoned_carts`	● List abandoned carts	Shopping Carts › view
`somcp_list_search_terms`	● List shop search terms	Stats › view
`somcp_list_viewed_not_sold`	● List products viewed but not sold	Stats › view
`somcp_list_unsold_products`	● List products never purchased	Stats › view
`somcp_list_cart_rules`	● List cart rules	Cart Rules › view
`somcp_get_cart_rule`	● Get a cart rule	Cart Rules › view
`somcp_create_cart_rule`	✎ Create a cart rule	Cart Rules › add

somcp_ping needs no right: it only tells the assistant which shop, account, language and currency it is connected to.

More than 10 prompts ship with the module, such as finding an order, changing an order status, checking stock, auditing SEO or getting recommended by AI assistants; each one is described in docs/TOOLS.md. The built-in assistant offers them too, each with its icon: those of the page you are on first, and all of them from the + of its field.

Need help?

Documentation: the wiki covers requirements, installation, settings, each assistant and the built-in assistant. The same guide comes as a PDF, readme_en.pdf, with every release.
A bug or an idea: open an issue.
Installation, setup or a tool made for your shop: Novalo.
What changed in each version: CHANGELOG.md.

For developers

How the module works (OAuth, MCP, multistore), how to install it from the sources, how to publish tools from your own module, how to contribute and where help is wanted: CONTRIBUTING.md.

Contributors

Everyone who helped build the module, the top contributor in the middle. The names and the counts are read from GitHub each time this page is shown, so they are always up to date. The settings page of the module shows the same list, read from GitHub, under Help and updates > Meet our contributors.

_2nd

1st

_{Top contributor}

_3rd

Want to be next? CONTRIBUTING.md explains how.

License

Academic Free License 3.0, like the rest of the Novalo modules.

novalo / prestashop-mcp-server

Package info

Security

Fund package maintenance!

Statistics