MCP ECOM Shopify — Komplette Anleitung (Alle Versionen)

Voraussetzungen

Anforderung	Details
Shopify	Shopify Basic, Shopify, Advanced oder Plus Plan
Webserver	Externer PHP 8.1+ Server mit cURL-Extension (z.B. Hetzner, DigitalOcean, IONOS, Strato oder eigener Server)
ChatGPT	ChatGPT Plus- oder Team-Abo (Entwicklermodus erforderlich)
SSL	HTTPS-Zertifikat auf dem Webserver (ChatGPT erfordert HTTPS)
Shopify Access Token	Custom App im Shopify-Admin erstellen (siehe Anleitung unten)
Lizenzschlüssel	Für Starter, Pro und Pro Plus Versionen (bei mcpecom.com erhältlich)

Wichtig: Da Shopify keine serverseitigen Plugins erlaubt, wird MCP ECOM als eigenständige PHP-Anwendung auf einem separaten Webserver betrieben. Diese Anwendung kommuniziert über die Shopify Admin REST API mit deinem Shop.

Shopify Custom App erstellen

Bevor du MCP ECOM installierst, musst du eine Custom App in deinem Shopify-Admin erstellen, um einen Access Token zu erhalten.

1

Custom App Development aktivieren

Im Shopify-Admin: Einstellungen → Apps und Vertriebskanäle → Apps entwickeln

Falls noch nicht aktiviert: Klicke auf Custom App Development erlauben und bestätige.

2

App erstellen

Klicke auf App erstellen und vergib einen Namen (z.B. "MCP ECOM").

3

API-Berechtigungen konfigurieren

Unter API-Berechtigungen konfigurieren folgende Admin API-Zugriffsrechte setzen:

Bereich	Berechtigung
Products	Read and write
Product listings	Read
Inventory	Read and write
Collections	Read and write

4

App installieren & Token kopieren

Klicke auf App installieren, bestätige und kopiere den Admin API Access Token.

Achtung: Der Access Token wird nur einmal angezeigt! Kopiere ihn sofort und speichere ihn sicher. Du wirst ihn für die config.json brauchen.

Installation auf deinem Webserver

Hinweis: MCP ECOM Shopify ist eine eigenständige PHP-Anwendung. Du lädst sie auf deinen Webserver hoch — nicht in den Shopify-Admin.

Version	Ordner	Server-URL
Free	`McpEcomShopify`	`https://dein-server.de/McpEcomShopify/`
Starter	`McpEcomShopifyStarter`	`https://dein-server.de/McpEcomShopifyStarter/`
Pro	`McpEcomShopifyPro`	`https://dein-server.de/McpEcomShopifyPro/`
Pro Plus	`McpEcomShopifyProPlus`	`https://dein-server.de/McpEcomShopifyProPlus/`

1

Dateien hochladen

Lade den Ordner deiner Version per FTP/SFTP auf deinen Webserver hoch. Der Ordner sollte über HTTPS erreichbar sein.

Dein Webserver/
  McpEcomShopify/          (oder Starter/Pro/ProPlus)
    index.php
    config.json
    config.example.json
    .htaccess
    src/
      McpProxyController.php
      ProductService.php
      AiForwardService.php
      LicenseService.php       (ab Starter)
      CsvImportService.php     (ab Starter)
    tmp/

2

config.json erstellen

Kopiere config.example.json zu config.json und trage deine Daten ein:

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

Ersetze die Werte mit deinen echten Daten. Die shopUrl ist deine Shopify-Store-URL.

3

Testen

Öffne die URL in deinem Browser:

https://dein-server.de/McpEcomShopify/?token=dein-sicherer-token

Du solltest eine JSON-Antwort mit der MCP-Server-Information sehen. Fertig!

Sicherheit: Die .htaccess schützt automatisch die config.json, den src/ und tmp/ Ordner vor direktem Zugriff. Stelle sicher, dass dein Webserver Apache mit mod_rewrite nutzt oder konfiguriere die Regeln für nginx entsprechend.

Einstellungen (config.json)

Alle Einstellungen werden in der config.json Datei vorgenommen.

Alle Versionen (Free, Starter, Pro, Pro Plus)

Einstellung	Pflicht?	Beschreibung
shopUrl	Ja	Deine Shopify-Store-URL (z.B. `https://mein-shop.myshopify.com`)
accessToken	Ja	Der Admin API Access Token aus deiner Custom App
mcpToken	Ja	Sichert die Verbindung zwischen ChatGPT und MCP ECOM. Frei wählbar.
aiEndpoint	Nein	URL des KI-Servers. Standard: `https://ai.mcpecom.com`
bulkLimit	Nein	Max. Produkte pro Bulk-Upload. Free: 3, Starter: 10, Pro: 30, Pro Plus: 50
apiVersion	Nein	Shopify API Version. Standard: `2024-01`

Ab Starter

Einstellung	Beschreibung
licenseKey	Dein Lizenzschlüssel von mcpecom.com
brandVoice	Markenbeschreibung für konsistente KI-Texte
targetAudience	Beschreibung der Zielgruppe
brandTone	Wahl: professionell, freundlich, luxuriös, jugendlich, technisch, minimalistisch
brandUsp	Alleinstellungsmerkmal deiner Marke

Ab Pro

Einstellung	Beschreibung
serpApiKey	Für Web-Recherche und Konkurrenzanalyse (serpapi.com)
brandValues	Kernwerte deiner Marke
contentLanguage	de, en, fr, es, it, nl

Nur Pro Plus

Einstellung	Beschreibung
autoSchema	Automatische Produktschema-Erkennung (true/false)
auditSchedule	manuell, wöchentlich, monatlich

Wichtig: Bei Shopify brauchst du den Access Token aus deiner Custom App und deine Store-URL. Beides trägst du in der config.json ein. Es gibt keine Plugin-Konfiguration im Shopify-Admin.

MCP-Server-URLs

Deine MCP-Server-URL hängt von der installierten Version ab:

Version	URL
Free	`https://dein-server.de/McpEcomShopify/?token=DEIN-TOKEN`
Starter	`https://dein-server.de/McpEcomShopifyStarter/?token=DEIN-TOKEN`
Pro	`https://dein-server.de/McpEcomShopifyPro/?token=DEIN-TOKEN`
Pro Plus	`https://dein-server.de/McpEcomShopifyProPlus/?token=DEIN-TOKEN`

Ersetze dein-server.de mit deiner Server-Domain und DEIN-TOKEN mit deinem gewählten Token aus der config.json.

ChatGPT verbinden

1

ChatGPT Entwicklermodus aktivieren

Gehe auf chatgpt.com und dann zu:

Einstellungen → Apps → Erweiterte Einstellungen → Entwicklermodus

Aktiviere den Entwicklermodus.

2

App erstellen

Klicke auf App erstellen und trage ein:

Feld	Wert
Name	MCP ECOM Shopify (oder frei wählbar)
Beschreibung	optional
URL	Deine MCP-Server-URL (siehe Tabelle oben)
Authentication	No Auth

Hinweis zum Custom MCP-Server bestätigen.

3

Testen

Öffne einen neuen Chat in ChatGPT und schreibe:

Zeige mir meine Shopify-Produkte

ChatGPT sollte jetzt deine Produkte auflisten. Fertig!

Fehlermeldung "Konnektorname ist bereits vorhanden"? Du hast bereits eine App mit diesem Namen. Gehe zu Einstellungen → Apps, lösche die alte App und erstelle eine neue mit einem anderen Namen.

Free Version

FREE

Die kostenlose Einstiegsversion. Erstelle Produkte per KI, lade Bilder hoch und nutze den Bulk-Upload für bis zu 3 Produkte gleichzeitig. Keine Lizenz erforderlich.

Verfügbare Tools (3)

Tool	Beschreibung
generateFullProduct	Erstellt ein vollständiges Produkt per KI — inklusive Titel, Beschreibung, SEO-Texte, Tags und Bilder.
bulkGenerateProducts	Erstellt mehrere Produkte auf einmal (Bulk-Upload). Limit: 3 Produkte.
listProducts	Listet alle Produkte auf, mit Filter- und Sortiermöglichkeiten.

Eckdaten

Bulk-Limit

3 Produkte

Lizenz

Nicht erforderlich

Endpoint

https://dein-server.de/McpEcomShopify/?token=DEIN-TOKEN

Starter Version

STARTER

Die Starter-Version erweitert Free um Produkt-Optimierung, CSV-Import und die Brand Voice Engine. Optimiere bestehende Produkte und importiere ganze Produktlisten per CSV.

Verfügbare Tools (5)

Tool	Beschreibung
generateFullProduct	Erstellt ein vollständiges Produkt per KI — jetzt mit Brand Voice.
optimizeProduct	Optimiert ein bestehendes Produkt — verbessert Beschreibung, SEO-Texte und Struktur basierend auf deiner Brand Voice und Zielgruppe.
bulkGenerateProducts	Erstellt bis zu 10 Produkte auf einmal.
csvProductImport	Importiert Produkte aus einer CSV-Datei. Spalten werden automatisch erkannt. Max. 25 Zeilen.
listProducts	Listet alle Produkte auf, mit Filter- und Sortiermöglichkeiten.

Eckdaten

Bulk-Limit

10 Produkte

CSV-Import

25 Zeilen

Neue Features

Brand Voice Engine: Definiere Markenstimme, Zielgruppe, Markenton und USP — die KI generiert dann konsistente Texte passend zu deiner Marke.

Produkt-Optimierung: Bestehende Produkte per KI verbessern — Beschreibung aufpolieren, SEO optimieren und Struktur anpassen.

CSV-Import: Lade Produkte per CSV-Datei hoch. Die Spalten werden automatisch erkannt. Unterstützte Trennzeichen: Komma, Semikolon, Tab.

Endpoint

https://dein-server.de/McpEcomShopifyStarter/?token=DEIN-TOKEN

Lizenz erforderlich: Du benötigst einen Starter-Lizenzschlüssel von mcpecom.com. Trage ihn in der config.json als licenseKey ein.

Pro Version

PRO

Die Pro-Version bringt Web-Recherche, Konkurrenzanalyse und erweiterte Produkttools. Nutze SerpAPI für datengestützte Produkterstellung und optimiere dein gesamtes Sortiment.

Verfügbare Tools (12)

Tool	Beschreibung
generateFullProduct	Erstellt ein vollständiges Produkt — mit Brand Voice und Content-Sprache.
optimizeProduct	Optimiert bestehende Produkte mit erweiterten KI-Funktionen.
bulkGenerateProducts	Erstellt bis zu 30 Produkte auf einmal.
csvProductImport	CSV-Import mit bis zu 50 Zeilen.
listProducts	Listet und filtert alle Produkte.
webResearch	Recherchiert per SerpAPI im Web — findet Trends, Preise und Marktdaten.
competitorAnalysis	Analysiert Konkurrenzprodukte und liefert Verbesserungsvorschläge.
keywordSuggestions	Schlägt relevante Keywords für SEO und Produkttexte vor.
generateVariations	Erstellt Variationen eines bestehenden Produkts (Farbe, Größe, Material).
detectAttributes	Erkennt automatisch Produktattribute aus der Beschreibung.
categoryMapping	Ordnet Produkte automatisch den passenden Collections zu.
qualityCheck	Prüft Produktqualität — Vollständigkeit, SEO, Beschreibung und Bilder.

Eckdaten

Bulk-Limit

30 Produkte

CSV-Import

50 Zeilen

Neue Features

SerpAPI Integration: Recherchiere im Web, analysiere Konkurrenz und finde Keywords — alles datengestützt über SerpAPI.

Content-Sprache: Erstelle Produkte in 6 Sprachen — de, en, fr, es, it, nl.

Quality Check: Automatische Qualitätsprüfung für deine Produkte — erkennt fehlende Beschreibungen, schlechte SEO-Texte und mehr.

Produkt-Variationen: Erstelle automatisch Variationen eines Produkts basierend auf Attributen wie Farbe, Größe oder Material.

Endpoint

https://dein-server.de/McpEcomShopifyPro/?token=DEIN-TOKEN

Lizenz erforderlich: Du benötigst einen Pro-Lizenzschlüssel von mcpecom.com. Zusätzlich brauchst du einen SerpAPI Key für die Web-Recherche-Features.

Pro Plus Version

PRO PLUS

Die umfassendste Version mit AI Catalog Intelligence. Normalisiere Attribute, erstelle strukturierte Schemas, führe Katalog-Audits durch und suche Produkte per natürlicher Sprache.

Verfügbare Tools (16)

Tool	Beschreibung
generateFullProduct	Erstellt Produkte mit allen Features — Brand Voice, Content-Sprache und Auto-Schema.
optimizeProduct	Optimiert bestehende Produkte mit erweiterten KI-Funktionen.
bulkGenerateProducts	Erstellt bis zu 50 Produkte auf einmal.
csvProductImport	CSV-Import mit bis zu 50 Zeilen.
listProducts	Listet und filtert alle Produkte.
webResearch	Web-Recherche per SerpAPI.
competitorAnalysis	Konkurrenzanalyse mit Verbesserungsvorschlägen.
keywordSuggestions	Keyword-Vorschläge für SEO.
generateVariations	Produkt-Variationen erstellen.
detectAttributes	Automatische Attribut-Erkennung.
categoryMapping	Automatisches Collection-Mapping.
qualityCheck	Qualitätsprüfung für Produkte.
normalizeAttributes	Attribut-Normalisierung — scannt, zeigt Vorschau und wendet einheitliche Attribute an (scan/preview/apply).
structureProductSchema	Erstellt strukturierte Produktschemas als JSON oder Tabelle — ideal für konsistente Produktdaten.
catalogAudit	Katalog-Audit mit 7 Prüfungen (voll/schnell/kategorie). Erkennt Qualitätsprobleme und bietet Auto-Fix.
aiQueryProducts	Natürlichsprachliche Produktsuche — finde Produkte per Frage statt per Filter.

Eckdaten

Bulk-Limit

50 Produkte

Exklusive Tools

4 Tools

Exklusive Features: AI Catalog Intelligence

normalizeAttributes: Scannt alle Produktattribute und normalisiert sie — z.B. "Farbe: rot", "color: Red", "Colour: red" werden zu einem einheitlichen Format. Modi: scan (analysieren), preview (Vorschau der Änderungen), apply (anwenden).

structureProductSchema: Erstellt strukturierte Produktschemas als JSON oder Tabelle. Ideal für konsistente Produktdaten über den gesamten Katalog.

catalogAudit: Führt einen umfassenden Katalog-Audit durch mit 7 Prüfungen. Modi: voll (gesamter Katalog), schnell (Quick-Check), kategorie (eine Collection). Bietet Auto-Fix für erkannte Probleme.

aiQueryProducts: Suche Produkte per natürlicher Sprache — z.B. "Finde alle roten Schuhe unter 50 Euro" statt komplexer Filter.

Endpoint

https://dein-server.de/McpEcomShopifyProPlus/?token=DEIN-TOKEN

Lizenz erforderlich: Du benötigst einen Pro Plus-Lizenzschlüssel von mcpecom.com.

Prompt-Sammlung

Kopiere diese Prompts direkt in ChatGPT. Alle Produkte werden als Entwurf (Draft) erstellt — du kannst sie im Shopify-Admin prüfen und dann aktivieren.

Free — Grundlagen

FREE

Produkte auflisten

Zeige mir meine Shopify-Produkte

Zeige mir alle aktiven Produkte

Zeige mir Produkte aus der Collection "Elektronik"

Suche nach Produkten mit "Kerze" im Namen

Zeige mir die 20 neuesten Produkte, sortiert nach Erstelldatum

Zeige mir alle Entwürfe (Draft-Produkte)

Einzelnes Produkt erstellen

Erstelle ein Shopify-Produkt: "Duftkerze Vanille" für 14,90€

Erstelle ein Produkt: "Yoga-Matte Premium" zum Preis von 39,90€ ohne Bilder

Erstelle ein Produkt: "Bluetooth Lautsprecher Mini" für 34,90€.
Material: Aluminium. Zielgruppe: Outdoor-Fans. Stil: modern.
Collection: Elektronik

Erstelle ein Produkt: "Bio Olivenöl Extra Vergine" für 18,50€.
Keywords: olivenöl kaufen, bio olivenöl, natives olivenöl extra

Bilder-Logik: ChatGPT fragt automatisch nach Bildern. Du kannst Bild-URLs angeben — das erste Bild wird zum Hauptbild (Cover), der Rest zur Galerie. Einzige Ausnahme: Wenn du "ohne Bilder" schreibst.

Produkt mit Bildern erstellen

Erstelle ein Produkt: "Ledergürtel Braun" für 49,90€.
Bilder:
- https://example.com/images/lederguertel-braun-1.jpg
- https://example.com/images/lederguertel-braun-2.jpg

Erstelle ein Produkt: "Sneaker Urban White" für 89,90€.
Collection: Schuhe. Material: Leder.
Bilder: https://example.com/sneaker-white-front.jpg, https://example.com/sneaker-white-side.jpg

Mehrere Produkte auf einmal (Bulk — bis 3)

Erstelle folgende 3 Produkte:
1. Espressotasse "Milano" — 12,90€
2. Cappuccino-Tasse "Roma" — 14,90€
3. Latte-Glas "Firenze" — 16,90€
Collection: Küche & Haushalt

Starter — Optimierung & Import

STARTER

Optimiere das Produkt "Duftkerze Vanille" — verbessere Beschreibung und SEO

Importiere Produkte aus meiner CSV-Datei

Erstelle 10 Produkte zum Thema "Bürozubehör"

Pro — Recherche & Analyse

PRO

Recherchiere "nachhaltige Trinkflaschen" und erstelle ein Produkt basierend auf den Ergebnissen

Analysiere die Konkurrenz für "Yoga-Matte Premium"

Schlage Keywords vor für "Bio Olivenöl"

Prüfe die Qualität von Produkt "Ledergürtel Braun"

Erkenne Attribute für Produkt "Bluetooth Lautsprecher"

Erstelle 5 Variationen für "Duftkerze Vanille"

Pro Plus — Katalog Intelligence

PRO PLUS

Normalisiere die Attribute aller Produkte in der Collection "Elektronik"

Erstelle ein strukturiertes Schema für Produkt "Sneaker Urban White"

Führe einen Katalog-Audit für meinen gesamten Shop durch

Finde alle Produkte unter 20€ mit fehlender Beschreibung

Versionen im Vergleich (Shopify)

Funktion	FREE	STARTER	PRO	PRO PLUS
Produkte per KI erstellen	✅	✅	✅	✅
Produkte auflisten	✅	✅	✅	✅
Bilder per URL	✅	✅	✅	✅
SEO-Texte	✅	✅	✅	✅
Collections & Tags	✅	✅	✅	✅
Bulk-Upload	3	10	30	50
Lizenz erforderlich	—	✅	✅	✅
Brand Voice Engine	—	✅	✅	✅
Produkt-Optimierung	—	✅	✅	✅
CSV-Import	—	25	50	50
Web-Recherche	—	—	✅	✅
Konkurrenzanalyse	—	—	✅	✅
Keyword-Vorschläge	—	—	✅	✅
Produkt-Variationen	—	—	✅	✅
Attribut-Erkennung	—	—	✅	✅
Collection-Mapping	—	—	✅	✅
Quality Check	—	—	✅	✅
Content-Sprache (6)	—	—	✅	✅
SerpAPI Integration	—	—	✅	✅
Attribut-Normalisierung	—	—	—	✅
Strukturierte Schemas	—	—	—	✅
Katalog-Audit	—	—	—	✅
AI Query Layer	—	—	—	✅
Auto-Schema	—	—	—	✅

Shopify vs. andere Plattformen — Unterschiede

MCP ECOM funktioniert auf allen Plattformen ähnlich, aber es gibt einige Shopify-spezifische Besonderheiten:

Shopify

Standalone PHP-App auf separatem Server
Braucht Access Token aus Custom App
Konfiguration via config.json
Kategorien = Collections (bestehende zuordnen)
Tags: Komma-separierter String
Produkte werden als Draft erstellt
Preis auf Variant-Level
Bilder direkt per URL — sehr einfach
SKU: MCP-XXXXXXXX

Shopware 6 / WooCommerce

Plugin direkt im Shop installiert
Shopware: nur MCP Token / WooCommerce: API Key + Secret
Konfiguration im Shop-Admin
Kategorien: Shopware ordnet zu / WooCommerce erstellt neue
Tags: Shopware erstellt automatisch
Produkte als inaktiv / Entwurf
Preis direkt am Produkt
Bilder: Upload via Media-Manager
Produktnummer: MCP-XXXXXXXX

Datenschutz & Sicherheit

MCP ECOM wurde mit Datenschutz als Kernprinzip entwickelt. Hier erfahren Sie genau, was mit Ihren Daten passiert:

Datenfluss

Sie (ChatGPT) → HTTPS/SSE → Ihr PHP-Server → Shopify Admin REST API → Ihr Shopify-Shop

Keine externen Server: MCP ECOM speichert keine Produktdaten auf fremden Servern. Die PHP-App läuft auf Ihrem eigenen Webspace.
Kein Zugriff auf Bestell- oder Kundendaten: MCP ECOM greift ausschließlich auf Produktdaten zu (Titel, Beschreibung, Preis, Tags, Bilder). Bestellungen, Kundennamen, Adressen, Zahlungsinformationen oder andere personenbezogene Daten werden weder gelesen noch verarbeitet.
Shopify Access Token: Der Access Token sollte nur Produkt-Berechtigungen haben (write_products, read_products). Erteilen Sie keine Berechtigungen für Orders oder Customers.
KI-Verarbeitung: Die Texterstellung findet bei OpenAI (ChatGPT) statt — gemäß deren Datenschutzrichtlinien.
Lizenzprüfung: Einmal täglich wird nur Ihr Lizenzschlüssel + Domain geprüft — keine Produktdaten, keine Kundendaten.

Sicherheitsmaßnahmen

MCP Token: Jede Anfrage wird durch Ihr individuelles Token in der config.json authentifiziert.
HTTPS-Pflicht: Die gesamte Kommunikation läuft verschlüsselt über HTTPS.
.htaccess-Schutz: Sensible Dateien (config.json, tmp/) sind per .htaccess vor externem Zugriff geschützt.
Nur Entwürfe: KI-generierte Produkte werden als Draft (status: draft) angelegt — niemals direkt veröffentlicht.

DSGVO-Konformität

MCP ECOM verarbeitet keine personenbezogenen Kundendaten, keine Bestelldaten und keine Zahlungsinformationen. Es werden ausschließlich Produktdaten verarbeitet. Empfehlung: Erstellen Sie in Shopify eine Custom App mit nur Produkt-Berechtigungen — so ist technisch sichergestellt, dass kein Zugriff auf Kunden-/Bestelldaten möglich ist.

Weitere Details in unserer Datenschutzerklärung.

Warum MCP ECOM statt manuell mit ChatGPT?

Warum ein Plugin, wenn man Produkttexte auch direkt in ChatGPT schreiben und per Copy-Paste übertragen kann?

Funktion	Manuell (Copy-Paste)	MCP ECOM
Produkt erstellen (komplett)	5–10 Min	30 Sek
SEO Meta-Tags	Manuell	Automatisch
Tags & Collections	Manuell zuweisen	KI-gestützt
Bulk-Erstellung (50 Produkte)	8–16 Stunden	15–30 Min
CSV-Import	Nicht möglich	Automatisch
Brand Voice Konsistenz	Jedes Mal anpassen	Einmal konfigurieren
Katalog-Audit	Nicht möglich	KI-gestützt (Pro Plus)

Rechenbeispiel: Bei 100 Produkten sparen Sie mit MCP ECOM ca. 20–40 Stunden manuelle Arbeit. Bei einem Stundensatz von 50 € entspricht das 1.000–2.000 € Ersparnis.

Fehlerbehebung

401 — "token_invalid_or_missing"

Ursache: Kein oder falscher MCP-Token in der URL.
Lösung: Prüfe, ob ?token=DEIN-TOKEN am Ende der URL steht und mit dem mcpToken in deiner config.json übereinstimmt.

500 — "config_missing" oder "config_invalid"

Ursache: Die config.json fehlt oder ist unvollständig.
Lösung: Kopiere config.example.json zu config.json und trage shopUrl, accessToken und mcpToken ein.

Shopify API Fehler (401/403)

Ursache: Ungültiger Access Token oder fehlende Berechtigungen.
Lösung:

Prüfe den accessToken in config.json
Stelle sicher, dass die Custom App die richtigen Berechtigungen hat (Products, Inventory, Collections)
Prüfe die shopUrl — sie muss das Format https://dein-shop.myshopify.com haben

429 — Rate Limit

Ursache: Zu viele API-Anfragen an Shopify.
Lösung: MCP ECOM wartet automatisch 1 Sekunde und versucht es erneut. Bei anhaltenden Problemen: Reduziere das bulkLimit in der config.json.

ChatGPT zeigt "Tool aufrufen fehlgeschlagen"

Ursache: ChatGPT kann die URL nicht erreichen.
Lösung:

Prüfe ob der Server per HTTPS erreichbar ist
Teste die URL im Browser — du solltest JSON sehen
Prüfe ob eine Firewall die Anfrage blockiert
Stelle sicher, dass PHP 8.1+ mit cURL-Extension installiert ist

"license_invalid" oder "quota_reached"

Ursache: Ungültiger Lizenzschlüssel oder Kontingent aufgebraucht.
Lösung: Prüfe den licenseKey in der config.json. Erneuere ggf. deine Lizenz auf mcpecom.com.

CSV-Import Fehler

Ursache: CSV-Datei hat mehr Zeilen als erlaubt oder ungültiges Format.
Lösung: Starter: max. 25 Zeilen, Pro/Pro Plus: max. 50 Zeilen. Stelle sicher, dass die CSV mindestens 2 Zeilen hat (Header + Daten). Unterstützte Trennzeichen: Komma, Semikolon, Tab.

.htaccess funktioniert nicht (nginx)

Ursache: nginx nutzt keine .htaccess Dateien.
Lösung: Füge folgende Regeln in deine nginx-Konfiguration ein:

location ~* (config\.json|/src/|/tmp/) {
    deny all;
    return 403;
}

So funktioniert MCP ECOM (Shopify)

┌─────────────────────────────────────────────────────┐ │ WEBSERVER (Einmalig einrichten) │ │ ═══════════════════════════════ │ │ │ │ ✦ PHP-Dateien hochladen │ │ ✦ config.json mit Shopify-Daten befüllen │ │ ✦ Access Token aus Custom App eintragen │ │ ✦ MCP Token frei wählen │ │ ✦ Lizenzschlüssel eintragen (Starter/Pro/Pro Plus) │ │ ✦ Brand Voice konfigurieren (ab Starter) │ │ ✦ SerpAPI Key eintragen (ab Pro) │ │ │ └────────────────────┬────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ CHATGPT (Täglich nutzen) │ │ ════════════════════════ │ │ │ │ FREE: │ │ ✦ Produkte auflisten und durchsuchen │ │ ✦ Neue Produkte per KI erstellen │ │ ✦ Bilder per URL hochladen │ │ ✦ Bulk-Upload (bis zu 3 Produkte) │ │ │ │ STARTER: │ │ ✦ + Produkte optimieren │ │ ✦ + CSV-Import (bis 25 Zeilen) │ │ ✦ + Brand Voice für konsistente Texte │ │ ✦ + Bulk bis 10 Produkte │ │ │ │ PRO: │ │ ✦ + Web-Recherche & Konkurrenzanalyse │ │ ✦ + Keyword-Vorschläge & Quality Check │ │ ✦ + Variationen & Attribut-Erkennung │ │ ✦ + 6 Content-Sprachen │ │ ✦ + Bulk bis 30, CSV bis 50 │ │ │ │ PRO PLUS: │ │ ✦ + Attribut-Normalisierung │ │ ✦ + Strukturierte Produktschemas │ │ ✦ + Katalog-Audit (voll/schnell/kategorie) │ │ ✦ + AI Query Layer (natürliche Suche) │ │ ✦ + Bulk bis 50 Produkte │ │ │ └────────────────────┬────────────────────────────────┘ │ ▼ ┌─────────────────────────────────────────────────────┐ │ SHOPIFY SHOP (Ergebnis) │ │ ═══════════════════════ │ │ │ │ ✦ Produkte als Draft (Entwurf) angelegt │ │ ✦ Im Shopify-Admin prüfen und aktivieren │ │ ✦ Sofort im Online Store sichtbar nach │ │ Aktivierung │ │ │ └─────────────────────────────────────────────────────┘

Tipps

Produkte prüfen: Alle Produkte werden als Draft erstellt. Prüfe sie im Shopify-Admin und setze den Status auf "Active", wenn alles passt.

Collections vorher anlegen: MCP ECOM erstellt keine neuen Collections — es ordnet nur bestehende zu. Lege deine Collections vorher im Shopify-Admin an.

Bilder per URL: Shopify lädt Bilder direkt von der angegebenen URL herunter — die Bilder müssen öffentlich erreichbar sein.

Token sicher wählen: Nutze einen langen, zufälligen Token (z.B. mcp-x7k9m2-shop-2025). Jeder, der den Token kennt, kann Produkte erstellen.

config.json schützen: Die .htaccess blockiert den direkten Zugriff auf config.json. Prüfe das, indem du https://dein-server.de/McpEcomShopify/config.json im Browser aufrufst — du solltest einen 403 Fehler sehen.

Access Token erneuern: Falls der Access Token kompromittiert wird, lösche die Custom App im Shopify-Admin und erstelle eine neue. Trage den neuen Token in die config.json ein.

Brand Voice nutzen (Starter+): Fülle die Brand Voice Felder in der config.json aus — die KI generiert dann konsistente Texte passend zu deiner Marke.

CSV-Import (Starter+): Die Spalten werden automatisch erkannt. Unterstützte Formate: Komma, Semikolon, Tab als Trennzeichen. Spaltenköpfe wie "Titel", "Preis", "Kategorie" werden automatisch zugeordnet.

Katalog-Audit (Pro Plus): Starte mit einem Quick-Audit — er zeigt dir sofort die größten Qualitätsprobleme in deinem Shop.

MCP ECOM Shopify — Komplette Anleitung

Was kann MCP ECOM?

Voraussetzungen

Shopify Custom App erstellen

Custom App Development aktivieren

App erstellen

API-Berechtigungen konfigurieren

App installieren & Token kopieren

Installation auf deinem Webserver

Dateien hochladen

config.json erstellen

Testen

Einstellungen (config.json)

Alle Versionen (Free, Starter, Pro, Pro Plus)

Ab Starter

Ab Pro

Nur Pro Plus

MCP-Server-URLs

ChatGPT verbinden

ChatGPT Entwicklermodus aktivieren

App erstellen

Testen

Free Version

Verfügbare Tools (3)

Eckdaten

Endpoint

Starter Version

Verfügbare Tools (5)

Eckdaten

Neue Features

Endpoint

Pro Version

Verfügbare Tools (12)

Eckdaten

Neue Features

Endpoint

Pro Plus Version

Verfügbare Tools (16)

Eckdaten

Exklusive Features: AI Catalog Intelligence

Endpoint

Prompt-Sammlung

Free — Grundlagen

Produkte auflisten

Einzelnes Produkt erstellen

Produkt mit Bildern erstellen

Mehrere Produkte auf einmal (Bulk — bis 3)

Starter — Optimierung & Import

Pro — Recherche & Analyse

Pro Plus — Katalog Intelligence

Versionen im Vergleich (Shopify)

Shopify vs. andere Plattformen — Unterschiede

Shopify

Shopware 6 / WooCommerce

Datenschutz & Sicherheit

Datenfluss

Sicherheitsmaßnahmen

DSGVO-Konformität

Warum MCP ECOM statt manuell mit ChatGPT?

Fehlerbehebung

401 — "token_invalid_or_missing"

500 — "config_missing" oder "config_invalid"

Shopify API Fehler (401/403)

429 — Rate Limit

ChatGPT zeigt "Tool aufrufen fehlgeschlagen"

"license_invalid" oder "quota_reached"

CSV-Import Fehler

.htaccess funktioniert nicht (nginx)

So funktioniert MCP ECOM (Shopify)

Tipps