Meta Ads MCP v Cursor, VS Code a Claude Code: návod na nastavenie
Pripojte Meta Ads ku Cursoru, VS Code alebo Claude Code jednou MCP adresou: presná konfigurácia pre každý editor, prihlásenie a kontrola nad zmenami reklám.
Na tejto stránke
Meta Ads môžete dostať do Cursoru, VS Code alebo Claude Code pridaním jednej adresy vzdialeného MCP servera, https://teraads.co/mcp, a prihlásením do Tera Ads v prehliadači. Nič sa neinštaluje ani nehostuje. Cursor a VS Code berú krátky záznam v JSON, Claude Code jeden príkaz a všetky tri potom môžu čítať vaše živé kampane a zisk vášho obchodu na Shopify po vratkách. Pri každom pripojení si zvolíte, či vaša AI iba číta, najprv sa opýta, alebo robí zmeny.
Hlavné body
- Jedna adresa funguje vo všetkých troch editoroch:
https://teraads.co/mcp, hostovaný MCP server s prihlásením v prehliadači a bez API kľúčov v konfigurácii. - Cursor číta
~/.cursor/mcp.jsonpre všetky projekty alebo.cursor/mcp.jsonpre jeden; VS Code používa MCP: Add Server alebo.vscode/mcp.json. - Claude Code potrebuje jeden príkaz
claude mcp addalebo plugin, ktorý pridá server plus šesť hotových reklamných skills. - Vaša AI dostane 29 nástrojov: živé čítanie Mety, zisk vášho obchodu po vratkách a pozastavenia, zapnutia a zmeny rozpočtu v pevných limitoch.
- Pred pripojením rozhodnite, čo smie AI robiť: read only, ask first alebo make changes.
Prečo pripojiť Meta Ads k editoru kódu
Ak si tému Shopify, skripty alebo interné nástroje budujete sami, váš editor je už tam, kde trávite deň. AI agent v ňom dokáže odpovedať na otázku o reklamách bez cesty do Ads Manageru, zapísať odpoveď do súboru vo vašom repozitári alebo skontrolovať, či vstupná stránka, ktorú ste práve zmenili, je tá, na ktorú vaše najlepšie reklamy posielajú ľudí.
MCP, Model Context Protocol, je otvorený štandard, ktorý to umožňuje: agent v editore volá nástroje, ktoré server ponúka, a server komunikuje s reklamnou platformou. MCP konektory vysvetlené pokrývajú, ako to funguje. Dokumentácia Cursoru uvádza stdio, SSE a Streamable HTTP ako podporované transporty a hovorí, že podporuje OAuth pre servery, ktoré ho potrebujú (dokumentácia MCP v Cursore). Claude Code sa prihlasuje k vzdialeným serverom cez OAuth príkazom /mcp (dokumentácia MCP v Claude Code). Hostovaný server teda nepotrebuje kľúče vložené do konfiguračného súboru.
Tera Ads Connect je takýto server, postavený pre značky na Shopify. Okrem živého čítania Mety odpovedá z vášho obchodu: objednávok, vratiek, ceny produktov, dopravy, poplatkov a refundácií, mínus vaše výdavky na Metu a Google. Tržby pripísané Metou sú označené ako tržby Mety, takže ich vaša AI nezamieňa za predaje. Ak chcete širší pohľad na servery, ktoré by ste mohli použiť namiesto toho, možnosti Meta Ads MCP ich porovnávajú.
Skôr než začnete
- Bezplatný účet Tera Ads. Zaregistrujte sa a pripojte svoj reklamný účet Meta. Pripojte aj Shopify, aby vaša AI videla predaje a zisk obchodu.
- Prístup vlastníka. AI k podniku v Tera Ads môže pripojiť len vlastník podniku.
- Váš editor. Cursor, VS Code s chatovým zobrazením alebo Claude Code v termináli.
- Rozhodnutie o zmenách. Rozhodnite, či bude AI iba reportovať, alebo aj pozastavovať reklamy a meniť rozpočty. Sprievodca bezpečným prístupom AI obsahuje krátku politiku, ktorú môžete skopírovať.
Nastavenie v piatich krokoch
- Vytvorte bezplatný účet Tera Ads. Zaregistrujte sa, pripojte svoj reklamný účet Meta a potom pripojte Shopify, aby odpovede zahŕňali zisk obchodu po vratkách.
- Pridajte adresu servera do editora. Vložte
https://teraads.co/mcpdo nastavení MCP v Cursore alebo VS Code, alebo spustite jeden príkaz v Claude Code; sekcie nižšie dávajú presný záznam pre každý. - Prihláste sa do Tera Ads v prehliadači. Editor otvorí Tera Ads, kde sa prihlásite a vyberiete jeden podnik na zdieľanie.
- Zvoľte, čo smie vaša AI robiť. Vyberte read only, ask me first alebo make changes pre toto pripojenie; medzi poslednými dvoma môžete neskôr prepínať v časti Pripojenia AI v Tera Ads.
- Opýtajte sa na niečo, čo viete overiť. Začnite napríklad „Koľko som včera minul na Mete?“ a porovnajte odpoveď s Ads Managerom, skôr než sa spoľahnete na niečo väčšie.

Prihlásenie používa OAuth 2.1 s PKCE a server podporuje dynamickú registráciu klienta, takže sa váš editor zaregistruje sám a nikdy nepracujete s ID klienta ani tajomstvom. Tera Ads ukladá tokeny len ako jednosmerné hashe. Prístupové tokeny vydržia hodinu a obnovujú sa za vás; pripojenie vydrží 30 dní, kým sa musíte prihlásiť znova.
Cursor
Cursor číta MCP servery zo súboru JSON. Jeho dokumentácia uvádza, že ~/.cursor/mcp.json vo vašom domovskom priečinku sprístupní nástroje všade a .cursor/mcp.json vnútri projektu ich obmedzí na ten projekt (dokumentácia MCP v Cursore). Pridajte tento záznam, ten istý, ktorý Tera Ads zverejňuje ako configs/cursor/mcp.json vo svojom repozitári na GitHube:
{"mcpServers": {"tera-ads": {"url": "https://teraads.co/mcp"}}}
Ak súbor už uvádza iné servery, pridajte záznam "tera-ads" do existujúceho objektu mcpServers, nenahrádzajte ho. Keď sa Cursor opýta, prihláste sa do Tera Ads v prehliadači. Nie je treba pridávať žiadny API kľúč ani hlavičku.
Cursor sa v predvolenom nastavení pred použitím nástroja MCP pýta na schválenie. Jeho dokumentácia popisuje aj povolenie nástrojov, aby bežali bez pýtania. Ak to používate, povoľte len nástroje na čítanie, ako get_insights a get_profit, a nástroje na zmeny (pause, resume, set_budget, duplicate a nástroje na vytváranie) nechajte za potvrdením.
VS Code
VS Code dáva dve cesty:
- MCP: Add Server. Otvorte Command Palette, spustite MCP: Add Server, vyberte HTTP, vložte
https://teraads.co/mcpa serveru dajte IDtera-ads. - Súbor pracovného priestoru. Pridajte záznam z
configs/vscode/mcp.jsonv repozitári do.vscode/mcp.json:{"servers": {"tera-ads": {"type": "http", "url": "https://teraads.co/mcp"}}}. VS Code používaserverstam, kde Cursor používamcpServers, takže nekopírujte súbor jedného editora do druhého.
Dokumentácia MCP vo VS Code teraz vedie nové nastavenia cez svoj sprevádzaný postup a uvádza, že súbory .vscode/mcp.json v pracovnom priestore zostávajú dostupné kvôli kompatibilite, takže funguje ktorákoľvek cesta. Spustite server, prihláste sa do Tera Ads, keď sa VS Code opýta, a potom zapnite Tera Ads v Configure Tools v chatovom vstupe. Dokumentácia VS Code radí schvaľovať len akcie, ktorým rozumiete, čo je správny zvyk pri každej požiadavke, ktorá sa dotýka rozpočtu.
Claude Code
Server pridá jeden príkaz:
claude mcp add --transport http tera-ads https://teraads.co/mcp
Spustite Claude Code, napíšte /mcp, vyberte tera-ads a prihláste sa do Tera Ads v prehliadači. Dokumentácia Claude Code uvádza, že /mcp spúšťa prihlásenie OAuth a že tokeny sa ukladajú a obnovujú automaticky; claude mcp list ukazuje, či je každý server pripojený alebo potrebuje autentifikáciu.
Server sa predvolene pridáva v lokálnom rozsahu: len pre vás, len v aktuálnom projekte. Pridajte --scope user, aby bol vo všetkých vašich projektoch, alebo --scope project, aby sa zapísal do súboru .mcp.json zdieľaného cez správu verzií. Zdieľaný súbor zdieľa len adresu. Každý sa prihlasuje samostatne a AI k podniku v Tera Ads môže pripojiť len vlastník podniku.
Plugin so šiestimi skills
Ak chcete pridať server spolu s hotovými pracovnými postupmi, nainštalujte namiesto toho Tera Ads ako plugin. Spustite claude plugin marketplace add Teralabsx/meta-ads-mcp a potom claude plugin install tera-ads@tera-ads. Dokumentácia pluginov Claude Code uvádza, že plugin pridáva svoje skills, agentov, hooky a MCP servery a že jeho skills sa zobrazujú v tvare /<plugin>:<skill>, takže prvý z nich nižšie je /tera-ads:profit-check.
| Skill | Čo robí |
|---|---|
profit-check | Dá čísla Mety vedľa zisku vášho obchodu po vratkách |
weekly-ads-review | Porovná tento týždeň s minulým a navrhne zmeny, bez toho, aby nejaké urobil |
pause-wasted-spend | Nájde reklamy, ktoré míňajú bez predaja, a pozastaví tie, ktoré vyberiete |
scale-a-winner | Zvyšuje rozpočet víťaza v bezpečných krokoch alebo ho skopíruje ako pozastavený návrh |
launch-paused-campaign | Zostaví celú kampaň, sadu reklám a reklamu, všetko pozastavené, na vašu kontrolu |
refresh-ad-copy | Napíše nové verzie unavenej reklamy ako pozastavené reklamy vedľa nej |
Tá istá dokumentácia uvádza, že pluginy z marketplaceov tretích strán sa predvolene neaktualizujú automaticky. Novú verziu získate príkazom claude plugin update tera-ads@tera-ads.
Tri editory vedľa seba
| Cursor | VS Code | Claude Code | |
|---|---|---|---|
| Kam ide nastavenie | ~/.cursor/mcp.json alebo .cursor/mcp.json | MCP: Add Server alebo .vscode/mcp.json | claude mcp add, v lokálnom, používateľskom alebo projektovom rozsahu |
| Formát záznamu | mcpServers s url | servers s "type": "http" a url | Jeden príkaz, žiadny súbor na úpravu |
| Prihlásenie | Prehliadač, keď sa Cursor opýta | Prehliadač po spustení servera | /mcp, potom prehliadač |
| Pred prvým použitím | Nič navyše | Zapnúť v Configure Tools | Nič navyše |
| Bonusy | Žiadne | Žiadne | Plugin so šiestimi skills |
| Dokumentácia editora | Cursor | VS Code | Claude Code |
Na čo sa opýtať ako prvé
Začnite otázkami, ktorých odpovede viete za minútu overiť v Ads Manageri. Keď čísla sedia, prejdite na tie, ktoré potrebujú dáta vášho obchodu. Knižnica promptov na analýzu reklám a otázky pre AI o vašich reklamách obsahujú viac.
| Opýtate sa | Čo vaša AI vyhľadá |
|---|---|
| „Ktoré kampane minuli tento týždeň najviac a čo priniesli?“ | get_insights |
| „Aký bol môj zisk po vratkách za posledných 30 dní?“ | get_profit |
| „Meta hovorí, že môj ROAS je 3. Čo môj obchod skutočne zarobil?“ | get_insights, get_profit |
| „Ktoré kampane prerábajú po vratkách a čo s nimi robiť?“ | get_ads_review |
| „Ktoré reklamy za posledných 14 dní minuli peniaze bez predaja?“ | get_insights na úrovni reklám |
| „Čo sa tento týždeň zmenilo v mojich reklamách a môžem to ešte vrátiť späť?“ | list_recent_changes |
Pri čítaní odpovedí majte na pamäti dve veci. Po prvé, nákupy a tržby z Mety sú atribúcia Mety, nie predaje vášho obchodu; prečo sa Meta Ads a Shopify nezhodujú vysvetľuje rozdiel. Po druhé, get_ads_review posudzuje každú kampaň, ktorá míňala, podľa zisku po obvyklých vratkách vášho obchodu, pri vašich vlastných nákladoch, voči vášmu break-even ROAS. Samotný zisk je odhad za celý obchod, zostavený z vašich objednávok pri vašom nastavení marže, nie hotovosť v banke.
Majte zmeny reklám pod kontrolou
Zmeny sa riadia na dvoch miestach: vo vašom editore, ktorý sa môže opýtať pred každým spustením nástroja, a v Tera Ads, ktoré rozhoduje, čo smie pripojenie vôbec robiť.
- Read only, ask first alebo make changes. S ask first zmena čaká v Tera Ads, kým ju tam neschválite, a vaša AI ju za vás schváliť nemôže.
- Nové veci začínajú pozastavené. Kampane, sady reklám, reklamy a kópie nič neminú, kým ich niečo nezapne.
- Kroky rozpočtu sú obmedzené. Jedna zmena môže rozpočet najviac strojnásobiť alebo znížiť na desatinu.
- Denný strop. Asistenti môžu urobiť najviac 50 zmien denne v jednom podniku.
- Žiadny nástroj na mazanie. Vaša AI môže pozastaviť, ale nemôže nič zmazať.
- Vrátenie späť 7 dní. Pozastavenie, zapnutie alebo zmenu rozpočtu možno v Tera Ads vrátiť späť 7 dní. Nové kampane, sady reklám a reklamy sa vrátiť späť nedajú, ale začínajú pozastavené.
- Jeden podnik na pripojenie. Pripojenie nemôže čítať iný podnik, ani ten, ktorý tiež vlastníte.

Názvy kampaní a texty reklám sa k vašej AI dostanú ako dáta a Tera Ads jej hovorí, aby nenasledovala pokyny v nich. Dokumentácia Claude Code uvádza aj všeobecný bod: servery, ktoré načítavajú vonkajší obsah, vás môžu vystaviť prompt injection, preto pripájajte len servery, ktorým dôverujete. Ak chcete vidieť každú zmenu skôr, než sa stane, zvoľte ask first.
Keď niečo nefunguje
Server hlási, že potrebuje prihlásenie. V Claude Code spustite /mcp a vyberte tera-ads; claude mcp list ukazuje, že potrebuje autentifikáciu, kým to neurobíte. V Cursore a VS Code reštartujte server a dokončite prihlásenie v prehliadači.
Nástroje sa nezobrazujú v chate VS Code. Otvorte Configure Tools v chatovom vstupe a zapnite Tera Ads.
Vaša AI hlási dosiahnutý limit. Bezplatný plán má 30 volaní týždenne, resetovaných týždenne v UTC. Požiadajte svoju AI, aby spustila get_usage, ktoré je zadarmo a povie, koľko volaní ostáva a kedy sa počet resetuje.
Rozpočty vyzerajú stokrát väčšie. list_campaigns ukazuje rozpočty v jednotkách Mety, ktoré sú pri väčšine mien stotiny, takže 5000 znamená 50 USD. set_budget berie celé jednotky meny vášho účtu.
Odpovede sú o nesprávnom obchode. Každé pripojenie pokrýva jeden podnik. Pripojte sa znova a vyberte druhý podnik.
Tera Ads Connect je MCP server Tera Ads, dashboardu zisku pre značky na Shopify. Dáva vášmu editoru živé čítanie Mety, predaje zo Shopify a zisk po vratkách a obmedzené, zaznamenávané zmeny reklám. Bezplatný plán zahŕňa 30 volaní týždenne na jednom reklamnom účte Meta a Connect Pro stojí 15 USD mesačne za 3 000 volaní mesačne až na troch reklamných účtoch; je zahrnutý v plánoch Growth a Scale. Kroky nastavenia pre každého klienta sú na stránke Connect.
Časté otázky
Funguje Meta Ads MCP v Cursore?
Áno. Cursor podporuje vzdialené MCP servery s prihlásením cez OAuth. Pridajte záznam Tera Ads do ~/.cursor/mcp.json alebo .cursor/mcp.json a potom sa prihláste do Tera Ads, keď sa Cursor opýta.
Ako pridám Meta Ads MCP do VS Code?
Spustite MCP: Add Server, vyberte HTTP a vložte https://teraads.co/mcp, alebo pridajte záznam do .vscode/mcp.json. Spustite server, prihláste sa a potom zapnite Tera Ads v Configure Tools v chate.
Aký je príkaz Claude Code pre Meta Ads MCP?
claude mcp add --transport http tera-ads https://teraads.co/mcp. Potom v Claude Code napíšte /mcp a prihláste sa. Šesť hotových reklamných skills získate inštaláciou pluginu cez claude plugin marketplace add Teralabsx/meta-ads-mcp a claude plugin install tera-ads@tera-ads.
Potrebujem API kľúč alebo vývojársku aplikáciu Meta?
Nie. Do Tera Ads sa prihlásite v prehliadači a zmeny sa dostanú k Mete cez vlastnú schválenú aplikáciu Meta od Tera Ads. Do konfiguračného súboru nejde nič tajné.
Môže AI v mojom editore meniť moje reklamy?
Len ak to pre dané pripojenie dovolíte. Aj vtedy nové veci začínajú pozastavené, jedna zmena rozpočtu ho môže najviac strojnásobiť alebo znížiť na desatinu a pozastavenie, zapnutie alebo zmenu rozpočtu možno v Tera Ads vrátiť späť 7 dní.
Koľko to stojí?
Bezplatný plán zahŕňa 30 volaní týždenne na jednom reklamnom účte Meta. Connect Pro stojí 15 USD mesačne za 3 000 volaní mesačne. Volanie je jedno vyhľadanie, ktoré vaša AI urobí v Tera Ads, a jedna otázka môže vyžadovať niekoľko.