Shopify MCP migrace na UCP: průvodce migrací do června 2026

Co se změnilo ve Storefront Catalog MCP Shopify

Shopify oficiálně migroval Storefront Catalog MCP na Unified Commerce Platform (UCP). Nejde o drobnou aktualizaci: mění se referenční endpoint, názvy nástrojů i schémata request/response. Kdo vybudoval AI-assisted integrace nebo headless architektury spoléhající na staré MCP nástroje, má jasný termín: 15. června 2026.

Do té doby zůstávají staré nástroje aktivní, ale veškerá oficiální dokumentace Shopify již odkazuje na novou verzi. Čekání znamená zvládání migrace za krizových podmínek se všemi z toho plynoucími provozními riziky.

---

Nové nástroje UCP: názvy, funkce a rozdíly

Nová MCP plocha nabízí tři hlavní nástroje s přepracovanými názvy a chováním oproti předchozí verzi.

search_catalog

Nahrazuje starý nástroj search. Provádí vyhledávání v katalogu produktů s podporou:

• strukturovaných filtrů podle atributu, kategorie a dostupnosti
• nativní stránkování výsledků
• kontextu kupujícího (buyer context), který umožňuje přizpůsobit výsledky podle trhu, měny nebo segmentu

lookup_catalog

Nahrazuje starý nástroj lookup. Umožňuje dávkové načítání produktů nebo variant na základě jednoho či více identifikátorů. Je to správný nástroj, pokud již znáte ID produktu nebo varianty a chcete načíst strukturovaná data bez provádění vyhledávání.

get_product

Nový nástroj oproti předchozí verzi. Vrací kompletní detail jednoho produktu včetně výběru varianty a signálů dostupnosti (availability signals). Jde o přístupový bod pro agenty a integrace, které potřebují zobrazit detailní produktovou kartu nebo řídit logiku výběru varianty na straně AI.

---

Nový referenční endpoint

Endpoint se mění zásadním způsobem. Starý path je nahrazen:

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

Všechna MCP volání musí být přesměrována na tento path. Integrace, které nadále ukazují na starý endpoint, budou fungovat do termínu deprecace, ale nebudou těžit z aktualizací a rozšíření plánovaných pro UCP.

---

Proč tato migrace přesahuje rámec technické údržby

Přechod na UCP není jen přejmenování. Shopify sjednocuje pod jedinou přístupovou plochu všechny kontaktní body mezi AI agenty, headless integracemi a katalogem produktů. To má konkrétní architekturální dopady:

• Konzistence schémat: jediná struktura request/response pro všechny integrace bez ohledu na kanál
• Integrovaný kontext kupujícího: UCP nativně přináší koncept buyer context, který umožňuje personalizace dříve vyžadující další vrstvy
• Škálovatelnost pro AI agenty: nástroje UCP jsou navrženy pro konzumaci LLM-based agenty se strukturovanými popisy, které zlepšují schopnost modelu vybrat správný nástroj

Kdo zvažuje nebo již implementoval AI-assisted architektury pro storefront, musí UCP považovat za stabilní základ, na němž stavět, nikoli za vzdálenou destinaci.

---

Plán migrace: co dělat teď

Migrace je technicky ohraničená, ale vyžaduje pozornost věnovanou schématům. Zde jsou konkrétní kroky:

1. Ověřte stávající integrace: zkontrolujte, zda aplikace používá staré nástroje search a lookup v MCP voláních
2. Aktualizujte názvy nástrojů: nahraďte search za search_catalog a lookup za lookup_catalog; zvažte, kde zapojit get_product
3. Migrujte endpoint: aktualizujte path na /api/ucp/mcp ve všech prostředích (vývoj, staging, produkce)
4. Přezkumejte schémata request/response: každé volání nástroje může mít dodatečné nebo přejmenované parametry; před spuštěním do produkce je nezbytný regresní test všech volání
5. Aktualizujte interní dokumentaci: pokud tým udržuje dokumentaci integrací, slaďte ji dříve, než staré reference způsobí zmatek

Pokud budujete nebo spravujete Shopify integrace s AI nástroji, prohlédněte si plány pro vývojáře Shopify na Barikreativa a zjistěte, jaká technická podpora je k dispozici.

---

Termín a provozní riziko

1. června 2026 je potvrzené datum deprecace. Po tomto datu již nebudou staré nástroje garantovány. Integrace, které migraci nedokončí, riskují výpadky služby bez dalšího upozornění.

Nejlepší čas zahájit migraci je teď, dokud jsou staré nástroje stále aktivní a týmy mohou testovat paralelně bez provozního tlaku.