Margyn MCP

Kérdezz bármit a webáruházadról. Kapj elemzői választ.

Kösd össze az AI asszisztensedet a Margyn-nal, és kérdezd természetes nyelven a bevételt, a profitot és a hirdetési teljesítményt — valós, az előző időszakhoz mért számokkal.

Alapból csak olvasás · OAuth 2.1 · Claude + ChatGPT

https://app.margyn.io/api/mcp/mcp

Mi az MCP?

Az MCP (Model Context Protocol) egy nyílt szabvány, amivel AI asszisztenseket köthetsz össze külső adatforrásokkal. A Margyn MCP szervere közvetlen hozzáférést ad az AI-nak a webáruházad adataihoz — kérdezz rá bármire, például: "Mennyi volt a profitom múlt hónapban?", és azonnal megkapod a választ.


Mit tud

55 eszköz, aszerint csoportosítva, amit el akarsz érni. Kérdezz természetes nyelven — az asszisztens kiválasztja a megfelelő eszközt és automatikusan összeveti az előző időszakkal.

Hogy áll a webáruház

Az eredménytáblád: bevétel, profit, ROAS, hirdetési költés és adatfrissesség minden webáruházra és platformra.

list_clientsget_data_healthget_dashboard_metricsget_profit_lossget_net_sales_statement

Profit- és költségdiagnosztika

Hol szivárog az árrés és miért mozdult egy P&L sor — volumen × összetétel × ráta bontásban, azzal együtt, hogy mit javíts először.

get_profit_healthget_cost_breakdownget_metric_change_analysisget_target_recommendationsget_profit_opportunitiesget_operating_expenses

Hirdetés-optimalizálás

Több platformos hirdetési teljesítmény, kreatív- és közönség-kifáradás, az, hogy az egyes Meta-hirdetések új vagy meglévő embereket érnek-e el, attribúciós ablakok, a vásárlási tölcsér csatornánként, költségvetés-pacing és Performance Max.

get_ad_performanceget_ad_commentssearch_ad_commentsget_comment_insightssave_comment_insightdraft_comment_briefsync_ad_commentsget_meta_insightsget_funnelget_budget_pacingget_pmax_analyticsrefresh_pmax_data

Vásárlók és megtartás

Kohort-megtartás, újravásárlási ütem, és valós LTV:CAC megtérüléssel.

get_cohort_analysisget_retention_kpisget_ltvget_time_between_orders

Termékek és készlet

Termékszintű árrés és előretekintő kifogyási / újrarendelési időzítés.

get_product_analyticsget_inventory_outlook

Trendek és időzítés

Keresleti szezonalitás, anomália-riasztások, növekedési lehetőségek, utánvét-gazdaságosság, és egy előretekintő cselekvési naptár.

get_sales_timeseriesget_seasonality_patternsget_anomaly_radarget_growth_opportunitiesget_cod_economicsget_growth_calendar

Rögzítsd, mi történt

Írd fel, mi történt aznap a webáruházban — kampányindítás, árváltozás, készlethiány, szállítói csúszás —, hogy a következő elemzés ezt mondja meg, és ne találgasson. Szerkeszteni és törölni csak te tudod.

log_annotation

Ad Library: mit hirdetnek a versenytársak

Keress a követett versenytársak és a saját hirdetéseid között, ugyanazokkal a szűrőkkel, címkékkel és becsült nyerőpontszámmal, mint a Margyn Ad Library-jében. Egy hirdetést megnyitva látod, miért kapta a pontszámát, és kérhetsz hozzá útmutatót a saját változatodhoz: ez egy minta, nem a versenytárs szavai, képei vagy logója. A megőrzésre érdemeseket elmentheted a csapat közös mentett hirdetései közé. A Meta nem közöl megjelenítéseket, ezért a pontszám becslés. A versenytársak képeit és videóit az asszisztens nem kapja meg.

search_ad_libraryget_library_adlist_library_brandssave_library_ad

Hirdetéskészítés és versenytárs-kutatás

Fizetős · írás

Egy körben több különböző kreatív ötlet, mentett arculati stílusokkal, előre látott költséggel. Emellett kreatív-befektetés előrejelzése, versenytársak élő Meta-hirdetéseinek visszafejtése, és megnézheted, mennyibe került eddig az AI.

start_ad_campaigngenerate_ad_creativeget_generation_statusget_generation_assetget_ai_spendlist_generationslist_video_jobsgenerate_ad_videoget_video_statuscreate_style_presetlist_style_presetsdelete_style_presetget_creative_forecastanalyze_competitor_adssave_competitor_report

A teljes eszköztár a Margyn-on belül él

Pontosan mit ad vissza minden eszköz és milyen paraméterekkel — és a beépített elemzési playbook, ami úgy használja őket, mint egy tapasztalt operátor — a csatlakozás után tárul fel.

Csatlakozás

Analytics Playbook

Az MCP szerver tartalmaz egy beépített elemzési útmutatót (playbook), ami automatikusan betöltődik az AI-ba. Ennek köszönhetően az AI úgy dolgozza fel az adataidat, ahogy egy tapasztalt e-commerce elemző tenné.

Profit Waterfall

BevételCM1CM2Nettó Profit

CM1 = Bevétel − COGS − Szállítás | CM2 = CM1 − Hirdetési költés | Nettó Profit = CM2 − Működési költségek

A playbook automatikusan a megfelelő eszközt választja a kérdésedhez, és összeveti az előző időszakkal.


Költségbontás: miért nőtt egy P&L sor?

A költségbontó eszközök minden P&L sor változását három összeadódó hatásra osztják az előző időszakhoz képest. Nem elég azt mondani, hogy „a szállítási költségek 34%-kal nőttek" — meg kell mondani, miért.

Δ Költség = három hatás összege

Volumen+Összetétel+Ráta
  • Volumen-hatás: a webáruház egyszerűen nagyobb — több rendelés, ugyanaz az összetétel, ugyanazok a ráták.
  • Összetétel-hatás: a vásárlók más arányban használják az egyes csoportokat (pl. drágább fizetési mód, nehezebb futár).
  • Ráta-hatás: egy szolgáltató megemelte a díjat — azonos összetétel mellett is drágább.

Példa: „a fizetési költségek 34,5%-kal nőttek — miért?"

Az AI meghívja a get_cost_breakdown eszközt costType="payment", szolgáltató szerinti bontásban, és kiolvassa a három hatást:

  • • Volumen +12% — több rendelés érkezett.
  • • Összetétel +21% — a vásárlók a Barion (3,2% díj) felé tolódtak a Shopify Payments (2,4% díj) helyett.
  • • Ráta +1% — nincs érdemi díjszerkezet-változás.

„A 34,5%-os emelkedés nagy részét az összetétel-eltolódás okozza — a vásárlók egyre inkább a Barion-t használják, ami 0,8 százalékponttal drágább. Ha több pénztárt át tudsz vinni Shopify Payments-re, a növekedés ~21%-át vissza tudod nyerni."


Csatlakozás

Claude

Működik a claude.ai weben és a Claude Desktop appban is.

  1. 1Nyisd meg a Settings > Connectors menüt
  2. 2Kattints az "Add custom connector" gombra
  3. 3Illeszd be a szerver URL-t:
https://app.margyn.io/api/mcp/mcp
  1. 4Engedélyezd az OAuth bejelentkezést a felugró ablakban
  2. 5Kész! Már kérdezhetsz is.

Jó promptok, amikkel érdemes kezdeni

Próbáld ki ezeket rögtön csatlakozás után:

Áttekintés

“Hogy megy a webáruházam ebben a hónapban?”

“Miért csökkent a profitom a múlt héten?”

“Frissek az adataim minden platformon?”

“Hogyan teljesít a TikTok, Meta és Google hirdetésem egymás mellett?”

Termékek

“Melyek a legjövedelmezőbb termékeim?”

“Melyik termékekre költök sokat hirdetésben, de nem hoznak profitot?”

Performance Max

“Hogyan teljesítenek a PMax kampányaim csatornánként?”

“Melyik PMax eszközök (asset-ek) működnek a legjobban?”

“A PMax brand vagy nem-brand kereséseket hoz?”

Vásárlók

“Hányan rendelnek újra a vásárlóim közül az elmúlt 6 hónapban?”

“Mennyit költenek átlagosan az új vs visszatérő vásárlók?”

“Mennyi az új vásárlóim CPA-ja és ROAS-a csatornánként?”

“Mennyi az LTV:CAC arányom, és mennyi idő alatt térül meg a hirdetési költésem?”

“Megtérülnek-e a kohortjaim a CAC-jukból, és mikor?”

Meta hirdetés-elemzés

“Melyik kreatívjaim teljesítenek a legjobban hook rate alapján?”

“Melyik közönségeim égnek ki — mutasd a frekvenciát és a CTR-trendet.”

“Mennyit ad hozzá a 7 napos klikk-attribúció a riportolt ROAS-omhoz az 1 napossal szemben?”

“Melyik kampányaim túlköltenek vagy alulköltenek a napi költségvetéshez képest?”

“Melyik Meta hirdetéseim adják a legjobb completion rate-et videós oldalon?”

Döntéstámogatás

“Milyen ROAS kell, hogy nyereséges legyek? Mi a nullszaldós ROAS-om?”

“Miért változott az árrésem a múlt héten — bontsd komponensekre.”

“Hány termékemnél hiányzik a beállított költség?”

“Hol veszítek a legtöbb pénzt — mit javítsak először?”

Versenytársak és új hirdetések

“Elemezd a [versenytárs] Meta-hirdetéseit: mi működik náluk, és mit teszteljek én?”

“Mit nem csinálnak a versenytársaim, amit én kipróbálhatnék?”

“Adj 5 hirdetésötletet a legjobban fogyó termékemhez.”

“Melyek a legjobb hirdetések a követett versenytársaimtól?”

“Mutasd a(z) [versenytárs] leghosszabb ideje futó ajánlatos hirdetéseit, és mondd meg, mi bennük a közös.”

“Készíts útmutatót abból a hirdetésből a legjobban fogyó termékemhez, és mentsd el a közös mentett hirdetéseink közé.”

Mi történt aznap

“Miért ugrott meg az árbevétel 14-én? Van rá jegyzetem?”

“Írd fel 14-re, hogy elindult a nyári akció.”

“A múlt hónapban mihez van jegyzetem, és mihez nincs?”

“Fél napra leállt az oldal 9-én — írd fel, és nézd meg, mennyibe került.”

Költségdiagnosztika

“Miért nőttek a fizetési költségek a múlt hónapban?”

“Melyik futárnak emelkedett a tarifája — bontsd le szolgáltatóra.”

“Mi hajtja a visszatérítéseket — termék- vagy szállítási probléma?”

“A kedvezmények rontják az árrésemet? Mutasd kódonként.”


Biztonság

Egy AI-t a pénzügyi adataidhoz kötni alapból legyen biztonságos. Így az:

Alapból csak olvasás

Az asszisztens olvassa az analitikádat. A rendeléseidhez, termékeidhez, költségeidhez és beállításaidhoz nem nyúl.

OAuth 2.1 + PKCE

Korlátozott, bármikor visszavonható bejelentkezés. Nincs beillesztendő vagy kiszivárogtatható API-kulcs.

Mit tárol a Margyn

Minden válasz élő adatból készül. A beszélgetéseidet az asszisztensed tárolja, a saját beállításai szerint — a Margyn nem látja őket. A Margyn azt naplózza, melyik eszközt és milyen beállításokkal hívta az asszisztens, hogy javíthassuk a terméket, és megőrzi, amit elmentesz: jegyzetet a grafikonon, hirdetésképet vagy versenytárs-riportot.

Webáruházanként korlátozva

A hozzáférés minden híváskor ellenőrzött — az AI csak azokat a webáruházakat látja, amelyeknek tagja vagy.

A fizetős eszközök (hirdetéskép-generálás, AI videó-generálás) ki vannak kapcsolva, amíg egy admin be nem kapcsolja őket. A videó-generálás ára jóval a többi fölött van: egy klip akár több dollárba is kerülhet, ez a legdrágább művelet, amit ez a kapcsolat el tud végezni. Emiatt egy webáruháznak külön jóváhagyás kell a videóhoz, a hirdetéskép-generálástól függetlenül és azon felül, mielőtt használhatná. A videó-generálásnak saját jogosultsági köre is van, így egy kapcsolat, amely már jóváhagyta a hirdetéskép-generálást, megújításkor nem kapja meg automatikusan a videó-generálás jogát is; azt névre szólóan, külön kell jóváhagyni. (Egy már elkészült klip letöltése nincs ehhez a jogosultsághoz kötve.) Minden íráshoz — jegyzet a grafikonra, versenytárs-riport mentése — admin jogosultság kell, és mind ott van a jóváhagyó képernyőn.


FAQ

MCP Server | Margyn Dokumentáció