Shopify MCP migrál UCP-re: migrációs útmutató 2026 júniusáig

Mi változott a Shopify Storefront Catalog MCP-ben

A Shopify hivatalosan áthelyezte a Storefront Catalog MCP-t az Unified Commerce Platformra (UCP). Ez nem kisebb frissítés: megváltozik a referencia endpoint, a toolok neve és a request/response sémák. Azoknak, akik AI-assisted integrációkat vagy headless architektúrákat építettek a régi MCP toolokra, pontos határidőjük van: 2026. június 15.

Addig a régi toolok aktívak maradnak, de a Shopify teljes hivatalos dokumentációja már az új verzióra mutat. A halogatás azt jelenti, hogy sürgősségi migrációval kell majd szembenézni, az azzal járó operatív kockázatokkal együtt.

---

Az új UCP toolok: nevek, funkciók és különbségek

Az új MCP felület három fő toolt tesz elérhetővé, amelyek nevei és viselkedése az előző verzióhoz képest újradefiniáltak.

search_catalog

A régi search tool utódja. Termékkeresést végez a katalógusban, az alábbi támogatással:

• strukturált szűrők attribútum, kategória és elérhetőség szerint
• natív eredménylap-ozás
• vevői kontextus (buyer context), amely hasznos az eredmények személyre szabásához piac, pénznem vagy szegmens alapján

lookup_catalog

A régi lookup tool utódja. Lehetővé teszi termékek vagy variánsok tömeges lekérését egy vagy több azonosító alapján. Ez a megfelelő eszköz, ha a termék- vagy variáns-azonosító már ismert, és strukturált adatokat kell visszakeresni keresés nélkül.

get_product

Az előző verzióhoz képest teljesen új tool. Egyetlen termék teljes részleteit adja vissza, beleértve a variáns kiválasztását és az elérhetőségi jelzéseket (availability signals). Ez a belépési pont olyan ügynökök és integrációk számára, amelyeknek részletes termékoldalt kell megjeleníteniük, vagy AI-oldalon kell kezelniük a variáns-kiválasztási logikát.

---

Az új referencia endpoint

Az endpoint lényegesen megváltozik. A régi path helyére ez lép:

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

Minden MCP-hívást erre a pathre kell átirányítani. Azok az integrációk, amelyek továbbra is a régi endpointra mutatnak, a határidőig működnek, de nem részesülnek az UCP számára tervezett frissítésekből és bővítésekből.

---

Miért számít ez a migráció a technikai átálláson túl is

Az UCP-re való áttérés nem csupán névváltozás. A Shopify egyetlen hozzáférési felület alá vonja össze az AI-ügynökök, headless integrációk és a termékkatalógus összes érintkezési pontját. Ennek konkrét architektúrális következményei vannak:

• Séma-konzisztencia: egyetlen request/response struktúra az összes integrációhoz, csatornától függetlenül
• Beépített vevői kontextus: az UCP natívan hozza magával a buyer context fogalmát, olyan személyre szabásokat engedve meg, amelyek korábban további rétegeket igényeltek
• Skálázhatóság AI-ügynökök számára: az UCP toolokat LLM-alapú ügynökök általi fogyasztásra tervezték, strukturált leírásokkal, amelyek javítják a modell képességét a megfelelő tool kiválasztásában

Azoknak, akik AI-assisted storefront architektúrákat értékelnek vagy már megvalósítottak, az UCP-t stabil alapként kell kezelniük, nem jövőbeli célállomásként.

---

Migrációs terv: mit kell tenni most

A migráció technikailag jól körülhatárolt, de figyelmet igényel a sémák terén. Íme a konkrét lépések:

1. Meglévő integrációk ellenőrzése: megvizsgálni, hogy az alkalmazás használja-e a régi search és lookup toolokat az MCP-hívásokban
2. Tool nevek frissítése: a search helyett search_catalog, a lookup helyett lookup_catalog használata; értékelni, hol érdemes beilleszteni a get_product toolt
3. Endpoint migrálása: a path frissítése /api/ucp/mcp-re minden környezetben (fejlesztői, staging, éles)
4. Request/response sémák felülvizsgálata: minden tool call-nak lehetnek további vagy átnevezett paraméterei; az élesbe állítás előtt regressziós tesztelés szükséges az összes hívásra
5. Belső dokumentáció frissítése: ha a csapat karbantartja az integrációs dokumentációt, azt még azelőtt frissíteni kell, hogy a régi hivatkozások zavart okozzanak

Ha Shopify integrációkat építesz vagy tartasz karban AI toolokkal, tekintsd meg a Shopify fejlesztői csomagokat a Barikreativán az elérhető technikai támogatás megismeréséhez.

---

Határidő és operatív kockázat

1. június 15. a megerősített elavulási dátum. Ezt követően a régi toolok működése nem garantált. Azok az integrációk, amelyek nem fejezik be a migrációt, további előzetes figyelmeztetés nélkül szolgáltatáskimaradást kockáztatnak.

A migráció megkezdésének legjobb ideje most van, amíg a régi toolok még aktívak, és a csapatok párhuzamosan tesztelhetnek operatív nyomás nélkül.