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) |
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.
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.
Create the App
Click Create an App and choose a name (e.g. "MCP ECOM").
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 |
Install the App & Copy the Token
Click Install App, confirm and copy the Admin API Access Token.
config.json.
Installation on Your Web Server
| 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/ |
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/
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.
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!
.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 |
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
Enable ChatGPT Developer Mode
Go to chatgpt.com and then to:
Settings → Apps → Advanced Settings → Developer Mode
Enable Developer Mode.
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.
Test
Open a new chat in ChatGPT and type:
Show me my Shopify products
ChatGPT should now list your products. Done!
Free Version
FREEThe 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
3 Products
Not required
Endpoint
https://your-server.com/McpEcomShopify/?token=YOUR-TOKEN
Starter Version
STARTERThe 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
10 Products
25 Rows
New Features
Endpoint
https://your-server.com/McpEcomShopifyStarter/?token=YOUR-TOKEN
config.json as licenseKey.
Pro Version
PROThe 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
30 Products
50 Rows
New Features
Endpoint
https://your-server.com/McpEcomShopifyPro/?token=YOUR-TOKEN
Pro Plus Version
PRO PLUSThe 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
50 Products
4 Tools
Exclusive Features: AI Catalog Intelligence
Endpoint
https://your-server.com/McpEcomShopifyProPlus/?token=YOUR-TOKEN
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
FREEList 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
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
STARTEROptimize 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
PROResearch "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 PLUSNormalize 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/SSE → Your PHP Server → Shopify Admin REST API → Your 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 min | 30 sec |
| SEO Meta Tags | Manual | Automatic |
| Tags & Collections | 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) |
Troubleshooting
401 — "token_invalid_or_missing"
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"
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)
Solution:
- Check the
accessTokeninconfig.json - Make sure the Custom App has the correct permissions (Products, Inventory, Collections)
- Check the
shopUrl— it must be in the formathttps://your-store.myshopify.com
429 — Rate Limit
Solution: MCP ECOM automatically waits 1 second and retries. If problems persist: Reduce the
bulkLimit in the config.json.
ChatGPT shows "Tool call failed"
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"
Solution: Check the
licenseKey in the config.json. Renew your license at mcpecom.com if necessary.
CSV Import Error
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)
.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)
Tips
mcp-x7k9m2-shop-2025). Anyone who knows the token can create products.
.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.
config.json.
config.json — the AI will then generate consistent texts tailored to your brand.