Перейти к содержимому
100CTR

Автоматизация

Как подключить Codex к Яндекс Директу

Подключите OpenAI Codex к Яндекс Директу: MCP-сервер 100CTR, блок для ~/.codex/config.toml, ключ в переменной окружения и права доступа.

Работает в кабинете 100CTRЕсть бесплатный тариф

На входе
Аккаунт 100CTR, подключённый кабинет Директа, Codex CLI или расширение Codex
На выходе
Codex читает кампании и отчёты Директа и вносит изменения в рамках прав ключа
Для чего
Автоматизировать отчёты и рутинные правки Директа с помощью Codex

Работает в кабинете 100CTR

Инструмент использует сервер 100CTR, поэтому запускается из личного кабинета. Регистрация бесплатная и занимает минуту — нужен только e-mail.

Как подключить Codex к Яндекс Директу

Codex — агент OpenAI для терминала и редактора кода — подключает внешние инструменты через MCP-серверы. Добавьте в него облачный MCP-сервер 100CTR, и Codex получит доступ к API Яндекс Директа: кампании, группы, объявления, ключевые фразы, ставки, статистика и поисковые запросы. Устанавливать сервер не нужно — он работает по адресу https://mcp.100ctr.com/mcp.

Настройка занимает несколько минут: подключить кабинет Директа в 100CTR, создать API-ключ, положить его в переменную окружения и добавить четыре строки в ~/.codex/config.toml. Ключ при этом не хранится в конфигурации — Codex берёт его из окружения при запуске.

Как пользоваться

  1. Подключите Яндекс Директ в 100CTR

    В разделе «Интеграции и API» нажмите «Подключить Яндекс Директ» и подтвердите доступ. Агентству — выбрать клиента; для организации в Яндекс ID — сначала переключиться в неё.

  2. Создайте API-ключ

    Выберите права под задачу: «Чтение» и «Отчёты» для анализа, «Изменение кампаний» и «Бюджеты и ставки» — для правок. Скопируйте ключ, он показывается один раз.

  3. Сохраните ключ в переменной окружения

    macOS и Linux: добавьте export CTR100_API_KEY="100ctr_..." в ~/.zshrc или ~/.bashrc. Windows: setx CTR100_API_KEY "100ctr_..." и перезапустите терминал.

  4. Добавьте сервер в config.toml

    Откройте ~/.codex/config.toml (в Windows — %USERPROFILE%\.codex\config.toml) и добавьте блок [mcp_servers."100ctr"] с адресом и bearer_token_env_var — пример ниже.

  5. Проверьте подключение

    Запустите Codex и выполните /mcp: сервер 100ctr должен быть в списке с инструментами. Попросите «Покажи кампании Директа» — это безопасный запрос на чтение.

Пример

Блок для ~/.codex/config.toml

Исходные данные

Переменная окружения:
CTR100_API_KEY=100ctr_xxxxxxxx…

Результат

[mcp_servers."100ctr"]
url = "https://mcp.100ctr.com/mcp"
bearer_token_env_var = "CTR100_API_KEY"

Codex подключается к удалённому серверу по Streamable HTTP и сам подставляет заголовок Authorization: Bearer из переменной CTR100_API_KEY. Тот же файл использует расширение Codex для редактора, поэтому сервер появится и там.

Зачем Codex доступ к Директу

Codex хорош в задачах, где нужно пройтись по данным и что-то посчитать или собрать: выгрузить статистику за период и сравнить кампании, разобрать отчёт по поисковым запросам и подготовить минус-фразы, сверить ставки с целевой ценой клика, собрать комбинаторные объявления для новых групп и проверить их на ограничения Директа. Результат он может сохранить в файлы проекта — таблицы, отчёты, скрипты.

  • Чтение: кампании, группы, объявления, фразы, ставки, клиенты агентства.
  • Отчёты: статистика кампаний и поисковые запросы, проверка изменений.
  • Изменения: остановка и запуск кампаний, минус-фразы, комбинаторные объявления, ставки и бюджеты — по правам ключа.
  • Инструменты 100CTR: проверка и генерация объявлений, частотность WordStat, прогноз показов.

Безопасность: права и пробный режим

Список инструментов, который получает Codex, зависит от прав API-ключа, и каждый вызов повторно проверяется на сервере. Для исследования данных создайте ключ без прав на изменение — тогда Codex просто не увидит инструментов, способных что-то поменять в кабинете.

Изменяющие инструменты принимают dryRun: true: сервер проверяет запрос и возвращает предпросмотр, не отправляя его в Директ. Попросите Codex сначала выполнить пробный прогон и показать, что будет изменено. Все вызовы попадают в журнал 100CTR — их видно в разделе «Интеграции и API».

Агентства: работа с несколькими клиентами

Для агентского аккаунта в 100CTR выбирается клиент по умолчанию — его логин передаётся в заголовке Client-Login. Для другого клиента Codex передаёт параметр clientLogin в вызове инструмента; список логинов возвращает yd_list_clients. Так можно, например, попросить Codex собрать сводку расходов по всем клиентам агентства.

Примеры задач для Codex

  • «Выгрузи статистику всех кампаний за прошлую неделю и сохрани в reports/week.csv с расходом, кликами и CPC».
  • «Найди в отчёте по поисковым запросам за 14 дней запросы без конверсий дороже 500 ₽ и подготовь список минус-фраз — пока без применения».
  • «Сравни текущие ставки по фразам кампании 12345 с целевой ценой клика 40 ₽ и покажи, где ставка выше в два раза».
  • «Собери по три комбинаторных объявления для новых групп из файла groups.md, проверь их на ограничения Директа и создай с dryRun».

Чем конкретнее задача — период, кампания, порог, формат файла, — тем меньше вызовов API сделает Codex и тем меньше баллов API Директа уйдёт на выполнение.

Типичные ошибки настройки

  • 401 Unauthorized — переменная окружения не видна Codex: проверьте echo $CTR100_API_KEY в том же терминале, где запускаете Codex.
  • Сервер есть, инструментов Директа нет — не подключён кабинет в 100CTR или у ключа нет права «Чтение».
  • Ключ в конфигурации открытым текстом — используйте bearer_token_env_var, чтобы ключ не попал в резервные копии и репозитории.

Частые вопросы

Нужен ли платный тариф 100CTR?

Для чтения — нет: на бесплатном тарифе ключ видит кампании, отчёты и WordStat, до 100 вызовов MCP в сутки. Изменения кампаний и ставок, а также генерация объявлений через MCP доступны на Pro. WordStat расходует месячный лимит фраз тарифа.

Можно ли указать ключ прямо в config.toml?

Можно задать заголовок через http_headers, но надёжнее bearer_token_env_var: ключ остаётся в окружении и не хранится в файле.

Codex может изменить ставки без спроса?

Только если у ключа есть право «Бюджеты и ставки». Используйте отдельный ключ для изменений и просите сначала пробный прогон с dryRun.

Работает ли это в расширении Codex для VS Code?

Да, расширение читает тот же ~/.codex/config.toml.

Как подключить VK Рекламу?

Подключите кабинет VK Рекламы в 100CTR — инструменты VK появятся на том же MCP-сервере без изменений в config.toml.

Как отозвать доступ?

Отзовите API-ключ в разделе «Интеграции и API». Codex сразу перестанет получать ответы от сервера.

Похожие инструменты

Соберите всю кампанию за один проход

В проекте 100CTR фразы группируются автоматически, в каждую группу пишутся объявления с подстановкой ключа, а результат выгружается файлом для Директ Коммандера.

Как это работает