MCP ECOM Shopify

MCP ECOM Shopify — Complete Guide

Connect your Shopify store with ChatGPT. Create, optimize, analyze and bulk-import products with AI — from Free to Pro Plus.

What can MCP ECOM do?

Create Generate products with AI and automatically publish them in your store
Optimize Improve existing products with AI and optimize SEO
Analyze Quality checks, competitor analysis and keyword research
Import CSV import, bulk upload and catalog audit

Requirements

Requirement Details
Shopify Shopify Basic, Shopify, Advanced or Plus Plan
Web Server External PHP 8.1+ server with cURL extension (e.g. Hetzner, DigitalOcean, IONOS, Strato or your own server)
ChatGPT ChatGPT Plus or Team subscription (Developer Mode required)
SSL HTTPS certificate on the web server (ChatGPT requires HTTPS)
Shopify Access Token Create a Custom App in the Shopify Admin (see instructions below)
License Key Required for Starter, Pro and Pro Plus versions (available at mcpecom.com)
Important: Since Shopify does not allow server-side plugins, MCP ECOM runs as a standalone PHP application on a separate web server. This application communicates with your store via the Shopify Admin REST API.

Create a Shopify Custom App

Before installing MCP ECOM, you need to create a Custom App in your Shopify Admin to obtain an Access Token.

1

Enable Custom App Development

In the Shopify Admin: Settings → Apps and Sales Channels → Develop Apps

If not yet enabled: Click Allow Custom App Development and confirm.

2

Create the App

Click Create an App and choose a name (e.g. "MCP ECOM").

3

Configure API Permissions

Under Configure Admin API scopes, set the following Admin API access permissions:

Scope Permission
Products Read and write
Product listings Read
Inventory Read and write
Collections Read and write
4

Install the App & Copy the Token

Click Install App, confirm and copy the Admin API Access Token.

Warning: The Access Token is only shown once! Copy it immediately and store it securely. You will need it for the config.json.

Installation on Your Web Server

Note: MCP ECOM Shopify is a standalone PHP application. You upload it to your web server — not to the Shopify Admin.
Version Folder Server URL
Free McpEcomShopify https://your-server.com/McpEcomShopify/
Starter McpEcomShopifyStarter https://your-server.com/McpEcomShopifyStarter/
Pro McpEcomShopifyPro https://your-server.com/McpEcomShopifyPro/
Pro Plus McpEcomShopifyProPlus https://your-server.com/McpEcomShopifyProPlus/
1

Upload Files

Upload the folder for your version via FTP/SFTP to your web server. The folder must be accessible over HTTPS.

Your Web Server/
  McpEcomShopify/          (or Starter/Pro/ProPlus)
    index.php
    config.json
    config.example.json
    .htaccess
    src/
      McpProxyController.php
      ProductService.php
      AiForwardService.php
      LicenseService.php       (from Starter)
      CsvImportService.php     (from Starter)
    tmp/
2

Create config.json

Copy config.example.json to config.json and enter your data:

{
  "shopUrl": "https://your-store.myshopify.com",
  "accessToken": "shpat_XXXXXXXXXXXXXXXXXXXXXX",
  "mcpToken": "your-secure-token",
  "aiEndpoint": "https://ai.mcpecom.com",
  "bulkLimit": 3,
  "apiVersion": "2024-01"
}

Replace the values with your actual data. The shopUrl is your Shopify store URL.

3

Test

Open the URL in your browser:

https://your-server.com/McpEcomShopify/?token=your-secure-token

You should see a JSON response with the MCP server information. Done!

Security: The .htaccess automatically protects config.json, the src/ and tmp/ folders from direct access. Make sure your web server uses Apache with mod_rewrite, or configure the rules for nginx accordingly.

Settings (config.json)

All settings are configured in the config.json file.

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

Setting Required? Description
shopUrl Yes Your Shopify store URL (e.g. https://my-store.myshopify.com)
accessToken Yes The Admin API Access Token from your Custom App
mcpToken Yes Secures the connection between ChatGPT and MCP ECOM. Freely choosable.
aiEndpoint No URL of the AI server. Default: https://ai.mcpecom.com
bulkLimit No Max. products per bulk upload. Free: 3, Starter: 10, Pro: 30, Pro Plus: 50
apiVersion No Shopify API version. Default: 2024-01

From Starter

Setting Description
licenseKey Your license key from mcpecom.com
brandVoice Brand description for consistent AI-generated texts
targetAudience Description of the target audience
brandTone Choice: professional, friendly, luxurious, youthful, technical, minimalist
brandUsp Unique selling proposition of your brand

From Pro

Setting Description
serpApiKey For web research and competitor analysis (serpapi.com)
brandValues Core values of your brand
contentLanguage de, en, fr, es, it, nl

Pro Plus Only

Setting Description
autoSchema Automatic product schema detection (true/false)
auditSchedule manual, weekly, monthly
Important: For Shopify, you need the Access Token from your Custom App and your store URL. Both are entered in the config.json. There is no plugin configuration in the Shopify Admin.

MCP Server URLs

Your MCP server URL depends on the installed version:

Version URL
Free https://your-server.com/McpEcomShopify/?token=YOUR-TOKEN
Starter https://your-server.com/McpEcomShopifyStarter/?token=YOUR-TOKEN
Pro https://your-server.com/McpEcomShopifyPro/?token=YOUR-TOKEN
Pro Plus https://your-server.com/McpEcomShopifyProPlus/?token=YOUR-TOKEN

Replace your-server.com with your server domain and YOUR-TOKEN with your chosen token from the config.json.

Connect ChatGPT

1

Enable ChatGPT Developer Mode

Go to chatgpt.com and then to:

Settings → Apps → Advanced Settings → Developer Mode

Enable Developer Mode.

2

Create the App

Click Create App and enter:

Field Value
Name MCP ECOM Shopify (or any name you prefer)
Description optional
URL Your MCP server URL (see table above)
Authentication No Auth

Confirm the Custom MCP Server notice.

3

Test

Open a new chat in ChatGPT and type:

Show me my Shopify products

ChatGPT should now list your products. Done!

Error message "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 the 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, 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-server.com/McpEcomShopify/?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 texts tailored to 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-server.com/McpEcomShopifyStarter/?token=YOUR-TOKEN
License required: You need a Starter license key from mcpecom.com. Enter it in the config.json as licenseKey.

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 collections.
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 6 languages — de, en, fr, es, it, nl.
Quality Check: Automatic quality review for your products — detects missing descriptions, poor SEO texts and more.
Product Variations: Automatically create variations of a product based on attributes such as color, size or material.

Endpoint

https://your-server.com/McpEcomShopifyPro/?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 collection mapping.
qualityCheck Quality check for products.
normalizeAttributes Attribute normalization — scans, previews and applies uniform attributes (scan/preview/apply).
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. "Farbe: rot", "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 the entire catalog.
catalogAudit: Runs a comprehensive catalog audit with 7 checks. Modes: full (entire catalog), quick (quick check), category (one collection). 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-server.com/McpEcomShopifyProPlus/?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 Draft — you can review them in the Shopify Admin and then activate them.

Free — Basics

FREE

List Products

Show me my Shopify products

Show me all active products

Show me products from the collection "Electronics"

Search for products with "candle" in the name

Show me the 20 newest products, sorted by creation date

Show me all drafts (draft products)

Create a Single Product

Create a Shopify 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 enthusiasts. Style: modern.
Collection: 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: if you write "without images".

Create a Product with Images

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

Create a product: "Urban White Sneaker" for $89.90.
Collection: 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
Collection: 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 collection "Electronics"

Create a structured schema for product "Urban White Sneaker"

Run a catalog audit for my entire store

Find all products under $20 with missing descriptions

Version Comparison (Shopify)

Feature FREE STARTER PRO PRO PLUS
Create products with AI
List products
Images via URL
SEO texts
Collections & 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
Collection mapping
Quality Check
Content language (6)
SerpAPI Integration
Attribute normalization
Structured schemas
Catalog audit
AI Query Layer
Auto-Schema

Shopify vs. Other Platforms — Differences

MCP ECOM works similarly across all platforms, but there are some Shopify-specific differences:

Shopify
  • Standalone PHP app on a separate server
  • Requires Access Token from Custom App
  • Configuration via config.json
  • Categories = Collections (assign existing ones)
  • Tags: Comma-separated string
  • Products are created as Draft
  • Price at variant level
  • Images directly via URL — very easy
  • SKU: MCP-XXXXXXXX
Shopware 6 / WooCommerce
  • Plugin installed directly in the shop
  • Shopware: MCP Token only / WooCommerce: API Key + Secret
  • Configuration in the shop admin
  • Categories: Shopware assigns / WooCommerce creates new ones
  • Tags: Shopware creates automatically
  • Products as inactive / draft
  • Price directly on the product
  • Images: Upload via Media Manager
  • Product number: 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/SSEYour PHP ServerShopify Admin REST APIYour Shopify Store

  • No external servers: MCP ECOM does not store any product data on third-party servers. The PHP app runs on your own hosting.
  • No access to orders or customer data: MCP ECOM exclusively accesses product data (title, description, price, tags, images). Orders, customer names, addresses, payment information, or other personal data are never read or processed.
  • Shopify Access Token: The access token should only have product permissions (write_products, read_products). Do not grant permissions for orders or customers.
  • AI processing: Text generation happens at OpenAI (ChatGPT) — according to their privacy policies.
  • License check: Once daily, only your license key + domain are verified — no product data, no customer data.

Security Measures

  • MCP Token: Every request is authenticated with your individual token in config.json.
  • HTTPS required: All communication runs encrypted over HTTPS.
  • .htaccess protection: Sensitive files (config.json, tmp/) are protected from external access via .htaccess.
  • Drafts only: AI-generated products are created as drafts (status: draft) — never published directly.

GDPR Compliance

MCP ECOM does not process any personal customer data, order data, or payment information. Only product data is processed. Recommendation: Create a Custom App in Shopify with product permissions only — this technically ensures no access to customer/order data is possible.

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 min30 sec
SEO Meta TagsManualAutomatic
Tags & CollectionsManual assignmentAI-powered
Bulk creation (50 products)8–16 hours15–30 min
CSV ImportNot possibleAutomatic
Brand Voice consistencyAdjust every timeConfigure once
Catalog AuditNot possibleAI-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

401 — "token_invalid_or_missing"

Cause: Missing or incorrect MCP token in the URL.
Solution: Check that ?token=YOUR-TOKEN is at the end of the URL and matches the mcpToken in your config.json.

500 — "config_missing" or "config_invalid"

Cause: The config.json is missing or incomplete.
Solution: Copy config.example.json to config.json and enter shopUrl, accessToken and mcpToken.

Shopify API Error (401/403)

Cause: Invalid Access Token or missing permissions.
Solution:
  • Check the accessToken in config.json
  • Make sure the Custom App has the correct permissions (Products, Inventory, Collections)
  • Check the shopUrl — it must be in the format https://your-store.myshopify.com

429 — Rate Limit

Cause: Too many API requests to Shopify.
Solution: MCP ECOM automatically waits 1 second and retries. If problems persist: Reduce the bulkLimit in the config.json.

ChatGPT shows "Tool call failed"

Cause: ChatGPT cannot reach the URL.
Solution:
  • Check if the server is accessible via HTTPS
  • Test the URL in the browser — you should see JSON
  • Check if a firewall is blocking the request
  • Make sure PHP 8.1+ with cURL extension is installed

"license_invalid" or "quota_reached"

Cause: Invalid license key or quota exhausted.
Solution: Check the licenseKey in the config.json. Renew your license at mcpecom.com if necessary.

CSV Import Error

Cause: CSV file has more rows than allowed or invalid format.
Solution: Starter: max. 25 rows, Pro/Pro Plus: max. 50 rows. Make sure the CSV has at least 2 rows (header + data). Supported delimiters: comma, semicolon, tab.

.htaccess not working (nginx)

Cause: nginx does not use .htaccess files.
Solution: Add the following rules to your nginx configuration:
location ~* (config\.json|/src/|/tmp/) {
    deny all;
    return 403;
}

How MCP ECOM Works (Shopify)

┌─────────────────────────────────────────────────────┐ │ WEB SERVER (One-time setup) │ │ ═══════════════════════════ │ │ │ │ ✦ Upload PHP files │ │ ✦ Fill config.json with Shopify data │ │ ✦ Enter Access Token from Custom App │ │ ✦ Choose your MCP Token │ │ ✦ 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 texts │ │ ✦ + Bulk up to 10 products │ │ │ │ PRO: │ │ ✦ + Web research & competitor analysis │ │ ✦ + Keyword suggestions & Quality Check │ │ ✦ + Variations & attribute detection │ │ ✦ + 6 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 │ │ │ └────────────────────┬────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ SHOPIFY STORE (Result) │ │ ═══════════════════════ │ │ │ │ ✦ Products created as Draft │ │ ✦ Review and activate in the Shopify Admin │ │ ✦ Visible in the Online Store immediately │ │ after activation │ │ │ └─────────────────────────────────────────────────────┘

Tips

Review products: All products are created as Draft. Review them in the Shopify Admin and set the status to "Active" when everything looks good.
Create collections first: MCP ECOM does not create new collections — it only assigns existing ones. Create your collections in the Shopify Admin beforehand.
Images via URL: Shopify downloads images directly from the provided URL — the images must be publicly accessible.
Choose a secure token: Use a long, random token (e.g. mcp-x7k9m2-shop-2025). Anyone who knows the token can create products.
Protect config.json: The .htaccess blocks direct access to config.json. Verify this by opening https://your-server.com/McpEcomShopify/config.json in the browser — you should see a 403 error.
Renew Access Token: If the Access Token is compromised, delete the Custom App in the Shopify Admin and create a new one. Enter the new token in the config.json.
Use Brand Voice (Starter+): Fill in the Brand Voice fields in the config.json — the AI will then generate consistent texts tailored to your brand.
CSV Import (Starter+): Columns are automatically detected. Supported formats: comma, semicolon, tab as delimiters. Column headers like "Title", "Price", "Category" are automatically mapped.
Catalog Audit (Pro Plus): Start with a quick audit — it will immediately show you the biggest quality issues in your store.