Wat is een Shopify MCP-server?

Het is een server die het Model Context Protocol gebruikt om AI-apps tools te geven voor een Shopify-webshop. De ROASaurus MCP-server geeft een AI-client alleen-lezen tools voor winst, attributie, advertenties, klantwaarde, voorraad, doelen, benchmarks en waarschuwingen van één webshop.

Kan de AI mijn campagnes of mijn webshop wijzigen?

Niet zelfstandig. De analysetools in Ask AI en de MCP-server lezen alleen. Ask AI, en een MCP-client waarvan de sleutel de scope actions:write heeft, kunnen in de Actions-inbox een wijziging aan een campagne voorstellen, en er verandert niets totdat een eigenaar of beheerder die goedkeurt. Geen van beide kan je webshop, je kosten of je instellingen bewerken.

Welke AI-apps kunnen verbinding maken met de ROASaurus MCP-server?

Claude, ChatGPT en andere MCP-clients die OAuth ondersteunen, loggen in met je ROASaurus-login. Clients waarin je een Authorization-header kunt instellen, zoals Claude Code, kunnen in plaats daarvan een API-sleutel gebruiken.

Worden klantgegevens naar de AI gestuurd?

De tools geven geaggregeerde metrics terug, geen contactgegevens van klanten. Ask AI stuurt je vraag en deze metrics naar Anthropic; via MCP gaan de resultaten naar de AI-client die je koppelt.

Waarom kan ik niet vragen naar een eigen datumbereik?

De tools accepteren alleen vaste periodes: vandaag, gisteren, of de laatste 7, 14, 30 of 90 dagen in de tijdzone van de webshop. Vragen over klantwaarde en cohorten nemen geen periode en gebruiken in plaats daarvan je bestelgeschiedenis.

Tellen MCP-vragen mee voor de limiet van 40 vragen?

Nee. De dagelijkse limiet geldt voor Ask AI in het dashboard. Via MCP gelden de gebruikslimieten van je eigen AI-client.

Shopify MCP: stel vragen over je webshopdata in Claude en andere AI-apps

Belangrijkste punten

MCP (Model Context Protocol) is een open standaard waarmee AI-apps tools van andere diensten kunnen aanroepen, zodat een assistent kan antwoorden op basis van je echte webshopdata.
ROASaurus Ask AI en de ROASaurus MCP-server delen 24 alleen-lezen tools, van winst, attributie en klantwaarde tot kosten, leads, abonnementen, het marketing mix model en afwijkingen.
Een AI-app maakt verbinding door met OAuth in te loggen bij ROASaurus, of met een API-sleutel in een Authorization-header.
Een benoemde sleutel met alleen de scope mcp kan alleen lezen; met de Orders API-sleutel kun je ook bestellingen versturen, dus houd elke sleutel geheim en trek hem in als hij uitlekt.
De periodes liggen vast (vandaag, gisteren, of de laatste 7, 14, 30 of 90 dagen), en Ask AI staat standaard 40 vragen per gebruiker per dag toe.

Een Shopify MCP-server verbindt je webshopdata via het Model Context Protocol (MCP) met een AI-assistent. Je stelt een vraag in gewone taal, zoals “Welke campagne leverde vorige maand de meeste winst op?”, en de assistent antwoordt met de echte cijfers van je webshop in plaats van uit het geheugen. ROASaurus draait een MCP-server met 24 alleen-lezen analysetools, en dezelfde tools sturen Ask AI in het dashboard aan.

Deze gids legt uit wat MCP is, waarom het helpt om analysevragen op deze manier te stellen, hoe Ask AI en de MCP-server werken, hoe je een client koppelt, welke vragen goed werken en wat je moet weten over privacy, beveiliging en beperkingen.

Wat is MCP?

MCP is een open-sourcestandaard om AI-toepassingen met externe systemen te verbinden. Een AI-app zoals Claude is de client. Een dienst die data of acties aanbiedt, is de server. De server beschrijft zijn tools: elke tool heeft een naam, een beschrijving en een schema voor zijn invoer.

Wanneer je een vraag stelt, vraagt de client aan de server welke tools er zijn (tools/list). Het model kiest de tool die past en de client roept die aan (tools/call). Het resultaat gaat terug naar het model, dat het antwoord schrijft. Je hoeft de namen van de tools niet te kennen. Je stelt alleen de vraag.

Shopify draait ook MCP-servers. Die richten zich op shopping agents en ontwikkelaars: productzoekopdrachten, winkelwagens, checkout, klantaccounts en ontwikkelaarsdocumentatie. Een analyse-MCP-server beantwoordt een ander soort vraag: winst na advertenties, attributie en klantwaarde, berekend uit je bestellingen, je kosten en de uitgaven in je advertentieaccounts.

Waarom vragen stellen over je webshopdata in een AI-assistent?

De meeste vragen over je webshop hebben cijfers uit meerdere rapporten nodig. “Heeft Meta vorige maand geld opgeleverd?” vraagt om omzet, productkosten, verzending, transactiekosten en advertentiekosten op één plek. In een dashboard open je het juiste rapport, stel je de data in en doe je de rekensom. In een AI-assistent die met je data is verbonden, stel je de vraag en krijg je het antwoord met de cijfers erachter.

Gewone taal. Geen filters, rapportbuilders of spreadsheetformules.
Vervolgvragen. Vraag “en voor TikTok?” of “welke campagne veroorzaakte dat?” zonder opnieuw te beginnen.
Meerdere rapporten in één antwoord. Winst, attributie en klantwaarde kunnen in één antwoord worden gecombineerd.
Je eigen taal. Ask AI antwoordt in de taal waarin je schrijft.
Naast je andere werk. Via MCP zijn de cijfers van je webshop beschikbaar in de AI-app waarin je al updates of plannen schrijft.

Het antwoord is maar zo compleet als de data erachter. Koppel eerst server-side tracking, je advertentieaccounts en je productkosten, zodat de tools bestellingen, uitgaven en marges hebben om mee te werken.

Hoe werken Ask AI en de ROASaurus MCP-server?

Ask AI is een chatpagina in het ROASaurus-dashboard. Het draait op Claude, het model van Anthropic. De MCP-server biedt dezelfde 24 tools aan een AI-client naar keuze. In beide gevallen lezen de tools je ROASaurus-rapporten en geven ze de cijfers als JSON terug. Het model schrijft het antwoord uit die resultaten.

Je stelt een vraagIn Ask AI of in je eigen MCP-client

Het model kiest een toolBijvoorbeeld campaign_profit voor de laatste 30 dagen

ROASaurus voert de tool uitAlleen-lezen, op de data van één webshop

Het model schrijft het antwoordAlleen uit de teruggegeven cijfers

Het model leest je database nooit rechtstreeks. Het ziet alleen wat een tool teruggeeft.

Elke analysetool leest alleen. Geen enkele tool kan je webshop, campagnes, kosten of instellingen wijzigen. De MCP-server markeert ze allemaal als alleen-lezen en vertelt de client dat die alleen uit toolresultaten mag antwoorden. Een sleutel met de scope actions:write krijgt ook propose_action, dat een voorgestelde advertentiewijziging aan de Actions-inbox toevoegt; er verandert niets totdat een eigenaar of beheerder die goedkeurt. Ask AI in het dashboard heeft deze tool ook.

In Ask AI kan één vraag tot 8 rondes aan toolaanroepen gebruiken. Als een vraag er meer nodig heeft, vraagt de assistent je om specifieker te zijn. Ask AI bewaart je gesprek per gebruiker en webshop en gebruikt de laatste 12 berichten als context voor een vervolgvraag. Je kunt het gesprek op elk moment wissen.

24alleen-lezen tools, hetzelfde in Ask AI en MCP

6vaste periodes: vandaag, gisteren, 7, 14, 30 en 90 dagen

40Ask AI-vragen per gebruiker per dag, standaard

1webshop per API-sleutel en per verbinding

Welke vragen kun je stellen?

Goede vragen noemen een metric en een van de ondersteunde periodes. De tabel toont voorbeeldvragen, de tool die elke vraag beantwoordt en waarop het antwoord is gebaseerd.

Vraag	Tool	Wat het antwoord toont
Hoe verhielden de laatste 7 dagen zich tot de 7 dagen daarvoor?	`profit_summary`	Omzet, bestellingen, advertentiekosten, MER, POAS en winst, tegenover de vorige periode van gelijke lengte
Welke campagne had de beste POAS in de laatste 30 dagen?	`campaign_profit`	Per campagne: toegeschreven omzet, brutowinst, advertentiekosten, winst na advertenties, ROAS, POAS en CAC
Welke advertenties hebben een hoge CPM en weinig aankopen?	`ads_table`	Uitgaven, vertoningen, klikken, CTR en CPM naast getrackte aankopen, ROAS en CPA
Hoeveel maanden heeft een cohort nodig om zijn CAC terug te verdienen?	`ltv_insights`	Maandelijkse cohorten, de maand van de CAC-terugverdienperiode en voorspelde LTV
Welke producten leveren de meeste terugkerende klanten op?	`products`	Topproducten en het aandeel eerste kopers dat opnieuw bestelde
Liggen we op koers voor het omzetdoel van deze maand?	`goals_forecast`	Doelen, werkelijke cijfers tot nu toe en de prognose voor het einde van de maand
Wat moet ik deze week opnieuw bestellen?	`inventory`	Voorraad, verkoopsnelheid, resterende dagen voorraad en herbestelstatus

Het model kiest de tool. Jij hoeft alleen de vraag te stellen.

Hier is een uitgewerkt voorbeeld. Je vraagt: “Heeft Meta de laatste 30 dagen geld opgeleverd?” Het model roept campaign_profit aan met de periode ingesteld op 30 dagen en het standaardmodel last click. Voor een voorbeeldwebshop ziet de Meta-rij van het resultaat er zo uit:

Regel	Meta, laatste 30 dagen	Hoe het wordt berekend
Toegeschreven omzet	$24,000	Omzet van de bestellingen die aan Meta-klikken zijn toegeschreven
Brutowinst (contribution in het resultaat)	$13,440	Omzet min productkosten, verzending, transactiekosten en afhandeling (56%)
Advertentiekosten	$8,000	Gesynchroniseerd uit het Meta-advertentieaccount
Winst na advertenties	$5,440	$13,440 − $8,000
ROAS	3.00	$24,000 ÷ $8,000
POAS	1.68	$13,440 ÷ $8,000

Voorbeeldwebshop. Een POAS boven 1.0 betekent dat de advertenties meer brutowinst terugverdienden dan ze kostten.

In Ask AI begint het antwoord met “Ja”, geeft dan de winst na advertenties en de POAS en stelt maximaal drie vervolgstappen voor. Wil je een andere invalshoek, stel dan een vervolgvraag zoals “en met het Total Impact-model?”. In onze gidsen over POAS en attributiemodellen worden deze cijfers uitgebreider uitgelegd.

Hoe koppel je de ROASaurus MCP-server?

De server gebruikt het Streamable HTTP-transport van MCP en geeft JSON-antwoorden terug, zonder server-sent events. AI-apps zoals Claude en ChatGPT loggen in met OAuth: je logt in bij ROASaurus, kiest een webshop en geeft toestemming voor de koppeling. Clients waarin je een request-header kunt instellen, zoals Claude Code, kunnen in plaats daarvan een API-sleutel gebruiken, zoals in de stappen hieronder.

Maak een API-sleutel aan
Open Store settings › API & data in ROASaurus en maak een benoemde sleutel aan met de scope mcp. Kopieer hem: hij wordt maar één keer getoond. Alleen eigenaren en beheerders kunnen sleutels aanmaken.
Of hergebruik de Orders API-sleutel
Je kunt ook de sleutel op de kaart Orders API gebruiken, bijvoorbeeld die van de WooCommerce-plugin. Met die sleutel kun je ook bestellingen versturen. Regenerate API key vervangt hem en verbreekt alles wat de oude gebruikt.
Noteer de webshopsleutel
Een benoemde sleutel gaat in zijn eentje in de header. Bij de Orders API-sleutel voeg je de webshopsleutel toe: de waarde van X-Roasaurus-Key op dezelfde kaart, waarvan het MCP-gedeelte de volledige header toont.
Voeg de server toe aan je MCP-client
Vul het endpoint en de Authorization-header in die hieronder staan. De client moet Streamable HTTP en aangepaste request headers ondersteunen.
Stel een testvraag
Vraag "Wat was mijn omzet gisteren?" en controleer het getal in je dashboard.

Endpoint en een voorbeeld voor Claude Code

# Endpoint
POST https://app.roasaurus.com/mcp
Authorization: Bearer <named key with the mcp scope>
# or, with the Orders API key
Authorization: Bearer <store key>:<API key>

# Claude Code
claude mcp add --transport http roasaurus https://app.roasaurus.com/mcp \
  --header "Authorization: Bearer <named key with the mcp scope>"

Je kunt de webshopsleutel ook in een header X-Roasaurus-Key meesturen en alleen de API-sleutel als bearer-token. Houd in Claude Code de standaard lokale scope aan. Een server met projectscope wordt opgeslagen in een bestand .mcp.json dat via versiebeheer wordt gedeeld, en dan zou je sleutel worden gedeeld.

Wil je liever inloggen? Voeg https://app.roasaurus.com/mcp toe als custom connector in Claude of ChatGPT en log in als de app daarom vraagt. Alleen eigenaren en beheerders kunnen een koppeling toestaan. Store settings › API & data toont elke gekoppelde app, waar je die kunt ontkoppelen, en een koppeling stopt ook als die persoon de workspace verlaat.

initialize · 2025-06-18Client en server stemmen de protocolversie af

tools/list · 24 tools · readOnlyHint: trueDe client leert welke tools er bestaan

tools/call · campaign_profit · period 30Het model vraagt om 30 dagen campagnewinst

result · isError: falseJSON met één rij per kanaal en campagne

401 · Invalid store key or API key.Wat een onjuiste of opnieuw gegenereerde sleutel teruggeeft

Hoe één vraag eruitziet tussen de client en de ROASaurus MCP-server.

Is het veilig? Privacy en beveiliging

Omdat de analysetools alleen lezen, kan een AI-app via ROASaurus geen campagne pauzeren, geen kosten bewerken en geen instelling wijzigen; met actions:write kan die alleen een advertentiewijziging voorstellen die een eigenaar of beheerder moet goedkeuren. De tools accepteren ook alleen vaste invoer, zoals een periode of een attributiemodel uit een lijst. Toch zijn er een paar punten waarop je moet letten.

Waar de data naartoe gaat. Ask AI stuurt je vraag en geaggregeerde webshopmetrics naar Anthropic, dat Claude draait. Het stuurt geen contactgegevens van je klanten mee. Via MCP gaan toolresultaten naar de AI-client die je koppelt, onder de voorwaarden van die client. Controleer de instellingen voor gegevensbewaring en training.
Wat de tools teruggeven. Totalen per periode, kanaal, campagne, advertentie, product, cohort en segment. Ze geven geen klantnamen, e-mailadressen of telefoonnummers terug.
Wie kan vragen stellen. Iedereen met toegang tot de AI-app waarin je de verbinding toevoegt, kan de webshop bevragen. Voeg hem toe aan je eigen account, niet aan een gedeeld account.
Andere connectors. De MCP-specificatie zegt dat er altijd een mens in de lus moet zijn die toolaanroepen kan weigeren, en dat clients toolannotaties als onbetrouwbaar moeten behandelen tenzij de server betrouwbaar is. Heeft je AI-app ook tools die e-mail versturen of berichten plaatsen, laat de bevestigingsvragen dan aan staan voor die tools.

Wat zijn de beperkingen?

Vaste periodes. Vandaag, gisteren, of de laatste 7, 14, 30 of 90 dagen, in de tijdzone van de webshop. Een eigen bereik, zoals één week in maart, wordt niet ondersteund. De tools voor klantwaarde en cohorten nemen geen periode: ze werken met je bestelgeschiedenis, met maximaal 12 maandelijkse cohorten.
Een periode van 7 dagen voor de advertentietabel. De advertentietool gebruikt een attributieperiode van 7 dagen, welke periode je ook instelt in Store settings. De tools voor attributie en campagnewinst gebruiken, net als de attributierapporten in het dashboard, je eigen instelling of een periode waar je om vraagt.
Ingekorte lijsten. Campagnelijsten geven maximaal 25 campagnes terug, de advertentietabel de 30 rijen met de hoogste uitgaven en de productlijst de top 25 producten.
Eén webshop per verbinding. Maak voor meerdere webshops een sleutel en een verbinding per webshop aan.
De limiet voor Ask AI-vragen. Elke gebruiker kan standaard 40 vragen per dag stellen, geteld over de laatste 24 uur. Via MCP gelden in plaats daarvan de eigen gebruikslimieten van je AI-client.
Antwoorden kunnen onjuist zijn. Het model kan een resultaat verkeerd lezen. Controleer belangrijke cijfers in de rapporten voordat je erop handelt, bijvoorbeeld in winstanalyse.

Bronnen

In ROASaurus

Lees verder

Creatives, e-mail en AICreatieve vermoeidheid bij Facebook-advertenties: wanneer vervang je een advertentie?Creatieve vermoeidheid bij Facebook-advertenties zie je aan een stijgende frequentie en een dalende CTR. Leer het per advertentie te meten, hook rate en hold rate te lezen en een verversingsroutine te plannen.Creatives, e-mail en AIKlaviyo-flows voor verlaten winkelwagens: herken meer shoppersDe flows voor verlaten winkelwagens en browse abandonment van Klaviyo bereiken alleen shoppers die Klaviyo kan identificeren. Leer hoe Klaviyo ze identificeert en hoe je er bij de checkout meer herkent.TrackingAdblockers en tracking: wat je webshop mislooptAdblockers blokkeren trackingpixels, waardoor advertentieplatforms aankopen missen. Zie welke events verloren gaan, waarom server-side events dat niet doen en hoe je je gat meet.