MCP ECOM Shopware 6 — Complete Guide (All Versions)

Requirements

Requirement	Details
Shopware	Shopware 6.5 or 6.6 (Community Edition)
PHP	PHP 8.1 or newer
ChatGPT	ChatGPT Plus or Team subscription (Developer Mode required)
SSL	HTTPS certificate on your shop (ChatGPT requires HTTPS)
License Key	Required for Starter, Pro and Pro Plus versions (available at mcpecom.com)

Installation

Note: The plugin folder and installation command differ depending on the version. See the table below.

Version	Plugin Folder	Install Command
Free	`McpEcomShopware`	`bin/console plugin:install McpEcomShopware`
Starter	`McpEcomShopwareStarter`	`bin/console plugin:install McpEcomShopwareStarter`
Pro	`McpEcomShopwarePro`	`bin/console plugin:install McpEcomShopwarePro`
Pro Plus	`McpEcomShopwareProPlus`	`bin/console plugin:install McpEcomShopwareProPlus`

1

Upload Plugin

Download the plugin ZIP file and extract it to the corresponding folder:

custom/plugins/[FOLDERNAME]/

Replace [FOLDERNAME] with the plugin folder from the table above (e.g. McpEcomShopware for Free).

2

Install and Activate Plugin

Run the following commands in your terminal (SSH). Replace [PLUGINNAME] with the appropriate name from the table:

bin/console plugin:refresh
bin/console plugin:install [PLUGINNAME]
bin/console plugin:activate [PLUGINNAME]
bin/console cache:clear

Alternative via Admin: Go to Extensions → My Extensions, find the plugin, install and activate it.

3

Done!

The plugin is now active. Continue with the settings.

Settings in Shopware Admin

Go to Extensions → My Extensions → [Plugin Name] → Configuration

All Versions (Free, Starter, Pro, Pro Plus)

Setting	Required?	Description
MCP Token	Yes	Secures the connection between ChatGPT and your shop. You can choose any value.
Bulk Limit	No	Max. products per bulk upload. Free: 3, Starter: 10, Pro: 30, Pro Plus: 50
AI Endpoint	No	URL of the AI server. Default: `https://ai.mcpecom.com`

From Starter

Setting	Description
License Key	Your license key from mcpecom.com
Brand Voice	Brand description for consistent AI-generated text
Target Audience	Description of your target audience
Brand Tone	Choose: professional, friendly, luxurious, youthful, technical, minimalist
USP	Unique selling proposition of your brand

From Pro

Setting	Description
SerpAPI Key	For web research and competitor analysis
Brand Values	Core values of your brand
Content Language	de_formal, de_informal, en, fr, es, it, nl

Pro Plus Only

Setting	Description
Auto-Schema	Automatic product schema detection
Audit Schedule	manual, weekly, monthly

Important: With Shopware you do not need WooCommerce API keys (Consumer Key/Secret). Shopware uses its own DAL (Data Abstraction Layer) internally. You only need the MCP Token.

MCP Server URLs

Your MCP server URL depends on the installed version:

Version	URL
Free	`https://your-shop.com/mcp-proxy-shopware/v1?token=YOUR-TOKEN`
Starter	`https://your-shop.com/mcp-proxy-shopware-starter/v1?token=YOUR-TOKEN`
Pro	`https://your-shop.com/mcp-proxy-shopware-pro/v1?token=YOUR-TOKEN`
Pro Plus	`https://your-shop.com/mcp-proxy-shopware-pro-plus/v1?token=YOUR-TOKEN`

Replace your-shop.com with your shop domain and YOUR-TOKEN with your chosen token.

Connect ChatGPT

1

Enable ChatGPT Developer Mode

Go to chatgpt.com and navigate to:

Settings → Apps → Advanced Settings → Developer Mode

Enable Developer Mode.

2

Create App

Click Create App and enter:

Field	Value
Name	MCP ECOM Shopware (or any name you prefer)
Description	optional
URL	Your MCP server URL (see table above — depends on your version)
Authentication	No Auth

Confirm the Custom MCP Server notice.

3

Test

Open a new chat in ChatGPT and type:

Show me my Shopware products

ChatGPT should now list your products. Done!

Error "Connector name already exists"? You already have an app with this name. Go to Settings → Apps, delete the old app and create a new one with a different name.

Free Version

FREE

The free entry-level version. Create products with AI, upload images and use bulk upload for up to 3 products at once. No license required.

Available Tools (3)

Tool	Description
generateFullProduct	Creates a complete product with AI — including title, description, SEO texts, categories, tags and images.
bulkGenerateProducts	Creates multiple products at once (bulk upload). Limit: 3 products.
listProducts	Lists all products with filter and sorting options.

Key Facts

Bulk Limit

3 Products

License

Not required

Endpoint

https://your-shop.com/mcp-proxy-shopware/v1?token=YOUR-TOKEN

Starter Version

STARTER

The Starter version extends Free with product optimization, CSV import and the Brand Voice Engine. Optimize existing products and import entire product lists via CSV.

Available Tools (5)

Tool	Description
generateFullProduct	Creates a complete product with AI — now with Brand Voice.
optimizeProduct	Optimizes an existing product — improves description, SEO texts and structure based on your Brand Voice and target audience.
bulkGenerateProducts	Creates up to 10 products at once.
csvProductImport	Imports products from a CSV file. Columns are automatically detected. Max. 25 rows.
listProducts	Lists all products with filter and sorting options.

Key Facts

Bulk Limit

10 Products

CSV Import

25 Rows

New Features

Brand Voice Engine: Define your brand voice, target audience, brand tone and USP — the AI then generates consistent text that matches your brand.

Product Optimization: Improve existing products with AI — polish descriptions, optimize SEO and adjust structure.

CSV Import: Upload products via CSV file. Columns are automatically detected. Supported delimiters: comma, semicolon, tab.

Endpoint

https://your-shop.com/mcp-proxy-shopware-starter/v1?token=YOUR-TOKEN

License required: You need a Starter license key from mcpecom.com. Enter it in the plugin settings.

Pro Version

PRO

The Pro version adds web research, competitor analysis and advanced product tools. Use SerpAPI for data-driven product creation and optimize your entire catalog.

Available Tools (12)

Tool	Description
generateFullProduct	Creates a complete product — with Brand Voice and content language.
optimizeProduct	Optimizes existing products with advanced AI features.
bulkGenerateProducts	Creates up to 30 products at once.
csvProductImport	CSV import with up to 50 rows.
listProducts	Lists and filters all products.
webResearch	Researches the web via SerpAPI — finds trends, prices and market data.
competitorAnalysis	Analyzes competitor products and provides improvement suggestions.
keywordSuggestions	Suggests relevant keywords for SEO and product texts.
generateVariations	Creates variations of an existing product (color, size, material).
detectAttributes	Automatically detects product attributes from the description.
categoryMapping	Automatically maps products to the appropriate categories.
qualityCheck	Checks product quality — completeness, SEO, description and images.

Key Facts

Bulk Limit

30 Products

CSV Import

50 Rows

New Features

SerpAPI Integration: Research the web, analyze competitors and find keywords — all data-driven via SerpAPI.

Content Language: Create products in 7 languages — de_formal, de_informal, en, fr, es, it, nl.

Quality Check: Automatic quality check for your products — detects missing descriptions, poor SEO texts and more.

Product Variations: Automatically create variations of a product based on attributes like color, size or material.

Endpoint

https://your-shop.com/mcp-proxy-shopware-pro/v1?token=YOUR-TOKEN

License required: You need a Pro license key from mcpecom.com. Additionally, you need a SerpAPI key for the web research features.

Pro Plus Version

PRO PLUS

The most comprehensive version with AI Catalog Intelligence. Normalize attributes, create structured schemas, run catalog audits and search products using natural language.

Available Tools (16)

Tool	Description
generateFullProduct	Creates products with all features — Brand Voice, content language and Auto-Schema.
optimizeProduct	Optimizes existing products with advanced AI features.
bulkGenerateProducts	Creates up to 50 products at once.
csvProductImport	CSV import with up to 50 rows.
listProducts	Lists and filters all products.
webResearch	Web research via SerpAPI.
competitorAnalysis	Competitor analysis with improvement suggestions.
keywordSuggestions	Keyword suggestions for SEO.
generateVariations	Create product variations.
detectAttributes	Automatic attribute detection.
categoryMapping	Automatic category mapping.
qualityCheck	Quality check for products.
normalizeAttributes	Attribute normalization — scans, previews and applies uniform attributes (scan/preview/apply modes).
structureProductSchema	Creates structured product schemas as JSON or table — ideal for consistent product data.
catalogAudit	Catalog audit with 7 checks (full/quick/category). Detects quality issues and offers auto-fix.
aiQueryProducts	Natural language product search — find products by asking questions instead of using filters.

Key Facts

Bulk Limit

50 Products

Exclusive Tools

4 Tools

Exclusive Features: AI Catalog Intelligence

normalizeAttributes: Scans all product attributes and normalizes them — e.g. "Color: red", "color: Red", "Colour: red" are unified into a consistent format. Modes: scan (analyze), preview (preview changes), apply (apply changes).

structureProductSchema: Creates structured product schemas as JSON or table. Ideal for consistent product data across your entire catalog.

catalogAudit: Runs a comprehensive catalog audit with 7 checks. Modes: full (entire catalog), quick (quick check), category (single category). Offers auto-fix for detected issues.

aiQueryProducts: Search products using natural language — e.g. "Find all red shoes under 50 euros" instead of complex filters.

Endpoint

https://your-shop.com/mcp-proxy-shopware-pro-plus/v1?token=YOUR-TOKEN

License required: You need a Pro Plus license key from mcpecom.com.

Prompt Collection

Copy these prompts directly into ChatGPT. All products are created as inactive (draft) — you can review them in the Shopware admin and activate them when ready.

Free — Basics

FREE

List Products

Show me my Shopware products

Show me all active products

Show me products in the "Electronics" category

Search for products with "candle" in the name

Show me the 20 newest products, sorted by creation date

Show me all inactive products (drafts)

Create a Single Product

Create a Shopware product: "Vanilla Scented Candle" for $14.90

Create a product: "Premium Yoga Mat" priced at $39.90 without images

Create a product: "Mini Bluetooth Speaker" for $34.90.
Material: Aluminum. Target audience: Outdoor fans. Style: modern.
Category: Electronics

Create a product: "Organic Extra Virgin Olive Oil" for $18.50.
Keywords: buy olive oil, organic olive oil, extra virgin olive oil

Image Logic: ChatGPT automatically asks for images. You can provide image URLs — the first image becomes the main image (cover), the rest go to the gallery. The only exception: when you write "without images".

Create Product with Images

Create a product: "Brown Leather Belt" for $49.90.
Images:
- https://example.com/images/leather-belt-brown-1.jpg
- https://example.com/images/leather-belt-brown-2.jpg

Create a product: "Urban White Sneaker" for $89.90.
Category: Shoes. Material: Leather.
Images: https://example.com/sneaker-white-front.jpg, https://example.com/sneaker-white-side.jpg

Multiple Products at Once (Bulk — up to 3)

Create the following 3 products:
1. Espresso Cup "Milano" — $12.90
2. Cappuccino Cup "Roma" — $14.90
3. Latte Glass "Firenze" — $16.90
Category: Kitchen & Home

Starter — Optimization & Import

STARTER

Optimize the product "Vanilla Scented Candle" — improve description and SEO

Import products from my CSV file

Create 10 products on the topic "Office Supplies"

Pro — Research & Analysis

PRO

Research "sustainable water bottles" and create a product based on the results

Analyze the competition for "Premium Yoga Mat"

Suggest keywords for "Organic Olive Oil"

Check the quality of product "Brown Leather Belt"

Detect attributes for product "Bluetooth Speaker"

Create 5 variations for "Vanilla Scented Candle"

Pro Plus — Catalog Intelligence

PRO PLUS

Normalize the attributes of all products in the "Electronics" category

Create a structured schema for product "Urban White Sneaker"

Run a catalog audit for my entire shop

Find all products under $20 with missing descriptions

Version Comparison (Shopware 6)

Feature	FREE	STARTER	PRO	PRO PLUS
AI Product Creation	✓	✓	✓	✓
List Products	✓	✓	✓	✓
Image Upload	✓	✓	✓	✓
SEO Texts	✓	✓	✓	✓
Categories & Tags	✓	✓	✓	✓
Bulk Upload	3	10	30	50
License Required	—	✓	✓	✓
Brand Voice Engine	—	✓	✓	✓
Product Optimization	—	✓	✓	✓
CSV Import	—	25	50	50
Web Research	—	—	✓	✓
Competitor Analysis	—	—	✓	✓
Keyword Suggestions	—	—	✓	✓
Product Variations	—	—	✓	✓
Attribute Detection	—	—	✓	✓
Category Mapping	—	—	✓	✓
Quality Check	—	—	✓	✓
Content Language (7)	—	—	✓	✓
SerpAPI Integration	—	—	✓	✓
Attribute Normalization	—	—	—	✓
Structured Schemas	—	—	—	✓
Catalog Audit	—	—	—	✓
AI Query Layer	—	—	—	✓
Auto-Schema	—	—	—	✓

Shopware 6 vs. WooCommerce — Differences

The plugin works similarly on both platforms, but there are some differences:

Shopware 6

Only MCP Token needed (no API Key/Secret)
Products use Shopware DAL internally
Categories: Only existing ones are assigned
Tags: Automatically created if needed
Products are created as inactive
Tax: Automatically 19% VAT
Sales Channel is automatically assigned
Product numbers: MCP-XXXXXXXX

WooCommerce

Requires Consumer Key + Secret
Uses the WooCommerce REST API
Categories: Automatically created
Tags: Automatically created
Products are created as draft
Tax: Depends on WooCommerce settings
No Sales Channel concept
SKU: MCP-XXXXXXXX

Privacy & Security

MCP ECOM was built with privacy as a core principle. Here's exactly what happens with your data:

Data Flow

You (ChatGPT) → HTTPS/SSE → Your Shopware 6 Server → Shopware Admin API → Your Database

No external servers: MCP ECOM does not store any product data on third-party servers. Everything stays on your own hosting.
No access to orders or customer data: MCP ECOM exclusively accesses product data (title, description, price, categories, tags). Orders, customer names, addresses, payment information, or other personal data are never read or processed.
AI processing: Text generation happens at OpenAI (ChatGPT) — according to their privacy policies. Only product information is sent to ChatGPT.
License check: Once daily, only your license key + domain are verified — no product data, no customer data.

Security Measures

Secret Token: Every request is authenticated with your individual token. No token, no access.
HTTPS required: All communication runs encrypted over HTTPS.
Drafts only: AI-generated products are always created as drafts — never published directly.
Shopware Admin API: The plugin exclusively uses product endpoints of the Shopware Admin API — never /order, /customer, or other sensitive endpoints.

GDPR Compliance

MCP ECOM does not process any personal customer data, order data, or payment information. Only product data (title, description, price, categories, tags, SEO fields) is processed. For more details, see our Privacy Policy.

Why MCP ECOM Instead of Manual ChatGPT?

Why use a plugin when you can write product texts directly in ChatGPT and copy-paste them?

Feature	Manual (Copy-Paste)	MCP ECOM
Create product (complete)	5–10 min	30 sec
SEO Meta Tags	Manual	Automatic
Categories & Tags	Manual assignment	AI-powered
Bulk creation (50 products)	8–16 hours	15–30 min
CSV Import	Not possible	Automatic
Brand Voice consistency	Adjust every time	Configure once
Catalog Audit	Not possible	AI-powered (Pro Plus)

ROI example: For 100 products, MCP ECOM saves approximately 20–40 hours of manual work. At a rate of $50/hour, that's $1,000–$2,000 in savings.

Troubleshooting

URL shows "Domain Mapping Misconfiguration"

Cause: Shopware does not recognize the domain.
Solution: In the Shopware admin under Sales Channel → Domains, add your domain (both https:// and http:// if you use a proxy).

401 — "token_invalid_or_missing"

Cause: No or incorrect token in the URL.
Solution: Check that ?token=YOUR-TOKEN is at the end of the URL and matches the token in the plugin settings.

500 — "has no container set"

Cause: The services.xml is missing or misconfigured.
Solution: Make sure the setContainer call for the controller exists in services.xml. Then run: bin/console cache:clear

401 — "Missing Authorization header"

Cause: The route uses the api scope (requires OAuth).
Solution: The route must use the storefront scope with auth_required: false. This is already correctly configured in the current version.

ChatGPT shows "Tool call failed"

Cause: ChatGPT cannot reach the URL.
Solution:

Check that your shop is accessible via HTTPS
Test the URL in your browser — you should see JSON
Check if a firewall is blocking the request

"license_invalid" or "license_expired"

Cause: Invalid or expired license key.
Solution: Check your license key in the plugin settings. Renew your license at mcpecom.com if necessary.

"csv_limit_exceeded"

Cause: CSV file has more rows than allowed.
Solution: Starter: max. 25 rows, Pro/Pro Plus: max. 50 rows. Split large files into smaller parts.

How MCP ECOM Works (Shopware 6)

┌─────────────────────────────────────────────────────┐ │ SHOPWARE ADMIN (One-time setup) │ │ ════════════════════════════════════ │ │ │ │ ✦ Set MCP Token │ │ ✦ Activate plugin │ │ ✦ Configure domain │ │ ✦ Enter license key (Starter/Pro/Pro Plus) │ │ ✦ Configure Brand Voice (from Starter) │ │ ✦ Enter SerpAPI key (from Pro) │ │ │ └────────────────────┬────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ CHATGPT (Daily use) │ │ ════════════════════════ │ │ │ │ FREE: │ │ ✦ List and search products │ │ ✦ Create new products with AI │ │ ✦ Upload images via URL │ │ ✦ Bulk upload (up to 3 products) │ │ │ │ STARTER: │ │ ✦ + Optimize products │ │ ✦ + CSV import (up to 25 rows) │ │ ✦ + Brand Voice for consistent text │ │ ✦ + Bulk up to 10 products │ │ │ │ PRO: │ │ ✦ + Web research & competitor analysis │ │ ✦ + Keyword suggestions & quality check │ │ ✦ + Variations & attribute detection │ │ ✦ + 7 content languages │ │ ✦ + Bulk up to 30, CSV up to 50 │ │ │ │ PRO PLUS: │ │ ✦ + Attribute normalization │ │ ✦ + Structured product schemas │ │ ✦ + Catalog audit (full/quick/category) │ │ ✦ + AI Query Layer (natural language search) │ │ ✦ + Bulk up to 50 products │ │ │ └────────────────────┬────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ SHOPWARE SHOP (Result) │ │ ═════════════════════ │ │ │ │ ✦ Products created as inactive (draft) │ │ ✦ Review and activate in admin │ │ ✦ Immediately visible in storefront after │ │ activation │ │ │ └─────────────────────────────────────────────────────┘

Tips

Review products: All products are created as inactive. Review them in the Shopware admin and only activate them when everything looks good.

Create categories first: The plugin does not create new categories — it only assigns existing ones. Create your categories in the Shopware admin beforehand.

Name your images: Name image files after the product (leather-belt-brown.jpg) — the AI will automatically assign them.

Choose a secure token: Use a long, random token (e.g. mcp-x7k9m2-shop-2025). Anyone who knows the token can create products.

Clear cache: After plugin updates, always run bin/console cache:clear or clear the cache in the admin under Settings → System → Caches & Indexes.

Local testing: For local tests, use ngrok (ngrok http 80) to make your local shop accessible via HTTPS. Don't forget to add the ngrok domain as a Sales Channel domain.

Use Brand Voice (Starter+): Fill in the Brand Voice fields — the AI will then generate consistent text that matches your brand.

CSV Import (Starter+): Columns are automatically detected. Supported formats: comma, semicolon, tab as delimiters.

Catalog Audit (Pro Plus): Start with a quick audit — it instantly shows you the biggest quality issues in your shop.

MCP ECOM Shopware 6 — Complete Guide

What can MCP ECOM do?

Requirements

Installation

Upload Plugin

Install and Activate Plugin

Done!

Settings in Shopware Admin

All Versions (Free, Starter, Pro, Pro Plus)

From Starter

From Pro

Pro Plus Only

MCP Server URLs

Connect ChatGPT

Enable ChatGPT Developer Mode

Create App

Test

Free Version

Available Tools (3)

Key Facts

Endpoint

Starter Version

Available Tools (5)

Key Facts

New Features

Endpoint

Pro Version

Available Tools (12)

Key Facts

New Features

Endpoint

Pro Plus Version

Available Tools (16)

Key Facts

Exclusive Features: AI Catalog Intelligence

Endpoint

Prompt Collection

Free — Basics

List Products

Create a Single Product

Create Product with Images

Multiple Products at Once (Bulk — up to 3)

Starter — Optimization & Import

Pro — Research & Analysis

Pro Plus — Catalog Intelligence

Version Comparison (Shopware 6)

Shopware 6 vs. WooCommerce — Differences

Shopware 6

WooCommerce

Privacy & Security

Data Flow

Security Measures

GDPR Compliance

Why MCP ECOM Instead of Manual ChatGPT?

Troubleshooting

URL shows "Domain Mapping Misconfiguration"

401 — "token_invalid_or_missing"

500 — "has no container set"

401 — "Missing Authorization header"

ChatGPT shows "Tool call failed"

"license_invalid" or "license_expired"

"csv_limit_exceeded"

How MCP ECOM Works (Shopware 6)

Tips