Shopify Storefront MCP Server

Der Shopify Storefront MCP Server ist Shopifys offizieller Model-Context-Protocol-Server für Commerce-Daten auf Store-Ebene. Er verbindet KI-Assistenten und Shopping-Agenten mit dem Produktkatalog, dem Warenkorb und den Richtlinien eines konkreten Shopify-Stores. Im Gegensatz zum Shopify Dev MCP Server – der auf Entwicklerdokumentation und API-Schemas zugreift – ist der Storefront MCP Server für Endkunden-Szenarien konzipiert: Ein Käufer stellt eine Frage zu Produkten, der Agent durchsucht den Katalog des gewählten Shops, legt Artikel in den Warenkorb und führt bis zum Checkout. Die offizielle Dokumentationsseite lautet https://shopify.dev/docs/apps/build/storefront-mcp.

Was ist der Shopify Storefront MCP Server?

Der Storefront MCP Server stellt laut Anbieter strukturierten Zugriff auf Shopifys Commerce-Daten bereit: Produktsuche, Warenkorb-Operationen und Abfragen zu Store-Richtlinien. Jeder Shopify-Store besitzt seinen eigenen MCP-Endpunkt unter https://{shop}.myshopify.com/api/mcp. Dieser Endpunkt ist Store-spezifisch und deckt alle Storefront-Commerce-Funktionen ab. Die Shopify-App, die als MCP-Client fungiert, leitet die Anfragen des KI-Modells an diesen Endpunkt weiter; das Chat-UI wird als Shopify Theme Extension in die Store-Oberfläche eingebettet.

Architektur: MCP-Client, MCP-Server und Chat-UI

Laut Anbieter verwendet das System eine Client-Server-Architektur nach dem Model Context Protocol: Der MCP-Client ist die Shopify-App, die KI-Modelle einbindet und deren Anfragen an den MCP-Server weiterleitet. Der MCP-Server ist ein API-Endpunkt, der strukturierten Zugriff auf Commerce-Daten wie Produkte, Warenkorboperationen und Kundeninformationen bietet. Das Chat-UI ist eine Shopify Theme Extension, die ein kundenseitiges Chatfenster darstellt. Das Backend agiert als MCP-Client, während das Frontend die Kundenerfahrung bereitstellt. Dieser Ansatz ermöglicht die Verbindung beliebiger KI-Modelle mit Shopify ohne individuelle Integration.

Verfügbare Tools

Der Shopify Storefront MCP Server stellt laut offizieller Dokumentation folgende Werkzeuge bereit:

search_catalog: Durchsucht den Produktkatalog des Stores nach Artikeln, die zu den Bedürfnissen des Kunden passen. Unterstützt Freitext-Suche, Buyer-Signals (Land, Sprache, Währung, Kaufabsicht), Filter nach Kategorien und Preisspannen sowie cursorbasierte Paginierung. Dieses Tool entspricht der UCP-Katalog-Spezifikation und ist über den Endpunkt https://{shop}.myshopify.com/api/ucp/mcp verfügbar.

lookup_catalog: Ruft Produkte oder Varianten anhand von Identifikatoren ab. Nützlich, wenn Produkt- oder Variant-IDs bereits aus Suchergebnissen, gespeicherten Listen oder Deep Links vorliegen. Unterstützt bis zu zehn IDs pro Anfrage, Käufer-Lokalisierungssignale und nachgelagerte Filter.

get_product: Ruft vollständige Details zu einem einzelnen Produkt ab, mit optionaler interaktiver Variantenauswahl. Geeignet, wenn ein Käufer ein Produkt ausgewählt hat und detaillierte Informationen für eine Kaufentscheidung benötigt. Unterstützt Variantenauswahl und Präferenzen für Entspannungsreihenfolge.

search_shop_policies_and_faqs: Beantwortet Fragen zu den Richtlinien, Produkten und Diensten eines Shops, um das Kundenvertrauen zu stärken. Laut Shopify sollte nur die bereitgestellte Antwort zur Formulierung genutzt werden; externe Informationen können ungenau sein.

get_cart: Ruft den aktuellen Inhalt eines Warenkorbs ab, einschließlich Artikeldetails und Checkout-URL. Erfordert eine Cart-ID.

update_cart: Aktualisiert Mengen von Artikeln in einem vorhandenen Warenkorb oder fügt neue Artikel hinzu. Erstellt einen neuen Warenkorb, wenn keine Cart-ID angegeben wird. Mit Menge 0 wird ein Artikel entfernt.

Abgrenzung: Storefront MCP vs. Dev MCP vs. Customer Accounts MCP

Shopify betreibt mehrere MCP-Server für unterschiedliche Anwendungsfälle. Der Storefront MCP Server bedient Endkunden-Shoppingszenarien: Produktsuche, Warenkorb, Richtlinien. Er benötigt keine Authentifizierung für den Storefront-Endpunkt. Der Dev MCP Server (@shopify/dev-mcp) richtet sich ausschließlich an Entwickler: Er gibt Zugriff auf Shopify-Entwicklerdokumentation und API-Schemas, nicht auf Store-Daten. Der Customer Accounts MCP Server (https://{shopDomain}/customer/api/mcp) ermöglicht authentifizierte kundenspezifische Aktionen wie Bestellverfolgung und Retouren; er erfordert OAuth 2.0 mit PKCE und Zugriff auf geschützte Kundendaten laut Shopify Partner Dashboard.

Einrichtung für Entwickler

Für die Integration eines Storefront MCP Servers in eine eigene Shopify-App sind folgende Komponenten erforderlich: eine Shopify-App (Node.js empfohlen), ein Shopify Partner-Account, ein Entwicklungsstore sowie grundlegende Kenntnisse in MCP und Shopify-App-Entwicklung. Der Endpunkt ist Store-spezifisch und hat die Form https://{shop}.myshopify.com/api/mcp. Für UCP-Katalog-Tools gilt der separate Endpunkt https://{shop}.myshopify.com/api/ucp/mcp mit einem Agent-Profil-Header. Die offizielle Anleitung empfiehlt den Start mit dem Shopify AI Toolkit unter shopify.dev/docs/apps/build/devmcp für den Entwickler-Einstieg.

Sicherheitshinweise

Der Storefront MCP Server selbst erfordert laut offizieller Dokumentation keine Authentifizierung für öffentliche Store-Daten – Produktkatalog und Policies sind per Design öffentlich zugänglich. Für den Customer Accounts MCP Server ist OAuth 2.0 (Authorization Code Flow mit PKCE) erforderlich, und der Entwickler muss Level-2-Schutz für Kundendaten (PII) über das Shopify Partner Dashboard beantragen. Shopify weist darauf hin, dass einzelne Stores den Zugang möglicherweise einschränken; daher sollte die eigene Integration immer mit dem spezifischen Teststore geprüft werden. Durch die Verwendung der Shopify MCP-Server stimmt der Entwickler laut Anbieter den Shopify API-Nutzungsbedingungen zu. Daten, die der KI-Agent abruft, werden in Modellanfragen eingebettet; das verwendete KI-Modell und dessen Datenschutzrichtlinien sind zu prüfen.

FAQ

Brauche ich ein Shopify-Konto als Endkunde? Nein. Der Storefront MCP Server stellt öffentliche Produktdaten bereit; ein Shopify-Kundenkonto ist nur für den Customer Accounts MCP Server erforderlich, der Bestellhistorie und persönliche Daten verwaltet.

Ist der Storefront MCP Server kostenlos? Die MCP-Endpunkte sind als Teil von Shopifys Storefront-API ohne zusätzliche Kosten verfügbar. Kosten entstehen durch Shopify-Partner-Pläne, den gewählten KI-Modellanbieter sowie ggf. durch Shopify-App-Gebühren. Aktuelle Preisinformationen unter shopify.dev.

Gibt es ein öffentliches GitHub-Repository? Laut Recherche am 08.09.2026 existiert kein öffentliches Repository unter github.com/Shopify für diesen spezifischen MCP-Server. Der Server ist ein cloud-gehosteter, Store-spezifischer Endpunkt ohne separates Open-Source-Paket.

Wo liegt der Unterschied zur Shopify Storefront API? Die Storefront API ist eine GraphQL-API für direkte Abfragen. Der Storefront MCP Server setzt auf dem MCP-Standard auf und ermöglicht KI-Assistenten strukturierten, werkzeuggestützten Zugriff auf dieselben Commerce-Daten, ohne dass die KI-Seite direkt GraphQL-Abfragen formulieren muss.

Shopify-Partner-Account, Shopify-App (Node.js empfohlen), Entwicklungsstore, MCP-kompatibler KI-Client oder eigene App-Integration.

Den Store-spezifischen MCP-Endpunkt https://{shop}.myshopify.com/api/mcp in der eigenen Shopify-App als MCP-Client konfigurieren. Für UCP-Katalog-Tools den Endpunkt https://{shop}.myshopify.com/api/ucp/mcp verwenden. Vollständige Anleitung: shopify.dev/docs/apps/build/storefront-mcp.

Kein Auth für öffentliche Storefront-Daten (Produkte, Richtlinien, Warenkorb). OAuth 2.0 mit PKCE für den Customer Accounts MCP Server (Bestellungen, Kundendaten).

Lesezugriff auf öffentliche Katalog- und Policydaten; Schreibzugriff auf Warenkörbe. Der Customer Accounts MCP Server erfordert Level-2-Schutz für Kundendaten (PII).

Der Server ist ein cloud-gehosteter, Store-spezifischer Endpunkt von Shopify. Abgerufene Commerce-Daten werden in Modellanfragen des KI-Clients eingebettet. Kundendaten im Customer Accounts MCP werden durch Shopify-Datenschutzrichtlinien und OAuth geschützt.

Storefront-Endpunkt: Niedriges Risikoprofil für öffentliche Daten. Customer Accounts MCP: Zugriff auf PII erfordert OAuth 2.0 und Shopify-Genehmigung. Abgerufene Daten fließen in Modellanfragen ein; verwendetes KI-Modell und Datenschutzrichtlinie prüfen.