Shopify Admin MCP

A1 Shopify Admin MCP verbindet eine KI-Anwendung mit dem Admin-Bereich eines Shopify-Shops über die Admin API (GraphQL). Er hilft bei der Arbeit mit Produkten und Preisen, Bestellungen, Kunden, Lagerbeständen und Rabattcodes – in natürlicher Sprache.

Der Server ist an einen einzigen Shop gebunden: Die Domain wird per Konfiguration festgelegt, der Token ist der Admin-API-Zugriffstoken einer benutzerdefinierten App, und kein Tool kann auf einen fremden Shop zugreifen.

• 16 Tools. Shop, Produkte und Varianten, Bestellungen, Kunden, Standorte und Lagerbestände, Rabatte – plus beliebige GraphQL-Abfragen für alles Weitere.

• Ehrliche HTTP 200. Shopify-Mutationen geben auch bei Fehlern 200 zurück; der Server liest userErrors und verwandelt die Ablehnung in einen verständlichen Fehler. Eine 200-Antwort ohne data-Objekt – leer, abgebrochen oder gar kein GraphQL – wird ebenfalls zu einem Fehler und nicht zu einem leeren Ergebnis.

• Irreversible Operationen sind sichtbar. Die Stornierung von Bestellungen (mit Entscheidungen über Rückerstattung und Warenrücksendung) sowie beliebige GraphQL-Abfragen sind als destruktiv markiert.

• Cost-Bucket unter Kontrolle. Jede Antwort enthält cost: wie viele Punkte die Abfrage gekostet hat und wie viele Punkte im Bucket verbleiben.

Beginnen Sie mit einer Abfrage, die nur Daten liest:

Zeig mir die letzten Bestellungen des Shops und die Top-Produkte mit Lagerbeständen.

Server verbinden · Szenarien ansehen · Technische Dokumentation öffnen

In einer Minute in Aktion sehen

Sie: Zeig mir die letzten Bestellungen des Shops und die Top-Produkte mit Lagerbeständen.

Assistent: Zeigt Bestellungen mit Status und Beträgen, Produkte mit Preisen und Lagerbeständen. Es wird nichts verändert.

Sie: Bereite einen 20%-Rabatt mit dem Promocode SUMMER für zwei Wochen vor.

Assistent: Zeigt die Parameter des zukünftigen Promocodes – Code, Höhe, Laufzeit, Limits – und fragt nach Bestätigung.

Sie: Ich bestätige.

• Schnellstart

• Was man delegieren kann

• Was sich ändern kann

• Zugriff erhalten

• Konfiguration

• Daten, Limits und Hintergrundarbeit

• Technische Dokumentation

• Support

Schnellstart

Benötigt werden Node.js 20+, eine Shop-Domain der Form my-store.myshopify.com und ein Admin-API-Zugriffstoken einer benutzerdefinierten App (shpat_…). Zum Erstellen einer App benötigen Sie Besitzerrechte am Shop oder Staff-Rechte für die App-Entwicklung.

1. Erhalten Sie Zugriff.

2. Fügen Sie den Server zur KI-Anwendung hinzu.

3. Senden Sie die sichere erste Abfrage oben.

Klicken Sie in Settings → Plugins → MCP servers auf Add server und fügen Sie dann npx -y mcp-shopify-admin@latest mit SHOPIFY_STORE_DOMAIN und SHOPIFY_ACCESS_TOKEN hinzu.

codex mcp add shopify-admin \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  -- npx -y mcp-shopify-admin@latest
codex mcp list

Codex-MCP-Dokumentation

claude mcp add \
  --env SHOPIFY_STORE_DOMAIN=my-store.myshopify.com \
  --env SHOPIFY_ACCESS_TOKEN=shpat_your_token \
  --transport stdio --scope user shopify-admin \
  -- npx -y mcp-shopify-admin@latest
claude mcp list

Claude-Code-MCP-Dokumentation

Öffnen Sie Settings → Developer → Edit Config und fügen Sie Folgendes hinzu:

{"mcpServers":{"shopify-admin":{"command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}}

Wenn Edit Config nicht verfügbar ist, bearbeiten Sie ~/Library/Application Support/Claude/claude_desktop_config.json auf macOS oder %APPDATA%\Claude\claude_desktop_config.json auf Windows. Claude-Desktop-MCP-Dokumentation

Fügen Sie {"mcpServers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"my-store.myshopify.com","SHOPIFY_ACCESS_TOKEN":"shpat_your_token"}}}} in ~/.cursor/mcp.json auf macOS/Linux oder %USERPROFILE%\.cursor\mcp.json auf Windows ein. Cursor-MCP-Dokumentation

Starten Sie MCP: Open User Configuration und fügen Sie Folgendes hinzu:

{"servers":{"shopify-admin":{"type":"stdio","command":"npx","args":["-y","mcp-shopify-admin@latest"],"env":{"SHOPIFY_STORE_DOMAIN":"${input:shopify_store_domain}","SHOPIFY_ACCESS_TOKEN":"${input:shopify_access_token}"}}},"inputs":[{"type":"promptString","id":"shopify_store_domain","description":"Домен магазина my-store.myshopify.com"},{"type":"promptString","id":"shopify_access_token","description":"Admin API access token (shpat_…)","password":true}]}

Überprüfen Sie den Server mit dem Befehl MCP: List Servers. VS-Code-MCP-Dokumentation

Was man delegieren kann

• Zeig mir die Bestellungen der Woche, ihre Zahlungs- und Erfüllungsstatus.

• Finde Produkte ohne Lagerbestand und erhöhe die Preise ausgewählter Varianten.

• Lege ein neues Produkt als Entwurf an und fülle die Beschreibung aus.

• Setze die tatsächlichen Lagerbestände nach der Inventur.

• Erstelle einen Promocode für den Ausverkauf mit Nutzungslimit.

• Finde einen Kunden per E-Mail und zeig mir seine letzten Bestellungen.

Was sich ändern kann

Das Erstellen von Bestellungen, das Ausführen von Sendungen, das Ändern von Kunden, das Veröffentlichen von Produkten in Verkaufskanälen und das Löschen von Objekten sind nicht Teil des Tool-Sets – bei Bedarf erfolgt dies über graphql_request mit ausdrücklicher Bestätigung.

Zugriff erhalten

1. Öffnen Sie den Admin-Bereich des Shops: Settings → Apps and sales channels → Develop apps (aktivieren Sie die App-Entwicklung, falls sie deaktiviert ist).

2. Erstellen Sie eine App und erteilen Sie auf der Registerkarte Configuration die benötigten Admin-API-Zugriffs-Scopes: read_products/write_products, read_orders, read_customers, read_locations/write_inventory, read_discounts/write_discounts – je nach Ihren Szenarien.

3. Installieren Sie die App und kopieren Sie auf der Registerkarte API credentials den Admin API access token (shpat_…; wird nur einmal angezeigt).

4. Übergeben Sie Domain und Token als SHOPIFY_STORE_DOMAIN und SHOPIFY_ACCESS_TOKEN.

Der Token ist statisch und an den Shop gebunden. Behandeln Sie ihn wie ein Passwort. Wenn Sie der App später neue Scopes erteilen, gibt Shopify einen neuen Token aus – aktualisieren Sie die Variable und starten Sie den Server neu. Für sichere Übungen eignet sich ein Development Store.

Konfiguration

Daten, Limits und Hintergrundarbeit

• GraphQL-Cost-Bucket. Jede Abfrage kostet Punkte je nach Komplexität; der Bucket füllt sich jede Sekunde wieder auf. Eine Seite mit first bis 250 ist sparsamer als eine Reihe kleiner Abfragen; der Server zeigt cost mit jedem Ergebnis an.

• Temporäre Fehler. THROTTLED wird automatisch mit einer Wartezeit aus der Bucket-Mathematik wiederholt. Mutationen werden nach Netzwerk- oder 5xx-Fehlern nicht wiederholt, um eine doppelte Anwendung der Änderung zu vermeiden.

• Bestellungen älter als 60 Tage erfordern den Scope read_all_orders, den Shopify auf Anfrage vergibt; ohne ihn werden alte Bestellungen einfach nicht geliefert.

• Keine ständige Überwachung. Der Server arbeitet nur bei Aufruf. Wenn die KI-Anwendung geplante Aufgaben unterstützt, kann sie Bestellungen und Lagerbestände regelmäßig prüfen.

• Anonyme Telemetrie. Es gelangen keine Geheimnisse, Shop-Daten, Argumente oder Prompts hinein; Deaktivierung: ASKADS_TELEMETRY=0.

Technische Dokumentation

• Katalog der MCP-Fähigkeiten – Seiten zu Benutzeraufgaben für jedes Tool.

• Alle Tools und Parameter

• Entwicklungsdokumentation

• Veröffentlichungsdokumentation

• Shopify-Admin-API-Dokumentation (GraphQL)

Support

Einen Fehler gefunden oder ein Szenario fehlt? Erstellen Sie ein Issue oder schreiben Sie an Telegram.