Shopify MCP prelazi na UCP: vodič za migraciju do lipnja 2026.

Što se promijenilo u Shopify Storefront Catalog MCP-u

Shopify je službeno migrirao Storefront Catalog MCP na Unified Commerce Platform (UCP). Nije riječ o manjoj nadogradnji: mijenjaju se referentni endpoint, nazivi alata i sheme request/response. Oni koji su izgradili AI-assisted integracije ili headless arhitekture koje se oslanjaju na stare MCP alate imaju jasan rok: 15. lipnja 2026.

Do tog datuma stari alati ostaju aktivni, ali cjelokupna službena Shopify dokumentacija već upućuje na novu verziju. Čekanje znači suočavanje s hitnom migracijom pod pritiskom, uz sve operativne rizike koje to nosi.

---

Novi UCP alati: nazivi, funkcije i razlike

Nova MCP površina izlaže tri glavna alata, s redefiniranim nazivima i ponašanjem u odnosu na prethodnu verziju.

search_catalog

Zamjenjuje stari alat search. Izvodi pretraživanje kataloga proizvoda uz podršku za:

• strukturirane filtre po atributu, kategoriji i dostupnosti
• nativnu paginaciju rezultata
• kontekst kupca (buyer context), koristan za personalizaciju rezultata prema tržištu, valuti ili segmentu

lookup_catalog

Zamjenjuje stari alat lookup. Omogućuje grupno dohvaćanje proizvoda ili varijanti na temelju jednog ili više identifikatora. Ispravan je izbor kada je ID proizvoda ili varijante već poznat i žele se dohvatiti strukturirani podaci bez izvođenja pretrage.

get_product

Nov alat koji nije postojao u prethodnoj verziji. Vraća potpune detalje jednog proizvoda, uključujući odabir varijante i signale dostupnosti (availability signals). To je pristupna točka za agente i integracije koje trebaju prikazati detaljnu karticu proizvoda ili upravljati logikom odabira varijante na strani AI-a.

---

Novi referentni endpoint

Endpoint se bitno mijenja. Stara putanja zamjenjuje se s:

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

Svi MCP pozivi moraju biti preusmjereni na ovu putanju. Integracije koje nastave koristiti stari endpoint funkcionirat će do isteka roka, no neće imati koristi od ažuriranja i proširenja predviđenih za UCP.

---

Zašto je ova migracija važnija od pukog tehničkog čišćenja

Prelazak na UCP nije samo promjena naziva. Shopify objedinjuje sve kontaktne točke između AI agenata, headless integracija i kataloga proizvoda pod jednu pristupnu površinu. To ima konkretne arhitekturalne posljedice:

• Dosljednost shema: jedna struktura request/response za sve integracije, neovisno o kanalu
• Integrirani kontekst kupca: UCP nativno donosi koncept buyer contexta, omogućujući personalizacije koje su prije zahtijevale dodatne slojeve
• Skalabilnost za AI agente: UCP alati dizajnirani su za korištenje od strane LLM-based agenata, s strukturiranim opisima koji poboljšavaju sposobnost modela da odabere ispravan alat

Oni koji razmatraju ili su već implementirali AI-assisted arhitekture za storefront trebaju UCP smatrati stabilnim temeljem na kojem grade, a ne udaljenim ciljem.

---

Plan migracije: što napraviti odmah

Migracija je tehnički ograničenog opsega, ali zahtijeva pažnju prema shemama. Evo operativnih koraka:

1. Provjeriti postojeće integracije: utvrditi koristi li aplikacija stare alate search i lookup u MCP pozivima
2. Ažurirati nazive alata: zamijeniti search s search_catalog i lookup s lookup_catalog; procijeniti gdje integrirati get_product
3. Migrirati endpoint: ažurirati putanju prema /api/ucp/mcp u svim okruženjima (razvoj, staging, produkcija)
4. Pregledati sheme request/response: svaki tool call može imati dodatne ili preimenovane parametre; regresijsko testiranje svih poziva nužno je prije go-livea
5. Ažurirati internu dokumentaciju: ako tim održava dokumentaciju integracija, uskladiti je prije nego što stare reference počnu stvarati zabunu

Ako gradite ili održavate Shopify integracije s AI alatima, pogledajte planove za developere na Barikreativi kako biste procijenili dostupnu tehničku podršku.

---

Rok i operativni rizik

1. lipnja 2026. potvrđeni je datum deprecacije. Nakon tog datuma stari alati više neće biti zajamčeni. Integracije koje ne dovrše migraciju riskiraju prekide usluge bez dodatne najave.

Najbolje je pokrenuti migraciju odmah, dok su stari alati još aktivni i timovi mogu testirati paralelno bez operativnog pritiska.