- MCP (Model Context Protocol) är en öppen standard som låter AI-appar anropa verktyg i andra tjänster, så att en assistent kan svara utifrån din verkliga butiksdata.
- ROASaurus Ask AI och ROASaurus MCP-server delar 24 skrivskyddade verktyg, från vinst, attribution och kundvärde till kostnader, leads, prenumerationer, marketing mix-modellen och avvikelser.
- En AI-app ansluter genom att logga in i ROASaurus med OAuth, eller med en API-nyckel i en Authorization-header.
- En namngiven nyckel med bara behörigheten mcp kan bara läsa; Orders API-nyckeln kan också skicka ordrar, så håll alla nycklar hemliga och återkalla en nyckel om den läcker.
- Perioderna är fasta (i dag, i går eller de senaste 7, 14, 30 eller 90 dagarna), och Ask AI tillåter som standard 40 frågor per användare och dag.
En Shopify MCP-server kopplar din butiksdata till en AI-assistent via Model Context Protocol (MCP). Du ställer en fråga med vanliga ord, till exempel ”Vilken kampanj gav mest vinst förra månaden?”, och assistenten svarar utifrån din butiks verkliga siffror i stället för utifrån minnet. ROASaurus kör en MCP-server med 24 skrivskyddade analysverktyg, och samma verktyg driver Ask AI i dashboarden.
Den här guiden förklarar vad MCP är, varför det hjälper att ställa analysfrågor på det här sättet, hur Ask AI och MCP-servern fungerar, hur du ansluter en klient, vilka frågor som fungerar bra, och vad du bör känna till om integritet, säkerhet och begränsningar.
Vad är MCP?
MCP är en öppen källkodsstandard för att koppla AI-applikationer till externa system. En AI-app som Claude är klienten. En tjänst som erbjuder data eller åtgärder är servern. Servern beskriver sina verktyg: varje verktyg har ett namn, en beskrivning och ett schema för sina indata.
När du ställer en fråga frågar klienten servern vilka verktyg som finns (tools/list). Modellen väljer det verktyg som passar och klienten anropar det (tools/call). Resultatet går tillbaka till modellen, som skriver svaret. Du behöver inte känna till verktygens namn. Du ställer bara frågan.
Shopify driver också MCP-servrar. De fokuserar på shoppingagenter och utvecklare: produktsökning, varukorgar, kassa, kundkonton och utvecklardokumentation. En MCP-server för analys svarar på en annan sorts fråga: vinst efter annonser, attribution och kundvärde, beräknat från dina ordrar, dina kostnader och annonskostnaden i dina annonskonton.
Varför ställa frågor om din butiksdata i en AI-assistent?
De flesta butiksfrågor behöver siffror från flera rapporter. ”Tjänade Meta pengar förra månaden?” kräver intäkter, produktkostnader, frakt, avgifter och annonskostnad på ett ställe. I en dashboard öppnar du rätt rapport, anger datumen och gör beräkningen. I en AI-assistent som är kopplad till din data ställer du frågan och får svaret med siffrorna bakom.
- Vanligt språk. Inga filter, rapportbyggare eller kalkylbladsformler.
- Följdfrågor. Fråga ”och för TikTok?” eller ”vilken kampanj orsakade det?” utan att börja om.
- Flera rapporter i ett svar. Vinst, attribution och kundvärde kan kombineras i ett och samma svar.
- Ditt eget språk. Ask AI svarar på det språk du skriver på.
- Vid sidan av ditt andra arbete. Via MCP finns butikens siffror i den AI-app där du redan skriver uppdateringar eller planer.
Svaret är bara så fullständigt som datan bakom det. Anslut server-side tracking, dina annonskonton och dina produktkostnader först, så att verktygen har ordrar, annonskostnader och marginaler att arbeta med.
Hur fungerar Ask AI och ROASaurus MCP-server?
Ask AI är en chattsida i ROASaurus dashboard. Den körs på Claude, Anthropics modell. MCP-servern erbjuder samma 24 verktyg till en AI-klient som du väljer. I båda fallen läser verktygen dina ROASaurus-rapporter och returnerar siffrorna som JSON. Modellen skriver svaret utifrån de resultaten.
Varje analysverktyg läser bara. Inget verktyg kan ändra din butik, dina kampanjer, dina kostnader eller dina inställningar. MCP-servern markerar vart och ett av dem som skrivskyddat och säger åt klienten att bara svara utifrån verktygsresultat. En nyckel med behörigheten actions:write får också propose_action, som lägger till en föreslagen annonsändring i Actions-inkorgen; ingenting ändras förrän en ägare eller administratör godkänner den. Ask AI i dashboarden har det också.
I Ask AI kan en fråga använda upp till 8 omgångar med verktygsanrop. Om en fråga kräver fler ber assistenten dig vara mer specifik. Ask AI sparar din konversation per användare och butik och använder de senaste 12 meddelandena som kontext för en följdfråga. Du kan rensa konversationen när som helst.
Vilka frågor kan du ställa?
Bra frågor nämner ett mått och en av de perioder som stöds. Tabellen visar exempelfrågor, det verktyg som svarar på var och en och vad svaret bygger på.
| Fråga | Verktyg | Det som svaret visar |
|---|---|---|
| Hur jämfördes de senaste 7 dagarna med de 7 dagarna före? | profit_summary | Intäkter, ordrar, annonskostnad, MER, POAS och vinst, mot föregående period av samma längd |
| Vilken kampanj hade bäst POAS de senaste 30 dagarna? | campaign_profit | Per kampanj: tillskrivna intäkter, bruttovinst, annonskostnad, vinst efter annonser, ROAS, POAS och CAC |
| Vilka annonser har högt CPM och få köp? | ads_table | Kostnad, visningar, klick, CTR och CPM bredvid spårade köp, ROAS och CPA |
| Hur många månader tar det innan en kohort har täckt sin CAC? | ltv_insights | Månadskohorter, payback-månad för CAC och prognostiserat LTV |
| Vilka produkter ger flest återkommande kunder? | products | Toppprodukter och andelen förstagångsköpare som beställde igen |
| Ligger vi i fas med intäktsmålet för den här månaden? | goals_forecast | Mål, utfall hittills och prognosen för månadens slut |
| Vad ska jag beställa in igen den här veckan? | inventory | Lagersaldo, försäljningstakt, dagar kvar i lager och status för ombeställning |
Här är ett exempel. Du frågar: ”Tjänade Meta pengar de senaste 30 dagarna?” Modellen anropar campaign_profit med perioden satt till 30 dagar och standardmodellen last click. För en exempelbutik ser Meta-raden i resultatet ut så här:
| Rad | Meta, senaste 30 dagarna | Så beräknas det |
|---|---|---|
| Tillskrivna intäkter | $24,000 | Intäkter från de ordrar som tillskrivs Meta-klick |
| Bruttovinst (contribution i resultatet) | $13,440 | Intäkter minus produktkostnad, frakt, betalavgifter och hantering (56%) |
| Annonskostnad | $8,000 | Synkad från Meta-annonskontot |
| Vinst efter annonser | $5,440 | $13,440 − $8,000 |
| ROAS | 3.00 | $24,000 ÷ $8,000 |
| POAS | 1.68 | $13,440 ÷ $8,000 |
I Ask AI inleds svaret med ”Ja”, och därefter anges vinsten efter annonser och POAS, samt högst tre förslag på nästa steg. Om du vill ha en annan vinkel kan du ställa en följdfråga som ”och med Total Impact-modellen?”. Våra guider om POAS och attributionsmodeller förklarar siffrorna mer ingående.
Hur ansluter du ROASaurus MCP-server?
Servern använder MCP:s Streamable HTTP-transport och returnerar JSON-svar, utan server-sent events. AI-appar som Claude och ChatGPT loggar in med OAuth: du loggar in i ROASaurus, väljer en butik och godkänner anslutningen. Klienter där du kan ange en request-header, som Claude Code, kan använda en API-nyckel i stället, som i stegen nedan.
- Skapa en API-nyckel
Öppna Store settings › API & data i ROASaurus och skapa en namngiven nyckel med behörigheten
mcp. Kopiera den: den visas bara en gång. Bara ägare och administratörer kan skapa nycklar. - Eller återanvänd Orders API-nyckeln
Du kan också använda nyckeln på kortet Orders API, till exempel den som WooCommerce-pluginet använder. Den nyckeln kan också skicka ordrar. Regenerate API key ersätter den och kopplar bort allt som använder den gamla.
- Notera butiksnyckeln
En namngiven nyckel läggs ensam i headern. Med Orders API-nyckeln lägger du till butiksnyckeln: värdet
X-Roasaurus-Keypå samma kort, vars MCP-avsnitt visar hela headern. - Lägg till servern i din MCP-klient
Ange endpointen och Authorization-headern som visas nedan. Klienten måste stödja Streamable HTTP och egna request-headers.
- Ställ en testfråga
Fråga "Vad var mina intäkter i går?" och kontrollera siffran mot din 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 också skicka butiksnyckeln i en X-Roasaurus-Key-header och bara API-nyckeln som bearer-token. I Claude Code behåller du det lokala standardomfånget. En server med projektomfång sparas i en .mcp.json-fil som delas via versionshantering, och då skulle din nyckel delas.
Vill du logga in i stället lägger du till https://app.roasaurus.com/mcp som anpassad connector i Claude eller ChatGPT och loggar in när appen ber om det. Bara ägare och administratörer kan godkänna en anslutning. Store settings › API & data visar varje ansluten app, där du kan koppla från den, och en anslutning upphör också när personen lämnar arbetsytan.
initialize · 2025-06-18Klient och server enas om protokollversionentools/list · 24 tools · readOnlyHint: trueKlienten får veta vilka verktyg som finnstools/call · campaign_profit · period 30Modellen ber om 30 dagars kampanjvinstresult · isError: falseJSON med en rad per kanal och kampanj401 · Invalid store key or API key.Vad en felaktig eller omgenererad nyckel returnerarÄr det säkert? Integritet och säkerhet
Eftersom analysverktygen bara läser kan en AI-app inte pausa en kampanj, ändra en kostnad eller ändra en inställning via ROASaurus; med actions:write kan den bara föreslå en annonsändring som en ägare eller administratör får godkänna. Verktygen accepterar också bara fasta indata, som en period eller en attributionsmodell från en lista. Några punkter kräver ändå försiktighet.
- Vart datan går. Ask AI skickar din fråga och aggregerade butiksmått till Anthropic, som kör Claude. Den skickar inga kontaktuppgifter om dina kunder. Via MCP går verktygsresultaten till den AI-klient du ansluter, enligt den klientens villkor. Kontrollera dess inställningar för datalagring och träning.
- Vad verktygen returnerar. Summor per period, kanal, kampanj, annons, produkt, kohort och segment. De returnerar inga kundnamn, e-postadresser eller telefonnummer.
- Vem som kan fråga. Alla med åtkomst till den AI-app där du lägger till anslutningen kan fråga ut butiken. Lägg till den i ditt eget konto, inte i ett delat.
- Andra connectors. MCP-specifikationen säger att det alltid bör finnas en människa med i loopen som kan neka verktygsanrop, och att klienter måste behandla verktygsannoteringar som opålitliga om inte servern är betrodd. Om din AI-app också har verktyg som skickar e-post eller publicerar meddelanden, låt bekräftelsefrågorna vara påslagna för de verktygen.
Vilka begränsningar finns?
- Fasta perioder. I dag, i går eller de senaste 7, 14, 30 eller 90 dagarna, i butikens tidszon. Ett eget intervall, som en vecka i mars, stöds inte. Verktygen för kundvärde och kohorter tar ingen period: de utgår från din orderhistorik, med upp till 12 månadskohorter.
- Ett 7-dagarsfönster för annonstabellen. Annonsverktyget använder ett lookback-fönster på 7 dagar, oavsett vilket fönster du ställer in i Store settings. Verktygen för attribution och kampanjvinst använder, precis som rapporterna om attribution i dashboarden, din egen inställning eller ett lookback-fönster du frågar efter.
- Förkortade listor. Kampanjlistor returnerar högst 25 kampanjer, annonstabellen de 30 raderna med mest kostnad, och produktlistan de 25 främsta produkterna.
- En butik per anslutning. För flera butiker skapar du en nyckel och en anslutning för varje.
- Gränsen för Ask AI-frågor. Varje användare kan ställa 40 frågor per dag som standard, räknat över de senaste 24 timmarna. Via MCP gäller i stället din AI-klients egna användningsgränser.
- Svar kan vara fel. Modellen kan misstolka ett resultat. Kontrollera viktiga siffror i rapporterna innan du agerar på dem, till exempel i vinstanalysen.
Källor
- Model Context Protocol: What is the Model Context Protocol (MCP)?
- Model Context Protocol specification (2025-06-18): Tools
- Claude Code Docs: Connect Claude Code to tools via MCP
- Claude Docs: Authentication for connectors
- OpenAI: Building MCP servers for plugins and API integrations