Перейти к содержимому
ИИ для рекламы

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, поэтому агент не принимает её за продажи. О других серверах, которые можно подключить вместо этого, читайте в материале о вариантах MCP для Meta Ads.

Одно замечание о Gemini CLI: в его документации есть уведомление, что для пользователей бесплатного уровня и Google One Gemini CLI заменён на Antigravity CLI с 18 июня 2026 года (документация Gemini CLI по MCP). Шаги ниже следуют 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. Задайте вопрос, который можно проверить. Попробуйте «Use Tera Ads to list my active Meta campaigns with yesterday's spend» и сравните ответ с 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. Задайте вопрос, который можно проверить. Попробуйте «Which Meta campaigns spent the most this week?» и сравните ответ с 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. Назовите его в запросе («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 в месяц за 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, и на один вопрос может уйти несколько.

Узнайте, сколько на самом деле зарабатывает ваша реклама.

Подключите магазин и рекламные аккаунты. Бесплатно для одного бизнеса, карта не нужна.

Создать бесплатный аккаунт