Op deze pagina
Universal Commerce Protocol (UCP) is een open, versiegebonden protocol voor commerce via agents. De actuele Shopify-implementatie biedt UCP-conforme MCP-servers voor cataloguszoekopdrachten, winkelwagens, checkout en bestelprocessen. UCP is vandaag beschikbaar voor ontwikkelaars, maar een open protocol betekent niet dat elke agent of merchant elke mogelijkheid ondersteunt.
Het grotere plaatje: wat is er veranderd?
UCP is op 11 januari 2026 door Shopify en Google aangekondigd. Het protocol blijft zich ontwikkelen; de actuele agentdocumentatie van Shopify gebruikt agentprofielvoorbeelden met 2026-08-25. Op 13 oktober 2026 kondigde Shopify ook Shop MCP aan, waarmee compatibele agents Shopify Catalog kunnen doorzoeken, winkelwagens kunnen bouwen en checkout kunnen maken via één MCP-verbinding.
Voor Shopify-ontwikkelaars is de praktische vraag welke actuele agentworkflow je moet ondersteunen: productontdekking, winkelwagenopbouw, checkoutoverdracht of besteltracking. Controleer de ondersteunde tools en machtigingen in de Shopify-documentatie voordat je merchants een mogelijkheid belooft.
Wat is UCP precies?
UCP is een open protocol dat beschrijft hoe agentapplicaties en commercesystemen informatie uitwisselen en gedefinieerde commercehandelingen uitvoeren. Het gebruikt versies en mogelijkheden: een integratie maakt bekend wat ze ondersteunt en een agent hoort alleen die mogelijkheden te gebruiken.
Shopify implementeert UCP via MCP-endpoints en tools. Afhankelijk van endpoint en machtigingen kunnen ontwikkelaars met catalogusontdekking, winkelwagens, checkout of bestelgegevens werken. Dit zijn afzonderlijke workflows en ondersteuning voor één betekent geen ondersteuning voor elke andere UCP-mogelijkheid.
Rollen in een commerceproces via agents
- Agent of applicatie: helpt een koper producten te vinden, een winkelwagen te bouwen of door de checkout te gaan.
- Merchantsysteem: levert product- en checkoutinformatie en verwerkt de bestelling via de ondersteunde Shopify-interface.
- Credentialprovider: levert betalingsgegevens of tokens via de betaalmethode die voor het proces is overeengekomen.
- Betaaldienst: verzorgt betaling via de checkout of betaalmethode die in dat proces beschikbaar is.
- Koper: beoordeelt en autoriseert de aankoop. Volg de bevestigings- en machtigingseisen van het proces.
Het probleem: waarom e-commerce een protocol nodig had
E-commerce is op dit moment sterk versnipperd.
Stel dat een klant via een AI-assistent iets wil kopen:
- De AI moet productinformatie in merchantcatalogi kunnen vinden
- Ze moet beschikbaarheid, prijzen en verzendopties in realtime begrijpen
- Ze moet loyaliteitsprogramma’s, kortingscodes en abonnementsvoorkeuren verwerken
- Ze moet veilig betalingsgegevens verzamelen
- Ze moet de checkout afronden met alle specifieke eisen van de merchant
- Ten slotte moet ze besteltracking, retouren en klantenservice ondersteunen
Maatwerkintegraties brengen extra onderhoud met zich mee. UCP biedt gedeelde schema’s en onderhandeling over mogelijkheden die dat werk kunnen verminderen, maar twee implementaties hebben nog steeds compatibele versies, mogelijkheden, authenticatie en betalingshandlers nodig. Protocolcompatibiliteit alleen garandeert niet dat een agent een aankoop kan afronden.
UCP-mogelijkheden om eerst te begrijpen
Checkout, identiteitskoppeling en bestelstatus zijn nuttige uitgangspunten in de UCP-specificatie. Shopify documenteert ook catalogus- en winkelwagenmogelijkheden. Elke interface implementeert haar eigen ondersteunde set; controleer het overeengekomen profiel voordat je een tool aanroept.
1. Checkout
Checkout maakt en werkt een aankoopsessie bij, inclusief artikelen, kopersgegevens, totalen en betalingshandler. De merchant blijft de geregistreerde verkoper. De standaardflow draagt de koper over aan een vertrouwde interface om betaling te bevestigen; autonome afronding hangt af van ondersteunde autorisatie-extensies en de specifieke integratie.
2. Identiteiten koppelen
Identiteitskoppeling gebruikt OAuth 2.0 om een koper een agent toestemming te laten geven namens hem te handelen. Dit kan accountspecifieke functies zoals opgeslagen adressen of bestelgeschiedenis ondersteunen. Openbaar zoeken in catalogi kan zonder identiteitskoppeling werken, dus autorisatie is een afzonderlijke mogelijkheid en machtigingsbeslissing.
3. Bestelling
De Order-mogelijkheid deelt bestelstatus en levenscyclusgebeurtenissen zoals afhandeling, retouren en terugbetalingen. Het is geen algemene bestelbewerkings-API. De actuele Order MCP en API’s voor door kopers aangevraagde wijzigingen van Shopify hebben hun eigen gedocumenteerde reikwijdte en limieten, die hieronder worden beschreven.
De technische architectuur: gebouwd om mee te groeien
UCP gebruikt profielen om een protocolversie en ondersteunde mogelijkheden aan te geven. Bedrijven en agents onderhandelen over de mogelijkheden die ze voor een sessie gemeen hebben; de agent hoort alleen die overeengekomen set te gebruiken. Shopify-voorbeelden gebruiken profielen met datumversies, dus ontwikkelaars moeten het actuele profiel en schema uit de actieve documentatie kopiëren in plaats van een oud voorbeeld.
Extensies voegen optionele details toe aan een basismogelijkheid, zoals afhandeling of kortingen. Een bedrijf kan de basischeckout aanbieden zonder elke extensie en een agent moet controleren welke extensies de andere kant ondersteunt voordat hij erop vertrouwt. Bekijk het UCP-overzicht en de agentprofielgids van Shopify.
Ontworpen voor samenwerking tussen systemen
UCP is ontworpen om via protocolbindings zoals REST, MCP en A2A te werken. Dat beschrijft de bredere UCP-standaard, geen belofte dat één Shopify-implementatie elke mogelijkheid via elk transport biedt.
De actuele Shopify-ontwikkelaarsdocumentatie beschrijft UCP-conforme MCP-servers en hun ondersteunde tools. Controleer voor een integratie het exacte endpoint, de authenticatiemethode, profielversie en vereiste kopersbevestiging. Leid niet af dat een mogelijkheid uit de UCP-specificatie al via een bepaalde Shopify MCP-interface beschikbaar is.
De actuele UCP- en MCP-interfaces van Shopify
De agentdocumentatie van Shopify beschrijft verschillende afzonderlijke interfaces:
Catalogusontdekking
Catalog MCP-tools laten een agent Shopify Catalog doorzoeken en productdetails ophalen. Global Catalog MCP van Shopify gebruikt https://catalog.shopify.com/api/ucp/mcp; Shop MCP is beschikbaar op https://mcp.shop.com en biedt cataloguszoek- en producttools. Cataloguszichtbaarheid en resultaten hangen af van de actuele productgegevens en gebruikte interface.
Winkelwagenopbouw en checkout
Cart MCP kan een winkelwagen bouwen en bijwerken. Checkout MCP kan een checkoutsessie maken en beheren en de koper vervolgens naar de webshop van de merchant overdragen om stappen af te ronden die de koper vereisen. Shopify documenteert Checkout MCP als de aanbevolen serverkantaanpak; Checkout WebMCP is voor een agent die al in de browser van de koper werkt. Sommige checkouttypes en door apps gedefinieerde interacties worden niet door de browsertools afgehandeld.
Shop MCP is een afzonderlijke verbinding die Shopify Catalog kan doorzoeken, winkelwagens kan bouwen en Shop Pay-checkout kan maken. Dit betekent niet dat elke merchant automatisch in elke AI-app beschikbaar is.
Bestelgegevens
Order MCP van Shopify leest de actuele status van bestellingen die via de agent zijn geplaatst, inclusief orderafhandeling en wijzigingen na aankoop. De tool get_order is bedoeld voor weergaven op verzoek van de koper en reconciliatie. UCP-bestelwebhooks leveren doorlopende momentopnamen na vastgelegde wijzigingen; een Shopify-partnermanager moet het afleverendpoint registreren. Dit lees- en updatekanaal voert geen willekeurige bestelwijzigingen uit.
Afzonderlijk laten de Shopify-API’s voor bestelwijzigingen op verzoek van kopers van 1 oktober 2026 kopers vragen om niet-afgehandelde bestelregels te verwijderen; een merchant of app kan een verzoek beoordelen, afhandelen of afwijzen. Dat beperkte verzoekproces is niet hetzelfde als een adres wijzigen of een product omruilen.
Wat dit betekent voor Shopify-verkopers
De agenttools van Shopify kunnen product- en checkoutprocessen beschikbaar maken voor compatibele agents. De ervaring hangt af van de gebruikte interface, de ingeschakelde winkelmogelijkheden en de autorisatie van de koper. Houd productdetails, beschikbaarheid en beleid nauwkeurig en bevestig welke kanalen voor je winkel zijn ingeschakeld.
Behandel dit als een integratie-interface, niet als garantie voor universele AI-plaatsing of toegang tot elke merchant. Het overzicht van Agentic Storefronts van Shopify legt de kanaalbeschikbaarheid en standaarddoorverwijzing naar checkout vanuit ChatGPT uit.
Wat dit betekent voor ontwikkelaars van Shopify-apps
UCP en de MCP-tools van Shopify geven appontwikkelaars gedefinieerde interfaces om op te bouwen. Identificeer vóór de start de koperstaak, het Shopify-endpoint, het vereiste agentprofiel en de scopes en waar de koper een actie moet beoordelen of bevestigen.
Bouw op ondersteunde mogelijkheden
Gebruik de actuele agentdocumentatie en tutorials van Shopify voor endpointontdekking, authenticatie, winkelwagen- en checkouttools en besteltracking. Ga er niet van uit dat een externe app eigen functies aan een agent kan aanbieden alleen omdat UCP extensies ondersteunt; controleer of de appinterface en protocolmogelijkheid zijn geïmplementeerd.
Houd bestelbewerking apart
Order MCP dekt bestelgegevens en levenscyclusprocessen. Het voert geen willekeurige bewerkingen uit, zoals adreswijzigingen of productomruilingen. De op 1 oktober 2026 aangekondigde API’s voor door kopers aangevraagde bewerkingen zijn beperkt tot verzoeken om niet-afgehandelde orderregels te verwijderen, met beoordeling door merchant of app. Controleer voor andere klantbewerkingen na aankoop de actuele functies en machtigingen van de afzonderlijke app.
Wat dit betekent voor bureaus
Bureaus kunnen merchants helpen productgegevens en checkoutconfiguratie voor gekozen agentinterfaces voor te bereiden. Begin met de actuele Shopify-documentatie en het daadwerkelijke abonnement, de appconfiguratie, productgegevens en het koperstraject van de merchant. Behandel beschikbaarheid, klantbereik en conversieresultaten als vragen die je per merchant moet meten in plaats van protocolgaranties.
UCP naast andere agentic-commerceprotocollen
UCP en Agentic Commerce Protocol (ACP) zijn afzonderlijke protocolinitiatieven. Ze definiëren verschillende interfaces en workflows, dus ontwikkelaars mogen niet aannemen dat een UCP-integratie automatisch met ACP werkt of andersom. Bekijk de actuele specificaties en bouw alleen voor de agentinterfaces die je product wil ondersteunen.
De brug in deze illustratie staat voor integratiewerk dat moet worden beoordeeld, niet voor een reeds beschikbare Shopify-interoperabiliteitsfunctie.
Aan de slag: een praktische implementatiegids
Gebruik de actuele agentic-commercedocumentatie van Shopify als startpunt. Deze bevat de actuele MCP-interfaces, UCP-profielvoorbeelden, authenticatiedetails en tutorials. Shopify raadt de AI Toolkit-quickstart aan voor begeleide configuratie; ontwikkelaars kunnen ook de afzonderlijke tutorials volgen.
Stap 1: identificeer de koperstaak
Bepaal of je applicatie producten moet zoeken, een winkelwagen moet bouwen, checkout moet maken of bijwerken of bestelcyclusinformatie moet lezen. Deze taken gebruiken verschillende tools en scopes.
Stap 2: volg de actuele Shopify-gids
Gebruik het actuele agentprofiel en de API-voorbeelden uit de Shopify-documentatie. Kopieer geen oud endpoint, profielversie, voorbeeldrepository of playground-URL zonder te controleren of deze nog gedocumenteerd is.
Stap 3: test het volledige koperstraject
Gebruik een ontwikkelwinkel en test authenticatie, geretourneerde berichten en statussen, checkoutoverdracht en vereiste kopersbevestiging. Test het exacte bestel- of checkouttype dat je wilt ondersteunen; Shopify documenteert gevallen die browsercheckouttools niet afhandelen.
Stap 4: beperk de integratie tot geverifieerde mogelijkheden
Declareer en vraag alleen scopes die de workflow nodig heeft. Maak niet-ondersteunde stappen of stappen met kopersbevestiging duidelijk en controleer de actuele werking vóór uitrol naar productie.
Wat er nog aankomt
De gepubliceerde Shopify-documentatie dekt momenteel catalogusontdekking, winkelwagens, checkout en bestelgegevens via afzonderlijke MCP-workflows. Shop MCP voegt een verbinding toe waarmee compatibele agents Shopify Catalog kunnen doorzoeken, winkelwagens kunnen bouwen en Shop Pay-checkout kunnen maken. Behandel toekomstige protocolfuncties en uitroldatums als niet-aangekondigd totdat ze in de officiële specificatie of het Shopify-wijzigingslogboek staan.
Controleer vóór het vastleggen van een roadmap de actuele Shopify-documentatie voor het specifieke profiel, endpoint, scopes en bestel- of checkouttypes die je integratie gebruikt. Beschikbare tools, kopersbevestigingseisen en ondersteunde checkouttypes verschillen per interface en kunnen veranderen als Shopify API’s bijwerkt.
De kern
UCP geeft ontwikkelaars een gedeeld, evoluerend protocol om commerceprocessen via agents te bouwen. De actuele Shopify-tools dekken productontdekking, winkelwagen- en checkoutwerk en bestelcyclusinformatie, met afzonderlijke endpoints, scopes en limieten voor elk.
Controleer als merchant welke interfaces zijn ingeschakeld en welk koperstraject ze ondersteunen. Volg als appontwikkelaar of bureau de actuele documentatie, test met een ontwikkelwinkel en suggereer niet dat een integratie bestellingen kan bewerken of producten op elke AI-interface kan tonen, tenzij het doel dit ondersteunt.
Veelgestelde vragen
Maakt UCP elke Shopify-app aanroepbaar door een agent?
Een app heeft een geïmplementeerde interface nodig die de doelagent en Shopify-interface ondersteunen. Alleen een extensie declareren of een open standaard gebruiken, stelt de functies van de app niet beschikbaar.
Kan Order MCP een adres wijzigen of een product omruilen?
Order MCP haalt de status op van bestellingen die via de agent zijn geplaatst. Adreswijzigingen en productomruilingen vereisen een afzonderlijke bestelbewerkingsworkflow. Verwijdering van niet-afgehandelde artikelen op verzoek van de koper is een afzonderlijk API-verzoek dat een merchant of app beoordeelt.
Hoe ontvang ik UCP-bestelupdates in Shopify?
Regel webhookregistratie via je Shopify-partnermanager, verwerk inkomende bestelmomentopnamen en gebruik get_order wanneer een koper om actuele informatie vraagt of wanneer een aflevering moet worden afgestemd.
Is de standaard-ChatGPT-checkout van Shopify een rechtstreekse UCP-checkout?
De standaard-Agentic Storefront van Shopify voor ChatGPT stuurt de shopper door naar de webshopcheckout van de merchant. Andere ingeschakelde kanalen en afzonderlijke agentintegraties kunnen andere checkoutprocessen gebruiken; controleer het proces dat je implementeert.
Wat moet ik controleren voordat ik een UCP-integratie uitrol?
Controleer het endpoint, de overeengekomen protocolversie, mogelijkheden, machtigingen, authenticatie en stappen voor kopersbevestiging. Test niet-beschikbare producten, checkoutoverdracht en bestelupdates met de gekozen agent voordat je de integratie vrijgeeft.
Bronnen
- Shop MCP-aankondiging
- API’s voor bestelwijzigingen op verzoek van kopers
- UCP-checkoutmogelijkheid
- UCP-identiteitskoppeling
- UCP-bestelmogelijkheid
- Repository van de UCP-specificatie
Dit artikel maakt deel uit van onze serie “Beyond the Checkout”. De klantgerichte bestelbewerkingsapp van Revize biedt geschikte selfservicewijzigingen vóór de orderafhandeling, binnen een door de merchant ingestelde periode. Producten omruilen of toevoegen, kortingen toepassen en terugbetalingen als winkeltegoed vereisen Pro; bewerken door medewerkers is in ontwikkeling. Dit klantportaal staat los van een UCP-agentintegratie.
Verder lezen
Statistieken over Shopify-bestellingen bewerken (2026) · Verkopen via ChatGPT met Shopify: actuele gids voor Agentic Storefronts (2026) · Shopify MCP en UCP in 2026: actuele endpoints en hun functies · Shopify AI Toolkit 2026: wat ontwikkelaars en merchants moeten weten · Klanten hun eigen bestellingen laten bewerken in Shopify (2026)