Shopify MCP: spørg til dine shopdata i Claude og andre AI-apps

En Shopify MCP-server forbinder dine shopdata med en AI-assistent gennem Model Context Protocol (MCP). Du stiller et spørgsmål i almindeligt sprog, for eksempel »Hvilken kampagne gav mest overskud sidste måned?«, og assistenten svarer ud fra din shops rigtige tal i stedet for ud fra hukommelsen. ROASaurus kører en MCP-server med 24 skrivebeskyttede analyseværktøjer, og de samme værktøjer driver Ask AI i dashboardet.

Denne guide forklarer, hvad MCP er, hvorfor det hjælper at stille analysespørgsmål på denne måde, hvordan Ask AI og MCP-serveren fungerer, hvordan du forbinder en klient, hvilke spørgsmål der virker godt, og hvilke regler for privatliv, sikkerhed og begrænsninger du bør kende til.

Hvad er MCP?

MCP er en open source-standard til at forbinde AI-applikationer med eksterne systemer. En AI-app som Claude er klienten. En tjeneste, der tilbyder data eller handlinger, er serveren. Serveren beskriver sine værktøjer: Hvert værktøj har et navn, en beskrivelse og et skema for sine input.

Når du stiller et spørgsmål, spørger klienten serveren, hvilke værktøjer der findes (tools/list). Modellen vælger det værktøj, der passer, og klienten kalder det (tools/call). Resultatet går tilbage til modellen, som skriver svaret. Du behøver ikke kende værktøjernes navne. Du stiller bare spørgsmålet.

Shopify kører også MCP-servere. De fokuserer på shoppingagenter og udviklere: produktsøgning, kurve, checkout, kundekonti og udviklerdokumentation. En analyse-MCP-server besvarer en anden slags spørgsmål: overskud efter annoncer, attribution og kundeværdi, beregnet ud fra dine ordrer, dine omkostninger og forbruget i dine annoncekonti.

Hvorfor spørge dine shopdata i en AI-assistent?

De fleste spørgsmål om en shop kræver tal fra flere rapporter. »Tjente Meta penge sidste måned?« kræver omsætning, produktomkostninger, fragt, gebyrer og annonceforbrug samlet ét sted. I et dashboard åbner du den rigtige rapport, sætter datoerne og regner selv. I en AI-assistent, der er forbundet med dine data, stiller du spørgsmålet og får svaret med tallene bag.

• Almindeligt sprog. Ingen filtre, rapportbyggere eller regnearksformler.
• Opfølgende spørgsmål. Spørg »og for TikTok?« eller »hvilken kampagne forårsagede det?« uden at starte forfra.
• Flere rapporter i ét svar. Overskud, attribution og kundeværdi kan kombineres i ét svar.
• Dit eget sprog. Ask AI svarer på det sprog, du skriver på.
• Ved siden af dit øvrige arbejde. Gennem MCP er shoptal tilgængelige i den AI-app, hvor du allerede skriver opdateringer eller planer.

Svaret er kun så fuldstændigt som de data, der ligger bag. Forbind først server-side tracking, dine annoncekonti og dine produktomkostninger, så værktøjerne har ordrer, forbrug og marginer at arbejde med.

Hvordan fungerer Ask AI og ROASaurus MCP-serveren?

Ask AI er en chatside i ROASaurus-dashboardet. Den kører på Claude, Anthropics model. MCP-serveren tilbyder de samme 24 værktøjer til en AI-klient, du selv vælger. I begge tilfælde læser værktøjerne dine ROASaurus-rapporter og returnerer tallene som JSON. Modellen skriver svaret ud fra de resultater.

Hvert analyseværktøj læser kun. Intet værktøj kan ændre din shop, dine kampagner, dine omkostninger eller dine indstillinger. MCP-serveren markerer hvert af dem som skrivebeskyttet og beder klienten svare ud fra værktøjsresultater alene. En nøgle med scopet actions:write får også propose_action, som tilføjer en foreslået annonceændring til Actions-indbakken; intet ændres, før en ejer eller administrator godkender den. Ask AI i dashboardet har det også.

I Ask AI kan ét spørgsmål bruge op til 8 runder med værktøjskald. Hvis et spørgsmål kræver flere, beder assistenten dig være mere specifik. Ask AI gemmer din samtale pr. bruger og shop og bruger de seneste 12 beskeder som kontekst til et opfølgende spørgsmål. Du kan rydde samtalen når som helst.

Hvilke spørgsmål kan du stille?

Gode spørgsmål nævner en metrik og en af de understøttede perioder. Tabellen viser eksempelspørgsmål, det værktøj, der besvarer hvert af dem, og hvad svaret bygger på.

Her er et gennemregnet eksempel. Du spørger: »Tjente Meta penge de seneste 30 dage?« Modellen kalder campaign_profit med perioden sat til 30 dage og standardmodellen last click. For en eksempel-shop ser Meta-rækken i resultatet sådan ud:

I Ask AI starter svaret med »Ja«, giver derefter overskud efter annoncer og POAS og foreslår højst tre næste skridt. Hvis du vil have en anden vinkel, kan du stille et opfølgende spørgsmål som »og med Total Impact-modellen?«. Vores guides til POAS og attributionsmodeller forklarer disse tal mere dybdegående.

Hvordan forbinder du ROASaurus MCP-serveren?

Serveren bruger MCP’s Streamable HTTP-transport og returnerer JSON-svar uden server-sent events. AI-apps som Claude og ChatGPT logger ind med OAuth: du logger ind i ROASaurus, vælger en shop og giver tilladelse til forbindelsen. Klienter, hvor du kan sætte en request-header, som Claude Code, kan bruge en API-nøgle i stedet, som i trinene nedenfor.

1. Opret en API-nøgle

   Åbn Store settings › API & data i ROASaurus, og opret en navngiven nøgle med scopet mcp. Kopiér den: Den vises kun én gang. Kun ejere og administratorer kan oprette nøgler.

2. Eller genbrug Orders API-nøglen

   Du kan også bruge nøglen på kortet Orders API, for eksempel den, WooCommerce-pluginet bruger. Den nøgle kan også sende ordrer. Regenerate API key erstatter den og afbryder alt, der bruger den gamle.

3. Notér shopnøglen

   En navngiven nøgle sættes alene i headeren. Med Orders API-nøglen skal du tilføje shopnøglen: værdien X-Roasaurus-Key på det samme kort, hvis MCP-sektion viser den fulde header.

4. Tilføj serveren til din MCP-klient

   Indtast endpointet og den Authorization-header, der vises nedenfor. Klienten skal understøtte Streamable HTTP og brugerdefinerede request headers.

5. Stil et testspørgsmål

   Spørg »Hvad var min omsætning i går?«, og tjek tallet mod dit dashboard.

# 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 shopnøglen i en X-Roasaurus-Key-header og kun API-nøglen som bearer-token. I Claude Code skal du beholde standard local scope. En server med project scope gemmes i en .mcp.json-fil, som deles via versionsstyring, og det ville dele din nøgle.

Vil du hellere logge ind, så tilføj https://app.roasaurus.com/mcp som custom connector i Claude eller ChatGPT, og log ind, når appen beder om det. Kun ejere og administratorer kan give tilladelse til en forbindelse. Store settings › API & data viser hver forbundet app, hvor du kan afbryde den, og en forbindelse stopper også, når personen forlader workspacet.

Er det sikkert? Privatliv og sikkerhed

Fordi analyseværktøjerne kun læser, kan en AI-app ikke sætte en kampagne på pause, redigere en omkostning eller ændre en indstilling gennem ROASaurus; med actions:write kan den kun foreslå en annonceændring, som en ejer eller administrator skal godkende. Værktøjerne accepterer også kun faste input, som en periode eller en attributionsmodel fra en liste. Alligevel er der nogle punkter, der kræver omtanke.

• Hvor dataene går hen. Ask AI sender dit spørgsmål og aggregerede shopmetrikker til Anthropic, som kører Claude. Den sender ingen kontaktoplysninger på dine kunder. Gennem MCP går værktøjsresultaterne til den AI-klient, du forbinder, under den klients vilkår. Tjek dens indstillinger for dataopbevaring og træning.
• Det, værktøjerne returnerer. Totaler pr. periode, kanal, kampagne, annonce, produkt, kohorte og segment. De returnerer ingen kundenavne, e-mailadresser eller telefonnumre.
• Hvem der kan spørge. Alle med adgang til den AI-app, hvor du tilføjer forbindelsen, kan forespørge shoppen. Tilføj den til din egen konto, ikke til en delt.
• Andre connectors. MCP-specifikationen siger, at der altid bør være et menneske i loopet, som kan afvise værktøjskald, og at klienter skal behandle værktøjsannotationer som ikke-troværdige, medmindre serveren er troværdig. Hvis din AI-app også har værktøjer, der sender e-mail eller poster beskeder, så behold bekræftelsesprompter slået til for de værktøjer.

Hvad er begrænsningerne?

• Faste perioder. I dag, i går eller de seneste 7, 14, 30 eller 90 dage, i shoppens tidszone. Et brugerdefineret interval, som én uge i marts, understøttes ikke. Værktøjerne til kundeværdi og kohorter tager ingen periode: De arbejder ud fra din ordrehistorik med op til 12 månedlige kohorter.
• Et vindue på 7 dage for annoncetabellen. Annonceværktøjet bruger et lookback-vindue på 7 dage, uanset hvilket vindue du har sat i Store settings. Værktøjerne til attribution og kampagneoverskud bruger, ligesom attributionsrapporterne i dashboardet, din egen indstilling eller et lookback-vindue, du beder om.
• Forkortede lister. Kampagnelister returnerer højst 25 kampagner, annoncetabellen de 30 rækker med mest forbrug og produktlisten de 25 bedste produkter.
• Én shop pr. forbindelse. Til flere shops skal du oprette en nøgle og en forbindelse for hver.
• Grænsen for Ask AI-spørgsmål. Hver bruger kan som standard stille 40 spørgsmål om dagen, talt over de seneste 24 timer. Gennem MCP gælder din AI-klients egne brugsgrænser i stedet.
• Svar kan være forkerte. Modellen kan misforstå et resultat. Tjek vigtige tal i rapporterne, før du handler på dem, for eksempel i overskudsanalysen.

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
• Overskudsanalyse
• POAS-beregner

Læs videre