Shopify MCP en UCP in 2026: actuele endpoints en hun functies

Shopify MCP omvat meerdere interfaces met verschillende doelen. De Storefront MCP-migratiegids van Shopify koppelt de vroegere catalogus- en winkelwagentools aan UCP, met behoud van de beleids-/FAQ-tool en Customer Accounts MCP. Kies een interface op basis van de taak van de koper en controleer daarna het schema en de autorisatie. Deze gids legt ook uit waar een klantgerichte workflow voor bestelwijzigingen na aankoop past.

De technische basis in het kort#

MCP (Model Context Protocol) is een toolinterface die AI-clients gebruiken. De actuele commercedocumentatie van Shopify beschrijft ook UCP-endpoints (Universal Commerce Protocol) voor catalogusontdekking, checkout en besteltoegang. Een client moet het actuele schema, de authenticatie en machtigingen van het endpoint gebruiken; endpointnamen en mogelijkheden zijn niet uitwisselbaar.

De Storefront Catalog-documentatie vermeldt search_catalog, lookup_catalog en get_product en vereist het agentprofiel in meta.ucp-agent.profile. Checkout en Order MCP hebben andere toegangsregels en ondersteunde bewerkingen. Bekijk onze Shopify Catalog MCP-gids voor de ontdekkingstools en hun beperkingen.

Ons advies: bouw op het actuele gedocumenteerde endpoint#

Koppel oude integraties tool voor tool: productontdekking gebruikt Storefront Catalog, winkelwagenbewerkingen gebruiken Cart MCP en checkout gebruikt Checkout MCP. Houd beleidsvragen op /api/mcp. Test het verzoekschema en de toegangsregels van elke vervanger in een ontwikkelomgeving voordat je verkeer omzet.

Het catalogusendpoint kan productontdekking ondersteunen, maar bewijst op zichzelf niet dat een agent een checkout kan maken, een bestelling van een koper kan lezen of wijzigen. Dat zijn afzonderlijke workflows. Dev MCP van de AI Toolkit is voor ontwikkelaars en staat los van commerce-endpoints voor kopers.

Wat een AI-agent daadwerkelijk in je winkel doet#

De volgorde hangt af van de agent en de Shopify-interface die deze gebruikt. Een catalogusverzoek kan productgegevens zoeken of ophalen. Een checkoutproces kan authenticatie of een ondertekend verzoek vereisen en de koper doorsturen om de aankoop te bekijken of af te ronden. Order MCP van Shopify documenteert get_order voor ondersteunde, door agents geïnitieerde bestellingen; het is geen algemene bestelgeschiedenis-API over kanalen heen. Lees de reikwijdte van elk endpoint voordat je het aan klantenservice of orderafhandeling koppelt.

Geauthenticeerde klanttoegang is een afzonderlijke integratie#

Met Customer Accounts MCP kan een assistent bestelgegevens, status en accountvoorkeuren van de ingelogde klant voor die winkel afhandelen. Vind mcp_api via https://{shop}/.well-known/customer-account-api en authenticeer daarna met OAuth 2.0-authorization code en PKCE. De inrichting vereist een aangepast domein, klantauthenticatieconfiguratie en passende toegang tot beschermde klantgegevens. Gebruik na authenticatie tools/list om de daadwerkelijke tools en schema’s te inspecteren; ga niet uit van willekeurige wijzigingen of accounttoegang bij meerdere merchants.

Order MCP gebruikt daarentegen agentreferenties om bestellingen te lezen die via die agent zijn geplaatst. De bestelwebhookgids van Shopify beschrijft UCP-levenscyclusupdates en registratie aan Shopify-zijde via een partnermanager. Onze gids voor operationeel beheer van Shopify-bestellingen via agents behandelt aflevering en reconciliatie.

Het proces na aankoop staat apart#

Een productontdekkings- of checkoutendpoint biedt geen algemene bestelbewerkingsoperatie. De actuele Order MCP-documentatie van Shopify beschrijft het lezen van de status van ondersteunde, door agents geïnitieerde bestellingen; ze bewerkt die niet. Dat onderscheid is belangrijk als een klant na de checkout een adres, aantal of variant moet corrigeren.

Een winkel hoort klanten een route te bieden voor wijzigingen die volgens beleid en afhandelingsstatus in aanmerking komen. De klantgerichte bestelbewerkingsapp van Revize ondersteunt selfservicewijzigingen van adres, aantal, variant en annulering vóór de orderafhandeling tijdens de door de merchant ingestelde periode. Tussen producten wisselen, producten toevoegen, kortingen toepassen en terugbetalingen als winkeltegoed zijn Pro-functies. Het portaal vereist het Revize-appblok op de orderstatuspagina en is ook toegankelijk via de e-maillink Edit Order. Bekijk onze Shopify-gids voor bestelbewerking voor de workflow en beperkingen van de standaardeditor.

Wat Shopify vandaag documenteert#

Dit zijn de gedocumenteerde mogelijkheden die je aan de actuele Shopify-referenties moet toetsen:

• Winkelspecifieke catalogusontdekking via het UCP-endpoint, met gedocumenteerde catalogustools en een agentprofiel.
• Een afzonderlijk Global Catalog-endpoint voor bredere productontdekking.
• Checkout MCP met eigen authenticatie- of ondertekende-verzoekvereisten en mogelijke overdracht aan de koper.
• Order MCP met een tool get_order voor ondersteunde, door agents geïnitieerde bestellingen.
• Customer Accounts MCP voor geautoriseerde klantspecifieke verzoeken en de beleids-/FAQ-tool voor openbare winkelvragen.
• Een lokale ontwikkelaarstoolset via Shopify AI Toolkit en Dev MCP.

Een endpointnaam op zichzelf bewijst geen onbeperkte winkeltoegang, universele klantaccountgeschiedenis of bestelbewerkingsmachtigingen. Gebruik het gedocumenteerde bereik van elke interface. Onze Shopify AI Toolkit-gids legt de ontwikkelaarstools afzonderlijk uit.

Wat wij dit kwartaal zouden doen#

1. Kies het endpoint op basis van de taak. Gebruik de actuele Storefront Catalog-documentatie voor productontdekking, Checkout MCP voor checkout en Order MCP voor ondersteunde bestellezingen.
2. Controleer profiel- en toegangseisen. Storefront Catalog-verzoeken bevatten meta.ucp-agent.profile; controleer de precieze eisen voor elk ander endpoint afzonderlijk.
3. Test in een ontwikkelomgeving. Valideer verzoekschema, geretourneerde velden, authenticatie en overdracht aan de koper voordat je een klantgerichte lancering plant.
4. Controleer het proces na aankoop apart. Zorg dat klanten een route hebben om geschikte bestelwijzigingen te bekijken of aan te vragen; verwacht niet dat MCP een afgeronde bestelling bewerkt.
5. Controleer de documentatie opnieuw vóór uitrol. Shopify-agent-API’s en clientondersteuning kunnen veranderen; gebruik actuele primaire documentatie in plaats van gekopieerde voorbeelden.

De conclusie#

Bepaal welke gegevens de client nodig heeft en wiens autorisatie toegang geeft. Catalogusontdekking, checkout, openbare beleidsantwoorden, klantaccounts en het lezen van via agents geplaatste bestellingen hebben afzonderlijke afspraken. Onze ontwikkelaarsgids voor Universal Commerce Protocol legt uit hoe mogelijkheden onder de UCP-interfaces worden onderhandeld.

Houd als merchant klantenservice en bestelbewerking na aankoop expliciet in het ontwerp. De gedocumenteerde Order MCP van Shopify kan ondersteunde, door agents geïnitieerde bestellingen lezen; deze biedt geen algemeen bestelbewerkingsproces. Een klantportaal, merchantbeleid en afhandelingsgrens blijven afzonderlijke aandachtspunten.

Veelgestelde vragen#

Wat is het actuele Shopify MCP-endpoint?#

Gebruik /api/ucp/mcp voor Storefront Catalog en de gedocumenteerde winkelwagen- en checkouttools. Openbare beleidsvragen blijven op /api/mcp; geauthenticeerde klantverzoeken gebruiken het ontdekte Customer Accounts MCP-endpoint. Kies het endpoint dat de specifieke taak ondersteunt.

Welk Shopify-endpoint moet ik voor productontdekking gebruiken?#

Gebruik het gedocumenteerde winkelspecifieke catalogusendpoint voor de catalogus van één merchant of het afzonderlijke Global Catalog-endpoint van Shopify voor bredere ontdekking. Bekijk het catalogusoverzicht voor actuele tools en verzoekvereisten.

Wat is UCP?#

UCP is het open commerceprotocol van Shopify voor gedocumenteerde interacties tussen agents, merchants, credentialproviders en betaalproviders. Gebruik de endpointspecifieke referenties omdat ontdekking, checkout en besteloperaties niet één universeel machtigingsmodel delen.

Heb ik een agentprofiel nodig?#

De Storefront Catalog-documentatie vereist het profiel in meta.ucp-agent.profile. Controleer de documentatie voor elk ander endpoint in plaats van aan te nemen dat dezelfde eis of machtiging overal geldt.

Kan een AI-agent de checkout afronden?#

Shopify documenteert Checkout MCP afzonderlijk. Het actuele proces vereist authenticatie of een ondertekend verzoek en kan de koper doorsturen om de checkout te bekijken of af te ronden. Bekijk de Checkout MCP-referentie voor het ondersteunde traject.

Is Shopify MCP op elk abonnement beschikbaar?#

Beschikbaarheid en toegang hangen af van het endpoint en de winkelconfiguratie. Bekijk de actuele abonnements- en endpointdocumentatie van Shopify voor de specifieke integratie; leid abonnementstoegang niet af uit een MCP-voorbeeld.

Hoe verschilt Global Catalog van Storefront Catalog?#

Storefront Catalog is beperkt tot één merchant. Global Catalog is een afzonderlijk ontdekkingsendpoint voor productzoekopdrachten over Shopify. Hun endpoints en toolcontracten verschillen.

Wat doet Order MCP?#

Shopify documenteert een tool get_order om de actuele status van ondersteunde, door agents geïnitieerde bestellingen te lezen. Het is geen algemeen bestelgeschiedenisendpoint voor alle kanalen van een klant.

Hoe verschilt Customer Accounts MCP van Order MCP?#

Customer Accounts MCP gebruikt de OAuth-autorisatie van de klant voor account- en bestelverzoeken in die winkel. Order MCP gebruikt toegang die tot de agent is beperkt en kan alleen bestellingen ophalen die via die agent zijn geplaatst. Ontdek het schema van elke tool voordat je een klantenservicebewerking kiest.

Lost Shopify MCP wijzigingen aan bestellingen na aankoop op?#

Nee. De actuele Order MCP-documentatie beschrijft bestellezingen, geen bewerkingen. Klantgerichte bestelwijzigingen hebben een afzonderlijke workflow nodig en blijven afhankelijk van winkelbeleid en afhandelingsstatus.

Hoe test ik een Shopify-endpoint?#

Volg de officiële referentie voor dat endpoint en test het gedocumenteerde verzoek in een ontwikkelomgeving. Bevestig authenticatie, vereiste profielgegevens, geretourneerde velden en eventuele checkoutoverdracht vóór uitrol.

Wat meldde Shopify over groei van AI-zoekopdrachten?#

Shopify meldde in juni 2026 dat bestellingen uit AI-zoekopdrachten jaar op jaar 13x waren toegenomen, met 49% hogere conversie en 14% hogere gemiddelde bestelwaarde. Die cijfers beschrijven de AI-zoekrapportage van Shopify, niet de prestaties van een specifiek MCP-endpoint. Bekijk het Shopify-rapport.

Welke implementatiestap heeft de hoogste prioriteit?#

Kies één specifieke taak, volg de actuele Shopify-endpointdocumentatie en test het volledige verzoek en de klantervaring. Houd catalogus-, checkout-, bestellees- en bestelbewerkingsprocessen na aankoop apart.

Verder lezen#

Verkopen via ChatGPT met Shopify: actuele gids voor Agentic Storefronts (2026) · Klanten hun eigen bestellingen laten bewerken in Shopify (2026)