So richten Sie das Shopify AI Toolkit mit Claude Code ein

Am 9. April 2026 hat Shopify ein Toolkit als Open-Source-Software veröffentlicht, das Claude Code direkt mit der Shopify-Plattform verbindet – nicht mit Trainingsdaten über Shopify, sondern mit den tatsächlich live verfügbaren Entwicklerdokumenten, GraphQL-Schemata und der CLI. Der Unterschied ist wichtig: Fragen Sie Claude ohne das Toolkit nach einer Produktmutationsabfrage, und Sie erhalten eine bestmögliche Schätzung von vor acht Monaten. Mit dem Toolkit erhalten Sie die aktuell validierte Syntax.

Das Toolkit bietet Claude Code drei Dinge: Echtzeitzugriff auf die Shopify-Entwicklerdokumentation, lokale GraphQL-Schema-Validierung, die jede Abfrage vor der Ausführung überprüft, und die Möglichkeit, Live-Shop-Operationen über die Shopify-CLI auszuführen. Diese dritte Ebene – die tatsächliche Ausführung – unterscheidet dies von einem Autocomplete-Upgrade. Claude kann Produkte erstellen, Metafelder verwalten, Themendateien ändern und Massenoperationen ausführen, ohne dass Sie eine einzige Abfrage von Hand schreiben müssen.

Es gibt drei Möglichkeiten, es einzurichten: ein Plugin (der empfohlene Weg, automatische Updates), ein MCP-Server (einzelner Terminalbefehl, direkte Integration) und manuelle Agenten-Skills (granulare Kontrolle für Teams, die Funktionen einzeln aktivieren möchten). Dieser Leitfaden behandelt alle drei, sowie den Authentifizierungsschritt, den die meisten Tutorials überspringen, und einen Abschnitt darüber, was Sie tatsächlich mit Claude Code tun können, sobald es in Ihrem Shop läuft.

TL;DR

Was das Shopify AI Toolkit tatsächlich tut

Das Toolkit ist kein einzelnes Werkzeug – es ist ein Bündel von Skill-Dateien und einem Dev-MCP-Server, die Claude mit drei verschiedenen Ebenen der Shopify-Plattform verbinden.

Zugriff auf die Dokumentation. Claude durchsucht die aktuellen Shopify-Entwicklerdokumente in Echtzeit. Fragen Sie es nach der korrekten API-Syntax für eine bestimmte Operation, und es gibt zurück, was Shopify heute tatsächlich dokumentiert, nicht eine zwischengespeicherte Annäherung aus seinem Trainings-Cutoff.

Schema-Validierung. Das Toolkit bündelt die GraphQL-API-Schemata von Shopify lokal. Jede von Claude generierte Abfrage wird vor der Ausführung mit dem realen Schema abgeglichen – was die Klasse von Fehlern eliminiert, bei denen eine Abfrage im Playground erfolgreich ist, aber in der Produktion fehlschlägt, weil ein Feld umbenannt oder veraltet ist.

Shop-Ausführung. Über die Shopify-CLI kann Claude Live-Operationen ausführen: Produkte erstellen und aktualisieren, Metafelder verwalten, Themendateien ändern und Massenoperationen durchführen. Dies wird sofort ausgeführt, ohne Entwurfswarteschlange und ohne Rückgängig-Funktion. Laut der offiziellen AI-Toolkit-Dokumentation von Shopify wird ein Rollback in der aktuellen Version nicht unterstützt – testen Sie jede Operation zuerst in einem Entwicklungs-Shop.

So richten Sie das Shopify AI Toolkit mit Claude Code ein

Die Schritte 1 und 3–4 gelten unabhängig von der gewählten Installationsmethode. Schritt 2a, 2b und 2c sind die drei Installationspfade – wählen Sie einen aus.

Schritt 1: Voraussetzungen überprüfen

Sie benötigen Node.js 18 oder höher, bevor Sie irgendetwas anderes tun. Überprüfen Sie Ihre aktuelle Version:

Wenn die Ausgabe unter v18.0.0 liegt, aktualisieren Sie von nodejs.org, bevor Sie fortfahren. Claude Code muss bereits installiert sein.

Schritt 2a: Installation über Plugin (empfohlen)

Das Plugin bündelt alles in einer Installation und aktualisiert sich automatisch, wann immer Shopify neue Funktionen veröffentlicht. Öffnen Sie eine Claude Code-Chatsitzung und führen Sie diese beiden Befehle nacheinander aus:

Dies ist der reibungsloseste Weg für die meisten Entwickler – keine Konfigurationsdateien zum Bearbeiten, keine manuellen Updateschritte.

Schritt 2b: Installation über MCP-Server

Ein Terminalbefehl verbindet Claude Code mit allen Tools auf dem Shopify Dev MCP-Server:

Starten Sie Claude Code neu, nachdem Sie dies ausgeführt haben. Unter Windows sind Verbindungsfehler bei der Standardkonfiguration häufig. Verwenden Sie stattdessen cmd als Einstiegspunkt – fügen Sie es manuell zu Ihrer Claude MCP-Einstellungsdatei hinzu:

Um die Telemetrie zu deaktivieren (der Server sendet standardmäßig Instrumentierungsdaten), fügen Sie einen env-Block hinzu:

Schritt 2c: Installation über manuelle Agenten-Skills

Mit manuellen Skills können Sie Funktionen einzeln aktivieren. Um alle verfügbaren Skills zu installieren:

Um einen einzelnen Skill zu installieren – zum Beispiel nur den GraphQL Admin API Skill:

Durchsuchen Sie die vollständige Liste der Skills auf GitHub, um zu sehen, was verfügbar ist. Hinweis: Manuell installierte Skills werden nicht automatisch aktualisiert, daher müssen Sie neue Versionen selbst abrufen.

Schritt 3: Authentifizierung für Store-Operationen

Die Dokumentationssuche und die Schema-Validierung funktionieren sofort nach der Installation. Für Store-Operationen ist ein zusätzlicher Schritt erforderlich.

Führen Sie den Shopify CLI-Anmeldebefehl aus:

Dies öffnet ein Browserfenster, um Claude Code für Ihr Shopify-Partnerkonto zu autorisieren. Ab dem 1. Januar 2026 verwenden neue Shopify-Apps OAuth-Client-Anmeldeinformationen anstelle von statischen Zugriffstoken – die CLI übernimmt diesen Austausch automatisch. Token sind für ungefähr 24 Stunden gültig und werden vor Ablauf aktualisiert.

Stellen Sie sicher, dass Ihr Partnerkonto über die entsprechenden Berechtigungen für die Operationen verfügt, die Sie ausführen möchten, bevor Sie etwas in einem Produktions-Store testen.

Schritt 4: Überprüfen der Verbindung

Fragen Sie Claude etwas, das aktuelle Dokumentation erfordert, um genau zu antworten:

„Was ist die korrekte GraphQL-Mutation, um den Titel eines Produkts in der Shopify Admin API zu aktualisieren?“

Wenn das Toolkit aktiv ist, gibt Claude eine validierte Abfrage mit aktuellen Feldnamen zurück. Wenn es sich mit Phrasen wie „dies könnte sich seit meinem Training geändert haben“ absichert oder veraltete Felder generiert, wird die MCP-Verbindung nicht geladen – starten Sie Claude Code neu und überprüfen Sie Ihre Konfiguration.

Welche Einrichtungsmethode für das Shopify AI Toolkit sollten Sie verwenden?

Für die meisten Anwendungsfälle ist das Plugin die richtige Wahl. Der MCP-Server ist eine gute Wahl, wenn Sie bereits die MCP-Konfiguration als Code verwalten oder die Telemetrie vom ersten Tag an kontrollieren möchten. Manuelle Skills sind sinnvoll, wenn jede neue Werkzeugfunktion vor der Bereitstellung eine formelle Überprüfung erfordert.

Was Claude Code für Ihren Shopify-Store tun kann

Sobald das Toolkit verbunden ist, kann Claude Code eine Reihe von Aufgaben erledigen, die andernfalls Stunden manueller API-Arbeit erfordern würden. So sieht das in der Praxis aus.

Massen-Generierung von Produktbeschreibungen

Beschreiben Sie Ihre Produktkategorie, Zielgruppe und die SEO-Keywords, auf die Sie abzielen. Claude generiert optimierte Texte für jedes Produkt unter Verwendung der aktuellen Admin-API-Produktmutation und wendet die Änderungen dann in großen Mengen an – über Hunderte von SKUs in einer einzigen Sitzung. Sie überprüfen die Ergebnisse, bevor etwas live geht.

Dies ist besonders nützlich, wenn Sie eine neue Produktkategorie einführen oder Beschreibungen nach einer Markenerneuerung umschreiben. Claude sorgt für einen einheitlichen Ton im gesamten Katalog, ohne dass Sie jeden Datensatz manuell bearbeiten müssen.

Prompt: Lies alle Produkte in meinem Shop, deren Titel „xxx (z. B. Keramik)“ enthalten. Generiere für jeden Artikel eine SEO-optimierte Produktbeschreibung von etwa 150 Wörtern mit einem warmen Ton, der für nordamerikanische Familien geeignet ist, und aktualisiere dann die Beschreibungen direkt im Shop.

Bestandswarnungen und -anpassungen

Claude kann Lagerbestände an allen Standorten über die inventoryLevels-Verbindung abfragen, SKUs unter einem festgelegten Schwellenwert markieren und die zur Korrektur erforderlichen inventoryAdjustQuantities-Mutationen entwerfen. Sie definieren die Regeln – Claude führt die Prüfungen durch und bereitet die Anpassungen für Ihre Überprüfung vor.

Für Shopify-Stores mit mehreren Lagern oder Fulfillment-Partnern wird aus einer täglichen manuellen Prüfung eine 30-Sekunden-Abfrage.

Prompt: Frage alle Produkte mit einem Lagerbestand von weniger als 10 Einheiten ab, füge „[Niedriger Lagerbestand]“ am Anfang ihrer Titel hinzu und liste gleichzeitig alle Produkte auf, deren Stückkosten höher sind als der Verkaufspreis.

Fehlerbehebung im Theme-Code

Beschreiben Sie das Layout-Problem oder den visuellen Fehler. Claude liest die aktuellen Theme-Dateien, identifiziert den Liquid-Code, der das Problem verursacht, überprüft die Korrektur anhand des Theme-Schemas und wendet sie an. Der Schritt der Schema-Validierung fängt nicht übereinstimmende Abschnittseinstellungen ab, bevor sie den Live-Shop beeinträchtigen.

Beginnen Sie mit dem Entwickler-Shop – beschreiben Sie den Fehler, lassen Sie ihn von Claude identifizieren, überprüfen Sie die vorgeschlagene Korrektur und wenden Sie sie dann an. Claude kann auch erklären, warum der ursprüngliche Code das Problem hatte, was nützlich ist, um zu verhindern, dass dasselbe Problem erneut auftritt.

Prompt: Überprüfe die Datei checkout.liquid meines aktuellen Themes, finde den Code, der sich auf das benutzerdefinierte Feld „gift_message“ bezieht, und finde heraus, warum es in der neuesten Version nicht gerendert wird.

Massen-SEO-Optimierung

Claude kann SEO-Titel und Meta-Beschreibungen für ganze Kollektionen generieren, sie über Metafeld-Mutationen aktualisieren und den Abschluss der Schreibvorgänge bestätigen – alles in einer Sitzung. Geben Sie ihm Ihre Ziel-Keyword-Liste und die Richtlinien für die Markenstimme, und er kümmert sich gemeinsam um den Text und die API-Aufrufe.

Dies ist zuverlässiger als tabellenbasierte Massen-Editoren, da Claude jede Mutation vor der Ausführung anhand des aktuellen Schemas validiert. Veraltete Felder schlagen sauber fehl, anstatt stillschweigend zu versagen.

Prompt: Finde alle Produkte, die keine Meta-Beschreibung haben. Generiere eine Meta-Beschreibung mit maximal 160 Zeichen basierend auf dem Produkttitel und der Beschreibung, füge primäre Keywords hinzu, um Klicks zu generieren, und aktualisiere sie dann stapelweise.

Wettbewerber-Preisüberwachung und Reaktion

Claude kann die GraphQL-Abfragelogik und die Konfigurationen für Shopify Flow-Trigger generieren, um Ihre eigenen Preise im Verhältnis zu Zielen zu überwachen, und als Reaktion darauf Massenmutationen vom Typ productVariantsBulkUpdate entwerfen, um die Preise anzupassen. Für tatsächliche Wettbewerberdaten würden Sie ein Preisintelligenz-Tool eines Drittanbieters verbinden – Claude kümmert sich um die Shopify-Seite der Reaktion: welche Produkte, um wie viel und in welcher Reihenfolge aktualisiert werden sollen.

Für Shops mit großen Katalogen und dynamischen Preisregeln ersetzt dies stundenlanges manuelles Repricing durch einen beschreibbaren Workflow.

Prompt: Überprüfe täglich um 10 Uhr die Preise der „Vintage Lamp“-Produkte von Wettbewerber A und Wettbewerber B. Wenn ihre Preise mehr als 10 % unter meinen liegen, generiere automatisch einen zeitlich begrenzten Rabattcode im Format: PREIS + Datum, setze die Rabattmarge 5 % niedriger als die der Wettbewerber und sende mir eine E-Mail-Benachrichtigung.

Sichere Theme-Änderungen

Bevor eine Theme-Änderung vorgenommen wird, prüft Claude, welche Abschnitte über das Theme-Schema anpassbar sind und welche in Liquid fest codiert sind. Es teilt Ihnen mit, welche Änderungen über den Shopify Theme-Editor rückgängig gemacht werden können und welche Code-Änderungen erfordern – damit Sie die Rollback-Optionen verstehen, bevor Sie etwas anfassen.

Dies ist wichtig, da Theme-Änderungen über die CLI nicht denselben Versionsverlauf durchlaufen wie im Theme-Editor. Claude kennzeichnet diesen Unterschied und schlägt vor, welcher Ansatz für jede Änderung sicherer ist.

Automatisierung des Kundenservice

Claude Code kann vorgefertigte Antwortvorlagen entwerfen, Shopify Flow-Automatisierungen für Bestellstatus-Benachrichtigungen erstellen und Webhook-Handler für gängige Kundenanfragetypen einrichten – alles über die Admin-API und ohne Ihr Terminal zu verlassen.

Für live eingehende Anrufe und Chats, die außerhalb der Geschäftszeiten stattfinden – die Bestellanfrage um Mitternacht, die Rückerstattungsanfrage am Samstag – verbindet sich Solvea direkt mit Shopify und führt diese Gespräche ohne menschliches Eingreifen. Es löst Bestellanfragen, bearbeitet Rücksendeanträge und eskaliert an einen menschlichen Mitarbeiter, wenn die Situation es erfordert. Anker lässt jetzt 70 % seiner Kundenservicearbeit von Solvea erledigen, wodurch wöchentlich über 150 Agentenstunden eingespart werden. Claude Code kümmert sich um die Einrichtung der Automatisierung; Solvea führt die Live-Kundengespräche.

Automatisierung der Datenberichterstattung

Claude kann benutzerdefinierte GraphQL-Abfragen für Bestellanalysen, den Customer Lifetime Value und den Lagerumschlag schreiben – und dann die Ausgabe für den direkten Export nach Google Sheets oder als strukturiertes JSON für Ihre Reporting-Pipeline formatieren. Beschreiben Sie die benötigte Metrik und den Zeitraum, und Claude generiert die Abfrage, führt sie aus und gibt die Daten zurück.

Dies ist flexibler als die integrierten Berichte von Shopify, da Sie Daten aus mehreren Ressourcen in einer einzigen Abfrage kombinieren können. Claude kann auch wiederkehrende Abfragen mit Shopify Flow-Triggern planen, sodass Sie aktualisierte Zahlen in einem bestimmten Rhythmus erhalten, anstatt dieselbe Abfrage jede Woche manuell auszuführen.

Prompt: Erstelle einen Shop-Datenbericht für die letzte Woche (Montag bis Sonntag), der Folgendes enthält:

Gesamtumsatz, Anzahl der Bestellungen, durchschnittlicher Bestellwert (im Vergleich zur Wachstumsrate der vorletzten Woche)

Top 10 der meistverkauften Produkte

Top 5 Traffic-Quellen

Retourenquote und Rückerstattungsbetrag

Conversion Funnel (Besuch → In den Warenkorb → Kasse → Bezahlung)

Formatanforderungen:

Stelle die Kerndaten in einer Tabelle dar

Liste 3-5 wichtige Erkenntnisse auf

Gib 2-3 Handlungsvorschläge für die nächste Woche

Fazit

Das Shopify AI Toolkit verändert, was Claude Code mit einem Shopify-Shop tun kann – von der Generierung plausiblen Codes bis zur Ausführung validierter API-Aufrufe in Ihrem tatsächlichen Shop. Die Einrichtung dauert unabhängig von der Methode weniger als zehn Minuten, wobei das Plugin der reibungsloseste Weg ist und der MCP-Server Ihnen die größte Konfigurationskontrolle bietet.

Der Schritt, den die meisten Anleitungen überspringen: Authentifizierung. Die Dokumentationssuche und die Schema-Validierung funktionieren sofort nach der Installation, aber für den Betrieb des Shops ist shopify auth login erforderlich, bevor etwas ausgeführt wird. Erledigen Sie das zuerst, führen Sie Ihre ersten Tests in einem Entwicklungs-Shop durch und arbeiten Sie sich zu Produktionsvorgängen hoch, sobald Sie verstehen, wie das Ausführungsmodell funktioniert – es gibt keine Rückgängig-Funktion.

FAQ

Funktioniert das Shopify AI Toolkit mit Claude Code unter Windows?

Ja, aber die MCP-Serverkonfiguration erfordert cmd als Befehlseingangspunkt. Verwenden Sie \"command\": \"cmd\" mit \"args\": [\"/k\", \"npx\", \"-y\", \"@shopify/dev-mcp@latest\"] in Ihrer MCP-Einstellungsdatei. Die Plugin-Installationsmethode (/plugin marketplace add und /plugin install) funktioniert auf allen Betriebssystemen identisch.

Benötige ich einen kostenpflichtigen Shopify-Plan, um das AI Toolkit zu verwenden?

Das Toolkit selbst ist kostenlos und Open Source. Es verbindet sich mit der API von Shopify, was ein Partnerkonto oder einen aktiven Shop erfordert. Shop-Vorgänge verwenden Ihren bestehenden API-Zugang – es ist keine zusätzliche Tarifstufe erforderlich.

Ist das Shopify AI Toolkit dasselbe wie der Dev MCP-Server?

Nicht ganz. Der Dev MCP-Server (@shopify/dev-mcp) ist eine Komponente des umfassenderen AI Toolkits. Das vollständige Toolkit enthält auch Agent-Skill-Dateien und unterstützt die Plugin-Installation. Der MCP-Server ist der direkte Integrationspfad, der die Plugin-Ebene umgeht.

Kann Claude Code Änderungen an einem Live-Produktions-Shop vornehmen?

Ja – und das ist das Hauptrisiko. Shop-Ausführungsvorgänge werden sofort ohne Entwurfswarteschlange oder Rollback-Unterstützung ausgeführt. Testen Sie jeden neuen Vorgangstyp in einem Entwicklungs-Shop, bevor Sie ihn in der Produktion ausführen. Die store execute-Funktion der Shopify CLI hat keinen Bestätigungsschritt zwischen dem Befehl und dem API-Aufruf.

Was ist der Unterschied zwischen der Plugin- und der MCP-Installation?

Das Plugin bündelt alle Skill-Dateien und die MCP-Verbindung in einer einzigen Installation, die sich automatisch aktualisiert. Die MCP-Installation gibt Ihnen direkten Zugriff auf die Tools des Dev MCP-Servers ohne die Plugin-Ebene – nützlich, wenn Sie die Verbindung als Config-as-Code verwalten oder die Serverumgebung anpassen müssen. Beide Methoden geben Claude Code Zugriff auf die aktuelle Shopify-Dokumentation und die Schema-Validierung.