Meta Ads MCP Cursorban, VS Code-ban és Claude Code-ban: beállítási útmutató
Kösd a Meta Ads-t a Cursorhoz, a VS Code-hoz vagy a Claude Code-hoz egy MCP-címmel: a szerkesztők konfigurációja, a bejelentkezés és a változtatások kézben tartása.
Ezen az oldalon
A Meta Ads-t a Cursorba, a VS Code-ba vagy a Claude Code-ba egyetlen távoli MCP-szervercím, a https://teraads.co/mcp hozzáadásával és a Tera Ads-be való böngészős bejelentkezéssel hozhatod be. Semmit nem kell telepíteni vagy üzemeltetni. A Cursor és a VS Code rövid JSON-bejegyzést kér, a Claude Code egyetlen parancsot, és mindhárom utána olvashatja az élő kampányaidat és a Shopify-boltod visszaküldések utáni profitját. Kapcsolatonként te választod meg, hogy az AI-d csak olvas, előbb kérdez, vagy változtat.
A lényeg
- Egy cím működik mindhárom szerkesztőben:
https://teraads.co/mcp, egy üzemeltetett MCP-szerver böngészős bejelentkezéssel, API-kulcsok nélkül a konfigurációdban. - A Cursor a
~/.cursor/mcp.jsonfájlt olvassa minden projekthez, vagy a.cursor/mcp.json-t egyetlen projekthez; a VS Code az MCP: Add Server parancsot vagy a.vscode/mcp.json-t használja. - A Claude Code-hoz egyetlen
claude mcp addparancs kell, vagy egy plugin, amely a szerver mellé hat kész hirdetési skillt is hoz. - Az AI-d 29 eszközt kap: élő Meta-olvasások, a bolt visszaküldések utáni profitja, valamint leállítások, bekapcsolások és költségkeret-módosítások rögzített korlátokon belül.
- Csatlakozás előtt döntsd el, mit tehet az AI: csak olvas, előbb kérdez, vagy változtat.
Miért kösd a Meta Ads-t a kódszerkesztődhöz
Ha a Shopify-témádat, szkriptjeidet vagy belső eszközeidet magad építed, a szerkesztőd már most is ott van, ahol a napot töltöd. Egy ottani AI-ügynök megválaszolhat egy hirdetési kérdést anélkül, hogy az Ads Managerbe kellene mennie, beírhatja a választ egy fájlba a repódban, vagy ellenőrizheti, hogy az az oldal, amelyet épp megváltoztattál, az-e, amelyre a legjobb hirdetéseid küldik az embereket.
Az MCP, a Model Context Protocol, a nyílt szabvány, amely ezt lehetővé teszi: a szerkesztő ügynöke egy szerver által kínált eszközöket hív, a szerver pedig a hirdetési platformmal beszél. Az MCP-csatlakozók magyarázata bemutatja, hogyan működik. A Cursor dokumentációja a stdio, SSE és Streamable HTTP átvitelt sorolja a támogatottak közé, és azt írja, hogy támogatja az OAuth-ot az ezt igénylő szervereknél (a Cursor MCP-dokumentációja). A Claude Code a távoli szerverekre OAuth-tal jelentkezik be a /mcp parancsán keresztül (a Claude Code MCP-dokumentációja). Így egy üzemeltetett szerverhez nem kell kulcsokat beilleszteni egy konfigurációs fájlba.
A Tera Ads Connect ilyen szerver, Shopify-márkáknak építve. Az élő Meta-olvasások mellett a boltodból válaszol: rendelésekből, visszaküldésekből, termékköltségből, szállításból, díjakból és visszatérítésekből, a Meta- és Google-hirdetési költésedet levonva. A Meta által hozzárendelt bevétel Metáéként van címkézve, így az AI-d nem téveszti össze az eladásokkal. Ha a tágabb képet szeretnéd a szerverekről, amelyeket helyette használhatnál, a Meta Ads MCP lehetőségek összehasonlítja őket.
Mielőtt belekezdesz
- Egy ingyenes Tera Ads-fiók. Regisztrálj, és csatlakoztasd a Meta hirdetési fiókodat. Csatlakoztasd a Shopifyt is, hogy az AI-d lássa a bolti eladásokat és a profitot.
- Tulajdonosi hozzáférés. A Tera Ads-ben csak a vállalkozás tulajdonosa csatlakoztathat AI-t egy vállalkozáshoz.
- A szerkesztőd. A Cursor, a VS Code a csevegőnézetével, vagy a Claude Code a terminálban.
- Döntés a változtatásokról. Döntsd el, hogy az AI csak riportol, vagy hirdetéseket is leállít és költségkeretet módosít. A biztonságos AI-hozzáférés útmutatója rövid, lemásolható szabályzatot tartalmaz.
Beállítás öt lépésben
- Hozz létre ingyenes Tera Ads-fiókot. Regisztrálj, csatlakoztasd a Meta hirdetési fiókodat, majd a Shopifyt, hogy a válaszok tartalmazzák a bolt visszaküldések utáni profitját.
- Add hozzá a szervercímet a szerkesztődhöz. Illeszd be a
https://teraads.co/mcpcímet a Cursor vagy a VS Code MCP-beállításaiba, vagy futtass egy parancsot a Claude Code-ban; az alábbi szakaszok megadják az egyes szerkesztők pontos bejegyzését. - Jelentkezz be a Tera Ads-be a böngésződben. A szerkesztő megnyitja a Tera Ads-t, ahol bejelentkezel és kiválasztod az egy megosztandó vállalkozást.
- Válaszd ki, mit tehet az AI-d. Válaszd a csak olvasást, az „előbb kérdezzen" vagy a „végezzen változtatásokat" módot ehhez a kapcsolathoz; az utóbbi kettő között később válthatsz a Tera Ads AI-kapcsolatok részében.
- Tegyél fel egy ellenőrizhető kérdést. Kezdd valami olyannal, mint „Mennyit költöttem tegnap a Metán?", és hasonlítsd össze a választ az Ads Managerrel, mielőtt bármi nagyobbra támaszkodnál.

A bejelentkezés OAuth 2.1-et használ PKCE-vel, és a szerver támogatja a dinamikus kliensregisztrációt, így a szerkesztőd maga regisztrál, és soha nem kell kliensazonosítót vagy titkos kulcsot kezelned. A Tera Ads a tokeneket csak egyirányú hash-ként tárolja. A hozzáférési tokenek egy óráig érvényesek, és helyetted frissülnek; egy kapcsolat 30 napig tart, mielőtt újra be kell jelentkezned.
Cursor
A Cursor az MCP-szervereket egy JSON-fájlból olvassa. A dokumentációja szerint a saját mappádban lévő ~/.cursor/mcp.json mindenhol elérhetővé teszi az eszközöket, a projekten belüli .cursor/mcp.json pedig az adott projektre korlátozza (a Cursor MCP-dokumentációja). Add hozzá ezt a bejegyzést, ugyanazt, amelyet a Tera Ads configs/cursor/mcp.json néven publikál a GitHub-repójában:
{"mcpServers": {"tera-ads": {"url": "https://teraads.co/mcp"}}}
Ha a fájl már sorol más szervereket, a "tera-ads" bejegyzést a meglévő mcpServers objektumon belülre add hozzá, ne cseréld le. Amikor a Cursor kéri, jelentkezz be a Tera Ads-be a böngésződben. Nincs hozzáadandó API-kulcs vagy fejléc.
Alapértelmezés szerint a Cursor jóváhagyást kér, mielőtt MCP-eszközt használna. A dokumentációja az eszközök engedélyezőlistára tételét is leírja, hogy kérdés nélkül fussanak. Ha ezt használod, csak olvasó eszközöket tegyél engedélyezőlistára, mint a get_insights és a get_profit, a változtató eszközöket (pause, resume, set_budget, duplicate és a létrehozó eszközök) pedig tartsd rákérdezés mögött.
VS Code
A VS Code két utat ad:
- MCP: Add Server. Nyisd meg a Command Palette-et, futtasd az MCP: Add Server parancsot, válaszd a HTTP-t, illeszd be a
https://teraads.co/mcpcímet, és add a szervernek atera-adsazonosítót. - Munkaterületi fájl. Add hozzá a repó
configs/vscode/mcp.jsonfájljából a bejegyzést a.vscode/mcp.json-hoz:{"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. A VS Codeservers-t használ ott, ahol a CursormcpServers-t, ezért ne másold az egyik szerkesztő fájlját a másikba.
A VS Code MCP-dokumentációja az új beállításokat a vezetett folyamatán át tereli, és azt mondja, hogy a munkaterületi .vscode/mcp.json fájlok kompatibilitás miatt továbbra is elérhetők, így bármelyik út működik. Indítsd el a szervert, jelentkezz be a Tera Ads-be, amikor a VS Code kéri, majd kapcsold be a Tera Ads-t a csevegőmezőben a Configure Tools alatt. A VS Code dokumentációja azt tanácsolja, hogy csak olyan műveleteket hagyj jóvá, amelyeket megértesz, és ez a helyes szokás minden olyan kérésnél, amely költségkerethez nyúl.
Claude Code
Egyetlen parancs adja hozzá a szervert:
claude mcp add --transport http tera-ads https://teraads.co/mcp
Indítsd el a Claude Code-ot, írd be: /mcp, válaszd a tera-ads-t, és jelentkezz be a Tera Ads-be a böngésződben. A Claude Code dokumentációja szerint a /mcp futtatja az OAuth-bejelentkezést, a tokeneket pedig automatikusan tárolja és frissíti; a claude mcp list megmutatja, hogy az egyes szerverek csatlakoztak-e, vagy hitelesítést igényelnek.
A szerver alapértelmezésben helyi hatókörben kerül hozzáadásra: csak neked, csak az aktuális projektben. Add hozzá a --scope user kapcsolót, hogy minden projektedben megvan, vagy a --scope project-et, hogy egy verziókezelésen át megosztott .mcp.json fájlba íródjon. Egy megosztott fájl csak a címet osztja meg. Mindenki külön jelentkezik be, és csak a vállalkozás tulajdonosa csatlakoztathat AI-t egy Tera Ads-vállalkozáshoz.
A plugin, hat skillel
Ha a szervert kész munkafolyamatokkal együtt szeretnéd hozzáadni, telepítsd a Tera Ads-t pluginként. Futtasd a claude plugin marketplace add Teralabsx/meta-ads-mcp parancsot, majd a claude plugin install tera-ads@tera-ads-t. A Claude Code plugin-dokumentációja szerint egy plugin hozzáadja a skilljeit, ügynökeit, hookjait és MCP-szervereit, és a skilljei /<plugin>:<skill> alakban jelennek meg, így az alábbi első a /tera-ads:profit-check.
| Skill | Mit csinál |
|---|---|
profit-check | A Meta számait a bolt visszaküldések utáni profitja mellé teszi |
weekly-ads-review | Összehasonlítja ezt a hetet a múlt héttel, és változtatásokat javasol, anélkül, hogy bármit végrehajtana |
pause-wasted-spend | Megkeresi az eladás nélkül költő hirdetéseket, és leállítja azokat, amelyeket kiválasztasz |
scale-a-winner | Biztonságos lépésekben emeli egy nyertes költségkeretét, vagy szüneteltetett vázlatként lemásolja |
launch-paused-campaign | Felépít egy teljes kampányt, hirdetéscsoportot és hirdetést, mindet szüneteltetve, hogy ellenőrizhesd |
refresh-ad-copy | Új változatokat ír egy elfáradt hirdetésből, szüneteltetett hirdetésekként mellé |
Ugyanez a dokumentáció azt mondja, hogy a harmadik fél marketplace-eiről származó pluginok alapértelmezés szerint nem frissülnek automatikusan. Új verzió felvételéhez futtasd: claude plugin update tera-ads@tera-ads.
A három szerkesztő egymás mellett
| Cursor | VS Code | Claude Code | |
|---|---|---|---|
| Hová kerül a beállítás | ~/.cursor/mcp.json vagy .cursor/mcp.json | MCP: Add Server, vagy .vscode/mcp.json | claude mcp add, helyi, felhasználói vagy projekt hatókörben |
| Bejegyzés formátuma | mcpServers egy url-lel | servers "type": "http"-vel és egy url-lel | Egy parancs, nincs szerkesztendő fájl |
| Bejelentkezés | Böngésző, amikor a Cursor kéri | Böngésző, a szerver indítása után | /mcp, majd böngésző |
| Az első használat előtt | Semmi több | Kapcsold be a Configure Tools alatt | Semmi több |
| Extrák | Nincs | Nincs | Plugin hat skillel |
| Szerkesztő-dokumentáció | Cursor | VS Code | Claude Code |
Mit kérdezz először
Kezdd olyan kérdésekkel, amelyek válaszát egy perc alatt ellenőrizheted az Ads Managerben. Ha a számok egyeznek, térj át azokra, amelyekhez a bolt adatai kellenek. A promptkönyvtár a hirdetéselemzéshez és a kérdések, amelyeket feltehetsz az AI-nak a hirdetéseidről többet is tartalmaz.
| Kérdés | Mit néz meg az AI |
|---|---|
| „Mely kampányok költöttek a legtöbbet ezen a héten, és mennyit hoztak?" | get_insights |
| „Mennyi volt a profitom visszaküldések után az elmúlt 30 napban?" | get_profit |
| „A Meta szerint a ROAS-om 3. Mennyit keresett valójában a boltom?" | get_insights, get_profit |
| „Mely kampányok veszítenek pénzt visszaküldések után, és mit tegyek velük?" | get_ads_review |
| „Mely hirdetések költöttek pénzt az elmúlt 14 napban eladás nélkül?" | get_insights hirdetésszinten |
| „Mi változott a hirdetéseimben ezen a héten, és vissza tudom még vonni?" | list_recent_changes |
Két dolgot tarts szem előtt a válaszok olvasásakor. Egy: a Meta vásárlásai és bevétele a Meta hozzárendelése, nem a boltod eladásai; a miért tér el a Meta Ads és a Shopify elmagyarázza a különbséget. Kettő: a get_ads_review minden költő kampányt a bolt szokásos visszaküldései utáni profit alapján ítél meg, a saját költségeiddel, a break-even ROAS-odhoz mérve. Maga a profit a teljes bolt becslése, a rendeléseidből, a te marzsbeállításoddal építve, nem a bankszámlán lévő pénz.
Tartsd kézben a hirdetésváltoztatásokat
A változtatásokat két helyen szabályozzák: a szerkesztődben, amely minden eszközfuttatás előtt kérdezhet, és a Tera Ads-ben, amely egyáltalán eldönti, mit tehet a kapcsolat.
- Csak olvasás, előbb kérdezzen vagy végezzen változtatásokat. Az „előbb kérdezzen" móddal a változtatás a Tera Ads-ben vár, amíg ott jóvá nem hagyod, és az AI-d nem tudja helyetted jóváhagyni.
- Az új dolgok szüneteltetve indulnak. A kampányok, hirdetéscsoportok, hirdetések és másolatok semmit nem költenek, amíg valami be nem kapcsolja őket.
- A költségkeret-lépések plafonozottak. Egyetlen változtatás legfeljebb a háromszorosára emelheti vagy a tizedére csökkentheti a költségkeretet.
- Napi plafon. Az asszisztensek legfeljebb napi 50 változtatást végezhetnek egy vállalkozáson.
- Nincs törlő eszköz. Az AI-d leállíthat, de nem törölhet semmit.
- 7 napos visszavonás. A leállítás, bekapcsolás vagy költségkeret-módosítás 7 napig visszavonható a Tera Ads-ben. Az új kampányokat, hirdetéscsoportokat és hirdetéseket nem lehet visszavonni, de szüneteltetve indulnak.
- Kapcsolatonként egy vállalkozás. Egy kapcsolat nem olvashat másik vállalkozást, még akkor sem, ha az is a tiéd.

A kampánynevek és a hirdetésszövegek adatként jutnak el az AI-dhoz, és a Tera Ads azt mondja neki, hogy ne kövessen bennük található utasításokat. A Claude Code dokumentációja az általános pontot is kimondja: a külső tartalmat lekérő szerverek kitehetnek prompt injectionnek, ezért csak olyan szervereket csatlakoztass, amelyekben bízol. Ha minden változtatást látni akarsz, mielőtt megtörténik, válaszd az „előbb kérdezzen" módot.
Ha valami nem működik
A szerver azt mondja, bejelentkezés kell. A Claude Code-ban futtasd a /mcp parancsot, és válaszd a tera-ads-t; a claude mcp list megmutatja, hogy hitelesítést igényel, amíg meg nem teszed. A Cursorban és a VS Code-ban indítsd újra a szervert, és fejezd be a böngészős bejelentkezést.
Az eszközök nem jelennek meg a VS Code csevegésében. Nyisd meg a Configure Tools részt a csevegőmezőben, és kapcsold be a Tera Ads-t.
Az AI-d azt mondja, elértél egy korlátot. Az ingyenes csomag heti 30 hívás, hetente nullázódik UTC szerint. Kérd meg az AI-dat, hogy futtassa a get_usage-t, amely ingyenes, és megmondja, hány hívás maradt és mikor nullázódik a számláló.
A költségkeretek százszor akkorának tűnnek. A list_campaigns a költségkereteket a Meta egységeiben mutatja, amelyek a legtöbb pénznemnél századok, így az 5000 50 dollárt jelent. A set_budget a fiókod pénznemének egész egységeit veszi.
A válaszok rossz boltról szólnak. Minden kapcsolat egy vállalkozást fed le. Csatlakozz újra, és válaszd a másik vállalkozást.
A Tera Ads Connect a Tera Ads MCP-szervere, a Shopify-márkák profit-irányítópultjáé. Élő Meta-olvasásokat, Shopify-eladásokat és visszaküldések utáni profitot, valamint korlátozott, naplózott hirdetésváltoztatásokat ad a szerkesztődnek. Az ingyenes csomag heti 30 hívást tartalmaz egy Meta hirdetési fiókon, a Connect Pro pedig havi 15 dollár havi 3 000 hívásra, legfeljebb három hirdetési fiókon; a Growth és Scale csomagok tartalmazzák. Minden klienshez a beállítási lépések a Connect oldalon vannak.
Gyakori kérdések
Működik a Meta Ads MCP a Cursorban?
Igen. A Cursor támogatja a távoli MCP-szervereket OAuth-bejelentkezéssel. Add hozzá a Tera Ads bejegyzést a ~/.cursor/mcp.json vagy a .cursor/mcp.json fájlhoz, majd jelentkezz be a Tera Ads-be, amikor a Cursor kéri.
Hogyan adjam hozzá a Meta Ads MCP-t a VS Code-hoz?
Futtasd az MCP: Add Server parancsot, válaszd a HTTP-t, és illeszd be a https://teraads.co/mcp címet, vagy add hozzá a bejegyzést a .vscode/mcp.json-hoz. Indítsd el a szervert, jelentkezz be, majd kapcsold be a Tera Ads-t a csevegés Configure Tools részében.
Mi a Claude Code parancsa a Meta Ads MCP-hez?
claude mcp add --transport http tera-ads https://teraads.co/mcp. Majd írd be a Claude Code-ban: /mcp, és jelentkezz be. Hat kész hirdetési skillhez telepítsd a plugint a claude plugin marketplace add Teralabsx/meta-ads-mcp és a claude plugin install tera-ads@tera-ads paranccsal.
Kell API-kulcs vagy Meta fejlesztői app?
Nem. A Tera Ads-be a böngésződben jelentkezel be, a változtatások pedig a Tera Ads saját, jóváhagyott Meta-appján keresztül jutnak el a Metához. Semmi titkos nem kerül a konfigurációs fájlodba.
Megváltoztathatja az AI a szerkesztőmben a hirdetéseimet?
Csak ha az adott kapcsolatnál engedélyezed. Akkor is az új dolgok szüneteltetve indulnak, egy költségkeret-módosítás legfeljebb háromszorosára emelhet vagy tizedére csökkenthet, és a leállítás, bekapcsolás vagy költségkeret-módosítás 7 napig visszavonható a Tera Ads-ben.
Mennyibe kerül?
Az ingyenes csomag heti 30 hívást tartalmaz egy Meta hirdetési fiókon. A Connect Pro havi 15 dollár havi 3 000 hívásra. Egy hívás egy lekérdezés, amelyet az AI-d a Tera Ads-ben végez, és egy kérdés többbe is kerülhet.