Shopify und das Universal Commerce Protocol: ein Entwicklerleitfaden

Von Shubham Vats, Gründer von Revize

Veröffentlicht am Aktualisiert am 8 Min. Lesezeit

Auf dieser Seite

Das Universal Commerce Protocol (UCP) ist ein offenes, versioniertes Protokoll für agentenbasierten Handel. Shopifys aktuelle Implementierung stellt UCP-konforme MCP-Server für Katalogsuche, Warenkörbe, Checkout und Bestellabläufe bereit. Entwickler können UCP bereits heute nutzen. Ein offenes Protokoll bedeutet jedoch nicht, dass jeder Agent oder Händler jede Fähigkeit unterstützt.

Hub verbindet KI-Agent, Geschäft, Zahlungen und Warenkorb als Symbol für UCP-Commerce

Das Gesamtbild: Was hat sich verändert?

Shopify und Google kündigten UCP am 11. Januar 2026 an. Das Protokoll entwickelt sich weiter; Shopifys aktuelle Agentendokumentation nutzt Agentenprofilbeispiele mit Version 2026-08-25. Am 13. Oktober 2026 kündigte Shopify außerdem Shop MCP an. Damit können kompatible Agenten über eine einzige MCP-Verbindung Shopify Catalog durchsuchen, Warenkörbe erstellen und Checkouts anlegen.

Für Shopify-Entwickler lautet die praktische Frage, welchen aktuellen Agentenablauf sie unterstützen müssen: Produktentdeckung, Warenkorberstellung, Checkout-Weiterleitung oder Bestellverfolgung. Prüfen Sie unterstützte Werkzeuge und Berechtigungen in der Shopify-Dokumentation, bevor Sie Händlern eine Funktion zusagen.

Was genau ist UCP?

UCP ist ein offenes Protokoll, das beschreibt, wie Agentenanwendungen und Handelssysteme Informationen austauschen und definierte Handelsaktionen ausführen können. Es ist versioniert und basiert auf Fähigkeiten: Eine Integration erklärt, was sie unterstützt, und ein Agent sollte nur diese Fähigkeiten nutzen.

Shopify implementiert UCP über MCP-Endpunkte und Werkzeuge. Je nach Endpunkt und Berechtigungen können Entwickler Katalogsuche, Warenkörbe, Checkout oder Bestellinformationen nutzen. Dies sind unterschiedliche Abläufe. Unterstützung für einen davon bedeutet nicht Unterstützung für jede weitere UCP-Fähigkeit.

UCP-Hub mit Verbindungen zu Roboter-, Shop-, Zahlungs- und Nutzerprofil-Symbolen

Rollen in einem agentenbasierten Handelsablauf

  • Agent oder Anwendung: Hilft Käufern, Produkte zu finden, einen Warenkorb zu erstellen oder den Checkout fortzusetzen.
  • Händlersystem: Liefert Produkt- und Checkout-Informationen und verarbeitet die Bestellung über seine unterstützte Shopify-Schnittstelle.
  • Anbieter von Zugangsdaten: Liefert Zahlungszugangsdaten oder Token über die für den Ablauf ausgehandelte Zahlungsmethode.
  • Zahlungsdienst: Verarbeitet die Zahlung über den Checkout oder die in diesem Ablauf verfügbare Zahlungsmethode.
  • Käufer: Prüft und autorisiert den Kauf. Beachten Sie die Bestätigungs- und Berechtigungsanforderungen des Ablaufs.

Das Problem: Warum der Handel ein Protokoll brauchte

Der Handel ist heute stark fragmentiert.

Betrachten Sie, was geschieht, wenn ein Kunde über einen KI-Assistenten etwas kaufen möchte:

Verworrene Handelsverbindungen im Vergleich zu einem geordneten Hub-Netzwerk für ein gemeinsames Protokoll

  • Die KI muss Produktinformationen in Händlerkatalogen finden
  • Sie muss Verfügbarkeit, Preise und Versandoptionen in Echtzeit verstehen
  • Sie muss Treueprogramme, Rabattcodes und Abonnementpräferenzen berücksichtigen
  • Sie muss Zahlungsinformationen sicher erfassen
  • Sie muss den Checkout mit allen besonderen Händleranforderungen abschließen
  • Schließlich muss sie Bestellverfolgung, Retouren und Kundenservice unterstützen

Eigene Integrationen verursachen Wartungsaufwand. UCP bietet gemeinsame Schemas und die Aushandlung von Fähigkeiten, was diesen Aufwand reduzieren kann. Zwei Implementierungen benötigen aber weiterhin kompatible Versionen, Fähigkeiten, Authentifizierung und Zahlungs-Handler. Protokollkompatibilität allein garantiert nicht, dass ein Agent einen Kauf abschließen kann.

UCP-Fähigkeiten, die Sie zuerst verstehen sollten

Checkout, Identitätsverknüpfung und Bestellstatus sind sinnvolle Einstiegspunkte in die UCP-Spezifikation. Shopify dokumentiert außerdem Katalog- und Warenkorbfähigkeiten. Jede Schnittstelle implementiert ihren eigenen unterstützten Umfang; prüfen Sie vor einem Werkzeugaufruf das ausgehandelte Profil.

Illustrierter Stapel mit den Schritten Produktentdeckung, Checkout und Bestellverfolgung

1. Checkout

Checkout erstellt und aktualisiert eine Kaufsitzung einschließlich Artikeln, Käuferdaten, Summen und Zahlungs-Handler. Der Händler bleibt der verantwortliche Verkäufer. Der Standardablauf übergibt den Käufer zur Zahlungsbestätigung an eine vertrauenswürdige Oberfläche; autonomer Abschluss hängt von unterstützten Autorisierungserweiterungen und der konkreten Integration ab.

2. Identitätsverknüpfung

Identitätsverknüpfung nutzt OAuth 2.0, damit Käufer einen Agenten zum Handeln in ihrem Namen autorisieren können. Dies kann kontospezifische Funktionen wie gespeicherte Adressen oder Bestellverlauf unterstützen. Öffentliche Katalogsuche kann ohne Identitätsverknüpfung funktionieren; Autorisierung ist deshalb eine separate Fähigkeits- und Berechtigungsentscheidung.

3. Bestellung

Die Bestellfähigkeit teilt Bestellstatus und Lebenszyklusereignisse wie Fulfillment, Retouren und Rückerstattungen. Sie ist keine allgemeine API zur Bestellbearbeitung. Shopifys aktueller Order MCP und die APIs für Käuferanfragen zu Änderungen haben eigene dokumentierte Zuständigkeitsbereiche und Grenzen, die unten beschrieben werden.

Die technische Architektur: für Weiterentwicklung ausgelegt

UCP nutzt Profile, um Protokollversion und unterstützte Fähigkeiten zu deklarieren. Unternehmen und Agenten handeln für eine Sitzung ihre gemeinsamen Fähigkeiten aus; der Agent sollte nur diesen ausgehandelten Umfang nutzen. Shopifys Beispiele verwenden datumsbasierte Profilversionen. Entwickler sollten deshalb aktuelles Profil und Schema aus der aktuellen Dokumentation statt aus einem alten Beispiel übernehmen.

Mehrschichtiger Handelsdienst mit optionalen Funktionsmodulen zeigt die erweiterbare UCP-Architektur

Erweiterungen ergänzen optionale Details einer Grundfähigkeit, etwa Fulfillment oder Rabatte. Ein Unternehmen kann den grundlegenden Checkout ohne jede Erweiterung bereitstellen. Ein Agent muss prüfen, welche Erweiterungen die Gegenseite unterstützt, bevor er darauf baut. Siehe die UCP-Übersicht und Shopifys Anleitung zu Agentenprofilen.

Für Interoperabilität entwickelt

UCP ist für verschiedene Protokollanbindungen wie REST, MCP und A2A ausgelegt. Das beschreibt den übergeordneten UCP-Standard, ist aber kein Versprechen, dass eine Shopify-Implementierung jede Fähigkeit über jeden Transportweg bereitstellt.

UCP-Kern mit Verbindungen zu MCP, A2A, AP2 und REST im übergeordneten Protokollökosystem

Shopifys aktuelle Entwicklerdokumentation beschreibt UCP-konforme MCP-Server und deren unterstützte Werkzeuge. Prüfen Sie für eine Integration genauen Endpunkt, Authentifizierungsmethode, Profilversion und erforderliche Käuferbestätigung. Leiten Sie aus einer Fähigkeit in der UCP-Spezifikation nicht ab, dass sie bereits über eine bestimmte Shopify-MCP-Schnittstelle verfügbar ist.

Shopifys aktuelle UCP- und MCP-Schnittstellen

Shopifys Agentendokumentation beschreibt mehrere unterschiedliche Schnittstellen:

Katalogsuche

Catalog-MCP-Werkzeuge ermöglichen Agenten, Shopify Catalog zu durchsuchen und Produktdetails abzurufen. Shopifys Global Catalog MCP nutzt https://catalog.shopify.com/api/ucp/mcp; Shop MCP ist unter https://mcp.shop.com verfügbar und stellt Katalogsuche und Produktwerkzeuge bereit. Katalogsichtbarkeit und Ergebnisse hängen von aktuellen Produktdaten und der verwendeten Schnittstelle ab.

Warenkorberstellung und Checkout

Cart MCP kann einen Warenkorb erstellen und aktualisieren. Checkout MCP kann eine Checkout-Sitzung erstellen und verwalten und den Käufer dann für erforderliche eigene Schritte zur Storefront des Händlers weiterleiten. Shopify dokumentiert Checkout MCP als empfohlenen serverseitigen Ansatz; Checkout WebMCP ist für Agenten gedacht, die bereits im Browser des Käufers arbeiten. Einige Checkout-Arten und von Apps definierte Interaktionen werden von den Browserwerkzeugen nicht verarbeitet.

Shop MCP ist eine separate Verbindung, die Shopify Catalog durchsuchen, Warenkörbe erstellen und Shop-Pay-Checkouts anlegen kann. Das bedeutet nicht, dass jeder Händler automatisch in jeder KI-App verfügbar ist.

Bestellinformationen

Shopifys Order MCP liest den aktuellen Zustand von Bestellungen, die über den Agenten aufgegeben wurden, einschließlich Fulfillment und Anpassungen nach dem Kauf. Das Werkzeug get_order dient vom Käufer angeforderten Ansichten und dem Abgleich. UCP-Bestell-Webhooks liefern fortlaufende Momentaufnahmen nach verbindlich gespeicherten Änderungen; ein Shopify-Partner-Manager muss den Zustellendpunkt registrieren. Dieser Lese- und Aktualisierungskanal führt keine beliebigen Bestelländerungen aus.

Separat ermöglichen Shopifys APIs für Käuferanfragen zu Bestelländerungen vom 1. Oktober 2026 die Anfrage zur Entfernung nicht erfüllter Positionen; Händler oder Apps können sie prüfen, erledigen oder ablehnen. Dieser eng begrenzte Anfrageablauf entspricht keiner Adressänderung oder einem Produktwechsel.

Was das für Shopify-Händler bedeutet

Laptop mit Agentic-Storefront-Einstellungen und verbundenen KI-Shoppingkanälen

Shopifys Agentenwerkzeuge können Produkt- und Checkout-Abläufe für kompatible Agenten verfügbar machen. Das Erlebnis hängt von der verwendeten Schnittstelle, den im Shop aktivierten Fähigkeiten und der Käuferautorisierung ab. Halten Sie Produktdetails, Verfügbarkeit und Richtlinien korrekt und prüfen Sie, welche Kanäle für Ihren Shop aktiviert sind.

Behandeln Sie dies als Integrationsschnittstelle, nicht als Garantie universeller KI-Platzierung oder des Zugriffs auf jeden Händler. Shopifys Übersicht zu Agentic Storefronts erklärt Kanalverfügbarkeit und den standardmäßigen Checkout über ChatGPT-Verweise.

Was das für Shopify-App-Entwickler bedeutet

Hand interagiert mit Commerce-Komponenten neben einem Monitor mit Code

UCP und Shopifys MCP-Werkzeuge geben App-Entwicklern definierte Schnittstellen. Bestimmen Sie vor dem Start die Käuferaufgabe, den Shopify-Endpunkt, erforderliches Agentenprofil und Berechtigungen sowie die Stellen, an denen der Käufer eine Aktion prüfen oder bestätigen muss.

Unterstützte Fähigkeiten implementieren

Nutzen Sie Shopifys aktuelle Agentendokumentation und Anleitungen für Endpunktermittlung, Authentifizierung, Warenkorb- und Checkout-Werkzeuge sowie Bestellverfolgung. Gehen Sie nicht davon aus, dass eine Drittanbieter-App ihre Funktionen für einen Agenten bereitstellen kann, nur weil UCP Erweiterungen unterstützt; prüfen Sie, ob App-Schnittstelle und Protokollfähigkeit implementiert sind.

Bestellbearbeitung separat behandeln

Shopifys Order MCP deckt Bestellinformationen und Lebenszyklusabläufe ab. Es führt keine beliebigen Änderungen wie Adresskorrekturen oder Produktwechsel aus. Die am 1. Oktober 2026 angekündigten APIs für Käuferanfragen zu Bestelländerungen beschränken sich auf Anfragen zur Entfernung nicht erfüllter Positionen mit Händler- oder App-Prüfung. Prüfen Sie für andere Kundenänderungen nach dem Kauf die aktuellen Funktionen und Berechtigungen der separaten App.

Was das für Agenturen bedeutet

Agenturteam plant eine UCP-Integration anhand eines Commerce-Diagramms

Agenturen können Händlern helfen, Produktdaten und Checkout-Einrichtung für die gewünschten Agentenschnittstellen vorzubereiten. Beginnen Sie mit aktueller Shopify-Dokumentation sowie tatsächlichem Tarif, App-Konfiguration, Produktdaten und Käuferreise des Händlers. Behandeln Sie Verfügbarkeit, Kundenreichweite und Conversion-Ergebnisse als je Händler zu messende Fragen statt als Protokollgarantien.

UCP neben anderen Protokollen für agentenbasierten Handel

UCP und das Agentic Commerce Protocol (ACP) sind separate Protokollvorhaben. Sie definieren unterschiedliche Schnittstellen und Abläufe. Entwickler sollten deshalb nicht annehmen, dass eine UCP-Integration automatisch mit ACP funktioniert oder umgekehrt. Prüfen Sie die aktuellen Spezifikationen und entwickeln Sie nur für die Agentenschnittstellen, die Ihr Produkt unterstützen soll.

Konzeptioneller Vergleich von UCP- und ACP-Plattformen mit einer Integrationsbrücke dazwischen

Die Brücke in dieser Illustration steht für zu prüfende Integrationsarbeit, nicht für eine bereits veröffentlichte Shopify-Interoperabilitätsfunktion.

Erste Schritte: praktischer Implementierungsleitfaden

Nutzen Sie Shopifys aktuelle Dokumentation zum agentenbasierten Handel als Ausgangspunkt. Sie enthält aktuelle Shopify-MCP-Schnittstellen, UCP-Profilbeispiele, Authentifizierungsdetails und Anleitungen. Shopify empfiehlt den AI-Toolkit-Schnellstart für eine geführte Einrichtung; Entwickler können auch einzelnen Anleitungen folgen.

Umsetzungspfad von der Spezifikationsprüfung über Sandbox-Arbeit und Tests bis zum Start

Schritt 1: Käuferaufgabe bestimmen

Entscheiden Sie, ob Ihre Anwendung Produkte suchen, Warenkörbe erstellen, Checkouts anlegen oder aktualisieren oder Informationen zum Bestelllebenszyklus lesen muss. Diese Aufgaben nutzen unterschiedliche Werkzeuge und Berechtigungen.

Schritt 2: Der aktuellen Shopify-Anleitung folgen

Verwenden Sie das aktuelle Agentenprofil und API-Beispiele aus Shopifys Dokumentation. Kopieren Sie keinen alten Endpunkt, keine Profilversion, kein Beispielrepository und keine Playground-URL, ohne zu prüfen, ob sie noch dokumentiert sind.

Schritt 3: Die vollständige Käuferreise testen

Nutzen Sie einen Entwicklungs-Shop und testen Sie Authentifizierung, zurückgegebene Nachrichten und Status, Checkout-Weiterleitung sowie erforderliche Käuferbestätigung. Testen Sie genau den Bestell- oder Checkout-Typ, den Sie unterstützen möchten; Shopify dokumentiert Fälle, die Browser-Checkout-Werkzeuge nicht verarbeiten.

Schritt 4: Integration auf verifizierte Fähigkeiten begrenzen

Deklarieren und fordern Sie nur die für den Ablauf benötigten Berechtigungen an. Machen Sie nicht unterstützte Schritte oder erforderliche Käuferbestätigungen deutlich und prüfen Sie das aktuelle Verhalten vor der Produktivbereitstellung.

Was als Nächstes kommt

Shopifys veröffentlichte Dokumentation deckt derzeit Katalogsuche, Warenkörbe, Checkout und Bestellinformationen über separate MCP-Abläufe ab. Shop MCP ergänzt eine Verbindung, mit der kompatible Agenten Shopify Catalog durchsuchen, Warenkörbe erstellen und Shop-Pay-Checkouts anlegen können. Künftige Protokollfunktionen und Einführungstermine gelten als unangekündigt, bis sie in der offiziellen Spezifikation oder im Shopify-Changelog erscheinen.

Prüfen Sie vor einer verbindlichen Planung Shopifys aktuelle Dokumentation für Profil, Endpunkt, Berechtigungen sowie Bestell- oder Checkout-Arten Ihrer Integration. Verfügbare Werkzeuge, Käuferbestätigungsanforderungen und unterstützte Checkout-Typen unterscheiden sich je Schnittstelle und können sich mit API-Aktualisierungen ändern.

Fazit

UCP gibt Entwicklern ein gemeinsames, sich weiterentwickelndes Protokoll für agentenbasierte Handelsabläufe. Shopifys aktuelle Werkzeuge decken Produktentdeckung, Warenkorb- und Checkout-Aufgaben sowie Informationen zum Bestelllebenszyklus ab, jeweils mit separaten Endpunkten, Berechtigungen und Grenzen.

Händler sollten prüfen, welche Schnittstellen aktiviert sind und welche Käuferreise sie unterstützen. App-Entwickler und Agenturen sollten der aktuellen Shopify-Dokumentation folgen, mit einem Entwicklungs-Shop testen und nicht den Eindruck erwecken, eine Integration könne Bestellungen bearbeiten oder Produkte auf jeder KI-Oberfläche listen, sofern das Ziel dies nicht unterstützt.

Entwickler betrachtet ein verbundenes Handelsnetzwerk bei der Planung einer Einführung

Häufig gestellte Fragen

Macht UCP jede Shopify-App für einen Agenten aufrufbar?

Eine App benötigt eine implementierte Schnittstelle, die Zielagent und Shopify-Schnittstelle unterstützen. Das Deklarieren einer Erweiterung oder die Nutzung eines offenen Standards allein stellt die App-Funktionen nicht bereit.

Kann Order MCP eine Adresse ändern oder ein Produkt austauschen?

Order MCP ruft den Zustand von Bestellungen ab, die über den Agenten aufgegeben wurden. Adressänderungen und Produktwechsel benötigen einen separaten Bearbeitungsablauf. Die vom Käufer angefragte Entfernung nicht erfüllter Artikel ist eine eigenständige API-Anfrage mit Händler- oder App-Prüfung.

Wie empfange ich UCP-Bestellupdates in Shopify?

Vereinbaren Sie die Webhook-Registrierung über Ihren Shopify-Partner-Manager, verarbeiten Sie eingehende Bestellmomentaufnahmen und nutzen Sie get_order, wenn Käufer aktuelle Informationen anfragen oder eine Zustellung abgeglichen werden muss.

Ist Shopifys standardmäßiger ChatGPT-Checkout ein direkter UCP-Checkout?

Shopifys standardmäßige ChatGPT-Agentic-Storefront leitet Käufer zum Onlineshop-Checkout des Händlers weiter. Andere aktivierte Kanäle und separate Agentenintegrationen können andere Checkout-Abläufe nutzen; prüfen Sie den von Ihnen implementierten Weg.

Was sollte ich vor der Bereitstellung einer UCP-Integration prüfen?

Prüfen Sie Endpunkt, ausgehandelte Protokollversion, Fähigkeiten, Berechtigungen, Authentifizierung und Käuferbestätigungsschritte. Testen Sie nicht verfügbare Produkte, Checkout-Weiterleitung und Bestellupdates mit dem gewählten Agenten vor der Veröffentlichung.

Ressourcen

Dieser Artikel gehört zu unserer Reihe „Über den Checkout hinaus“. Revizes App zur Bestellbearbeitung durch Kunden ermöglicht berechtigte Self-Service-Änderungen vor dem Fulfillment innerhalb eines vom Händler festgelegten Zeitfensters. Produktwechsel, zusätzliche Produkte, Rabattanwendung und Erstattungen als Shop-Guthaben erfordern Pro; die Bearbeitung durch Mitarbeitende ist in Entwicklung. Dieses Kundenportal ist von einer UCP-Agentenintegration getrennt.

Weiterführende Artikel

Statistiken zur Shopify-Bestellbearbeitung · Mit Shopify Agentic Storefronts über ChatGPT verkaufen · Leitfaden zu Shopify-MCP- und UCP-Endpunkten · Leitfaden zum Shopify AI Toolkit · Kunden Shopify-Bestellungen selbst bearbeiten lassen