Shopify MCP migreert naar UCP: migratiegids voor juni 2026

Wat er is veranderd in de Storefront Catalog MCP van Shopify

Shopify heeft de Storefront Catalog MCP officieel gemigreerd naar de Unified Commerce Platform (UCP). Dit is geen kleine update: de referentie-endpoint, de toolnamen en de request/response-schema's veranderen allemaal. Wie AI-assisted integraties of headless-architecturen heeft gebouwd die afhankelijk zijn van de oude MCP-tools, heeft een vaste deadline: 15 juni 2026.

Tot die datum blijven de oude tools actief, maar alle officiële Shopify-documentatie verwijst al naar de nieuwe versie. Wachten betekent dat u een migratie onder tijdsdruk moet uitvoeren, met alle operationele risico's van dien.

---

De nieuwe UCP-tools: namen, functies en verschillen

Het nieuwe MCP-oppervlak biedt drie hoofdtools met opnieuw gedefinieerde namen en gedragingen ten opzichte van de vorige versie.

search_catalog

Vervangt de oude tool search. Voert zoekopdrachten uit in de productcatalogus met ondersteuning voor:

• gestructureerde filters op attribuut, categorie en beschikbaarheid
• native paginering van resultaten
• koperscontext (buyer context), nuttig voor het personaliseren van resultaten op basis van markt, valuta of segment

lookup_catalog

Vervangt de oude tool lookup. Maakt batch-ophaling van producten of varianten mogelijk op basis van een of meer identificatoren. Dit is het juiste instrument wanneer u het product- of variant-ID al kent en gestructureerde gegevens wilt ophalen zonder een zoekopdracht uit te voeren.

get_product

Een nieuwe tool ten opzichte van de vorige versie. Geeft de volledige details van één product terug, inclusief variantselectie en beschikbaarheidssignalen (availability signals). Dit is het toegangspunt voor agents en integraties die een gedetailleerde productpagina moeten tonen of de logica voor variantselectie aan de AI-kant moeten afhandelen.

---

Het nieuwe referentie-endpoint

Het endpoint verandert ingrijpend. Het oude pad wordt vervangen door:

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

Alle MCP-aanroepen moeten naar dit pad worden omgeleid. Integraties die nog naar het oude endpoint verwijzen, blijven werken tot de deadline, maar profiteren niet van de updates en uitbreidingen die voor de UCP zijn gepland.

---

Waarom deze migratie verder gaat dan een technische opruiming

De overstap naar de UCP is niet alleen een naamswijziging. Shopify brengt alle contactpunten tussen AI-agents, headless integraties en de productcatalogus samen onder één uniform toegangsoppervlak. Dit heeft concrete architecturale gevolgen:

• Consistente schema's: één request/response-structuur voor alle integraties, ongeacht het kanaal
• Geïntegreerde koperscontext: de UCP biedt het concept van buyer context standaard aan, waardoor personalisaties mogelijk worden die voorheen extra lagen vereisten
• Schaalbaarheid voor AI-agents: de UCP-tools zijn ontworpen om te worden gebruikt door LLM-gebaseerde agents, met gestructureerde beschrijvingen die het vermogen van het model verbeteren om de juiste tool te selecteren

Wie AI-assisted architecturen voor de storefront overweegt of al heeft geïmplementeerd, moet de UCP beschouwen als de stabiele basis om op te bouwen, niet als een toekomstige bestemming.

---

Migratieplan: wat u nu moet doen

De migratie is technisch gezien beperkt van omvang, maar vereist aandacht voor de schema's. Dit zijn de operationele stappen:

1. Bestaande integraties controleren: nagaan of de applicatie de oude tools search en lookup gebruikt in MCP-aanroepen
2. Toolnamen bijwerken: search vervangen door search_catalog en lookup door lookup_catalog; bepalen waar get_product geïntegreerd moet worden
3. Endpoint migreren: het pad naar /api/ucp/mcp bijwerken in alle omgevingen (ontwikkeling, staging, productie)
4. Request/response-schema's herzien: elke tool call kan aanvullende of hernoemde parameters hebben; een regressietest op alle aanroepen is nodig vóór go-live
5. Interne documentatie bijwerken: als het team documentatie over de integraties bijhoudt, deze afstemmen voordat oude verwijzingen voor verwarring zorgen

Als u Shopify-integraties met AI-tools bouwt of onderhoudt, kunt u de ontwikkelaarsprijzen en ondersteuningsopties bekijken om te bepalen welke technische begeleiding beschikbaar is.

---

Deadline en operationeel risico

15 juni 2026 is de bevestigde deprecatiedatum. Na die datum worden de oude tools niet langer gegarandeerd ondersteund. Integraties die de migratie niet hebben voltooid, lopen het risico op serviceonderbrekingen zonder aanvullende voorafgaande kennisgeving.

Het beste moment om de migratie te starten is nu, terwijl de oude tools nog actief zijn en teams parallel kunnen testen zonder operationele tijdsdruk.