Shopify Dev MCP Server

Der Shopify Dev MCP Server ist Shopifys offizieller Model-Context-Protocol-Server für die Entwicklerdokumentation und API-Schemas auf shopify.dev. Er richtet sich ausschließlich an Entwicklerinnen und Entwickler, die Shopify-Apps, -Extensions und -Themes bauen. Der Server ist kein Store-Management-Werkzeug: Bestellungen, Produkte und Kundendaten sind nicht zugänglich. Stattdessen verbindet er den KI-Client mit Shopifys Entwicklerressourcen und ermöglicht kontextbezogene, halluzinationsärmere Antworten auf Entwicklerfragen. Die offizielle Dokumentationsseite lautet https://shopify.dev/docs/apps/build/devmcp, das Plugin-Repository liegt unter https://github.com/Shopify/shopify-plugins.

Was ist der Shopify Dev MCP Server?

Der MCP-Server gibt einem kompatiblen KI-Client Zugang zu Shopifys Entwicklungsressourcen: Dokumentationsinhalte, API-Referenzen und Schemadaten für die Shopify Admin API (GraphQL), die Storefront API, Shopify Functions, Liquid und weitere Plattform-Surfaces. Laut Anbieter kann der Agent damit Entwicklerdokumentation und API-Schemas durchsuchen, aktuelle Antworten zu Shopify-APIs abrufen und Code gegen Shopify-Schemas validieren. Der Server wurde am 31. März 2025 im Shopify Developer Changelog angekündigt und läuft als lokaler STDIO-Prozess, der bei Bedarf via npx -y @shopify/dev-mcp@latest gestartet wird. Eine Authentifizierung ist nicht erforderlich – der Server benötigt weder ein Shopify-Konto noch einen API-Key für die Dokumentations- und Schema-Abfragen.

Abgrenzung zum Shopify AI Toolkit

Shopify veröffentlicht zwei sich ergänzende Entwicklerwerkzeuge: das Shopify AI Toolkit und den Dev MCP Server. Das Toolkit ist ein Plugin-Paket aus dem Repository https://github.com/Shopify/Shopify-AI-Toolkit (538 Sterne, MIT), das Skills, Hooks und Plugin-Definitionen für verschiedene KI-Clients bündelt und über claude plugin install shopify-ai-toolkit@claude-plugins-official installiert wird. Der Dev MCP Server ist das zugrunde liegende STDIO-Protokoll, das das Toolkit in seinem MCP-Installationspfad verwendet, aber auch direkt ohne das Toolkit konfiguriert werden kann. Für die meisten Entwickler ist das Toolkit die empfohlene Einstiegsmethode; wer mehr Kontrolle über die MCP-Konfiguration wünscht, installiert den Server direkt.

Voraussetzungen

Für die direkte MCP-Server-Installation werden folgende Komponenten benötigt: Node.js 18 oder höher mit verfügbarem npx-Befehl sowie ein kompatibler KI-Client. Laut offizieller Dokumentation werden Claude Code, Codex, Antigravity CLI, Cursor, Hermes (via Plugin), OpenClaw (via Plugin), Pi (via Plugin) und Visual Studio Code unterstützt. Eine Internetverbindung ist beim ersten Aufruf erforderlich, damit npx das Paket @shopify/dev-mcp@latest (~3 MB) vom npm-Registry herunterlädt. Weitere Installationsschritte oder Umgebungsvariablen sind für den Basisbetrieb nicht notwendig.

Funktionen und Tools

Der Shopify Dev MCP Server stellt laut Anbieter und Plugin-README folgende Fähigkeiten bereit:

Dokumentationssuche: Der Server kann Shopify-Entwicklerdokumentation auf shopify.dev durchsuchen und kontextrelevante Ausschnitte an den KI-Agenten zurückgeben. Das ermöglicht Antworten auf Fragen zu APIs, Konfigurationsoptionen und Best Practices, ohne dass der Agent sich auf veraltetes Modellwissen verlassen muss.

API-Schema-Introspektierung: GraphQL-Schemas der Shopify Admin API und der Storefront API können direkt vom Server abgefragt werden. Der Agent erhält aktuelle Felddefinitionen, Typen und verfügbare Queries oder Mutations – eine Grundlage für halluzinationsärmeres Code-Completion.

Code-Validierung: GraphQL-Queries, Liquid-Templates und Shopify-Extensions lassen sich gegen Shopify-Schemas validieren, um Fehler frühzeitig zu erkennen. Das ist besonders nützlich für Extension-Migrationen zwischen API-Versionen, etwa beim Wechsel von React-basierten Checkout-Extensions auf Polaris Web Components.

Entwicklungskontext: Mit dem installierten Server kann ein Agent Aufgaben übernehmen, die detailliertes Shopify-Plattformwissen erfordern: die richtige API-Surface auswählen, Scaffolding-Befehle der Shopify CLI erklären, App-Store-Anforderungen durchgehen oder Extension-Migrationen automatisieren.

Einrichtung

Die Einrichtung variiert je nach Client. Für Claude Code lautet der direkte MCP-Befehl:

claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest

Anschließend Claude Code neu starten, damit die Konfiguration geladen wird. Alternativ empfiehlt Shopify das Plugin für Claude Code:

claude plugin install shopify-ai-toolkit@claude-plugins-official

Für Codex CLI:

codex mcp add shopify-dev-mcp --command "npx -y @shopify/dev-mcp@latest"

Für Cursor lässt sich der Server über die MCP-Einstellungen oder eine ~/.cursor/mcp.json hinzufügen. Für GitHub Copilot (VS Code), Gemini CLI und andere Clients stehen Plugin-Installationswege über das Repository https://github.com/Shopify/shopify-plugins bereit.

Sicherheitshinweise

Da der Shopify Dev MCP Server ausschließlich Lesezugriff auf öffentlich verfügbare Dokumentation und API-Schemas bietet und keine Authentifizierung erfordert, ist das Risikoprofil vergleichsweise niedrig. Es werden keine Store-Daten, Bestellinformationen oder persönliche Kundendaten abgerufen. Der Server läuft lokal als STDIO-Prozess – es gibt keine persistente Netzwerkverbindung zu einem entfernten Server. Zu beachten ist dennoch, dass der Agent die abgerufenen Dokumentationsinhalte in Modellanfragen einbettet; wer mit einem proprietären Modell-Backend arbeitet, sollte prüfen, welche Daten die Modellanfragen enthalten. Prompt-Injection über manipulierte Dokumentationsinhalte ist theoretisch möglich, aber praktisch sehr unwahrscheinlich bei Shopifys eigener Dokumentation.

FAQ

Ist der Shopify Dev MCP Server kostenlos? Das npm-Paket @shopify/dev-mcp ist ISC-lizenziert und kostenlos nutzbar. Eventuelle Kosten entstehen durch den verwendeten KI-Client oder das verbundene Sprachmodell. Aktuelle Shopify-Preisinformationen für Entwickler unter shopify.dev.

Brauche ich ein Shopify-Konto? Nein. Der Server greift auf öffentliche Dokumentation und Schemas zu; für reine Dokumentations- und Schemaabfragen ist kein Konto erforderlich. Für Store-Management-Operationen über die Shopify CLI wäre ein Konto notwendig, aber das ist nicht Bestandteil dieses MCP-Servers.

Unterscheidet sich der Dev MCP Server vom Shopify AI Toolkit? Das Toolkit ist ein Plugin-Paket, das den MCP-Server intern nutzt, aber auch Skills und Hooks bündelt. Der Dev MCP Server kann direkt ohne das Toolkit installiert werden. Für den Einstieg empfiehlt Shopify das Toolkit; für manuelle Setups oder Umgebungen ohne Plugin-Support ist der direkte MCP-Pfad besser geeignet.

Wie aktuell sind die GitHub-Sterne? Die GitHub-API meldete am 08.09.2026 exakt 7 Sterne für das Plugin-Repository https://github.com/Shopify/shopify-plugins. Das zugehörige Shopify-AI-Toolkit-Repository https://github.com/Shopify/Shopify-AI-Toolkit zählte 538 Sterne. Diese Zahlen sind Momentaufnahmen und kein Qualitätsurteil.

Node.js 18 oder höher mit npx, kompatibler KI-Client (Claude Code, Codex, Cursor u.a.), Internetverbindung beim ersten Start.

Für Claude Code: claude mcp add --transport stdio shopify-dev-mcp -- npx -y @shopify/dev-mcp@latest, dann Claude Code neu starten. Alternativ Plugin: claude plugin install shopify-ai-toolkit@claude-plugins-official.

npx -y @shopify/dev-mcp@latest

Keine Authentifizierung erforderlich; der Server greift auf öffentliche Shopify-Dokumentation und -Schemas zu.

Nur Lesezugriff auf öffentliche Shopify-Entwicklerdokumentation und API-Schemas; kein Store- oder Kundendatenzugriff.

Der Server läuft lokal als STDIO-Prozess und ruft Shopify-Dokumentation und -Schemas ab; abgerufene Inhalte werden in Modellanfragen des KI-Clients eingebettet.

Niedriges Risikoprofil: Nur Lesezugriff auf öffentliche Inhalte, keine Authentifizierung, lokaler STDIO-Prozess. Abgerufene Dokumentationsinhalte fließen in Modellanfragen ein.