Shopify MCP: still spørsmål til butikkdataene dine i Claude og andre AI-apper

En Shopify MCP-server kobler butikkdataene dine til en AI-assistent gjennom Model Context Protocol (MCP). Du stiller et spørsmål på vanlig språk, som «Hvilken kampanje ga mest fortjeneste forrige måned?», og assistenten svarer ut fra butikkens faktiske tall i stedet for fra hukommelsen. ROASaurus kjører en MCP-server med 24 skrivebeskyttede analyseverktøy, og de samme verktøyene driver Ask AI inne i dashboardet.

Denne guiden forklarer hva MCP er, hvorfor det hjelper å stille analysespørsmål på denne måten, hvordan Ask AI og MCP-serveren fungerer, hvordan du kobler til en klient, hvilke spørsmål som fungerer godt, og personvernet, sikkerheten og begrensningene du bør kjenne til.

Hva er MCP?

MCP er en åpen kildekode-standard for å koble AI-applikasjoner til eksterne systemer. En AI-app som Claude er klienten. En tjeneste som tilbyr data eller handlinger, er serveren. Serveren beskriver verktøyene sine: hvert verktøy har et navn, en beskrivelse og et skjema for inndataene.

Når du stiller et spørsmål, spør klienten serveren hvilke verktøy som finnes (tools/list). Modellen velger verktøyet som passer, og klienten kaller det (tools/call). Resultatet går tilbake til modellen, som skriver svaret. Du trenger ikke kjenne verktøynavnene. Du stiller bare spørsmålet.

Shopify kjører også MCP-servere. De fokuserer på handleagenter og utviklere: produktsøk, handlekurver, checkout, kundekontoer og utviklerdokumentasjon. En MCP-server for analyse svarer på en annen type spørsmål: fortjeneste etter annonser, attribusjon og kundeverdi, beregnet fra bestillingene dine, kostnadene dine og annonsekostnadene i annonsekontoene dine.

Hvorfor stille spørsmål til butikkdataene dine i en AI-assistent?

De fleste spørsmål om butikken trenger tall fra flere rapporter. «Tjente Meta penger forrige måned?» trenger omsetning, produktkostnader, frakt, gebyrer og annonsekostnader på ett sted. I et dashboard åpner du riktig rapport, setter datoene og gjør regnestykket. I en AI-assistent som er koblet til dataene dine, stiller du spørsmålet og får svaret med tallene bak.

• Vanlig språk. Ingen filtre, rapportbyggere eller regnearkformler.
• Oppfølgingsspørsmål. Spør «og for TikTok?» eller «hvilken kampanje forårsaket det?» uten å begynne på nytt.
• Flere rapporter i ett svar. Fortjeneste, attribusjon og kundeverdi kan kombineres i ett svar.
• Ditt eget språk. Ask AI svarer på språket du skriver på.
• Ved siden av det andre arbeidet ditt. Gjennom MCP er butikktallene tilgjengelige i AI-appen der du allerede skriver oppdateringer eller planer.

Svaret er bare så fullstendig som dataene bak det. Koble først til server-side tracking, annonsekontoene dine og produktkostnadene dine, slik at verktøyene har bestillinger, annonsekostnader og marginer å jobbe med.

Hvordan fungerer Ask AI og ROASaurus MCP-serveren?

Ask AI er en chatside i ROASaurus-dashboardet. Den kjører på Claude, Anthropics modell. MCP-serveren tilbyr de samme 24 verktøyene til en AI-klient du velger. I begge tilfeller leser verktøyene ROASaurus-rapportene dine og returnerer tallene som JSON. Modellen skriver svaret ut fra disse resultatene.

Hvert analyseverktøy leser bare. Ingen verktøy kan endre butikken din, kampanjene dine, kostnadene dine eller innstillingene dine. MCP-serveren markerer hvert av dem som skrivebeskyttet, og den ber klienten svare bare ut fra verktøyresultater. En nøkkel med scopet actions:write får også propose_action, som legger en foreslått annonseendring i Actions-innboksen; ingenting endres før en eier eller administrator godkjenner den. Ask AI i dashboardet har det også.

I Ask AI kan ett spørsmål bruke opptil 8 runder med verktøykall. Hvis et spørsmål trenger flere, ber assistenten deg om å være mer spesifikk. Ask AI lagrer samtalen din per bruker og butikk, og bruker de siste 12 meldingene som kontekst for et oppfølgingsspørsmål. Du kan tømme samtalen når som helst.

Hvilke spørsmål kan du stille?

Gode spørsmål nevner en måling og en av de støttede periodene. Tabellen viser eksempelspørsmål, verktøyet som svarer på hvert av dem, og hva svaret bygger på.

Her er et regneeksempel. Du spør: «Tjente Meta penger de siste 30 dagene?» Modellen kaller campaign_profit med perioden satt til 30 dager og standardmodellen siste klikk. For en eksempelbutikk ser Meta-raden i resultatet slik ut:

I Ask AI starter svaret med «Ja», gir deretter fortjenesten etter annonser og POAS, og foreslår høyst tre neste steg. Hvis du vil ha en annen vinkling, stiller du et oppfølgingsspørsmål som «og med Total Impact-modellen?». Guidene våre om POAS og attribusjonsmodeller forklarer disse tallene mer i dybden.

Hvordan kobler du til ROASaurus MCP-serveren?

Serveren bruker Streamable HTTP-transporten i MCP og returnerer JSON-svar, uten server-sent events. AI-apper som Claude og ChatGPT logger inn med OAuth: du logger inn i ROASaurus, velger en butikk og godkjenner tilkoblingen. Klienter der du kan angi en request-header, som Claude Code, kan bruke en API-nøkkel i stedet, som i trinnene nedenfor.

1. Opprett en API-nøkkel

   Åpne Store settings › API & data i ROASaurus og opprett en navngitt nøkkel med scopet mcp. Kopier den: den vises bare én gang. Bare eiere og administratorer kan opprette nøkler.

2. Eller gjenbruk Orders API-nøkkelen

   Du kan også bruke nøkkelen på kortet Orders API, for eksempel den WooCommerce-pluginen bruker. Den nøkkelen kan også sende bestillinger. Regenerate API key erstatter den og kobler fra alt som bruker den gamle.

3. Noter butikknøkkelen

   En navngitt nøkkel legges alene i headeren. Med Orders API-nøkkelen legger du til butikknøkkelen: verdien X-Roasaurus-Key på det samme kortet, der MCP-delen viser hele headeren.

4. Legg serveren til i MCP-klienten din

   Skriv inn endepunktet og Authorization-headeren som vises nedenfor. Klienten må støtte Streamable HTTP og egendefinerte forespørselsheadere.

5. Still et testspørsmål

   Spør «Hva var omsetningen min i går?» og sjekk tallet mot dashboardet ditt.

# 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>"

Du kan også sende butikknøkkelen i en X-Roasaurus-Key-header og bare API-nøkkelen som bearer-token. I Claude Code beholder du standard lokalt omfang. En server med prosjektomfang lagres i en .mcp.json-fil som deles gjennom versjonskontroll, og det ville delt nøkkelen din.

Vil du heller logge inn, legger du til https://app.roasaurus.com/mcp som egendefinert connector i Claude eller ChatGPT og logger inn når appen ber om det. Bare eiere og administratorer kan godkjenne en tilkobling. Store settings › API & data viser hver tilkoblet app, der du kan koble den fra, og en tilkobling stopper også når personen forlater arbeidsområdet.

Er det trygt? Personvern og sikkerhet

Fordi analyseverktøyene bare leser, kan ikke en AI-app sette en kampanje på pause, redigere en kostnad eller endre en innstilling gjennom ROASaurus; med actions:write kan den bare foreslå en annonseendring som en eier eller administrator må godkjenne. Verktøyene godtar også bare faste inndata, som en periode eller en attribusjonsmodell fra en liste. Likevel er det noen punkter som krever forsiktighet.

• Hvor dataene går. Ask AI sender spørsmålet ditt og aggregerte butikkmålinger til Anthropic, som kjører Claude. Den sender ingen kontaktopplysninger om kundene dine. Gjennom MCP går verktøyresultatene til AI-klienten du kobler til, på denne klientens vilkår. Sjekk innstillingene for datalagring og trening.
• Hva verktøyene returnerer. Totaler per periode, kanal, kampanje, annonse, produkt, kohort og segment. De returnerer ingen kundenavn, e-postadresser eller telefonnumre.
• Hvem som kan spørre. Alle med tilgang til AI-appen der du legger til tilkoblingen, kan spørre om butikken. Legg den til på din egen konto, ikke på en delt konto.
• Andre connectors. MCP-spesifikasjonen sier at det alltid bør være et menneske i loopen som kan avslå verktøykall, og at klienter må behandle verktøyannoteringer som ikke pålitelige med mindre serveren er pålitelig. Hvis AI-appen din også har verktøy som sender e-post eller poster meldinger, la bekreftelsesmeldinger stå på for de verktøyene.

Hva er begrensningene?

• Faste perioder. I dag, i går, eller de siste 7, 14, 30 eller 90 dagene, i butikkens tidssone. Et egendefinert tidsrom, som én uke i mars, støttes ikke. Verktøyene for kundeverdi og kohorter tar ingen periode: de jobber ut fra bestillingshistorikken din, med opptil 12 månedlige kohorter.
• Et vindu på 7 dager for annonsetabellen. Annonseverktøyet bruker et attribusjonsvindu på 7 dager, uansett hvilket vindu du setter i Store settings. Verktøyene for attribusjon og kampanjefortjeneste bruker, som attribusjonsrapportene i dashboardet, din egen innstilling eller et attribusjonsvindu du ber om.
• Forkortede lister. Kampanjelister returnerer høyst 25 kampanjer, annonsetabellen de 30 radene med høyest annonsekostnader, og produktlisten de 25 beste produktene.
• Én butikk per tilkobling. For flere butikker oppretter du en nøkkel og en tilkobling for hver.
• Spørsmålsgrensen i Ask AI. Hver bruker kan som standard stille 40 spørsmål per dag, regnet over de siste 24 timene. Gjennom MCP gjelder i stedet bruksgrensene til AI-klienten din.
• Svar kan være feil. Modellen kan misforstå et resultat. Sjekk viktige tall i rapportene før du handler på dem, for eksempel i fortjenesteanalysen.

Kilder

1. Model Context Protocol: What is the Model Context Protocol (MCP)?
2. Model Context Protocol specification (2025-06-18): Tools
3. Claude Code Docs: Connect Claude Code to tools via MCP
4. Claude Docs: Authentication for connectors
5. OpenAI: Building MCP servers for plugins and API integrations

I ROASaurus

• Ask AI og MCP
• Fortjenesteanalyse
• POAS-kalkulator

Les videre