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

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

MCP-сервер для Яндекс Директа

Облачный MCP-сервер для Яндекс Директа: подключите кабинет в один клик, и Claude, Codex или Cursor получат кампании, отчёты, ставки и минус-фразы.

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

На входе
Кабинет Яндекс Директа (OAuth в один клик) и API-ключ 100CTR с нужными правами
На выходе
Адрес MCP-сервера для ИИ-ассистента: кампании, отчёты, ставки, минус-фразы, объявления
Для чего
Анализировать и вести кампании Директа командами ИИ-ассистенту, не выгружая данные вручную

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

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

Готовый MCP-сервер для Яндекс Директа

MCP (Model Context Protocol) — открытый протокол, через который ИИ-ассистент получает «инструменты»: вызывает API, читает данные и выполняет действия по вашей команде. 100CTR даёт готовый облачный MCP-сервер для Яндекс Директа: ничего не нужно устанавливать и запускать у себя, достаточно подключить кабинет и добавить в ассистента один адрес — https://mcp.100ctr.com/mcp.

После подключения Claude, Codex, Cursor или другой MCP-клиент видит ваши кампании, группы, объявления, ключевые фразы и ставки, строит отчёты по статистике и поисковым запросам, добавляет минус-фразы и комбинаторные объявления. Запросы к Директу идут через официальный API v5 от имени вашего аккаунта, а все изменения сначала можно проверить в пробном режиме.

В тот же сервер встроены инструменты 100CTR: генерация и проверка объявлений, сбор частотности WordStat и прогноз показов Директа. Набор доступных инструментов определяется правами API-ключа — ассистент не увидит того, что вы не разрешили.

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

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

    Откройте раздел «Интеграции и API» в кабинете 100CTR и нажмите «Подключить Яндекс Директ». Яндекс спросит разрешение на доступ к API — токен сохранится автоматически, вставлять его вручную не нужно.

  2. Выберите клиента (для агентств)

    Если аккаунт агентский, 100CTR покажет список рекламодателей. Выберите клиента по умолчанию — его логин будет передаваться в заголовке Client-Login.

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

    В том же разделе создайте ключ и отметьте права: только чтение, отчёты, изменение кампаний, ставки и бюджеты. Полный ключ показывается один раз — сохраните его в менеджере паролей или переменной окружения.

  4. Добавьте сервер в ассистента

    Укажите адрес https://mcp.100ctr.com/mcp и заголовок Authorization: Bearer <ключ>. Готовые команды для Claude Code, Claude Desktop, Codex и Cursor есть в кабинете — их можно скопировать одной кнопкой.

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

    Попросите ассистента показать список кампаний. Это безопасный запрос на чтение: если кампании видны, сервер и права настроены правильно.

Пример

Запрос к ассистенту и что он делает через MCP

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

Покажи кампании с расходом за 7 дней и найди
поисковые запросы без конверсий дороже 300 ₽.
Предложи минус-фразы, но ничего не меняй.

Результат

1. yd_get_campaigns — список кампаний
2. yd_get_campaign_stats — расход и клики за 7 дней
3. yd_get_search_queries — отчёт по запросам
4. Ответ: таблица запросов и список минус-фраз
   (изменения не отправлялись)

Ассистент сам выбирает инструменты по задаче. Чтобы он мог добавить минус-фразы, ключу нужно право «Изменение кампаний»; без него сервер откажет ещё до обращения к Директу.

Что умеет MCP-сервер 100CTR

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

Кроме Директа, к тому же серверу можно подключить VK Рекламу: кампании, группы, объявления, бюджет и статистика.

Права ключа и безопасность

Каждый API-ключ получает свой набор прав (scopes): read, reports, campaign-edit, budget-edit, ads, wordstat. Список инструментов, который видит ассистент, фильтруется по правам ключа, а каждый вызов дополнительно проверяется на сервере. Для анализа и отчётов достаточно ключа только на чтение — так ассистент физически не сможет что-то изменить.

Изменяющие инструменты поддерживают параметр dryRun: сервер проверяет аргументы и права, записывает вызов в журнал и возвращает предпросмотр, но ничего не отправляет в Директ. Хорошая практика — просить ассистента сначала сделать пробный прогон, посмотреть результат и только потом подтверждать изменение.

Токены рекламных кабинетов хранятся в зашифрованном виде и обновляются автоматически. Каждый вызов попадает в журнал: какой инструмент, с каким ключом, успешно или с ошибкой, был ли это пробный режим. Ключ можно отозвать в любой момент — доступ прекращается сразу.

Агентские аккаунты и Client-Login

При подключении 100CTR определяет тип аккаунта. Для агентства загружается список рекламодателей, и вы выбираете клиента по умолчанию. Все запросы к API Директа и к отчётам отправляются с заголовком Client-Login этого клиента. Если нужно поработать с другим клиентом, попросите ассистента указать его логин — каждый инструмент принимает параметр clientLogin, а список логинов возвращает инструмент yd_list_clients.

Если кабинет принадлежит организации в Яндекс ID («паспортная» организация), авторизуйтесь, предварительно переключившись в эту организацию в переключателе аккаунтов Яндекса, и только потом нажимайте «Подключить Яндекс Директ». Иначе токен будет выдан для личного аккаунта, и кампании организации не будут видны.

Какие ассистенты поддерживаются

Сервер работает по транспорту Streamable HTTP и авторизует запросы по заголовку Authorization. Это поддерживают Claude Code, Codex CLI, Cursor и другие клиенты с удалёнными MCP-серверами. Claude Desktop подключается через небольшой мост mcp-remote, который передаёт заголовок с ключом. Пошаговые инструкции — на страницах Claude и Яндекс Директ и Codex и Яндекс Директ.

Сколько это стоит

На бесплатном тарифе ключ работает только на чтение: кампании, отчёты и WordStat, до 100 вызовов MCP в сутки. Изменения кампаний, ставок и генерация объявлений через MCP доступны на Pro (590 ₽ в месяц) — там же 50 генераций и 10 000 фраз WordStat в месяц; на Free — 300 фраз. Тариф «Агентство» добавляет выбор клиента агентского аккаунта в каждом вызове. Баллы API Директа списываются по правилам Яндекса с вашего аккаунта.

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

Нужно ли устанавливать MCP-сервер на свой компьютер?

Нет. Сервер уже работает в облаке по адресу https://mcp.100ctr.com/mcp. В ассистент добавляется только адрес и API-ключ 100CTR.

Нужно ли получать токен Яндекс Директа вручную?

Нет, достаточно нажать «Подключить Яндекс Директ» в разделе «Интеграции и API» и подтвердить доступ на странице Яндекса. Ручная вставка токена оставлена как запасной вариант.

Может ли ассистент случайно что-то сломать в кампаниях?

Только если вы дали ключу права на изменения. Для анализа создайте ключ с правами «Чтение» и «Отчёты». Для изменений просите сначала пробный прогон с dryRun — он ничего не отправляет в Директ.

Как работать с несколькими клиентами агентства?

Выберите клиента по умолчанию в кабинете 100CTR. Для разовых запросов к другому клиенту ассистент передаёт его логин в параметре clientLogin; список логинов возвращает инструмент yd_list_clients.

Кампании не видны после подключения. Что делать?

Проверьте, под каким аккаунтом вы авторизовались в Яндексе. Для организации в Яндекс ID переключитесь в неё и подключите кабинет заново. Для агентского аккаунта выберите клиента.

Сколько ключей можно создать?

До 5 активных ключей на организацию. Удобно выдавать отдельный ключ каждому ассистенту или компьютеру, чтобы при необходимости отозвать только его.

Видит ли 100CTR мои данные из Директа?

Сервер передаёт запросы ассистента в API Директа и возвращает ответ. В журнал записываются только служебные данные вызова: инструмент, время, результат и короткий фрагмент запроса.

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

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

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

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