Shopify MCP migra do UCP: przewodnik po migracji do czerwca 2026

Co się zmieniło w Shopify Storefront Catalog MCP

Shopify oficjalnie przeniósł Storefront Catalog MCP na Unified Commerce Platform (UCP). To nie jest drobna aktualizacja: zmieniają się endpoint, nazwy narzędzi oraz schematy request/response. Zespoły, które zbudowały integracje wspomagane przez AI lub architektury headless opierające się na starych narzędziach MCP, mają wyraźny termin: 15 czerwca 2026.

Do tej daty stare narzędzia pozostają aktywne, jednak cała oficjalna dokumentacja Shopify wskazuje już na nową wersję. Czekanie oznacza konieczność przeprowadzenia migracji w trybie awaryjnym, wraz z wynikającym z tego ryzykiem operacyjnym.

---

Nowe narzędzia UCP: nazwy, funkcje i różnice

Nowa powierzchnia MCP udostępnia trzy główne narzędzia, których nazwy i działanie zostały przedefiniowane w stosunku do poprzedniej wersji.

search_catalog

Zastępuje stare narzędzie search. Umożliwia przeszukiwanie katalogu produktów z obsługą:

• strukturalnych filtrów według atrybutu, kategorii i dostępności
• natywnej paginacji wyników
• kontekstu kupującego (buyer context), przydatnego do personalizacji wyników w zależności od rynku, waluty lub segmentu

lookup_catalog

Zastępuje stare narzędzie lookup. Umożliwia wsadowe pobieranie produktów lub wariantów na podstawie jednego lub wielu identyfikatorów. To właściwe narzędzie, gdy ID produktu lub wariantu jest już znane i chcemy pobrać dane strukturalne bez wykonywania wyszukiwania.

get_product

Nowe narzędzie nieobecne w poprzedniej wersji. Zwraca pełne szczegóły pojedynczego produktu, w tym wybór wariantu oraz sygnały dostępności (availability signals). Jest to punkt dostępu dla agentów i integracji, które muszą wyświetlać szczegółową kartę produktu lub obsługiwać logikę wyboru wariantu po stronie AI.

---

Nowy endpoint

Endpoint zmienia się w istotny sposób. Stara ścieżka zostaje zastąpiona przez:

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

Wszystkie wywołania MCP muszą być przekierowane na tę ścieżkę. Integracje nadal wskazujące stary endpoint będą działać do upływu terminu, ale nie skorzystają z aktualizacji i rozszerzeń przewidzianych dla UCP.

---

Dlaczego ta migracja ma znaczenie wykraczające poza porządkowanie techniczne

Przejście na UCP to nie tylko zmiana nazewnictwa. Shopify unifikuje pod jedną powierzchnią dostępu wszystkie punkty styku między agentami AI, integracjami headless a katalogiem produktów. Ma to konkretne implikacje architektoniczne:

• Spójność schematów: jedna struktura request/response dla wszystkich integracji, niezależnie od kanału
• Zintegrowany kontekst kupującego: UCP natywnie wprowadza koncepcję buyer context, umożliwiając personalizację, która wcześniej wymagała dodatkowych warstw
• Skalowalność dla agentów AI: narzędzia UCP są zaprojektowane z myślą o konsumpcji przez agentów opartych na LLM, ze strukturalnymi opisami poprawiającymi zdolność modelu do wyboru właściwego narzędzia

Zespoły, które oceniają lub już wdrożyły architektury wspomagane przez AI dla storefrontu, powinny traktować UCP jako stabilny fundament, na którym należy budować — nie jako odległy cel.

---

Plan migracji: co zrobić już teraz

Migracja jest technicznie ograniczona w zakresie, ale wymaga szczególnej uwagi przy schematach. Oto kroki operacyjne:

1. Zweryfikuj istniejące integracje: sprawdź, czy aplikacja korzysta ze starych narzędzi search i lookup w wywołaniach MCP
2. Zaktualizuj nazwy narzędzi: zastąp search przez search_catalog, a lookup przez lookup_catalog; oceń, gdzie warto zintegrować get_product
3. Zmigruj endpoint: zaktualizuj ścieżkę na /api/ucp/mcp we wszystkich środowiskach (development, staging, produkcja)
4. Przejrzyj schematy request/response: każde wywołanie narzędzia może mieć dodatkowe lub zmienione parametry; przed wdrożeniem produkcyjnym konieczne jest przeprowadzenie testów regresji wszystkich wywołań
5. Zaktualizuj dokumentację wewnętrzną: jeśli zespół utrzymuje dokumentację integracji, uaktualnij ją, zanim stare odwołania zaczną powodować nieporozumienia

Jeśli budujesz lub utrzymujesz integracje Shopify z narzędziami AI, zapoznaj się z planami dla deweloperów Shopify na Barikreativa, aby ocenić dostępne wsparcie techniczne.

---

Termin i ryzyko operacyjne

15 czerwca 2026 to potwierdzony termin deprecacji. Po tej dacie stare narzędzia nie będą już objęte gwarancją działania. Integracje, które nie ukończą migracji, narażone są na przerwy w działaniu usługi bez dodatkowego ostrzeżenia.

Najlepszy moment na rozpoczęcie migracji jest teraz — gdy stare narzędzia są jeszcze aktywne, a zespoły mogą testować równolegle bez presji operacyjnej.