Das Wichtigste in Kürze
- Das Shopify-Plugin lässt sich mit einem Befehl in Cursor Chat (
/add-plugin shopify) oder einem Klick im Cursor Marketplace installieren und wird automatisch mit neuen Funktionen aktualisiert.- Die manuelle Installation von Skills funktioniert, aber die Schemas weichen im Laufe der Zeit von der Live-Plattform ab, wenn keine manuellen Updates durchgeführt werden.
- Setze
OPT_OUT_INSTRUMENTATION=truevor deiner ersten Validierung, wenn du mit proprietärem Code arbeitest. Validierungs-Payloads enthalten standardmäßig deinen Code.- Cursors Verständnis der Codebase in Kombination mit der Schema-Validierung des Toolkits ist eine starke Kombi für die Shopify-Entwicklung.
- Store-Operationen werden sofort in deinem Live-Store ausgeführt. Es gibt keinen Entwurfs-Schritt und kein Rückgängigmachen (Undo).
Um das Shopify AI Toolkit in Cursor einzurichten, tippe /add-plugin shopify in den Cursor Chat ein oder installiere es mit einem Klick aus dem Cursor Marketplace. Stelle dann eine Frage zur Shopify-API im Chat, um zu bestätigen, dass die aktuellen Docs abgerufen werden.
Sobald es installiert ist, hat deine Cursor-Umgebung Zugriff auf die aktuelle Shopify-Dokumentation, Code-Validierung gegen mitgelieferte API-Schemas und die Möglichkeit, Store-Operationen über die Shopify CLI auszuführen.
Für eine vollständige Übersicht darüber, was das Toolkit macht, wie es funktioniert und welche Governance-Risiken bei der Store-Ausführung bestehen, sieh dir unsere Übersicht zum Shopify AI Toolkit an.
Warum du uns vertrauen kannst
Jacques hat über 15 Jahre Entwicklungserfahrung und hat mit Hunderten von Shopify-Stores gearbeitet. Wir bauen Fudge, den KI-Operator für Shopify-Stores, mit einer 4.9-Bewertung im Shopify App Store und einem Built for Shopify-Badge. Wir nutzen diese Tools täglich.
Voraussetzungen
- Cursor installiert und läuft
- Node.js 18 oder höher, Shopifys dokumentiertes Minimum (
node --versionzum Prüfen). Node 18 hat im April 2025 sein End-of-Life erreicht, nutze also Node 20 LTS oder neuer - Shopify CLI installiert (erforderlich für Store-Operationen)
- Ein Shopify-Store zur Verbindung (nur nötig, wenn du Store-Operationen ausführen willst)
Installation: Plugin-Methode (empfohlen)
Die Plugin-Methode ist der einfachste Weg und aktualisiert sich automatisch mit neuen Funktionen.
Schritt 1: Installiere das Plugin
Führe in Cursor Chat Shopifys dokumentierten Befehl aus:
/add-plugin shopifyOder installiere das Shopify AI Toolkit direkt aus dem Cursor Marketplace. Das geht mit einem Klick.
Alle verfügbaren Agent-Skills sind automatisch enthalten.
Schritt 2: Ueberpruefen, ob es funktioniert
Oeffne Cursors KI-Chat und stelle eine Shopify-spezifische Frage:
What's the correct GraphQL mutation to create a new product in Shopify's Admin API?Wenn das Toolkit aktiv ist, greift Cursor auf aktuelle Shopify-Dokumentation zurueck statt auf seine Trainingsdaten. Du wirst bemerken, dass die Antworten genaue, validierte Feldnamen enthalten.
Alternative: Manuelle Skills-Installation
Wenn dein Setup das Plugin nicht verwenden kann, oder du den Skill lieber selbst verwalten willst, installiere ihn direkt:
npx skills add Shopify/shopify-ai-toolkitDies installiert den einzigen shopify-Skill des Toolkits, der jeden Shopify-Entwicklerbereich abdeckt: die GraphQL Admin API, Shopify Functions, Polaris, Liquid, Hydrogen und Shopify CLI. Frühere Versionen lieferten einen separaten Skill pro Bereich, wie z.B. shopify-admin und shopify-liquid. Diese sind veraltet und werden nicht mehr aktualisiert. Wenn du also einen davon installiert hast, entferne ihn (zum Beispiel npx skills remove shopify-admin shopify-liquid) und installiere stattdessen den shopify-Skill.
Manuell installierte Skills aktualisieren sich nicht automatisch. Führe regelmäßig npx skills update aus, um bei Shopifys API-Änderungen auf dem neuesten Stand zu bleiben. Andernfalls weichen die mitgelieferten Schemas von der Live-Plattform ab.
Alternative: MCP-Server Setup
Für eine direkte MCP-Integration kannst du dich mit Shopifys Dev MCP-Server verbinden, indem du eine Konfiguration zu Cursors MCP-Einstellungen hinzufügst. Der Dev MCP-Server läuft als lokale Server/Client-Integration, macht aber Netzwerkaufrufe an Shopify-Endpunkte für die Dokumentationssuche.
Gehe in Cursor zu Cursor > Settings > Cursor Settings > Tools and MCP > New MCP server und füge diese Konfiguration hinzu, wie in den Shopify AI Toolkit Docs angegeben:
{
"mcpServers": {
"shopify-dev-mcp": {
"command": "npx",
"args": ["-y", "@shopify/dev-mcp@latest"]
}
}
}Speichere und starte Cursor neu. Wenn du unter Windows Verbindungsfehler siehst, bietet die Shopify-Doku eine Alternative, die denselben Befehl über cmd /k ausführt.
Telemetrie und Code-Übertragung
Bevor du anfängst Code zu validieren: Sowohl validate.mjs als auch search_docs.mjs senden standardmäßig Nutzungsdaten an die Shopify-Server.
Die SKILL.md-Dateien beschreiben dies als „anonymisierte Validierungsergebnisse (Pass/Fail und Skill-Name)“. Der eigentliche Validierungs-Payload enthält jedoch den Code, der validiert wird – deine GraphQL-Querys, Liquid-Templates und anderen Code, den du durch den Validator jagst.
Um dich abzumelden (Opt-out), setze diese Umgebungsvariable, bevor du Cursor startest:
export OPT_OUT_INSTRUMENTATION=trueWenn du mit proprietärem oder Kunden-Code arbeitest, richte dies vor deiner ersten Validierung ein.
Mit deinem Store verbinden
Für Store-Operationen (nicht nur Code-Generierung und -Validierung) musst du dich authentifizieren.
Authentifizierungs-Flow
Wenn du eine Store-Operation über Cursor anfragst, triggert das Toolkit:
shopify store auth --store yourstore.myshopify.com --scopes write_products,read_productsDadurch öffnet sich ein Browserfenster, in dem du die Verbindung über deinen Shopify-Adminbereich autorisierst.
Häufige OAuth-Scopes
| Was du tun willst | Benötigter Scope |
|---|---|
| Produktdaten lesen | read_products |
| Produkte aktualisieren | write_products |
| Lagerbestände lesen | read_inventory |
| Lagerbestand anpassen | write_inventory |
| Bestellinfos lesen | read_orders |
| Auf Kundendaten zugreifen | read_customers |
Nutze immer nur die minimal erforderlichen Scopes. Das Validierungsskript des Toolkits erkennt, was für jede Operation benötigt wird, aber write_products gewährt trotzdem Zugriff auf ALLE Produkt-Schreiboperationen, nicht nur auf die spezifische Mutation, die du ausführst.
Was du mit Cursor + Shopify AI Toolkit machen kannst
Validierte Code-Generierung
Der größte sofortige Nutzen: Cursor rät nicht mehr bei Shopify-APIs.
Ohne das Toolkit generiert Cursor möglicherweise GraphQL mit veralteten Feldern, falschen Typen oder nicht existierenden Mutationen, basierend auf veralteten Trainingsdaten. Mit dem Toolkit wird jede Query und Mutation gegen das mitgelieferte Shopify API-Schema validiert.
Cursors Codebase-Kontext nutzen
Cursor ist großartig darin, dein gesamtes Projekt zu verstehen. Kombiniere das Shopify-Toolkit mit Cursors Codebase-Verständnis:
Schau dir an, wie ich die anderen Produkt-Querys in diesem Projekt strukturiert habe und schreibe eine neue zum Abrufen von Produktempfehlungen, validiert gegen die aktuelle Shopify-APITheme-Entwicklung
Arbeite mit Liquid-Templates inklusive Validierung gegen Shopifys Theme-Regeln – einschließlich Schema-Blöcken und LiquidDoc-Headern.
Hydrogen-Storefronts
Baue Headless-Storefronts mit validierten React-Komponenten und korrekten Imports.
Store-Operationen
Führe Operationen direkt auf deinem verbundenen Store aus. Jede Store-Operation, die Daten schreibt, wird sofort in deinem Live-Store ausgeführt. Es gibt keinen Entwurfs-Schritt. Lies die vollständige Risikoaufschlüsselung, um zu verstehen, warum das wichtig ist.
Metafield-Management
Erweitere das Datenmodell deines Stores mit Metafield-Definitionen und benutzerdefinierten Daten.
Functions und Extensions
Baue Backend-Anpassungen – Rabatte, Warenkorb-Validierung, Lieferregeln – und scaffold UI-Extensions.
Für praxisnahe Theme-Beispiele sieh dir So fügst du benutzerdefinierte Liquid-Logik in Shopify hinzu an.
Best Practices für Cursor-User
1. Vor dem Mutieren abfragen (Query)
Lese immer den aktuellen Status, bevor du Änderungen machst:
Zeige mir zuerst die aktuellen Produktdaten für das Handle "summer-collection-tee", dann aktualisiere nur die Beschreibung2. Sei explizit beim Scope
Vage Anfragen führen zu weitreichenden Mutationen. Sei spezifisch:
Zu vage:
Optimiere meine Produkte für besseres SEOBesser:
Aktualisiere die Meta-Description für das Produkt-Handle "classic-tee" auf: "Klassisches T-Shirt aus Premium-Baumwolle. In 5 Farben erhältlich. Kostenloser Versand bei Bestellungen über 50$."3. Themes als unpublished pushen
Das Toolkit unterstützt --unpublished für Theme-Pushes, aber du musst explizit danach fragen. Es wird standardmäßig nicht erzwungen.
4. Füge eine Projekt-Regel hinzu
Erstelle .cursor/rules/shopify.mdc mit Shopify-spezifischen Anweisungen. Cursor behandelt .cursorrules als veraltet zugunsten von Projekt-Regeln (Project Rules):
---
description: Shopify development rules
alwaysApply: true
---
Beim Schreiben von Shopify GraphQL:
- Immer gegen das aktuelle Admin API Schema validieren
- Den shopify-Skill für API-Querys nutzen
- Standardmäßig Lese-Operationen (Read) nutzen, außer es wird explizit nach einer Mutation gefragt
- Bei Mutationen immer zuerst den aktuellen Status abfragen
- Für Theme-Pushes immer das --unpublished Flag verwenden5. Generierte Mutationen vor der Ausfuehrung ueberpruefen
Wenn Cursor eine Store-Mutation generiert, lies sie dir durch, bevor du sie genehmigst. Prüfe:
- Zielt sie auf das richtige Produkt bzw. die richtige Ressource ab?
- Entspricht der Umfang der Änderung deiner Absicht (1 Produkt vs. alle Produkte)?
- Werden vorhandene Feldwerte beibehalten oder überschrieben?
Einschraenkungen
Diese sind strukturell bedingt durch das Toolkit, nicht Cursor-spezifisch. Fuer die vollstaendige Risikoanalyse siehe unsere Shopify AI Toolkit Uebersicht.
- Kein Entwurfsmodus - Store-Mutationen werden sofort auf deinem Live-Store ausgefuehrt
- Keine Vorschau - Du kannst nicht sehen, wie Aenderungen aussehen werden, bevor sie passieren
- Kein Rueckgaengigmachen/Rollback - Aenderungen sind nach der Ausfuehrung permanent
- Kein Audit-Trail - Keine Aufzeichnung auf Toolkit-Ebene darueber, was geaendert wurde
- Breite Scopes - OAuth-Berechtigungen gelten fuer gesamte Ressourcentypen, nicht einzelne Elemente
- Code wird an Shopify gesendet - Validierungs-Payloads enthalten standardmaessig deinen Code (Opt-out mit
OPT_OUT_INSTRUMENTATION=true) - Manuelle Skills veralten - Nicht-Plugin-Installationen benoetigen regelmaessige manuelle Updates
Kurzreferenz
Das AI Toolkit macht dich beim Schreiben von Shopify-Code schneller: Schemas, Themes, Hydrogen, Custom Apps. Es ist jedoch nicht die richtige Oberfläche für das Merch-Team im Tagesgeschäft, und es fügt nicht den Workflow hinzu, den echte Shop-Änderungen brauchen: Entwürfe, Vorschauen, Freigaben, Versionsverlauf, Rollbacks. Code lebt in Git; der Status deines Stores nicht.
Das ist die Lücke, die Fudge schließt. Als KI-Operator für Shopify-Stores bietet es deinem Team den vorgefertigten KI-Workflow, anstatt dass du etwas Eigenes in Cursor entwerfen und pflegen musst. Fudge schlägt vor, was geändert werden sollte, bereitet jede Änderung als Entwurf in deinem Theme über seinen Store-Editor vor, zeigt an, wer was veröffentlicht hat, und vergleicht die Zahlen auf der Seite vor und nach der Änderung.
Nutze Cursor für den Code, den du selbst schreibst.
Zusammenfassung
| Aufgabe | Wie |
|---|---|
| Plugin installieren | /add-plugin shopify in Cursor Chat, oder mit einem Klick aus dem Marketplace |
| Alle Skills manuell installieren | npx skills add Shopify/shopify-ai-toolkit |
| Manuelle Skills updaten | npx skills update |
| Mit dem Store authentifizieren | Automatisch bei der ersten Store-Operation |
| Telemetrie deaktivieren | export OPT_OUT_INSTRUMENTATION=true |
| Node-Version prüfen | node --version (18+ erforderlich, 20 LTS empfohlen) |
Für das Gesamtbild zu Risiken und Governance, lies unsere Übersicht zum Shopify AI Toolkit. Für das Setup auf anderen Plattformen, sieh dir unseren Claude Code Guide und unseren OpenAI Codex Guide an.
Wir haben die Befehle auf dieser Seite zuletzt im Oktober 2026 mit den Shopify Docs abgeglichen.
FAQ
Was ist der Vorteil von Cursor + Shopify AI Toolkit gegenüber anderen KI-Tools?
Cursors Verständnis der Codebase ist das Alleinstellungsmerkmal – es kann beim Schreiben von neuem Shopify-Code deine bestehende Projektstruktur, Konventionen und Muster berücksichtigen. Kombiniert mit der Schema-Validierung des Toolkits rät Cursor nicht mehr bei deiner Codebase und den Shopify-APIs herum. Die Kombi erzeugt konsistenteren Code als jedes Tool für sich allein.
Sollte ich meine Cursor Projekt-Regeln ins Repo committen?
Ja. Projekt-Regeln in .cursor/rules/ sind Konfigurationen auf Projektebene, die dem gesamten Team zugutekommen. Wenn du sie committest, erhält jeder, der am Projekt arbeitet, automatisch das gleiche Shopify-aware Cursor-Verhalten. Nutze Projekt-Regeln für Projekt-Konventionen und Cursor-Einstellungen (die nicht committet werden) für persönliche Vorlieben wie UI-Entscheidungen.
Behält Cursor die Shopify-Store-Authentifizierung über Sessions hinweg bei?
Ja — Auth-Tokens werden von der Shopify CLI verwaltet, nicht von Cursor. Sobald du authentifiziert bist, bleibt das Token in der Config der CLI erhalten, bis es abläuft oder manuell widerrufen wird. Cursors Chatverlauf ist vom Auth-Status getrennt — wenn du den Chatverlauf löschst, wirst du nicht abgemeldet.
Kann ich das Shopify Toolkit im Agent-Modus (autonom) von Cursor nutzen?
Ja. Der Agent-Modus kann Validierungs- und Dokumentations-Tools genauso aufrufen wie der Chat-Modus. Sei vorsichtiger mit Mutationen im Agent-Modus — autonome Loops können Fehler verstärken. Nutze spezifische, eng gefasste Prompts und verlange eine explizite Bestätigung vor jeder Aktion, die den Store mutiert.
Wird das Shopify Toolkit mit anderen Cursor-Extensions in Konflikt geraten?
In der Regel nicht — Extensions sind isoliert. Das Shopify Toolkit operiert über Cursors MCP/Tool-Protokolle, die darauf ausgelegt sind, mit anderen Tool-Extensions zu koexistieren. Wenn du Konflikte feststellst, prüfe, ob mehrere Extensions um dieselbe Prompt-Kategorie konkurrieren — deaktiviere eine, um es zu testen.
