Shopify AI Toolkit 2026: wat ontwikkelaars en merchants moeten weten

De Shopify AI Toolkit is een toolset voor ontwikkelaars; Shopify’s Universal Commerce Protocol (UCP) en commerce-endpoints zijn verwante maar afzonderlijke onderdelen van het platform. Deze gids beschrijft de actuele toolkit, de UCP-endpoints in de ontwikkelaarsdocumentatie en wat die interfaces voor winkelbeheerders doen. De analyse van Revize vond dat 5,2% van bestellingen na de checkout wordt bewerkt (Revize, 2026); dat is context voor bestelprocessen na aankoop, geen claim over AI-bestellingen.

De toolkit kan ontwikkelaars helpen actuele Shopify-documentatie en API-richtlijnen te vinden vanuit ondersteunde AI-codeertools. Merchants moeten commerce-integraties beoordelen op basis van hun eigen behoeften, de actuele endpointdocumentatie van Shopify en het gedrag van elke agentprovider. Deze gids richt zich op die verifieerbare onderdelen.

Wat is de Shopify AI Toolkit?#

Shopify AI Toolkit biedt een plugin, agentskills en een lokale Dev MCP-server voor ondersteunde AI-ontwikkeltools. Shopify vermeldt momenteel Claude Code, Codex, Antigravity CLI, Cursor, OpenClaw, Pi, VS Code en Hermes voor de plugin; OpenClaw, Pi en Hermes werken alleen via de plugin. Bekijk de officiële AI Toolkit-documentatie voor actuele instelstappen en ondersteunde tools. Dev MCP draait lokaal en vereist geen Shopify-winkelauthenticatie voor de documentatie- en schematools.

De lokale Dev MCP stelt ontwikkelbronnen beschikbaar via Model Context Protocol. Winkelhandelingen gebruiken een afzonderlijke, geauthenticeerde Shopify CLI-context; het installeren van een documentatieserver geeft geen toestemming voor toegang tot een merchantwinkel.

De bruikbare ontwikkelmogelijkheden zijn concreet:

• Actuele documentatie vinden: bepaal het juiste API-onderdeel en de juiste versie voordat je een integratie genereert.
• GraphQL-schema’s inspecteren: controleer veldnamen, argumenten en retourtypen voordat je een query of mutatie opstelt.
• Code valideren: controleer gegenereerde GraphQL-, Liquid- en extensiecode aan de hand van Shopify-schema’s en test daarna het gedrag tijdens uitvoering lokaal.
• Een winkel beheren via CLI: bereid een bewerking met afgebakende machtigingen voor, authenticeer de geselecteerde winkel, controleer de query en variabelen en kies wanneer je deze uitvoert. Mutaties vereisen uitdrukkelijke toestemming.

Validatie vindt schema- en componentfouten; ze bewijst niet dat een wijziging bij de bedrijfsregels van de merchant past. Controleer de wijzigingen, gevraagde machtigingen en doelwinkel vóór uitvoering.

De commerce-MCP- en UCP-interfaces van Shopify#

Shopify documenteert afzonderlijke commerce-interfaces voor catalogusontdekking, checkout en besteltoegang. Ze hebben verschillende endpointpatronen, authenticatie en bewerkingen; geen ervan mag als universele agentinterface worden behandeld.

1. Storefront Catalog via UCP#

Het winkelspecifieke catalogusendpoint van Shopify is https://{shop}.myshopify.com/api/ucp/mcp, met search_catalog, lookup_catalog en get_product en een agentprofiel in meta.ucp-agent.profile. De Storefront MCP-migratiegids verplaatst catalogus- en winkelwagentools naar UCP, maar laat search_shop_policies_and_faqs op /api/mcp staan. Gebruik de Storefront Catalog-documentatie voor de afspraken rond productontdekking.

Ga er niet van uit dat dit endpoint checkout of bestelwijzigingen dekt. Shopify documenteert checkout en bestellingen als afzonderlijke agentinterfaces met eigen authenticatie, machtigingen en ondersteunde bewerkingen.

2. Global Catalog#

Shopify documenteert een Global Catalog-endpoint op https://catalog.shopify.com/api/ucp/mcp voor catalogusontdekking over Shopify. De tools en toegangseisen verschillen van een winkelspecifiek catalogusendpoint van een merchant. Bekijk vóór het bouwen het agentcatalogusoverzicht; hergebruik geen oude Storefront MCP-endpoint- of toolvoorbeelden.

3. Order MCP — toegang tot door agents geïnitieerde bestellingen#

Order MCP van Shopify documenteert momenteel een tool get_order om de actuele status van bestellingen op te halen die via de agent zijn ontstaan. Het geeft geen algemene toegang tot de volledige bestelgeschiedenis van een klant en bewerkt geen bestellingen. De tool vereist de relevante besteltoegang en agentprofielmachtigingen. Lees de Order MCP-documentatie voordat je er voor een workflow op vertrouwt.

Shopify documenteert ook afzonderlijke checkoutmogelijkheden via Checkout MCP. Authenticatie of een ondertekend verzoek is vereist en het proces kan de koper overdragen om de checkout te bekijken of af te ronden. Bekijk de Checkout MCP-documentatie voor het actuele contract.

4. Customer Accounts MCP — geauthenticeerde klantverzoeken#

Customer Accounts MCP blijft ondersteund. Vind mcp_api via https://{shop}/.well-known/customer-account-api; het endpointpatroon is https://{shop}/customer/api/mcp. OAuth-authorization code met PKCE geeft klantspecifieke toegang tot bestelgegevens, status en accountvoorkeuren in die winkel. De app heeft een ingestelde klantauthenticatie, een aangepast domein en toegang tot beschermde klantgegevens nodig. Gebruik tools/list om ondersteunde bewerkingen te ontdekken. Dit verschilt van Order MCP, dat beperkt is tot bestellingen die via de agent zijn geplaatst; geen van beide namen impliceert willekeurige bestelwijzigingen.

Universal Commerce Protocol (UCP): de basis onder de lagen#

Shopify beschrijft UCP als een open commerceprotocol voor interacties tussen agents, merchants, betaalproviders en credentialproviders. De documentatie specificeert ontdekking-, checkout- en bestelgerelateerde flows. Implementaties houden eigen endpoints, verzoekformaten, authenticatie en machtigingen; een UCP-label betekent niet dat elke client elke tool kan aanroepen. Bekijk de agentprofieldocumentatie en endpointspecifieke referenties voordat je een flow implementeert.

De belangrijkste protocolgebieden omvatten:

1. Catalogusontdekking — producten vinden en ondersteunde productdetails ophalen via de gedocumenteerde catalogusendpoints.
2. Checkout — checkout maken of voortzetten via het gedocumenteerde proces, dat authenticatie of overdracht aan de koper kan vereisen.
3. Besteltoegang — ondersteunde bestelgegevens ophalen onder de gedocumenteerde profiel- en toegangsregels; dit houdt niet in dat een agent een bestelling kan bewerken of terugbetalen.

Bevestig als merchant of het relevante Shopify-catalogusendpoint voor je winkel beschikbaar en ingesteld is. Het bestaan van een endpoint garandeert niet dat een bepaald AI-product het gebruikt of elk artikel toont. Bekijk Shopify’s UCP-gids en de actuele endpointdocumentatie en test daarna met de client die je wilt ondersteunen.

Wat merchants nu kunnen controleren#

1. AI-zoekverkeer groeit, maar dat bewijst niet dat MCP de oorzaak is. Shopify meldde in juni 2026 dat bestellingen vanuit AI-zoekopdrachten jaar op jaar met 13x waren gestegen, met 49% hogere conversie en 14% hogere gemiddelde bestelwaarde. Dit zijn door Shopify gerapporteerde AI-zoekcijfers, geen voorspelling voor elke merchant of bewijs dat een specifiek MCP-endpoint de bestellingen genereerde. Bekijk de update van juni 2026.

2. Controleer het daadwerkelijke proces na aankoop. De gedocumenteerde Order MCP van Shopify kan ondersteunde bestelgegevens van door agents geïnitieerde bestellingen lezen; deze bewerkt geen bestellingen. Merchants moeten de klantroute voor het corrigeren van geschikte bestellingen controleren in plaats van aan te nemen dat een agentendpoint dit dekt.

3. Houd productinformatie nauwkeurig. Duidelijke titels, opties, beschikbaarheid en beleid helpen klanten en commercesystemen een catalogus te begrijpen. Meet resultaten in je eigen winkel in plaats van aan te nemen dat een bepaald gegevensformaat rangschikking of conversie garandeert.

De AI Toolkit gebruiken als ontwikkelaar of bureau#

Begin met één ontwikkeltaak: inspecteer het schema, genereer een query, valideer deze en beoordeel het resultaat in een ontwikkelwinkel.

Installeer de Shopify-plugin voor je ondersteunde client, of volg de gedocumenteerde installatieprocedure voor skills of Dev MCP. Plugins worden automatisch bijgewerkt; handmatig geïnstalleerde skills moet je zelf bijwerken. Volg de instelinstructies voor de client die je daadwerkelijk gebruikt.

Voor winkelbeheer authenticeer je met Shopify CLI, met alleen de noodzakelijke machtigingen. De store execute-opdracht voert een beoordeelde Admin GraphQL-bewerking uit met die opgeslagen authenticatie. Dit voorbeeld leest de eerste tien producten van een ontwikkelwinkel:

shopify store auth --store YOUR-DEV-STORE.myshopify.com --scopes read_products
shopify store execute --store YOUR-DEV-STORE.myshopify.com --query '{ products(first: 10) { nodes { id title } } }'

Vervang de tijdelijke waarde door je ontwikkelwinkel. Leesbewerkingen werken zonder mutaties in te schakelen; schrijfbewerkingen vereisen --allow-mutations en de bijbehorende machtigingen. Controleer de volledige mutatie en variabelen voordat je toestemming geeft, verifieer de doelwinkel en test het beoogde gedrag voordat je een productiewijziging uitvoert.

Winkelen via assistenten inschakelen in je eigen winkel#

Als je wilt bouwen op een Shopify-catalogusendpoint, volg dan het huidige Storefront Catalog-verzoekformaat, inclusief meta.ucp-agent.profile. Een geslaagde productzoekopdracht bewijst niet dat je checkout- of besteltoegang hebt. Onze Shopify Catalog MCP-gids legt de ontdekkingstools en hun beperkingen uit.

Gebruik voor een merkagent de actuele voorbeeldprojecten en endpointspecifieke checkoutdocumentatie van Shopify. Plan een gefaseerde uitrol rond je eigen catalogus-, authenticatie-, betalings- en supporteisen; een voorbeeldproject is geen checklist voor productie-integratie. Test productdetails die klanten zien en checkoutoverdrachten vóór lancering.

De plek van processen na aankoop in een systeem met AI-assistenten#

Productontdekking, checkout, besteltracking en klantwijzigingen hebben elk hun eigen ondersteunde interfaces nodig. Onze gids voor Shopify MCP- en UCP-endpoints brengt die verantwoordelijkheden in kaart.

Shopify documenteert Order MCP als een leesinterface voor ondersteunde, via agents geplaatste bestellingen, met UCP-bestelwebhooks voor levenscyclusupdates. Deze biedt geen algemeen bestelbewerkingsproces. Revize biedt een klantportaal voor geschikte adres-, variant-, aantal- en annuleringswijzigingen vóór de orderafhandeling, onder de ingestelde bewerkingsperiode. Producten toevoegen, tussen producten wisselen, kortingen toepassen en terugbetalingen als winkeltegoed zijn Pro-functies. Bestelbewerking door medewerkers is in ontwikkeling. Het portaal vereist het Revize-appblok op de orderstatuspagina en kan ook vanuit de e-maillink Edit Order worden geopend. Bekijk Revize in de Shopify App Store voor productdetails.

Verder lezen#

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