Mi az a Shopify MCP-szerver?

Olyan szerver, amely a Model Context Protocolt használja, hogy eszközöket adjon az AI-appoknak egy Shopify webáruházhoz. A ROASaurus MCP-szerver csak olvasható eszközöket ad egy AI-kliensnek egy webáruház profitjához, attribúciójához, hirdetéseihez, vásárlói értékéhez, készletéhez, céljaihoz, benchmarkjaihoz és riasztásaihoz.

Meg tudja változtatni az AI a kampányaimat vagy a webáruházamat?

Önmagától nem. Az Ask AI és az MCP-szerver analitikai eszközei csak olvasnak. Az Ask AI, valamint az az MCP-kliens, amelynek kulcsa actions:write hatókörrel rendelkezik, javasolhatja egy kampány módosítását az Actions inboxban, és semmi sem változik, amíg egy tulajdonos vagy adminisztrátor jóvá nem hagyja. Egyikük sem módosíthatja a webáruházadat, a költségeidet vagy a beállításaidat.

Mely AI-appok csatlakozhatnak a ROASaurus MCP-szerverhez?

A Claude, a ChatGPT és más, OAuth-ot támogató MCP-kliensek a ROASaurus-belépéseddel jelentkeznek be. Azok a kliensek, amelyekben beállíthatsz Authorization-fejlécet, például a Claude Code, helyette API-kulcsot is használhatnak.

Elmegy vásárlói adat az AI-nak?

Az eszközök összesített mutatókat adnak vissza, nem vásárlói elérhetőségi adatokat. Az Ask AI a kérdésedet és ezeket a mutatókat az Anthropicnak küldi; MCP-n keresztül az eredmények az általad csatlakoztatott AI-klienshez kerülnek.

Miért nem kérdezhetek egyéni dátumtartományról?

Az eszközök csak rögzített időszakokat fogadnak el: ma, tegnap, vagy az elmúlt 7, 14, 30 vagy 90 nap a webáruház időzónájában. A vásárlói érték és a kohorsz kérdések nem fogadnak időszakot, helyette a rendelési előzményeidet használják.

Beleszámítanak az MCP-kérdések a 40 kérdéses korlátba?

Nem. A napi korlát az irányítópulton lévő Ask AI-ra vonatkozik. Az MCP-n keresztül az AI-kliensed saját használati korlátjai érvényesek.

Shopify MCP: kérdezz a webáruházad adatairól a Claude-ban és más AI-appokban

A legfontosabb tudnivalók

Az MCP (Model Context Protocol) egy nyílt szabvány, amely lehetővé teszi az AI-appoknak, hogy más szolgáltatások eszközeit hívják meg, így egy asszisztens a valódi webáruház-adataidból tud válaszolni.
A ROASaurus Ask AI és a ROASaurus MCP-szerver 24 csak olvasható eszközön osztozik, a profittól, az attribúciótól és az ügyfélértéktől a költségeken, a leadeken és az előfizetéseken át a marketingmix-modellig és az anomáliákig.
Egy AI-alkalmazás OAuth-bejelentkezéssel csatlakozik a ROASaurushoz, vagy egy Authorization-fejlécben küldött API-kulccsal.
A csak mcp hatókörű elnevezett kulcs csak olvasni tud; az Orders API kulccsal rendelések is küldhetők, ezért minden kulcsot tarts titokban, és vond vissza, ha kiszivárog.
Az időszakok rögzítettek (ma, tegnap, vagy az elmúlt 7, 14, 30 vagy 90 nap), az Ask AI pedig alapértelmezetten felhasználónként napi 40 kérdést enged.

A Shopify MCP-szerver a Model Context Protocolon (MCP) keresztül kapcsolja össze a webáruházad adatait egy AI-asszisztenssel. Hétköznapi nyelven teszel fel egy kérdést, például: „Melyik kampány hozta a legtöbb profitot a múlt hónapban?”, és az asszisztens a webáruházad valós számaiból válaszol, nem emlékezetből. A ROASaurus egy 24 csak olvasható analitikai eszközt kínáló MCP-szervert futtat, és ugyanezek az eszközök működtetik az irányítópulton belüli Ask AI-t is.

Ez az útmutató elmagyarázza, mi az MCP, miért hasznos így feltenni az analitikai kérdéseket, hogyan működik az Ask AI és az MCP-szerver, hogyan csatlakoztass egy klienst, milyen kérdések működnek jól, és milyen adatvédelmi, biztonsági és korlátozási tudnivalók fontosak.

Mi az az MCP?

Az MCP egy nyílt forráskódú szabvány AI-alkalmazások külső rendszerekhez kapcsolására. Egy olyan AI-app, mint a Claude, a kliens. Az a szolgáltatás, amely adatot vagy műveleteket kínál, a szerver. A szerver leírja az eszközeit: minden eszköznek van neve, leírása és sémája a bemeneteihez.

Amikor kérdést teszel fel, a kliens megkérdezi a szervert, milyen eszközök léteznek (tools/list). A modell kiválasztja a megfelelőt, a kliens pedig meghívja (tools/call). Az eredmény visszamegy a modellhez, amely megírja a választ. Nem kell ismerned az eszközök neveit. Csak felteszed a kérdést.

A Shopify is üzemeltet MCP-szervereket. Ezek a vásárlási ügynökökre és a fejlesztőkre összpontosítanak: termékkeresés, kosarak, pénztár, vásárlói fiókok és fejlesztői dokumentáció. Egy analitikai MCP-szerver másfajta kérdésekre válaszol: a hirdetések utáni profitra, az attribúcióra és a vásárlói értékre, amelyeket a rendeléseidből, a költségeidből és a hirdetési fiókjaid költéséből számol ki.

Miért érdemes egy AI-asszisztensben kérdezni a webáruházad adatairól?

A legtöbb webáruházi kérdéshez több riport számaira van szükség. A „Keresett pénzt a Meta a múlt hónapban?” kérdéshez egy helyen kell a bevétel, a termékköltségek, a szállítás, a díjak és a hirdetési költés. Egy irányítópulton megnyitod a megfelelő riportot, beállítod a dátumokat, és elvégzed a számolást. Egy, az adataidhoz kapcsolt AI-asszisztensben felteszed a kérdést, és megkapod a választ a mögötte lévő számokkal.

Köznapi nyelv. Nincsenek szűrők, riportszerkesztők vagy táblázatképletek.
Követő kérdések. Kérdezd meg, hogy „és a TikTokon?” vagy „melyik kampány okozta ezt?”, anélkül, hogy elölről kezdenéd.
Több riport egy válaszban. A profit, az attribúció és a vásárlói érték egyetlen válaszban kombinálható.
A saját nyelved. Az Ask AI azon a nyelven válaszol, amelyen írsz.
A többi munkád mellett. Az MCP-n keresztül a webáruház számai abban az AI-appban érhetők el, ahol már amúgy is frissítéseket vagy terveket írsz.

A válasz csak annyira teljes, mint a mögötte lévő adat. Előbb kapcsold össze a szerveroldali követést, a hirdetési fiókjaidat és a termékköltségeidet, hogy az eszközöknek legyen rendelés, költés és árrés, amivel dolgozhatnak.

Hogyan működik az Ask AI és a ROASaurus MCP-szerver?

Az Ask AI egy csevegőoldal a ROASaurus irányítópultján. Az Anthropic modelljén, a Claude-on fut. Az MCP-szerver ugyanezt a 24 eszközt kínálja egy általad választott AI-kliensnek. Az eszközök mindkét esetben a ROASaurus-riportjaidat olvassák, és JSON formátumban adják vissza a számokat. A választ a modell ezekből az eredményekből írja meg.

Felteszel egy kérdéstAz Ask AI-ban vagy a saját MCP-kliensedben

A modell kiválaszt egy eszköztPéldául campaign_profit az elmúlt 30 napra

A ROASaurus lefuttatja az eszköztCsak olvasható, egy webáruház adatain

A modell megírja a választKizárólag a visszaadott számokból

A modell soha nem olvassa közvetlenül az adatbázisodat. Csak azt látja, amit egy eszköz visszaad.

Minden analitikai eszköz csak olvas. Egyetlen eszköz sem módosíthatja a webáruházadat, a kampányaidat, a költségeidet vagy a beállításaidat. Az MCP-szerver mindegyiket csak olvashatóként jelöli, és arra utasítja a klienst, hogy kizárólag az eszközök eredményeiből válaszoljon. Az actions:write hatókörű kulcs a propose_action eszközt is megkapja, amely egy javasolt hirdetésmódosítást tesz az Actions inboxba; semmi sem változik, amíg egy tulajdonos vagy adminisztrátor jóvá nem hagyja. Az irányítópulton lévő Ask AI is rendelkezik vele.

Az Ask AI-ban egy kérdés legfeljebb 8 eszközhívási kört használhat. Ha egy kérdés többet igényel, az asszisztens arra kér, hogy légy konkrétabb. Az Ask AI felhasználónként és webáruházanként tárolja a beszélgetésedet, és az utolsó 12 üzenetet használja kontextusként egy követő kérdéshez. A beszélgetést bármikor törölheted.

24csak olvasható eszköz, ugyanazok az Ask AI-ban és az MCP-ben

6rögzített időszakok: ma, tegnap, 7, 14, 30 és 90 nap

40Ask AI kérdés felhasználónként és naponta, alapértelmezetten

1webáruház API-kulcsonként és kapcsolatonként

Milyen kérdéseket tehetsz fel?

A jó kérdések megneveznek egy mutatót és az egyik támogatott időszakot. A táblázat példakérdéseket mutat, a mindegyikre válaszoló eszközt, és azt, min alapul a válasz.

Kérdés	Eszköz	Amit a válasz mutat
Hogyan alakult az elmúlt 7 nap az előtte lévő 7 naphoz képest?	`profit_summary`	Bevétel, rendelések, hirdetési költés, MER, POAS és profit, az azonos hosszúságú előző időszakhoz képest
Melyik kampánynak volt a legjobb POAS-a az elmúlt 30 napban?	`campaign_profit`	Kampányonként: jóváírt bevétel, bruttó profit, hirdetési költés, hirdetések utáni profit, ROAS, POAS és CAC
Mely hirdetéseknek magas a CPM-je és kevés a vásárlása?	`ads_table`	Költés, megjelenések, kattintások, CTR és CPM a követett vásárlások, a ROAS és a CPA mellett
Hány hónap alatt téríti meg egy kohorsz a CAC-ját?	`ltv_insights`	Havi kohorszok, a CAC megtérülési hónapja és az előrejelzett LTV
Mely termékek hozzák vissza a legtöbb visszatérő vásárlót?	`products`	Legjobb termékek és az első vásárlók közül az újra rendelők aránya
Jó úton vagyunk a havi bevételi célunk felé?	`goals_forecast`	Célok, eddigi tényadatok és a hónap végi előrejelzés
Mit kellene újrarendelnem ezen a héten?	`inventory`	Készleten lévő mennyiség, eladási sebesség, a hátralévő készletnapok és az újrarendelés állapota

A modell választja ki az eszközt. Neked csak a kérdést kell feltenned.

Íme egy kidolgozott példa. Megkérdezed: „Keresett pénzt a Meta az elmúlt 30 napban?” A modell a campaign_profit eszközt hívja meg 30 napos időszakkal és az alapértelmezett utolsó kattintás modellel. Egy példa webáruháznál az eredmény Meta-sora így néz ki:

Tétel	Meta, elmúlt 30 nap	Hogyan számolódik
Jóváírt bevétel	$24,000	A Meta-kattintásoknak jóváírt rendelések bevétele
Bruttó profit (az eredményben contribution)	$13,440	Bevétel mínusz termékköltség, szállítás, fizetési díjak és kezelési költség (56%)
Hirdetési költés	$8,000	A Meta hirdetési fiókból szinkronizálva
Profit a hirdetések után	$5,440	$13,440 − $8,000
ROAS	3.00	$24,000 ÷ $8,000
POAS	1.68	$13,440 ÷ $8,000

Példa webáruház. Az 1.0 feletti POAS azt jelenti, hogy a hirdetések több bruttó profitot hoztak vissza, mint amennyibe kerültek.

Az Ask AI-ban a válasz „Igen”-nel kezdődik, majd megadja a hirdetések utáni profitot és a POAS-t, és legfeljebb három következő lépést javasol. Ha másik nézetre vágysz, kérdezz rá, például: „és a Total Impact modellel?”. A POAS-ról és az attribúciós modellekről szóló útmutatóink mélyebben elmagyarázzák ezeket a számokat.

Hogyan csatlakoztatod a ROASaurus MCP-szervert?

A szerver az MCP Streamable HTTP átvitelét használja, és JSON-válaszokat ad, server-sent events nélkül. Az olyan AI-alkalmazások, mint a Claude és a ChatGPT, OAuth-tal jelentkeznek be: belépsz a ROASaurusba, választasz egy webáruházat, és engedélyezed a kapcsolatot. Azok a kliensek, amelyekben beállíthatsz kérésfejlécet, például a Claude Code, helyette API-kulcsot is használhatnak, az alábbi lépések szerint.

Hozz létre egy API-kulcsot
Nyisd meg a ROASaurusban a Store settings › API & data oldalt, és hozz létre egy elnevezett kulcsot mcp hatókörrel. Másold ki: csak egyszer jelenik meg. Kulcsot csak tulajdonosok és adminisztrátorok hozhatnak létre.
Vagy használd az Orders API kulcsát
Használhatod az Orders API kártyán lévő kulcsot is, például azt, amelyet a WooCommerce-plugin használ. Ezzel a kulccsal rendelések is küldhetők. A Regenerate API key lecseréli, és minden olyan kapcsolatot megszakít, amely a régit használja.
Jegyezd fel a webáruház-kulcsot
Az elnevezett kulcs önmagában kerül a fejlécbe. Az Orders API kulcsa mellé add hozzá a webáruház-kulcsot is: az X-Roasaurus-Key értéket ugyanarról a kártyáról, amelynek MCP részében a teljes fejléc látható.
Add hozzá a szervert az MCP-klienseden
Add meg az alább látható végpontot és az Authorization fejlécet. A kliensnek támogatnia kell a Streamable HTTP-t és az egyéni kérésfejléceket.
Tegyél fel egy tesztkérdést
Kérdezd meg: „Mennyi volt a bevételem tegnap?”, és ellenőrizd a számot az irányítópulton.

Végpont és példa Claude Code-hoz

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

A webáruház-kulcsot küldheted egy X-Roasaurus-Key fejlécben is, és bearer tokenként csak az API-kulcsot. A Claude Code-ban hagyd meg az alapértelmezett helyi hatókört. A projekthatókörű szervert egy .mcp.json fájlba menti a rendszer, amelyet a verziókezelés megoszt, és ez a kulcsodat is megosztaná.

Ha inkább bejelentkeznél, add hozzá a(z) https://app.roasaurus.com/mcp címet egyéni connectorként a Claude-ban vagy a ChatGPT-ben, és jelentkezz be, amikor az alkalmazás kéri. Kapcsolatot csak tulajdonosok és adminok engedélyezhetnek. A Store settings › API & data minden csatlakoztatott alkalmazást mutat, ahol le is választhatod, és a kapcsolat akkor is megszűnik, ha az illető kilép a munkaterületről.

initialize · 2025-06-18A kliens és a szerver megegyezik a protokollverzióban

tools/list · 24 tools · readOnlyHint: trueA kliens megtudja, milyen eszközök léteznek

tools/call · campaign_profit · period 30A modell 30 napnyi kampányprofitot kér

result · isError: falseJSON csatornánként és kampányonként egy sorral

401 · Invalid store key or API key.Mit ad vissza egy hibás vagy újragenerált kulcs

Hogyan néz ki egy kérdés a kliens és a ROASaurus MCP-szerver között.

Biztonságos? Adatvédelem és biztonság

Mivel az analitikai eszközök csak olvasnak, egy AI-alkalmazás a ROASauruson keresztül nem tud kampányt szüneteltetni, költséget szerkeszteni vagy beállítást módosítani; actions:write hatókörrel is csak hirdetésmódosítást javasolhat, amelyet egy tulajdonos vagy adminisztrátor hagy jóvá. Az eszközök ráadásul csak rögzített bemeneteket fogadnak el, például egy időszakot vagy egy listából választott attribúciós modellt. Néhány dologra azért érdemes figyelni.

Hová kerülnek az adatok. Az Ask AI a kérdésedet és az összesített webáruház-mutatókat az Anthropicnak küldi, amely a Claude-ot futtatja. A vásárlóid elérhetőségi adatait nem küldi el. Az MCP-n keresztül az eszközök eredményei az általad csatlakoztatott AI-klienshez kerülnek, annak feltételei szerint. Ellenőrizd az adatmegőrzési és tanítási beállításait.
Mit adnak vissza az eszközök. Összesítéseket időszak, csatorna, kampány, hirdetés, termék, kohorsz és szegmens szerint. Nem adnak vissza vásárlói neveket, e-mail-címeket vagy telefonszámokat.
Ki kérdezhet. Bárki, aki hozzáfér ahhoz az AI-apphoz, ahol hozzáadod a kapcsolatot, lekérdezheti a webáruházat. A saját fiókodhoz add hozzá, ne egy megosztotthoz.
További összekötők. Az MCP specifikációja szerint mindig kell lennie egy embernek a folyamatban, aki megtagadhatja az eszközhívásokat, és a klienseknek az eszközannotációkat megbízhatatlanként kell kezelniük, hacsak a szerver nem megbízható. Ha az AI-appodban vannak e-mailt küldő vagy üzeneteket közzétevő eszközök is, azoknál tartsd bekapcsolva a megerősítő kérdéseket.

Melyek a korlátok?

Rögzített időszakok. Ma, tegnap, vagy az elmúlt 7, 14, 30 vagy 90 nap, a webáruház időzónájában. Az egyéni tartomány, például egy márciusi hét, nem támogatott. A vásárlói érték és a kohorsz eszközök nem fogadnak időszakot: a rendelési előzményeidből dolgoznak, legfeljebb 12 havi kohorsszal.
7 napos ablak a hirdetéstáblához. A hirdetéseszköz 7 napos visszatekintési ablakot használ, függetlenül attól, milyen ablakot állítottál be a Store settings alatt. Az attribúciós és a kampányprofit-eszközök az irányítópult attribúciós riportjaihoz hasonlóan a saját beállításodat vagy az általad kért visszatekintést használják.
Lerövidített listák. A kampánylisták legfeljebb 25 kampányt adnak vissza, a hirdetéstáblázat a legtöbbet költő 30 sort, a termékek listája pedig a 25 legjobb terméket.
Kapcsolatonként egy webáruház. Több webáruházhoz hozz létre mindegyikhez egy kulcsot és egy kapcsolatot.
Az Ask AI kérdéskorlátja. Minden felhasználó alapértelmezetten napi 40 kérdést tehet fel, az elmúlt 24 órára számolva. Az MCP-n keresztül helyette az AI-kliensed saját használati korlátjai érvényesek.
A válaszok tévedhetnek. A modell félreolvashat egy eredményt. A fontos számokat ellenőrizd a riportokban, mielőtt lépsz, például a profitanalitikában.

Források

A ROASaurusban

Olvass tovább

Kreatívok, e-mail és AIKreatívkifáradás a Facebook-hirdetéseknél: mikor cseréld le a hirdetéstA Facebook-hirdetések kreatívkifáradása növekvő frekvenciaként és csökkenő CTR-ként jelentkezik. Tanuld meg hirdetésenként mérni, értelmezni a hook és a hold rate-et, és kialakítani a frissítési rutint.Kreatívok, e-mail és AIKlaviyo elhagyott kosár flow-k: ismerj fel több vásárlótA Klaviyo elhagyott kosár és böngészés flow-i csak azokat a vásárlókat érik el, akiket a Klaviyo azonosítani tud. Tudd meg, hogyan azonosítja őket, és hogyan ismerhetsz fel többet a pénztárnál.KövetésReklámblokkolók és követés: mit veszít a webáruházadA reklámblokkolók megállítják a követőpixeleket, így a hirdetési platformok nem látják a vásárlásokat. Nézd meg, mely események vesznek el, miért nem vesznek el a szerveroldali események, és hogyan mérheted meg, mennyit veszítesz.

Shopify MCP: kérdezd a webáruházad adatait a Claude-ban és más AI-appokban