Shopify MCP migriert zu UCP: Migrationsleitfaden bis Juni 2026

Was sich im Shopify Storefront Catalog MCP geändert hat

Shopify hat den Storefront Catalog MCP offiziell zur Unified Commerce Platform (UCP) migriert. Dabei handelt es sich nicht um ein kleineres Update: Der Referenz-Endpoint, die Tool-Namen und die Request/Response-Schemata ändern sich grundlegend. Wer KI-gestützte Integrationen oder Headless-Architekturen auf Basis der alten MCP-Tools aufgebaut hat, steht vor einer klaren Frist: 15. Juni 2026.

Bis zu diesem Datum bleiben die alten Tools aktiv, doch die gesamte offizielle Shopify-Dokumentation verweist bereits auf die neue Version. Wer wartet, riskiert eine Notfall-Migration unter Zeitdruck – mit den damit verbundenen operativen Risiken.

---

Die neuen UCP-Tools: Namen, Funktionen und Unterschiede

Die neue MCP-Oberfläche bietet drei Haupt-Tools mit neu definierten Namen und Verhaltensweisen gegenüber der Vorgängerversion.

search_catalog

Ersetzt das alte Tool search. Führt Produktkatalogsuchen durch mit Unterstützung für:

• strukturierte Filter nach Attribut, Kategorie und Verfügbarkeit
• native Ergebnis-Paginierung
• Käuferkontext (buyer context), nützlich zur Personalisierung der Ergebnisse nach Markt, Währung oder Segment

lookup_catalog

Ersetzt das alte Tool lookup. Ermöglicht den Batch-Abruf von Produkten oder Varianten anhand eines oder mehrerer Bezeichner. Dies ist das richtige Tool, wenn die Produkt- oder Varianten-ID bereits bekannt ist und strukturierte Daten ohne Suche abgerufen werden sollen.

get_product

Ein gegenüber der Vorgängerversion neues Tool. Gibt die vollständige Detailansicht eines einzelnen Produkts zurück, einschließlich Variantenauswahl und Verfügbarkeitssignalen (availability signals). Es ist der Einstiegspunkt für Agenten und Integrationen, die eine detaillierte Produktseite darstellen oder die Variantenauswahl-Logik auf KI-Seite verwalten müssen.

---

Der neue Referenz-Endpoint

Der Endpoint ändert sich grundlegend. Der alte Pfad wird ersetzt durch:

`` https://{storedomain}/api/ucp/mcp ``

Alle MCP-Aufrufe müssen auf diesen Pfad umgeleitet werden. Integrationen, die weiterhin auf den alten Endpoint zeigen, funktionieren bis zum Ablaufdatum, profitieren jedoch nicht von den für die UCP geplanten Updates und Erweiterungen.

---

Warum diese Migration über eine technische Bereinigung hinausgeht

Der Wechsel zur UCP ist mehr als eine Namensänderung. Shopify vereinheitlicht unter einer einzigen Zugriffsoberfläche alle Berührungspunkte zwischen KI-Agenten, Headless-Integrationen und dem Produktkatalog. Dies hat konkrete architektonische Auswirkungen:

• Schema-Konsistenz: eine einzige Request/Response-Struktur für alle Integrationen, unabhängig vom Kanal
• Integrierter Käuferkontext: die UCP bringt das Konzept des Buyer Context nativ mit und ermöglicht Personalisierungen, die zuvor zusätzliche Schichten erforderten
• Skalierbarkeit für KI-Agenten: die UCP-Tools sind für den Einsatz durch LLM-basierte Agenten konzipiert, mit strukturierten Beschreibungen, die die Fähigkeit des Modells zur Tool-Auswahl verbessern

Wer KI-gestützte Architekturen für den Storefront bewertet oder bereits implementiert hat, sollte die UCP als stabilen Referenzrahmen betrachten, auf dem gebaut werden kann – nicht als zukünftiges Ziel.

---

Migrationsplan: Was jetzt zu tun ist

Die Migration ist technisch überschaubar, erfordert aber sorgfältige Aufmerksamkeit für die Schemata. Die operativen Schritte im Überblick:

1. Bestehende Integrationen prüfen: kontrollieren, ob die Anwendung die alten Tools search und lookup in MCP-Aufrufen verwendet
2. Tool-Namen aktualisieren: search durch search_catalog und lookup durch lookup_catalog ersetzen; prüfen, wo get_product sinnvoll integriert werden kann
3. Endpoint migrieren: den Pfad zu /api/ucp/mcp in allen Umgebungen aktualisieren (Entwicklung, Staging, Produktion)
4. Request/Response-Schemata überarbeiten: jeder Tool-Aufruf kann zusätzliche oder umbenannte Parameter aufweisen; ein Regressionstest aller Aufrufe ist vor dem Go-live erforderlich
5. Interne Dokumentation aktualisieren: falls das Team Integrationsdokumentation pflegt, diese aktualisieren, bevor alte Referenzen für Verwirrung sorgen

Wer Shopify-Integrationen mit KI-Tools aufbaut oder betreut, findet auf Barikreativa eine Übersicht der verfügbaren Entwicklerpläne und technischen Supportoptionen.

---

Frist und operatives Risiko

Der 15. Juni 2026 ist das bestätigte Deprecation-Datum. Nach diesem Datum sind die alten Tools nicht mehr garantiert. Integrationen, die die Migration nicht abgeschlossen haben, riskieren Dienstunterbrechungen ohne weitere Vorankündigung.

Der beste Zeitpunkt, die Migration zu starten, ist jetzt – solange die alten Tools noch aktiv sind und Teams parallel testen können, ohne unter operativem Druck zu stehen.