Shopify hat Shop MCP am 13. Oktober eingeführt. Damit erhalten Entwickler eine gehostete Verbindung für Produktsuche, Warenkörbe und Checkout. Der Dienst ist unter https://mcp.shop.com/ erreichbar. Seine 17 Tools können Produkte im Shopify Catalog finden und einen Checkout beim Händler öffnen, der einen Artikel verkauft. Für die Katalogsuche ist kein API-Schlüssel nötig. Einen tatsächlichen Kauf muss weiterhin der Käufer genehmigen.

Dieser Leitfaden richtet sich an Entwickler, die einen MCP-kompatiblen Assistenten einrichten. Die folgenden Schritte entsprechen der am 14. Oktober geprüften Shopify-Dokumentation. BIG CHANGE hat keinen Agent verbunden, keinen Warenkorb angelegt und keinen Kauf getätigt. Der Leitfaden beschreibt daher erwartete Ergebnisse, keine beobachtete Leistung.

Die wichtigste Änderung

  • Was sich geändert hat: Shopify bietet jetzt eine gehostete MCP-Verbindung, die von der Katalogsuche über den Händler-Warenkorb bis zum Checkout reicht. Außerdem dokumentiert Shopify den Abschluss mit Shop Pay für angemeldete Käufer nach einer ausdrücklichen Bestätigung.
  • Wer es nutzen kann: Entwickler mit einem MCP-Client, der Protokollversion 2026-07-28 unterstützt, oder mit Code für die dokumentierten HTTP-Aufrufe. Ein älterer Client, der nur den initialize-Handshake nutzt, kann sich nicht direkt verbinden.
  • Was zu prüfen ist: Ein Checkout ist eine Transaktion mit genau einem Händler. completed zusammen mit einer order bestätigt den Kauf; ein Warenkorb, ein Checkout-Link oder eine laufende Zahlung tun das nicht.

Vor dem Verbinden

Sie benötigen einen MCP-Client, der entfernte HTTP-Server und die von Shopify dokumentierte Verbindungsmethode unterstützt, oder eine App, die den Server per HTTP aufruft. Verwenden Sie die Basis-URL https://mcp.shop.com/; mit /mcp erhalten Sie einen 404-Fehler. Such- und Warenkorb-Tools funktionieren ohne Shop-Konto. Nach der Anmeldung kann der Assistent gespeicherte Einstellungen und Adressen nutzen, Bestellungen finden und Shop Pay anbieten, sofern der Händler es unterstützt. Für einen Assistenten mit eigenem HTTP-Code dokumentiert Shopify einen OAuth-Geräteablauf, den der Käufer auf der Shop-Website genehmigt.

Legen Sie vor der Suche eine Produktanfrage, das Zielland und die Währung fest. Trennen Sie ausdrücklich genannte Anforderungen des Käufers vom Suchkontext: Land oder Währung helfen bei der Lokalisierung; Preisobergrenze, Größe oder Lieferziel sind Filter. Die API gibt Preise in Untereinheiten der Währung an. Ihre App sollte das Antwortfeld messages auswerten, bevor sie behauptet, ein Ergebnis erfülle einen Filter, denn der Dienst kann melden, dass ein Filter nicht wie gewünscht angewendet wurde. Shopifys Suchleitfaden erläutert den Unterschied und das Limit von 1 bis 50 Ergebnissen pro Seite.

Ein dokumentierter Weg von der Suche zur Bestellung

  1. Verbindung herstellen und Suche prüfen. Richten Sie den Client mit https://mcp.shop.com/ ein und laden Sie Shopifys Shop skill, sofern der Client ihn unterstützt. Shopify empfiehlt, die Verbindung mit einer Suche nach drei Schreibtischlampen zu testen, ohne einen Warenkorb zu erstellen. Eine funktionierende Suche liefert Produkte mit Händler, Preis in einer angegebenen Währung und Händler-Link. Entwickler, die HTTP nutzen, können Shopifys JSON-RPC-Schnellstart mit den erforderlichen Protokoll-Headern und der search_catalog-Anfrage verwenden. Dies ist eine schreibgeschützte Prüfung und erfordert keine Anmeldung.
  2. Den passenden Artikel auswählen. Führen Sie search_catalog mit der Anfrage und den Anforderungen des Käufers aus. Die Suche liefert eine hervorgehobene Variante; möchte der Käufer eine andere Größe oder Farbe, verwenden Sie get_product. Vergleichen Sie product.selected und die zurückgegebene variant.options vor der Anzeige oder dem Kauf mit jeder vom Käufer gewünschten Größe, Farbe und sonstigen Auswahl. Shopify weist darauf hin, dass die Auswahl ohne Warnung gelockert werden kann. Wählt der Käufer ein Produkt aus oder ändert eine Option, rufen Sie get_product erneut auf, um aktuelle Verfügbarkeit und Preis zu prüfen. Übernehmen Sie die Varianten-ID und die Händler-Domain exakt. Gehen Sie nicht davon aus, dass der Händler einen zuvor angezeigten Preis einhält. Zeigen Sie Warnungen direkt beim betreffenden Produkt an. Diese Prüfungen sind unter Produkte finden dokumentiert.
  3. Einen Warenkorb nur auf Wunsch erstellen. Wenn der Käufer Sie anweist, Artikel zusammenzustellen, rufen Sie für den ausgewählten Händler und die Variante create_cart auf. Ein Warenkorb speichert Artikel, löst aber keine Bestellung aus. Halten Sie Artikel verschiedener Verkäufer in getrennten Warenkörben: Laut Shopify gehört jeder Warenkorb und Checkout zu genau einem Händler. Das Ergebnis sollte die Warenkorb-ID und seine Positionen enthalten. Möchte der Käufer nur stöbern, beenden Sie den Ablauf nach der Suche; Shopifys Warenkorbhinweisestellen klar, dass Interesse an einem Produkt allein keine Erlaubnis zum Erstellen eines Warenkorbs ist.
  4. Checkout öffnen und prüfen. Fragt der Käufer nach dem Gesamtpreis oder ist er kaufbereit, rufen Sie create_checkout mit der Warenkorb-ID oder der exakten Varianten-ID und Händler-Domain aus der Suche auf. Das Checkout-Dokument sollte ID, Status, Positionen, Währung, Summen, Zahlungsmethoden, messages, Händlerrichtlinie links und einen continue_url für die Händlerseite enthalten. Zeigen Sie dem Käufer vor dem Fortfahren die aktuellen Summen samt Bezeichnungen einschließlich Versand und Steuern, alle Warnungen und Richtlinien-Links. Erläuterungen gehören direkt zum betreffenden Artikel oder Feld. Geben Sie dem Käufer den unveränderten continue_url einschließlich seiner Abfrageparameter zusammen mit den abgedeckten Artikeln, auch wenn der Agent den Checkout abschließen kann. Der Checkout kann incomplete sein, wenn eine Adresse benötigt wird, oder requires_escalation, wenn der Käufer auf der Händlerseite abschließen muss. Shopify zufolge läuft ein Checkout standardmäßig nach sechs Stunden ab.
  5. Die Zahlung bleibt Sache des Käufers. Nach der Anmeldung kann der Checkout gespeicherte Adressen und Shop Pay anbieten. Lesen Sie vor dem Aufruf von complete_checkout den neuesten Checkout, bestätigen Sie den Status ready_for_complete, zeigen Sie Händler, Artikel, Mengen, Gesamtbetrag und verfügbare Methoden an und lassen Sie den Käufer eine Zahlungsmethode wählen. Wählen Sie nicht für ihn. Halten Sie den unveränderten continue_url des Händlers für den Käufer bereit, auch wenn der Agent den Checkout abschließen kann; ist kein Zahlungsinstrument verfügbar, muss der Käufer diesen Link verwenden. Shopifys Checkout-Anleitung besagt, dass complete_checkout nach der Zustimmung einmal gesendet und danach der zurückgegebene Status geprüft werden soll. Ein separater Zustimmungsablauf für Shops außerhalb von Shopify lässt den Käufer die Zahlung in Shop genehmigen und eine Karte für den eigenen Checkout des Shops bereitstellen; das ist nicht der Shopify-Händler-Checkout aus Schritt 3 und 4.
  6. Das Ergebnis prüfen. Nur status: completed mit einer order bestätigt, dass der Händler eine Bestellung angelegt hat. Wird die Zahlung noch verarbeitet, lesen Sie den Status mit get_checkout erneut aus. Shopify zufolge gibt es zum Start keine Webhooks; eine Integration muss daher get_checkout auf Aktualisierungen abfragen. Läuft ein Abschlussaufruf in ein Timeout oder ist die Antwort unklar, senden Sie ihn nicht erneut und öffnen Sie keinen Ersatz-Checkout. Lesen Sie den vorhandenen Checkout aus. Zeigt er nicht sowohl completed als auch order, teilen Sie dem Käufer mit, dass der Kauf unbestätigt ist, und geben Sie ihm continue_url.

Grenzen und Wiederherstellung

Laut Shopify funktioniert die Suche ohne Zugangsdaten. Die Einführungsmitteilung verweist Entwickler, die höhere Ratenlimits benötigen, auf einen API-Schlüssel im Shopify Dev Dashboard, nennt aber weder einen öffentlichen Preis noch eine Ratenlimit-Tabelle für diesen Schlüssel. Preise der Händlerartikel, Versand und Steuern stammen aus dem aktuellen Checkout; der Käufer sollte sie vor der Zahlung prüfen. Ein Agent kann außerdem eigene Hosting- oder Modellkosten verursachen, wenn der Entwickler solche Dienste nutzt. Die Ankündigung beziffert diese Kosten nicht.

Ein fehlgeschlagener Leseaufruf kann nach einer angegebenen retry_after Verzögerung wiederholt werden. Für das Erstellen oder Aktualisieren von Warenkörben und Checkouts empfiehlt Shopifys Fehlerleitfaden einen Idempotenzschlüssel und das Lesen der vorhandenen Ressource, bevor ein unsicherer Schreibvorgang wiederholt wird. Scheitert ein Erstellungsaufruf ohne Schlüssel, bevor er eine ID zurückgibt, ist das Ergebnis unbekannt; legen Sie nicht auf Verdacht einen zweiten an. complete_checkout ist strenger: Nach einer unklaren Antwort darf der Aufruf nie wiederholt werden. Die Händlerseite bleibt der Weg für den Käufer, wenn requires_escalation oder fehlende Zahlungsinformationen den Abschluss durch den Agent verhindern.

Behandeln Sie Checkout-IDs, Checkout-Links, Zugriffstoken und Zahlungsinstrumente als vertraulich. Shopify zufolge enthalten Checkout-ID und continue_url Zugriffsschlüssel; protokollieren Sie sie daher nicht und teilen Sie den Link nur mit dem Käufer. Die Authentifizierungsreferenz sagt, ein Shop-Token nur im Authorization-Header an https://mcp.shop.com/ zu senden. Ein Zahlungsinstrument kann Zugangsdaten enthalten; geben Sie es weder aus noch protokollieren Sie es.

BIG CHANGE hat zuvor Shopifys Checkout-Tools für Browser-Agenten behandelt. Diese gehostete MCP-Version beschreibt einen anderen Ablauf, der mit der Katalogsuche beginnt. Shopifys Versionshinweis und Handbücher erläutern, welche Aufrufe Entwickler nutzen und welche Antworten sie prüfen können; sie belegen weder höhere Conversion noch Zuverlässigkeit unter Last oder einen erfolgreichen Kauf durch BIG CHANGE.

Quellen und weiterführende Informationen