Shopify Catalog MCP in 2026: wat de officiële tools kunnen

Door Shubham Vats, Oprichter van Revize

Gepubliceerd op Bijgewerkt op 7 min leestijd

Op deze pagina

Shopify documenteert nu twee officiële Catalog MCP-interfaces: Global Catalog doorzoekt producten van Shopify-merchants en Storefront Catalog is beperkt tot één merchantwinkel. Beide gebruiken Shopify’s Universal Commerce Protocol (UCP)-catalogusmogelijkheid en bieden tools voor zoeken, opzoeken en variantselectie. De gedocumenteerde Catalog MCP-interface is bedoeld voor productontdekking; er zijn geen Shopify Admin-bewerkingen voor het aanpassen van bestellingen of catalogusgegevens.

Op 13 oktober 2026 kondigde Shopify ook Shop MCP aan. Deze aparte MCP-verbinding voegt winkelwagens, checkout en het opzoeken van bestellingen van ingelogde klanten toe. Dat breidt agentic commerce uit, maar maakt Catalog MCP zelf geen Admin API-editor.

AI-agent die een Shopify-productcatalogus doorzoekt en voorraadresultaten teruggeeft

Kort antwoord: Gebruik Catalog MCP om producten te ontdekken en varianten te selecteren: Global Catalog voor zoekopdrachten bij meerdere merchants en Storefront Catalog voor één winkel. Checkout en het opzoeken van bestellingen van ingelogde klanten verlopen via aparte commerce-interfaces, waaronder Shop MCP.

Wat is de functionaliteit van Shopify Catalog MCP?

Catalog MCP is een officiële Shopify-interface waarmee AI-agenten productinformatie kunnen vinden en ophalen. Global Catalog zoekt bij geschikte Shopify-merchants; Storefront Catalog is beperkt tot één merchantwinkel. Beide implementeren Shopify’s UCP-catalogusmogelijkheid en gebruiken dezelfde drie MCP-tools, maar het bereik en de responsvelden verschillen.

Een gebruikelijke flow bestaat uit twee stappen. Eerst vindt search_catalog producten op basis van tekst, afbeeldingen of product-ID’s; lookup_catalog lost bekende product- of variant-ID’s op. Daarna retourneert get_product de details van een gekozen product, beschikbare optiecombinaties en checkoutlinks. Zo kunnen agenten producten vinden en varianten selecteren zonder brede Admin API-toegang te krijgen.

Het aparte pakket @shopify/dev-mcp biedt Shopify-documentatie en tools voor ontwikkelaars. Het is iets anders dan Catalog MCP en Shop MCP, dat winkelwagen-, checkout- en ingelogde klantfuncties toevoegt.

Conceptuele lagen tussen een AI-assistent, MCP-tools en een Shopify-API

Hoe toegang tot de Shopify-catalogus via MCP echt werkt

De protocollaag: wat MCP precies doet

MCP beschrijft hoe een client tools ontdekt en aanroept die een server aanbiedt. UCP definieert de commerce-mogelijkheid en het formaat van catalogusverzoeken en -antwoorden. Bij Shopify Catalog MCP stuurt de agent een verzoek naar het Shopify-endpoint en geeft daarbij de URL van het eigen UCP-agentprofiel mee. Welke tools beschikbaar zijn, hangt af van de mogelijkheden die in dat profiel staan. Shopify host deze dienst; voor de gedocumenteerde catalogustools hoef je geen eigen MCP-server te bouwen.

De API-laag: Admin versus Storefront

Shopify documenteert twee Catalog MCP-endpoints:

  • Global Catalog: https://catalog.shopify.com/api/ucp/mcp doorzoekt Shopify-merchants.
  • Storefront Catalog: https://{storeDomain}/api/ucp/mcp doorzoekt één merchantwinkel.

Beide vereisen een agentprofiel en voor standaardverzoeken is geen API-sleutel nodig. De tools leveren catalogusgegevens voor productontdekking; ze zijn geen proxy voor Shopify Admin API. Voor het wijzigen van producten of bestellingen is een aparte app of integratie nodig met de juiste Shopify-API’s en machtigingen. Catalogustoegang is begrensd; zoekresultaten en productafbeeldingen mogen niet in de cache worden opgeslagen. Shopify markeert sommige responsvelden als afgeleid; ze kunnen dus ontbreken of wisselend nauwkeurig zijn. Bekijk de actuele gebruiksrichtlijnen voordat je resultaten aan klanten toont.

Mogelijkheid Global Catalog MCP Storefront Catalog MCP
Producten zoeken Bij geschikte Shopify-merchants Binnen de catalogus van één merchant
Endpoint https://catalog.shopify.com/api/ucp/mcp https://{storeDomain}/api/ucp/mcp
Standaardauthenticatie Agentprofiel; geen API-sleutel vereist Agentprofiel; geen API-sleutel vereist
Ontdekkingstools search_catalog, lookup_catalog, get_product Dezelfde drie catalogustools
Limiet voor opzoekverzoeken Maximaal 50 product- of variant-ID’s Maximaal 10 product- of variant-ID’s
Productdetails Opties, beschikbaarheidssignalen en checkoutlinks Winkelspecifieke opties, beschikbaarheidssignalen en checkoutlinks
Producten, voorraad of bestellingen wijzigen Niet beschikbaar Niet beschikbaar
Checkout uitvoeren Een aparte checkoutinterface is vereist Een aparte checkoutinterface is vereist

Toegangslagen van de Admin API en Storefront API in een Shopify MCP-configuratie

Wat je daadwerkelijk met Shopify Catalog MCP kunt doen

De gedocumenteerde Catalog MCP-tools ondersteunen deze taken:

  1. Zoeken op tekst: producten vinden op basis van een productverzoek in gewone taal.
  2. Zoeken op afbeelding of overeenkomst: Global Catalog ondersteunt afbeeldingsvragen en product-ID’s om vergelijkbare artikelen te vinden.
  3. Zoekresultaten filteren: gebruik ondersteunde filters zoals beschikbaarheid, prijs, verzendbestemming of -herkomst en productkenmerken.
  4. Bekende ID’s opzoeken: actuele product- of variantgegevens ophalen; één Global Catalog-verzoek kan maximaal 50 ID’s verwerken en Storefront Catalog maximaal 10.
  5. Productdetails bekijken: get_product geeft volledige details van één product, inclusief optiecombinaties en beschikbaarheidssignalen.
  6. Een variant selecteren: geef gekozen opties zoals kleur of maat door voor de overeenkomende variant en checkoutlink.
  7. Globaal of binnen één winkel zoeken: kies Global Catalog voor meerdere merchants of Storefront Catalog voor één winkel.

Dit zijn ontdekkingsfuncties. De catalogustools wijzigen geen prijzen, metafields of voorraad, bewerken geen bestellingen en voeren geen checkout uit.

Zeven soorten catalogushandelingen die AI-agenten via Shopify MCP kunnen uitvoeren

Wat Catalog MCP betekent voor processen na aankoop

Catalog MCP kan een agent helpen een product te vinden of de weergegeven opties te bekijken, maar leest geen Shopify-bestellingen en voert geen wijzigingen na aankoop uit. Houd deze taken gescheiden: gebruik de Shopify-agenttools voor productontdekking en een orderbeheer-app of passend geautoriseerde integratie voor orderwijzigingen.

De klantgerichte bestelbewerkingsapp van Revize biedt klanten selfservice voor bestelwijzigingen vóór fulfilment, binnen een bewerkingsvenster dat de merchant instelt. De merchant kiest welke acties beschikbaar zijn. Klanten gebruiken het ingeschakelde Revize-appblok op de Shopify-bestelstatus- of bedankpagina, of de link Bestelling bewerken in de bevestigingsmail. Revize controleert live voorraad bij variantwissels. Een tijdvenster alleen houdt fulfilment niet tegen; daarvoor moet de merchant de passende holdmodus en regels configureren. Zie de Shopify-gids voor het bewerken van bestellingen voor de native editor.

Shopify-winkelier bekijkt vol vertrouwen AI-inzichten in catalogus en bestellingen op een werkplek

AI-agenten in commerce en Catalog MCP: wat kan nu en wat komt eraan?

De huidige agenttools van Shopify hebben verschillende functies:

  • Catalog MCP: zoeken, opzoeken, details en variantontdekking via Global of Storefront Catalog.
  • Shop MCP: een aparte MCP-server die op 13 oktober 2026 is aangekondigd. Deze kan de catalogus doorzoeken, winkelwagens maken, checkout voor Shopify-winkels aanmaken, Shop Pay-checkout afronden nadat de klant bevestigt en bestellingen van ingelogde klanten opzoeken. Bij de lancering wordt de bestelstatus opgehaald door get_checkout te pollen; de release-informatie vermeldt dat webhooks nog niet beschikbaar zijn.
  • Shopify dev MCP: documentatie en tools voor ontwikkelaars, geen catalogus- of orderbeheeracties voor merchants.

Volg voor de inrichting de actuele Catalog-handleiding van Shopify of de Shop MCP-release-informatie. Ga er niet van uit dat een tool op de ene server ook op een andere beschikbaar is.

Implementatiechecklist

Als je Shopify Catalog MCP onderzoekt:

  1. Bepaal of de agent tussen meerdere merchants of binnen één winkel moet zoeken.
  2. Lees de setupinstructies voor het juiste endpoint en agentprofiel.
  3. Test zoeken, ID-opzoeking en variantselectie, ook met niet-beschikbare of onduidelijke opties.
  4. Respecteer snelheidslimieten en het verbod op het cachen van resultaten en afbeeldingen.
  5. Wijs productontdekking, checkout en orderwijzigingen na aankoop toe aan tools die elke taak expliciet ondersteunen.

Veelgestelde vragen

Is Catalog MCP een specifiek Shopify-product?

Ja. Shopify Global Catalog MCP zoekt bij geschikte merchants en Storefront Catalog MCP is beperkt tot één winkel. De op ontwikkelaars gerichte server @shopify/dev-mcp is iets anders.

Wat is Model Context Protocol precies?

MCP is een protocol waarmee een AI-client tools ontdekt en aanroept die een server aanbiedt. In Shopify’s catalogusimplementatie definieert UCP de commerce-mogelijkheid en het formaat van verzoeken en antwoorden via MCP.

Heb ik een ontwikkelaar nodig om Shopify Catalog MCP in te stellen?

Je hebt een MCP-compatibele client en agentprofiel nodig en stelt vervolgens het Shopify Catalog-endpoint in. Shopify host de gedocumenteerde server, dus voor deze tools hoef je geen eigen MCP-server te bouwen. Geavanceerder agentgedrag kan ontwikkelwerk vragen.

Welke Shopify-abonnementen ondersteunen Catalog MCP?

De Catalog-documentatie beschrijft endpoints en authenticatie met een agentprofiel, maar geen overzicht per abonnement. Controleer de actuele Shopify-documentatie en of je winkel in aanmerking komt voor de specifieke catalogus- of agentfunctie.

Kan MCP gegevens in mijn Shopify-catalogus wijzigen of alleen lezen?

Nee. Catalog MCP biedt productontdekkingstools, geen productwijzigingen of orderbewerkingen. Shop MCP is apart en voegt winkelwagen, checkout en orderopzoeking voor ingelogde klanten toe. Wijzigingen via Admin API vereisen een afzonderlijk geautoriseerde app of integratie.

Wat is het verschil tussen Catalog MCP en Shopify Flow?

Flow voert gebeurtenisgestuurde workflows uit in Shopify Admin. Catalog MCP laat een agent op verzoek productontdekkingstools aanroepen. Ze kunnen elkaar aanvullen, maar Catalog MCP start of voert zelf geen Flow-workflow uit.

Welke Admin API-machtigingen heeft Catalog MCP nodig?

De gehoste Catalog MCP-endpoints gebruiken een agentprofiel en hebben voor standaardverzoeken geen Admin API-token of API-sleutel nodig. Als een andere integratie Admin API-bewerkingen uitvoert, vraag dan alleen de benodigde machtigingen aan.

Kan Catalog MCP Shopify B2B-scenario’s ondersteunen?

De Catalog MCP-tools zijn gedocumenteerd voor productontdekking. Ze bieden geen bedrijfs-toewijzingen of een volledig B2B-orderproces. Controleer de actuele B2B-ondersteuning in de API of agentfunctie die je gebruikt; ga er niet van uit dat Catalog MCP Plus-specifieke Admin API-gegevens toont.

Welke AI-clients werken met Shopify Catalog MCP?

Gebruik een MCP-compatibele client die verbinding kan maken met het endpoint en een agentprofiel kan meesturen. De Shop MCP-release-informatie van 13 oktober beschrijft aanmeldflows voor MCP-clients zoals Claude en ChatGPT; ondersteuning en gedrag hangen af van de client.

Kost het extra tijd om catalogusgegevens via MCP op te vragen?

Shopify publiceert in de aangehaalde documentatie geen vaste responstijdgarantie voor Catalog MCP. Vertraging hangt af van de client, het verzoek en de dienst. Respecteer snelheidslimieten en sla cataloguszoekresultaten niet in de cache op.

Hoe beveilig ik mijn Shopify Catalog MCP-server?

Gebruik het vereiste agentprofiel, bescherm de clientconfiguratie, volg de gebruiksregels van Shopify en controleer welke productinformatie je agent toont. Standaard Catalog MCP-verzoeken gebruiken geen Admin API-token; andere integraties kunnen eigen inloggegevens en toegangscontroles hebben.

Kan ik Catalog MCP gebruiken voor actuele productaanbevelingen in mijn webshop?

Catalog MCP is bedoeld voor productontdekking en variantselectie door een agent. Het retourneert productgegevens en checkoutlinks; Shopify documenteert het niet als een storefront-API met lage latentie. Kies voor een aangepaste storefront de interface die past bij de prestatie- en weergavevereisten.

Verder lezen

Statistieken over Shopify-bestellingen bewerken (2026) · Shopify MCP en UCP in 2026: actuele endpoints en hun functies · Shopify en Universal Commerce Protocol: een ontwikkelaarsgids · Shopify AI Toolkit 2026: wat ontwikkelaars en merchants moeten weten · Shopify-orderbeheer 2026: draaiboek voor Plus-teams · Een Shopify-bestelling annuleren: stappen voor klanten en merchants · Verkopen via ChatGPT met Shopify: actuele gids voor Agentic Storefronts (2026) · Shopify Scripts na 30 juni 2026: migreren naar Functions · Klanten hun eigen bestellingen laten bewerken in Shopify (2026)