Quickstart (All Versions)
1
Install Plugin
Activate the plugin file in WordPress under Plugins → Add New → Upload Plugin.
2
Open Settings
WordPress → Settings → MCP ECOM (depending on version: Free / Starter / Pro / Pro Plus)
3
Fill Required Fields
| Field | Where to find? | Example |
|---|---|---|
| Secret Token | Freely selectable | my-secret-token-2025 |
| Consumer Key | WooCommerce → Settings → Advanced → REST API | ck_abc123... |
| Consumer Secret | WooCommerce → Settings → Advanced → REST API | cs_xyz789... |
| License Key | You will receive this via email after purchase | MCPE-XXXX-XXXX |
4
Copy MCP URL
After saving, your MCP Server URL will appear at the top. Copy this.
5
Connect in ChatGPT
- Open chatgpt.com
- Go to Settings → Apps → Advanced Settings → Developer Mode and activate it
- Click on Create App
- Enter the following information:
- Name: e.g., MCP Ecom
- Description: optional
- URL: paste here
- Authentication: No Auth
- Confirm the note about the Custom MCP Server
- Save — done!
What do I set where?
In the Backend (WordPress Settings)
The backend is your control center. You set everything up once here — after that, ChatGPT works with it automatically.
| Setting | Version | What it does |
|---|---|---|
| Secret Token | All | Secures the connection between ChatGPT and your shop |
| Consumer Key/Secret | All | Gives the plugin access to WooCommerce |
| License Key | Starter+ | Unlocks your quota |
| SerpAPI Key (optional) | Pro+ | Advanced market and keyword data |
| Brand Voice | Pro+ | Your brand language — automatically used for every product |
| Target Audience | Pro+ | Who are you writing for? Influences tone and vocabulary |
| Tone & Style | Pro+ | Luxurious, technical, casual, professional, playful, or minimalist |
| USP | Pro+ | Your unique selling point — appears in every product text |
| Brand Values | Pro+ | Core values like sustainability, quality, etc. |
| Content Language | Pro+ | German (formal/informal), English, French, Spanish, Italian, Dutch |
| Auto-Schema | Pro Plus | Automatically creates an AI schema for every new product |
| Audit Schedule | Pro Plus | Automatic catalog check (weekly/monthly) |
Important: You only need to configure the Brand Voice settings once. After that, every AI-generated product will automatically follow your style — whether you create a single product or 30 at once.
In the Frontend (ChatGPT Chat)
The chat is your workspace. Here you create, optimize, and analyze products with simple messages.
| Action | Version | Where? |
|---|---|---|
| Create products | All | ChatGPT |
| Optimize products | All | ChatGPT |
| Upload images | All | Upload link (comes automatically from ChatGPT) |
| Bulk creation (up to 10) | Starter+ | ChatGPT |
| CSV/Excel import | Starter+ | Upload link + ChatGPT |
| Bulk creation (up to 30) | Pro+ | ChatGPT |
| Web research | Pro+ | ChatGPT |
| Competitor analysis | Pro+ | ChatGPT |
| Keyword suggestions | Pro+ | ChatGPT |
| Create variations | Pro+ | ChatGPT |
| Detect attributes | Pro+ | ChatGPT |
| Category mapping | Pro+ | ChatGPT |
| Quality check | Pro+ | ChatGPT |
| Bulk creation (up to 50) | Pro Plus | ChatGPT |
| Attribute normalization | Pro Plus | ChatGPT |
| Create product schema | Pro Plus | ChatGPT |
| Catalog audit | Pro Plus | ChatGPT |
| AI Product Query | Pro Plus | ChatGPT |
Prompt Collection by Version
Copy these prompts directly into ChatGPT.
Free — Entry
Create a single product
Create a product: "Vanilla Scented Candle" for 14.90€
Create a WooCommerce product: "Premium Yoga Mat" for 39.90€ without images
Create a product: "Mini Bluetooth Speaker" for 34.90€. Material: Aluminum. Target audience: Outdoor fans. Style: modern.
Tip: ChatGPT will automatically ask for images. You will get an upload link. Upload your images and name them after the product (e.g., vanilla-scented-candle.jpg) — the AI will automatically assign them.
Optimize product
Optimize the product with ID 142. Focus keyword: "buy handmade soap"
Improve the SEO texts of product #85
Starter — More products, faster
Everything in FREE plus:
Bulk upload (up to 10 products)
Create the following 5 products: 1. Espresso cup "Milano" — 12.90€ 2. Cappuccino cup "Roma" — 14.90€ 3. Latte glass "Firenze" — 16.90€ 4. Espresso set 4-pack — 44.90€ 5. Ceramic coffee saucer — 8.90€
Create 3 products for my jewelry shop: - Silver ring "Infinity" for 89€ - Gold chain "Heart" for 149€ - Bracelet "Pearl" for 59€ Category: Jewelry
CSV/Excel Import
I want to import products from a CSV file
Import batch abc123 with AI enrichment
Import batch abc123 in "create_new" mode
Import batch abc123 in "optimize_existing" mode — add SEO texts
Import batch abc123 in "update_existing" mode — update prices
Pro — Professional E-Commerce
Everything in STARTER plus:
Set in Backend first (once)
- Brand Voice: e.g., "We use warm, trustworthy language. No exaggerated advertising language."
- Target Audience: e.g., "Women 25–45, quality-conscious, interested in sustainability"
- Tone & Style: e.g., "Luxurious & Exclusive"
- USP: e.g., "Handmade in Germany, 100% sustainable materials"
- Brand Values: e.g., "Sustainability, craftsmanship, transparency"
- Content Language: e.g., "English"
From now on, every AI-generated product automatically follows your style.
Then work in Chat
Create these 15 products for my electronics shop: 1. USB-C cable 1m — 9.90€ 2. USB-C cable 2m — 12.90€ 3. Wireless Charger — 24.90€ 4. Powerbank 10,000mAh — 29.90€ 5. Powerbank 20,000mAh — 44.90€ ...
Research current market prices for handmade silver jewelry in Germany
What are the 2025 trends in sustainable fashion?
Analyze the competition for "handmade candles" — focus: price comparison
Who are the main competitors for luxury ballpoint pens?
Find SEO keywords for my jewelry shop
Keyword suggestions for "gold chains" — max. 20, purchase-oriented
Create a variable product: "Premium T-Shirt" for 29.90€ with size (S, M, L, XL) and color (Black, White, Navy)
Variable product "Urban Sneaker" for 79.90€. Size: 39-46. Color: White, Black, Gray. Sizes 45 and 46 cost 5€ more.
Extract the attributes from this text: "This ring is made of 925 sterling silver, weighs 8g, is available in sizes 52-62 and has a width of 4mm."
Detect attributes of product #142 and save them directly
What categories are there in my shop?
Check if "Smart Home Devices" exists as a category
Check the quality of product #142
Is product #200 ready for publication? Check everything.
Pro Plus — AI Catalog Intelligence
Everything in PRO plus:
Set in Backend first
- Auto-Schema: Activate → A structured AI schema is automatically created for every new product
- Audit Schedule: Weekly or monthly → You automatically receive a quality report
Then work in Chat
Scan all attributes in my shop for duplicates
Normalize all attribute names — find similar ones like "Akkulaufzeit" and "Battery Life"
Check only the color attributes for inconsistent spellings
Normalize the attribute values — apply directly
Create an AI schema for product #142
Analyze product #88 and create a schema — save directly
Create a schema only for material, weight, and compatibility of product #55
Analyze this text and create a product schema: "The ANC-500 is an over-ear headphone with active noise canceling, 30 hours battery life, Bluetooth 5.3, USB-C, weighs 250g, compatible with iPhone and Android. 2-year warranty. CE certified."
Do a quick check of my entire shop
Full catalog audit — check everything
Check only the "Jewelry" category for data quality
Find all products without images and without descriptions
Find all products under 50€ from the jewelry category
Which products have gold as a material?
Show all products between 100€ and 500€, sorted by price
Find all products that are in stock, category electronics, under 200€
Show the 10 most expensive products with all attributes
Compare all rings — price, material, and availability
Do a catalog audit, create schemas for all products without a schema and normalize the attributes
Find all products without attributes, detect them automatically from the descriptions and save them
Version Comparison at a Glance
| Feature | FREE | STARTER | PRO | PRO PLUS |
|---|---|---|---|---|
| Create product | ✅ | ✅ | ✅ | ✅ |
| Optimize product | ✅ | ✅ | ✅ | ✅ |
| Image upload | ✅ | ✅ | ✅ | ✅ |
| Bulk (up to 10) | — | ✅ | ✅ | ✅ |
| CSV/Excel import | — | ✅ | ✅ | ✅ |
| Bulk (up to 30) | — | — | ✅ | ✅ |
| Web research | — | — | ✅ | ✅ |
| Competitor analysis | — | — | ✅ | ✅ |
| Keyword suggestions | — | — | ✅ | ✅ |
| Variations | — | — | ✅ | ✅ |
| Attribute detection | — | — | ✅ | ✅ |
| Category mapping | — | — | ✅ | ✅ |
| Quality Check | — | — | ✅ | ✅ |
| Brand Voice Engine | — | — | ✅ | ✅ |
| Bulk (up to 50) | — | — | — | ✅ |
| Attribute normalization | — | — | — | ✅ |
| Structured product schema | — | — | — | ✅ |
| Catalog Audit | — | — | — | ✅ |
| AI Query Layer | — | — | — | ✅ |
| Auto-Schema | — | — | — | ✅ |
Backend vs. Frontend — Summary
┌─────────────────────────────────────────────────┐
│ BACKEND (WordPress Admin) │
│ ═════════════════════════ │
│ Set once — works automatically │
│ │
│ ✦ Connection (Token, Keys, License) │
│ ✦ Brand Voice & Brand Tone │
│ ✦ Target Audience & Tone │
│ ✦ Content Language │
│ ✦ SerpAPI Key (optional) │
│ ✦ Auto-Schema (Pro Plus) │
│ ✦ Audit Schedule (Pro Plus) │
└────────────────────┬────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────┐
│ FRONTEND (ChatGPT Chat) │
│ ═════════════════════════ │
│ Use daily — just type │
│ │
│ ✦ Create & optimize products │
│ ✦ Upload images │
│ ✦ Bulk uploads & CSV import │
│ ✦ Research & analysis │
│ ✦ Variations & attributes │
│ ✦ Quality Check │
│ ✦ Catalog Audit & Normalization (Pro Plus) │
│ ✦ AI Product Query (Pro Plus) │
└─────────────────────────────────────────────────┘
Tips
Name images: Name files after the product (
leather-belt-brown.jpg) — the AI will automatically assign them.Use CSV: For 5+ products, CSV import is faster than creating them individually.
Brand Voice first: Set up the Brand Voice before you create products. Subsequent changes only apply to new products.
Quality Check before publishing: Create product as draft → Quality Check → Optimize → Publish.
Pro Plus Workflow: Catalog Audit → Normalize attributes → Create schemas → Use AI Query.
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 WordPress Server → WooCommerce REST 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 — never customer data.
- 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.
- License key encryption: Your license key is stored AES-256-CBC encrypted in the WordPress database.
- Drafts only: AI-generated products are always created as drafts — never published directly.
- No admin rights needed: The plugin exclusively uses the WooCommerce REST API with limited permissions.
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. The WooCommerce REST API keys are only used for product endpoints — never for /orders, /customers, or other sensitive endpoints. Processing takes place on your own server and at OpenAI. For the use of ChatGPT, OpenAI's privacy policies apply.
For more details, see our Privacy Policy.
Why MCP ECOM Instead of Manual ChatGPT?
A fair question: Why use a plugin when you can write product texts directly in ChatGPT and copy-paste them?
| Feature | Manual (ChatGPT + Copy-Paste) | MCP ECOM |
|---|---|---|
| Create product (complete) | 5–10 min (copy-paste per field) | 30 sec (one prompt) |
| SEO Meta Tags | Manually in Yoast/RankMath | Automatic |
| FAQ Schema (JSON-LD) | Manually or not at all | Automatic |
| Categories & Tags | Manual assignment | AI-powered mapping |
| Bulk creation (50 products) | 8–16 hours | 15–30 min |
| CSV Import | Not possible | Automatic (from Starter) |
| Brand Voice consistency | Adjust prompt every time | Configure once, always consistent |
| Internal linking | Manual | Automatic (related products + categories) |
| Catalog Audit & Normalization | 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 — even with the lowest plan.
Troubleshooting
"Connector name already exists"
Symptom: When creating the app in ChatGPT, you get a message that the name is already taken.
Solution:
- Go to Settings → Apps in ChatGPT
- Look for the old app under "Enabled Apps" or "Drafts"
- Click on it → "Delete"
- Wait 1–2 minutes
- Create the app again using the unique app name from your plugin settings
Tip: If the name is still taken, simply append a number (e.g., "MyShop2").
Endless spinner / white box when connecting
Symptom: When clicking "Connect" or "Create", a white box appears with a loading spinner that keeps spinning endlessly.
Cause: ChatGPT account settings or old drafts are blocking the connection. This issue is on ChatGPT's side, not your shop or plugin.
Solution (step by step):
- Go to Settings → Privacy and disable "Improve the model for everyone" (temporarily)
- Go to Settings → Apps and delete all drafts
- Sign out completely from ChatGPT
- Clear browser cache and cookies for
chatgpt.com - Sign back in and create the app from scratch
- If it works: "Improve the model for everyone" can be re-enabled afterwards
Tip: Try a different browser (Chrome, Firefox, Edge). If the problem persists across all browsers, contact OpenAI Support.
ChatGPT shows fake/invented products
Symptom: You ask about products, but ChatGPT shows products that don't exist in your shop.
Cause: The connection is not properly established. ChatGPT "invents" products instead.
Solution:
- Check under Settings → Apps whether your app is listed under "Enabled Apps" (with DEV badge)
- If it's under "Drafts": Click on it → "Enable"
- Open a new chat (don't continue the old one!)
- Test with: "List my products"
Connection not working (general)
Quick test: Open your MCP URL directly in the browser (the URL from your plugin settings). You should see a JSON response.
If you see an error instead:
- "token_invalid_or_missing" → Check the Secret Token in your plugin settings
- White page / 500 error → WooCommerce REST API is disabled or permalink settings are set to "Plain" → Change to "Post name"
- 404 Not Found → Re-save permalinks: Settings → Permalinks → Save Changes (without changing anything)
Upload page shows error
Symptom: The image upload page doesn't load or shows an error.
Solution:
- Make sure the token is correct in the URL
- Check that the PHP GD library is enabled on your server (required for WebP conversion)
- Ensure the uploads folder is writable (permissions: 755)
- Maximum file size: Check
upload_max_filesizein your PHP configuration