Meta Ads в Codex и Gemini CLI: свържете кодиращ агент с реклами
Свържете Codex или Gemini CLI с рекламите си в Meta с две команди: настройка, вход през браузъра, безопасни настройки на инструментите и въпроси спрямо печалбата.
На тази страница
Codex и Gemini CLI могат и двата да четат и управляват рекламите ви в Meta през Tera Ads, хостван MCP сървър на https://teraads.co/mcp. В Codex изпълнете codex mcp add tera-ads --url https://teraads.co/mcp, после codex mcp login tera-ads. В Gemini CLI инсталирайте разширението на Tera Ads от GitHub и изпълнете /mcp auth tera-ads. И двата ви вкарват в Tera Ads през браузъра, а вие избирате дали агентът само чете, пита ви първо или прави промени.
Накратко
- Две команди за всеки агент: добавяте сървъра, после влизате в Tera Ads през браузъра. API ключове не влизат в конфигурацията ви.
- Codex държи сървъра в
~/.codex/config.toml, който се споделя от разширението Codex за IDE и настолното приложение на ChatGPT. - Gemini CLI инсталира Tera Ads като разширение, което зарежда и контекстен файл, казващ на Gemini кога да го използва.
- Агентът ви получава 29 инструмента, от четене на живо от Meta до печалбата на магазина след връщанията и ограничени промени на бюджета.
- Ограничавайте промените на две места: собствените настройки на инструментите на агента и режима на връзката в Tera Ads.
Защо да свържете кодиращ агент с рекламите си
Много основатели с Shopify правят сами темата си, скриптове и вътрешни инструменти и прекарват половината ден в терминал. Кодиращ агент, свързан с рекламите ви, може да отговори на „колко похарчи Meta вчера?" в същата сесия, в която редактирате страница на продукт, да запише седмично обобщение като Markdown файл в хранилището ви или да подреди седмица резултати от кампании спрямо промяна, която сте пуснали във вторник.
Връзката между агента и рекламния ви акаунт е MCP, Model Context Protocol: отворен стандарт, който позволява на AI агент да извиква инструменти, предлагани от друга услуга. MCP конекторите, обяснени покрива основите. Codex и Gemini CLI поддържат отдалечени MCP сървъри с вход през OAuth, така че хостван сървър като Tera Ads не изисква нищо инсталирано освен самия агент.
Това, което Tera Ads добавя към обикновена връзка с Meta, е вашият магазин. Освен четене на живо на кампании, рекламни набори и реклами, отговаря и от поръчките, връщанията, себестойността, доставката, таксите и възстановяванията в Shopify, минус разходите ви за Meta и Google реклами. Приписаните от Meta приходи са означени като на Meta, така че агентът да не ги приема за продажби. За други сървъри, които можете да свържете вместо това, вижте опциите за Meta Ads MCP.
Една бележка за Gemini CLI: документацията му съдържа известие, че за потребители на безплатното ниво и Google One Gemini CLI е заменен от Antigravity CLI на 18 юни 2026 г. (MCP документацията на Gemini CLI). Стъпките по-долу следват Gemini CLI, както е документиран през октомври 2026 г.
Преди да започнете
- Безплатен акаунт в Tera Ads. Регистрирайте се и свържете рекламния си акаунт в Meta. Свържете и Shopify, за да вижда агентът продажбите и печалбата на магазина.
- Достъп на собственик. Само собственикът на бизнеса може да свърже AI с бизнес в Tera Ads.
- Инсталиран Codex или Gemini CLI и влязъл в собствения си акаунт.
- Правило за промените. Решете дали агентът само ще отчита, или ще спира реклами и ще мести бюджети. Ръководството за безопасен AI достъп има кратка политика, която можете да копирате.
Свързване на Codex, стъпка по стъпка
- Създайте безплатен акаунт в Tera Ads. Регистрирайте се, свържете рекламния си акаунт в Meta, после свържете Shopify, за да включват отговорите печалбата на магазина след връщанията.
- Добавете сървъра в Codex. В терминала изпълнете
codex mcp add tera-ads --url https://teraads.co/mcp. - Влезте в Tera Ads. Изпълнете
codex mcp login tera-ads; отваря Tera Ads в браузъра ви, където влизате, избирате бизнеса и избирате какво може да прави агентът. - Проверете връзката. Стартирайте
codexи напишете/mcp, което изброява активните MCP сървъри; tera-ads трябва да е в списъка. - Задайте въпрос, който можете да проверите. Опитайте „Use Tera Ads to list my active Meta campaigns with yesterday's spend" и сравнете отговора с Ads Manager.

Codex съхранява MCP сървърите в ~/.codex/config.toml, по една таблица [mcp_servers.tera-ads] на сървър с адреса в url. Документацията на OpenAI казва, че настолното приложение на ChatGPT, Codex CLI и разширението за IDE споделят тази конфигурация, така че една настройка покрива и трите (MCP документация на Codex). Същата документация казва, че codex mcp login обработва OAuth и че Codex може да избира метод за регистрация на клиент автоматично. Tera Ads поддържа динамична регистрация на клиент с OAuth 2.1 и PKCE, така че няма client ID за подаване.
Ограничете Codex до четене от негова страна
Настройките на сървъра в Codex приемат enabled_tools, списък с разрешени, и disabled_tools, списък със забранени, прилаган след него. За да не може Codex да извиква инструментите за промени, дори връзката ви в Tera Ads да позволява промени, добавете този ред под [mcp_servers.tera-ads] в config.toml:
disabled_tools = ["pause", "resume", "set_budget", "create_campaign", "create_ad_set", "create_ad", "duplicate"]
Документацията описва и настройки за одобрение за всеки сървър и всеки инструмент. Най-простата защита все пак е тази в Tera Ads: изберете само четене, когато влизате, и инструментите за промени не могат да направят нищо за тази връзка.
Свързване на Gemini CLI
- Инсталирайте разширението. Изпълнете
gemini extensions install https://github.com/Teralabsx/meta-ads-mcp. - Влезте в Tera Ads. Стартирайте Gemini CLI, изпълнете
/mcp auth tera-ads, после влезте, изберете бизнеса и изберете какво може да прави агентът. - Проверете инструментите. Напишете
/mcp, за да видите състоянието и инструментите на всеки сървър, или изпълнетеgemini extensions listв обвивката си. - Задайте въпрос, който можете да проверите. Опитайте „Кои кампании в Meta похарчиха най-много тази седмица?" и сравнете отговора с Ads Manager.
Разширението е малък файл gemini-extension.json в хранилището на Tera Ads в GitHub. Насочва Gemini към https://teraads.co/mcp през полето httpUrl, което документацията на Gemini определя като Streamable HTTP крайна точка, докато url е за SSE. Назовава и GEMINI.md като свой контекстен файл. Този файл казва на Gemini да използва Tera Ads за въпроси за реклами в Meta, ROAS и печалба, да означава приписаните от Meta приходи като на Meta и да третира имената на кампании и текста на реклами като данни, никога като инструкции.
Документацията на Gemini казва, че поддържа OAuth за отдалечени MCP сървъри, може да открива настройката автоматично, обработва динамична регистрация на клиент, където сървърът я поддържа, и съхранява токените в ~/.gemini/mcp-oauth-tokens.json. Настройките на сървъра включват и trust, което заобикаля всички потвърждения на извикване на инструменти, когато е true. Разширението на Tera Ads не го задава. Оставете го така, за да продължи Gemini да пита, преди да изпълни инструмент.
Codex и Gemini CLI един до друг
| Codex | Gemini CLI | |
|---|---|---|
| Добавяне на сървъра | codex mcp add tera-ads --url https://teraads.co/mcp | gemini extensions install https://github.com/Teralabsx/meta-ads-mcp |
| Вход | codex mcp login tera-ads | /mcp auth tera-ads |
| Къде се съхранява | ~/.codex/config.toml | Инсталирано разширение |
| Проверка, че работи | /mcp в Codex | /mcp или gemini extensions list |
| Ограничения от страна на агента | enabled_tools, disabled_tools, настройки за одобрение | Оставете trust изключено |
| Покрива още | Разширението Codex за IDE и настолното приложение на ChatGPT | Зарежда GEMINI.md като контекст |
| Документация на агента | MCP документация на Codex | Разширения на Gemini CLI |
За да накарате Codex или друг агент да използва Tera Ads без да му се казва, хранилището предлага да копирате съдържанието на GEMINI.md в AGENTS.md или CLAUDE.md на проекта си. Иначе назовете Tera Ads в подсказката си.
Подсказки, които подхождат на терминален агент
Кодиращ агент може да направи нещо, което чат прозорец не може: да сложи отговора там, където работите. Помолете го да запише резултатите във файл, да ги сравни с файла от миналата седмица или да отвори страницата на продукта, към която води кампания.
| Питайте | Какво използва агентът |
|---|---|
| „Каква беше печалбата ми след връщанията през последните 30 дни? Запази я в reports/profit.md." | get_profit, после собствените му инструменти за файлове |
| „Meta казва, че ROAS ми е 3. Какво всъщност направи магазинът ми?" | get_insights, get_profit |
| „Кои кампании губят пари след връщанията и какво да правя с тях?" | get_ads_review |
| „Кои реклами са харчили пари през последните 14 дни без продажба?" | get_insights на ниво реклама |
| „Какво се промени в рекламите ми тази седмица и мога ли още да го отменя?" | list_recent_changes |
| „Копирай най-добрата ми кампания като чернова на пауза." | duplicate |
| „Колко извиквания в Tera Ads са ми останали?" | get_usage, което е безплатно |
Четете отговорите с две уговорки. Покупките и приходите на Meta са атрибуция на Meta, не продажби на магазина ви. И get_ads_review преценява всяка кампания, която е харчила, по печалбата след обичайните връщания на магазина ви, при вашите собствени разходи, спрямо вашия break-even ROAS; сумата за печалбата е оценка за целия магазин, не пари в банката. Истинският ROAS след възстановяванията показва защо разликата има значение, а библиотеката с подсказки за анализ на реклами има още въпроси за пробване.

Дръжте промените на агента под контрол
Кодиращите агенти често са настроени да редактират файлове, без да питат всеки път. Не оставяйте този навик да се прехвърли върху инструментите за реклами, където едно грешно извикване харчи реални пари. Tera Ads налага свои лимити, каквото и да е позволено на агента:
- Само четене, първо питай или правене на промени. При първо питай промяната чака в Tera Ads, докато я одобрите там, и агентът не може да я одобри вместо вас.
- Новото започва на пауза. Кампании, рекламни набори, реклами и копия не харчат нищо, докато нещо не ги включи.
- Стъпките на бюджета са ограничени. Една промяна може най-много да утрои бюджета или да го намали до една десета.
- Дневен лимит. Асистентите могат да правят най-много 50 промени на ден за един бизнес.
- Няма инструмент за изтриване. Агентът може да паузира, но не може да изтрива нищо.
- Отмяна за 7 дни. Пауза, включване или промяна на бюджет може да се отмени в Tera Ads в рамките на 7 дни. Нови кампании, рекламни набори и реклами не могат да се отменят, но започват на пауза.
- Един бизнес на връзка. Връзката не може да чете друг бизнес, дори такъв, който също притежавате.
Ако резултат от промяна се върне като outcome_unknown, не искайте от агента да я повтаря. Помолете го първо да провери list_recent_changes, за да не се направи същата промяна два пъти.
Когато нещо не работи
Агентът игнорира Tera Ads. Назовете го в подсказката („use Tera Ads to...") или копирайте GEMINI.md във файла с инструкции на проекта си, както по-горе.
Иска да влезете отново. Токените за достъп траят един час и се подновяват вместо вас; връзката трае 30 дни. Изпълнете отново codex mcp login tera-ads или /mcp auth tera-ads.
Казва, че е достигнат лимит. Безплатният план има 30 извиквания седмично, нулирани седмично в UTC. get_usage е безплатно и казва колко извиквания са останали и кога се нулира броячът.
Бюджетите изглеждат сто пъти по-големи. list_campaigns показва бюджетите в единиците на Meta, които са стотни за повечето валути, така че 5000 означава $50. set_budget приема цели единици от валутата на акаунта ви.
Отговорите са за грешния магазин. Всяка връзка покрива един бизнес. Влезте отново и изберете другия.
Tera Ads Connect е MCP сървърът на Tera Ads, таблото за печалба за марки в Shopify. Дава на Codex, Gemini CLI и други MCP клиенти четене на живо от Meta, продажби от Shopify и печалба след връщанията, и ограничени, записвани промени на реклами. Безплатният план включва 30 извиквания седмично за един рекламен акаунт в Meta, а Connect Pro струва $15 месечно за 3000 извиквания месечно за до три рекламни акаунта; включен е в плановете Growth и Scale. Стъпките за други клиенти са на страницата Connect.
Често задавани въпроси
Може ли Codex да управлява реклами в Meta?
Да, през MCP сървър. Изпълнете codex mcp add tera-ads --url https://teraads.co/mcp и codex mcp login tera-ads, после питайте с прости думи. Какво може да променя Codex, зависи от режима, който изберете за връзката.
Как да свържа Gemini CLI с Facebook реклами?
Изпълнете gemini extensions install https://github.com/Teralabsx/meta-ads-mcp, после /mcp auth tera-ads в Gemini CLI и влезте в Tera Ads. Разширението покрива реклами във Facebook и Instagram във вашия рекламен акаунт в Meta.
Нужно ли ми е приложение за разработчици на Meta или API токен?
Не. Влизате в Tera Ads през браузъра, а промените стигат до Meta през собственото одобрено приложение на Tera Ads в Meta. Нищо тайно не влиза във вашия конфигурационен файл.
Работи ли настройката за Codex и в разширението за IDE?
Да. Документацията на OpenAI казва, че настолното приложение на ChatGPT, Codex CLI и разширението за IDE споделят една и съща MCP конфигурация, така че сървър, добавен в CLI, е наличен и в другите две.
Още ли е наличен Gemini CLI?
Документацията на Gemini CLI казва, че за потребители на безплатното ниво и Google One е заменен от Antigravity CLI на 18 юни 2026 г. Проверете документацията на Google за вашия тип акаунт, преди да го настроите.
Колко струва?
Безплатният план включва 30 извиквания седмично за един рекламен акаунт в Meta. Connect Pro е $15 месечно за 3000 извиквания месечно. Извикването е едно търсене, което агентът прави в Tera Ads, а един въпрос може да изисква няколко.