Přeskočit na obsah
AI pro reklamy

Meta Ads v Codexu a Gemini CLI: připojení kódovacího agenta k reklamám

Připojte Codex nebo Gemini CLI ke svým reklamám na Metě dvěma příkazy: nastavení, přihlášení v prohlížeči, bezpečné nastavení nástrojů a prompty k ověření zisku.

Aktualizováno 9 min čteníAutor Tera Ads editorial teamFakta ověřena

Také v jazyce English · Español · Português · Deutsch · Français · Italiano · Bahasa Indonesia · Nederlands · Türkçe · Polski · 日本語 · 한국어 · 简体中文 · 繁體中文 · हिन्दी · العربية · עברית · Русский · Українська · Svenska · Dansk · Norsk bokmål · Suomi · Română · Magyar · Ελληνικά · ไทย · Tiếng Việt · Bahasa Melayu · Filipino · Български · Slovenčina · Hrvatski · Lietuvių · Slovenščina

Na této stránce
  1. Proč připojit kódovacího agenta k reklamám
  2. Než začnete
  3. Připojení Codexu krok za krokem
  4. Připojení Gemini CLI
  5. Codex a Gemini CLI vedle sebe
  6. Prompty vhodné pro terminálového agenta
  7. Udržte změny agenta pod kontrolou
  8. Když něco nefunguje
  9. Časté dotazy

Codex i Gemini CLI mohou číst a spravovat vaše reklamy na Metě přes Tera Ads, hostovaný MCP server na https://teraads.co/mcp. V Codexu spusťte codex mcp add tera-ads --url https://teraads.co/mcp a pak codex mcp login tera-ads. V Gemini CLI nainstalujte rozšíření Tera Ads z GitHubu a spusťte /mcp auth tera-ads. Obojí vás přihlásí k Tera Ads v prohlížeči a vy zvolíte, zda agent jen čte, ptá se vás napřed, nebo provádí změny.

Hlavní body

  • Dva příkazy na agenta: přidáte server a pak se v prohlížeči přihlásíte k Tera Ads. Do konfigurace nepatří žádné API klíče.
  • Codex drží server v ~/.codex/config.toml, které sdílí rozšíření Codex pro IDE i desktopová aplikace ChatGPT.
  • Gemini CLI instaluje Tera Ads jako rozšíření, které navíc načte kontextový soubor, jenž Geminimu říká, kdy ho použít.
  • Váš agent dostane 29 nástrojů, od živého čtení z Mety po zisk obchodu po vratkách a změny rozpočtu s omezením.
  • Změny omezte na dvou místech: ve vlastním nastavení nástrojů agenta a v režimu připojení Tera Ads.

Proč připojit kódovacího agenta k reklamám

Spousta zakladatelů na Shopify si sama staví šablonu, skripty a interní nástroje a polovinu dne tráví v terminálu. Kódovací agent připojený k reklamám může odpovědět na „kolik Meta včera utratila?“ ve stejné relaci, ve které upravujete stránku produktu, uložit týdenní souhrn jako soubor Markdown do repozitáře nebo srovnat týden výsledků kampaní se změnou, kterou jste v úterý nasadili.

Spojení mezi agentem a reklamním účtem je MCP, Model Context Protocol: otevřený standard, který umožňuje AI agentovi volat nástroje, jež nabízí jiná služba. Základy vysvětluje průvodce konektory MCP. Codex i Gemini CLI podporují vzdálené MCP servery s přihlášením přes OAuth, takže hostovaný server jako Tera Ads nevyžaduje nic instalovat kromě samotného agenta.

Tera Ads k běžnému připojení k Metě přidává váš obchod. Kromě živého čtení kampaní, sad reklam a reklam odpovídá z objednávek ze Shopify, vratek, nákladů na zboží, dopravy, poplatků a refundací, po odečtení výdajů na Metu a Google. Tržby přiřazené Metou jsou označeny jako tržby Mety, takže je agent nepovažuje za prodeje. Jiné servery, které můžete připojit místo toho, najdete v možnostech MCP pro Meta Ads.

Poznámka ke Gemini CLI: jeho dokumentace obsahuje upozornění, že pro uživatele bezplatné úrovně a Google One byl Gemini CLI 18. června 2026 nahrazen Antigravity CLI (dokumentace MCP v Gemini CLI). Kroky níže odpovídají Gemini CLI, jak byl zdokumentován v říjnu 2026.

Než začnete

  • Bezplatný účet Tera Ads. Zaregistrujte se a připojte svůj reklamní účet Meta. Připojte i Shopify, aby agent viděl tržby a zisk obchodu.
  • Přístup vlastníka. K firmě v Tera Ads může AI připojit jen vlastník firmy.
  • Nainstalovaný Codex nebo Gemini CLI a přihlášený k vlastnímu účtu.
  • Pravidlo pro změny. Rozhodněte, zda agent bude jen reportovat, nebo i pozastavovat reklamy a přesouvat rozpočty. Průvodce bezpečným přístupem AI obsahuje krátkou politiku, kterou můžete převzít.

Připojení Codexu krok za krokem

  1. Vytvořte bezplatný účet Tera Ads. Zaregistrujte se, připojte reklamní účet Meta a pak Shopify, aby odpovědi zahrnovaly zisk obchodu po vratkách.
  2. Přidejte server do Codexu. V terminálu spusťte codex mcp add tera-ads --url https://teraads.co/mcp.
  3. Přihlaste se k Tera Ads. Spusťte codex mcp login tera-ads; otevře Tera Ads v prohlížeči, kde se přihlásíte, vyberete firmu a zvolíte, co smí agent dělat.
  4. Ověřte připojení. Spusťte codex a napište /mcp, což vypíše aktivní servery MCP; tera-ads by měl být na seznamu.
  5. Zeptejte se na něco, co můžete ověřit. Zkuste „Use Tera Ads to list my active Meta campaigns with yesterday's spend“ a porovnejte odpověď se Správcem reklam.
Jak se kódovací agent připojí k Tera Ads: přidat server, přihlásit se, vybrat firmu a režim, pak se ptát
Jak se kódovací agent připojí k Tera Ads: přidat server, přihlásit se, vybrat firmu a režim, pak se ptát

Codex ukládá servery MCP do ~/.codex/config.toml, jednu tabulku [mcp_servers.tera-ads] na server s adresou v url. Dokumentace OpenAI říká, že desktopová aplikace ChatGPT, Codex CLI a rozšíření pro IDE sdílejí tuto konfiguraci, takže jedno nastavení pokryje všechny tři (dokumentace MCP v Codexu). Stejná dokumentace uvádí, že codex mcp login zajišťuje OAuth a že Codex umí zvolit způsob registrace klienta automaticky. Tera Ads podporuje dynamickou registraci klienta s OAuth 2.1 a PKCE, takže nemusíte předávat žádné ID klienta.

Na straně Codexu se držte čtení

Nastavení serveru v Codexu přijímá enabled_tools, seznam povolených, a disabled_tools, seznam zakázaných, který se uplatní po něm. Aby Codex nevolal nástroje pro změny, ani když vaše připojení k Tera Ads změny povoluje, přidejte tento řádek pod [mcp_servers.tera-ads] v config.toml:

disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]

Dokumentace popisuje také nastavení schvalování pro každý server a nástroj. Nejjednodušší pojistkou je však dál ta v Tera Ads: při přihlášení zvolte jen čtení a nástroje pro změny u tohoto připojení nic neudělají.

Připojení Gemini CLI

  1. Nainstalujte rozšíření. Spusťte gemini extensions install https://github.com/Teralabsx/meta-ads-mcp.
  2. Přihlaste se k Tera Ads. Spusťte Gemini CLI, zadejte /mcp auth tera-ads, pak se přihlaste, vyberte firmu a zvolte, co smí agent dělat.
  3. Zkontrolujte nástroje. Napište /mcp pro stav a nástroje každého serveru, nebo spusťte v shellu gemini extensions list.
  4. Zeptejte se na něco, co můžete ověřit. Zkuste „Which Meta campaigns spent the most this week?“ a porovnejte odpověď se Správcem reklam.

Rozšíření je malý soubor gemini-extension.json v repozitáři Tera Ads na GitHubu. Ukazuje Geminimu na https://teraads.co/mcp přes pole httpUrl, které dokumentace Gemini definuje jako koncový bod Streamable HTTP, zatímco url je pro SSE. Jako kontextový soubor také uvádí GEMINI.md. Ten soubor říká Geminimu, aby sáhl po Tera Ads u dotazů na reklamy Mety, ROAS a zisk, aby tržby přiřazené Metou označoval jako tržby Mety a aby názvy kampaní a texty reklam bral jako data, nikdy jako pokyny.

Dokumentace Gemini uvádí, že podporuje OAuth pro vzdálené servery MCP, umí nastavení zjistit automaticky, zvládá dynamickou registraci klienta, kde ji server podporuje, a ukládá tokeny do ~/.gemini/mcp-oauth-tokens.json. Nastavení serveru zahrnuje i trust, které po nastavení na true obchází všechna potvrzování volání nástrojů. Rozšíření Tera Ads ho nenastavuje. Nechte to tak, aby se Gemini dál ptal, než nástroj spustí.

Codex a Gemini CLI vedle sebe

Nastavení Tera Ads v Codexu a Gemini CLI, podle dokumentace každého agenta a repozitáře Tera Ads, ověřeno 31. října 2026.
CodexGemini CLI
Přidání serverucodex mcp add tera-ads --url https://teraads.co/mcpgemini extensions install https://github.com/Teralabsx/meta-ads-mcp
Přihlášenícodex mcp login tera-ads/mcp auth tera-ads
Kde je uloženo~/.codex/config.tomlNainstalované rozšíření
Ověření funkčnosti/mcp v Codexu/mcp nebo gemini extensions list
Omezení na straně agentaenabled_tools, disabled_tools, nastavení schvalováníNechte trust vypnuté
Pokrývá takéRozšíření Codex pro IDE a desktopovou aplikaci ChatGPTNačítá GEMINI.md jako kontext
Dokumentace agentaDokumentace MCP v CodexuRozšíření Gemini CLI

Aby Codex nebo jiný agent používal Tera Ads, aniž by se mu to říkalo, repozitář doporučuje zkopírovat obsah GEMINI.md do AGENTS.md nebo CLAUDE.md vašeho projektu. Jinak uveďte Tera Ads v promptu.

Prompty vhodné pro terminálového agenta

Kódovací agent umí něco, co chatovací okno ne: dát odpověď tam, kde pracujete. Požádejte ho, aby uložil výsledky do souboru, porovnal je se souborem z minulého týdne nebo otevřel stránku produktu, na kterou kampaň posílá lidi.

Prompty pro Codex nebo Gemini CLI s nástroji Tera Ads, které každý používá.
ZadáníCo agent použije
„Jaký byl můj zisk po vratkách za posledních 30 dní? Ulož to do reports/profit.md.“get_profit, pak vlastní nástroje pro soubory
„Meta říká, že mé ROAS je 3. Co můj obchod skutečně vydělal?“get_insights, get_profit
„Které kampaně po vratkách prodělávají a co s nimi dělat?“get_ads_review
„Které reklamy za posledních 14 dní utratily peníze bez prodeje?“get_insights na úrovni reklam
„Co se v mých reklamách tento týden změnilo a lze to ještě vrátit?“list_recent_changes
„Zkopíruj mou nejlepší kampaň jako pozastavený koncept.“duplicate
„Kolik volání Tera Ads mi zbývá?“get_usage, které je zdarma

Odpovědi čtěte se dvěma výhradami. Nákupy a tržby z Mety jsou atribuce Mety, ne tržby vašeho obchodu. A get_ads_review posuzuje každou kampaň, která utrácela, podle zisku po obvyklých vratkách vašeho obchodu, s vašimi vlastními náklady, proti vašemu break-even ROAS; údaj o zisku je odhad pro celý obchod, ne hotovost na účtu. Skutečné ROAS po refundacích ukazuje, proč na rozdílu záleží, a knihovna promptů pro analýzu reklam nabízí další otázky k vyzkoušení.

Limity Tera Ads Connect na první pohled: 29 nástrojů, 7denní vrácení, trojnásobný strop rozpočtu a 30 bezplatných volání týdně
Limity Tera Ads Connect na první pohled: 29 nástrojů, 7denní vrácení, trojnásobný strop rozpočtu a 30 bezplatných volání týdně

Udržte změny agenta pod kontrolou

Kódovací agenti jsou často nastaveni, aby upravovali soubory bez ptaní. Nenechte tento zvyk přejít na nástroje pro reklamy, kde jedno špatné volání utratí skutečné peníze. Tera Ads si nastavuje vlastní limity bez ohledu na to, co smí agent:

  • Jen čtení, ptát se napřed, nebo provádět změny. V režimu ptát se napřed změna čeká v Tera Ads, dokud ji tam neschválíte, a agent ji za vás schválit nemůže.
  • Nové věci začínají pozastavené. Kampaně, sady reklam, reklamy a kopie nic neutrácejí, dokud je něco nezapne.
  • Kroky rozpočtu jsou omezené. Jedna změna ho může nanejvýš ztrojnásobit nebo snížit na desetinu.
  • Denní limit. Asistenti mohou provést nanejvýš 50 změn denně u jedné firmy.
  • Žádný nástroj pro mazání. Agent může pozastavit, ale nemůže nic smazat.
  • Vrácení po dobu 7 dnů. Pozastavení, zapnutí nebo změnu rozpočtu lze v Tera Ads vrátit po dobu 7 dnů. Nové kampaně, sady reklam a reklamy vrátit nelze, ale začínají pozastavené.
  • Jedna firma na připojení. Připojení nemůže číst jinou firmu, ani když ji také vlastníte.

Pokud výsledek změny přijde jako outcome_unknown, nežádejte agenta, aby ji zopakoval. Požádejte ho, aby nejdřív zkontroloval list_recent_changes, aby se tatáž změna neprovedla dvakrát.

Když něco nefunguje

Agent Tera Ads ignoruje. Pojmenujte ho v promptu („use Tera Ads to...“) nebo zkopírujte GEMINI.md do souboru s pokyny projektu, jak je popsáno výše.

Žádá o nové přihlášení. Přístupové tokeny platí hodinu a obnovují se za vás; připojení trvá 30 dní. Spusťte znovu codex mcp login tera-ads nebo /mcp auth tera-ads.

Hlásí dosažení limitu. Bezplatný plán má 30 volání týdně, nulované týdně v UTC. get_usage je zdarma a řekne, kolik volání zbývá a kdy se počet nuluje.

Rozpočty vypadají stokrát větší. list_campaigns ukazuje rozpočty v jednotkách Mety, což jsou u většiny měn setiny, takže 5000 znamená 50 USD. set_budget bere celé jednotky měny vašeho účtu.

Odpovědi se týkají špatného obchodu. Každé připojení pokrývá jednu firmu. Přihlaste se znovu a vyberte jinou.

Tera Ads Connect je MCP server Tera Ads, přehledu zisku pro značky na Shopify. Dává Codexu, Gemini CLI a dalším klientům MCP živé čtení z Mety, tržby ze Shopify a zisk po vratkách a omezené, zaznamenávané změny reklam. Bezplatný plán zahrnuje 30 volání týdně na jednom reklamním účtu Meta a Connect Pro stojí 15 USD měsíčně za 3 000 volání měsíčně až na třech reklamních účtech; je součástí plánů Growth a Scale. Kroky nastavení pro další klienty jsou na stránce Connect.

Časté dotazy

Může Codex spravovat reklamy na Metě?

Ano, přes MCP server. Spusťte codex mcp add tera-ads --url https://teraads.co/mcp a codex mcp login tera-ads a pak se ptejte běžnými slovy. Co smí Codex měnit, závisí na režimu, který pro připojení zvolíte.

Jak připojím Gemini CLI k reklamám na Facebooku?

Spusťte gemini extensions install https://github.com/Teralabsx/meta-ads-mcp, pak v Gemini CLI /mcp auth tera-ads a přihlaste se k Tera Ads. Rozšíření pokrývá reklamy na Facebooku a Instagramu ve vašem reklamním účtu Meta.

Potřebuji vývojářskou aplikaci Meta nebo API token?

Ne. K Tera Ads se přihlásíte v prohlížeči a změny se k Metě dostávají přes vlastní schválenou aplikaci Meta od Tera Ads. Do konfiguračního souboru nepatří nic tajného.

Funguje nastavení Codexu i v rozšíření pro IDE?

Ano. Dokumentace OpenAI říká, že desktopová aplikace ChatGPT, Codex CLI a rozšíření pro IDE sdílejí stejnou konfiguraci MCP, takže server přidaný v CLI je i v dalších dvou.

Je Gemini CLI pořád dostupný?

Dokumentace Gemini CLI uvádí, že byl pro uživatele bezplatné úrovně a Google One 18. června 2026 nahrazen Antigravity CLI. Než ho nastavíte, ověřte si v dokumentaci Googlu svůj typ účtu.

Kolik to stojí?

Bezplatný plán zahrnuje 30 volání týdně na jednom reklamním účtu Meta. Connect Pro stojí 15 USD měsíčně za 3 000 volání měsíčně. Volání je jedno vyhledání, které agent v Tera Ads provede, a jeden dotaz jich může vyžadovat několik.

Uvidíte, co vaše reklamy skutečně vydělávají.

Připojte svůj obchod a reklamní účty. Zdarma pro jeden byznys, bez karty.

Vytvořit bezplatný účet