Перейти до вмісту
AI для реклами

Meta Ads у Codex і Gemini CLI: підключення агента для коду до реклами

Підключіть Codex або Gemini CLI до реклами Meta двома командами: налаштування, вхід у браузері, безпечні параметри інструментів і запити, що звіряють рекламу з Shopify.

Оновлено 9 хв читанняАвтор Tera Ads editorial teamФакти перевірено

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

На цій сторінці
  1. Навіщо підключати агента для коду до реклами
  2. Перш ніж почати
  3. Підключення Codex крок за кроком
  4. Підключення Gemini CLI
  5. Codex і Gemini CLI поруч
  6. Запити, що пасують агентові в терміналі
  7. Тримайте зміни агента під контролем
  8. Коли щось не працює
  9. Поширені запитання

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: відкритий стандарт, що дозволяє ШІ-агентові викликати інструменти, які надає інший сервіс. Основи пояснює матеріал 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, щоб агент бачив продажі й прибуток магазину.
  • Доступ власника. Підключити ШІ до бізнесу в Tera Ads може лише власник бізнесу.
  • Встановлений Codex або Gemini CLI із виконаним входом у власний акаунт.
  • Правило для змін. Вирішіть, чи агент лише звітуватиме, чи ще й зупинятиме оголошення та переміщатиме бюджети. У посібнику про безпечний ШІ-доступ є коротка політика, яку можна скопіювати.

Підключення Codex крок за кроком

  1. Створіть безкоштовний акаунт Tera Ads. Зареєструйтеся, підключіть рекламний акаунт Meta, потім підключіть Shopify, щоб відповіді включали прибуток вашого магазину після повернень.
  2. Додайте сервер у Codex. У терміналі виконайте codex mcp add tera-ads --url https://teraads.co/mcp.
  3. Увійдіть у Tera Ads. Виконайте codex mcp login tera-ads; відкриється Tera Ads у браузері, де ви входите, вибираєте бізнес і визначаєте, що агентові дозволено.
  4. Перевірте підключення. Запустіть codex і введіть /mcp, що показує активні MCP-сервери; tera-ads має бути в списку.
  5. Поставте запитання, яке можна перевірити. Спробуйте «Використай Tera Ads, щоб показати мої активні кампанії Meta з учорашніми витратами» і порівняйте відповідь з Ads Manager.
Як агент для коду підключається до Tera Ads: додати сервер, увійти, вибрати бізнес і режим, потім питати
Як агент для коду підключається до Tera Ads: додати сервер, увійти, вибрати бізнес і режим, потім питати

Codex зберігає MCP-сервери в ~/.codex/config.toml, по одній таблиці [mcp_servers.tera-ads] на сервер з адресою в url. Документація OpenAI каже, що настільний застосунок ChatGPT, Codex CLI і розширення для IDE спільно використовують цю конфігурацію, тож одне налаштування покриває всі три (документація Codex MCP). У ній же сказано, що codex mcp login виконує OAuth і що Codex може сам вибрати спосіб реєстрації клієнта. Tera Ads підтримує динамічну реєстрацію клієнтів з OAuth 2.1 та PKCE, тож передавати ідентифікатор клієнта не потрібно.

Обмежте 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

  1. Встановіть розширення. Виконайте gemini extensions install https://github.com/Teralabsx/meta-ads-mcp.
  2. Увійдіть у Tera Ads. Запустіть Gemini CLI, виконайте /mcp auth tera-ads, потім увійдіть, виберіть бізнес і визначте, що агентові дозволено.
  3. Перевірте інструменти. Введіть /mcp, щоб побачити стан і інструменти кожного сервера, або виконайте в оболонці gemini extensions list.
  4. Поставте запитання, яке можна перевірити. Спробуйте «Які кампанії 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 поруч

Налаштування Tera Ads у Codex і Gemini CLI за документацією кожного агента та репозиторієм Tera Ads, перевірено 31 жовтня 2026 року.
CodexGemini CLI
Додати серверcodex mcp add tera-ads --url https://teraads.co/mcpgemini 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 як контекст
Документація агентаДокументація Codex MCPРозширення Gemini CLI

Щоб Codex чи інший агент користувався Tera Ads без підказки, репозиторій радить скопіювати вміст GEMINI.md у AGENTS.md або CLAUDE.md вашого проєкту. Інакше називайте Tera Ads у запиті.

Запити, що пасують агентові в терміналі

Агент для коду вміє те, чого не вміє вікно чату: класти відповідь туди, де ви працюєте. Попросіть його зберегти результати у файл, порівняти їх із минулотижневим файлом або відкрити сторінку товару, на яку веде кампанія.

Запити для Codex або Gemini CLI з інструментами 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 оцінює кожну кампанію, що витрачала гроші, за прибутком після звичних повернень вашого магазину, за вашими власними витратами, відносно вашого беззбиткового ROAS; показник прибутку — це оцінка для всього магазину, а не гроші на рахунку. Справжній ROAS після відшкодувань показує, чому ця різниця важлива, а в добірці запитів для аналізу реклами є більше запитань для спроб.

Ліміти Tera Ads Connect коротко: 29 інструментів, скасування протягом 7 днів, обмеження потроєння бюджету та 30 безкоштовних викликів на тиждень
Ліміти Tera Ads Connect коротко: 29 інструментів, скасування протягом 7 днів, обмеження потроєння бюджету та 30 безкоштовних викликів на тиждень

Тримайте зміни агента під контролем

Агентів для коду часто налаштовують редагувати файли без запитів щоразу. Не дозволяйте цій звичці поширитися на рекламні інструменти, де один хибний виклик витрачає реальні гроші. Tera Ads встановлює власні обмеження незалежно від того, що дозволено агентові:

  • Лише читання, спершу питати чи вносити зміни. У режимі «спершу питати» зміна чекає в Tera Ads, доки ви не схвалите її там, а агент не може схвалити її за вас.
  • Нове починає із паузи. Кампанії, групи оголошень, оголошення й копії нічого не витрачають, доки щось їх не ввімкне.
  • Кроки бюджету обмежені. Одна зміна може щонайбільше потроїти бюджет або зменшити його до десятої частини.
  • Денний ліміт. Асистенти можуть вносити щонайбільше 50 змін на день в один бізнес.
  • Немає інструмента видалення. Агент може призупинити, але нічого не може видалити.
  • Скасування протягом 7 днів. Зупинку, увімкнення чи зміну бюджету можна скасувати в Tera Ads протягом 7 днів. Нові кампанії, групи оголошень і оголошення скасувати не можна, але вони починають із паузи.
  • Один бізнес на підключення. Підключення не може читати інший бізнес, навіть якщо він теж ваш.

Якщо результат зміни повертається як outcome_unknown, не просіть агента повторити її. Попросіть спершу перевірити list_recent_changes, щоб та сама зміна не відбулася двічі.

Коли щось не працює

Агент ігнорує Tera Ads. Назвіть його в запиті («використай Tera Ads, щоб...») або скопіюйте 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 на місяць за 3 000 викликів на місяць на трьох рекламних акаунтах і входить у плани 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 через власний схвалений застосунок Meta від Tera Ads. Жодних секретів у ваш конфігураційний файл не потрапляє.

Чи працює налаштування 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 на місяць за 3 000 викликів на місяць. Виклик — це один запит, який агент робить у Tera Ads, і на одне запитання може піти кілька.

Подивіться, що насправді заробляє ваша реклама.

Підключіть магазин і рекламні акаунти. Безкоштовно для одного бізнесу, без картки.

Створити безкоштовний акаунт