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

Как подключить рекламный кабинет к ИИ-агенту: выпустить токен, собрать адрес, добавить его в агентную среду и проверить доступ чтением.

Подключение к Вордстату — частотность запросов — описано отдельно: MCP для Яндекс Вордстата.

Задача

Агент должен работать в вашем кабинете Яндекс Директа: видеть настоящие кампании, снимать по ним отчёты и вносить изменения — а не рассуждать о рекламе со стороны. Связь между агентом и кабинетом даёт MCP: так называется подключение агента к рекламной системе. Эта статья доводит до момента, когда агент по просьбе показывает ваши кампании с их статусами.

Что понадобится

• Агентная среда — программа, в которой работает агент. Она должна поддерживать подключение MCP по адресу.
• Аккаунт click.ru, в котором подключён рекламный аккаунт Яндекс Директа. Кабинет, созданный напрямую в Яндексе, минуя click.ru, подключается тоже — для него своя форма адреса, о ней в разделе «Какой адрес выбрать».
• Доступ к профилю этого аккаунта в click.ru. В профиле выпускается API-токен, заранее готовить его не нужно.

Устанавливать на компьютер ничего не требуется: в агентную среду добавляется только адрес, сам сервер подключения работает на стороне click.ru.

Какой адрес выбрать

Актуальных форм три. Различаются они тем, к скольким кабинетам дотянется агент и через кого идёт доступ. Старые формы, где логин Директа стоит перед токеном, сервер принимает для совместимости — новые подключения на них не собирают.

https://direct-mcp.aihub.click.ru/c/<токен click.ru>
https://direct-mcp.aihub.click.ru/c/<токен click.ru>/<кабинет>
https://direct-mcp.aihub.click.ru/y/<OAuth-токен Яндекса>

Все кабинеты сразу — /c/<токен>. Адрес без кабинета открывает все кабинеты, доступные токену: если кабинет один, агент работает в нём; если их несколько, агент перечислит их и спросит, в каком работать. Дальше переключение идёт репликой в диалоге: «перейди в кабинет такой-то». Адрес при этом не меняется, и настройки среды править не нужно.

Один кабинет — /c/<токен>/<кабинет>. Кабинет задаётся логином Директа, названием кабинета или его ID в click.ru; где взять логин — в шаге 2. Спецсимволы в этом сегменте кодируются: @ записывается как %40, пробел — как %20.

Кабинет напрямую в Яндексе — /y/<OAuth-токен Яндекса>. Форма для кабинета, который заведён в Яндексе, минуя click.ru: доступ идёт по OAuth-токену Яндекса, токен click.ru в ней не участвует.

Хвост /mcp в конце адреса допускается в любой форме — если среда подставляет его сама, исправлять ничего не нужно.

Адрес подключения равносилен паролю. Токен зашит прямо в строку, поэтому любой, у кого есть адрес, подключится без пароля и подтверждений — и не только к Директу: тот же токен открывает Вордстат и кабинеты VK Рекламы этого аккаунта. Адрес не пересылают в переписке и не публикуют. Если он всё-таки ушёл — нажмите в профиле click.ru «пересоздать»: новый токен заменит прежний, и старый адрес перестанет работать сразу. Остальные подключения придётся собрать заново — с новым токеном.

Что безопаснее. Закрепить кабинет в адресе: тогда агент по умолчанию работает в нём и не ошибётся кабинетом по невнимательности. Запретом это не является — вызов можно адресовать любому кабинету, доступному тому же токену. Нужен именно запрет: выпускайте токен в том аккаунте click.ru, где чужих кабинетов нет. Открытый доступ ко всем кабинетам удобнее в активной работе — переключение идёт репликой, без правки настроек. Цена удобства — внимание: следить, в каком кабинете сейчас работает агент, приходится специалисту.

Шаги

Шаг 1. Получите API-токен click.ru

Откройте профиль click.ru и найдите поле «API Token». Если в поле уже есть токен, используйте его: токен один на все подключения через click.ru из этого аккаунта — к Директу, Вордстату и VK Рекламе. Новый токен заменяет прежний, и все подключения на старом перестают работать, их приходится собирать заново. Поэтому «пересоздать» нажимают только при утечке. Если поле пустое, нажмите «Создать».

Токен выпускайте в том аккаунте, где подключён рекламный аккаунт Директа. Токен из другого аккаунта click.ru выглядит рабочим, но нужных кабинетов не откроет.

Результат: в поле «API Token» есть строка — её можно скопировать.

Шаг 2. Найдите логин рекламного аккаунта Директа

Шаг нужен, только если вы закрепите в адресе один кабинет. Он виден в том же аккаунте click.ru, в списке рекламных аккаунтов. Рекламного аккаунта в списке нет — сначала создайте его в click.ru или перенесите существующий: Яндекс Директ. Создание аккаунта, Бесшовный перенос аккаунтов Яндекс Директ.

Результат: логин виден в списке рекламных аккаунтов и скопирован.

Шаг 3. Соберите адрес подключения

Базовая форма выглядит так:

https://direct-mcp.aihub.click.ru/c/<токен click.ru>

Вместо <токен click.ru> подставьте строку из шага 1, угловые скобки уберите. Такой адрес открывает все кабинеты Директа, доступные этому токену — форму выбирайте по разделу выше. Для одного кабинета и для кабинета, созданного напрямую в Яндексе, есть другие формы — они разобраны выше.

Результат: адрес собран одной строкой, без пробелов и переносов.

Шаг 4. Добавьте подключение в агентную среду

Добавьте собранный адрес в среду как MCP. Где именно это делается, зависит от среды.

Результат: подключение появилось в списке подключений среды.

ClaudeCodex

В приложении Claude: Настройки → Connectors → Add custom connector. Имя любое, в поле адреса вставьте собранный адрес и нажмите Continue, затем Add. Способ аутентификации оставьте тем, который приложение определит само.

В приложении ChatGPT откройте Codex, затем настройки → Плагины → Добавить → Добавить сервер MCP. Тип — «Потоковая передача HTTP», имя любое, в поле URL вставьте собранный адрес, остальные поля оставьте пустыми и нажмите «Сохранить».

Шаг 5. Перезапустите агентную среду

Закройте среду и откройте заново. Пока сессия не перезапущена, новое подключение может не появиться в списке инструментов.

Результат: подключение отмечено как доступное, у него виден набор инструментов Директа.

Как убедиться, что получилось

Первые команды берите на чтение: они ничего не меняют в кабинете и не тратят бюджет.

• Покажи, к каким кабинетам Директа у меня есть доступ. — агент перечислит кабинеты, доступные токену. Список приходит целиком, даже если в адресе закреплён один кабинет.
• Покажи мои кампании в Директе со статусами. — придёт список кампаний с названиями и статусами. Сверьте две-три строки с кабинетом: названия и статусы должны совпасть.
• Собери отчёт по кампании за последние 7 дней. — придут показы, клики, расход и CTR.

Ответ пришёл и сошёлся с кабинетом — подключение работает, можно переходить к задачам.

Что агент умеет через это подключение

• Создавать кампании — для Поиска, РСЯ и ЕПК, со стратегией показов. Внутри кампании создаются группы, объявления, ключевые фразы, быстрые ссылки и уточнения, а к кампании привязываются готовые цели Яндекс Метрики.
• Менять созданное в кабинете — править объявления и ключевые фразы, пересобирать наборы быстрых ссылок и уточнений (набор заменяется новым целиком), добавлять изображения, останавливать и возобновлять показы, отправлять объявления на модерацию.
• Управлять ставками — ставки по фразам, данные аукциона и корректировки. Прогноза цены клика по произвольным фразам на этом маршруте нет: он живёт в старом API Яндекса, которому нужен OAuth-токен Яндекса, и доступен только форме /y/.
• Снимать отчёты — показы, клики, расход, CTR и поисковые запросы.

Чего подключение не делает

• Само ничего не начинает. Инструмент срабатывает, только когда агент его вызвал, а агента ведёт специалист.
• Встроенного подтверждения у MCP нет. Вызов на изменение уходит в кабинет сразу: подключение не переспрашивает. Созданная кампания при этом остаётся черновиком и показы сама не начинает — включает их человек. Паузу перед изменением держат двое: агентная среда, если в ней включён запрос разрешения на вызов инструмента (проверьте эту настройку в своей), и сам специалист — попросите агента показывать запрос до отправки.
• Не даёт больше, чем отдаёт API Яндекс Директа. Пакетные стратегии, промоакции и видеодополнения в объявлениях создаются только в интерфейсе Директа.
• Частотность фраз не собирает. Спрос по фразам живёт в Яндекс Вордстате: это отдельное подключение и отдельная статья. MCP для Яндекс Вордстата.

Работа без скилла

Подключение открывает агенту кабинет и объясняет, какие параметры есть у каждого инструмента. Что именно делать в кабинете, оно не подсказывает. Готовый маршрут работы даёт скилл — папка с инструкциями, по которым агент выполняет работу маркетолога. Для Директа это скилл «Директолог». Вести агента можно и своими инструкциями. А для точечных задач — снять статистику, поправить ставки, проверить статусы — хватает одного подключения.

Если не получилось

Агент не видит инструменты Директа. Чаще всего дело в адресе: при подстановке токена теряется символ или остаются угловые скобки. Сверьте адрес целиком, исправьте и перезапустите агентную среду — без перезапуска правка не подхватится.

Ошибка доступа. Токен пересоздан после сборки адреса или выпущен не в том аккаунте click.ru. Откройте профиль того аккаунта, где подключён рекламный аккаунт Директа, возьмите действующий токен и пересоберите адрес. Если токен пришлось пересоздать, остальные подключения на нём тоже соберите заново.

Агент отвечает, что закончились баллы. Ничего не сломано и ничего не потеряно: это дневной лимит баллов API Яндекс Директа. Яндекс считает его отдельно для каждого рекламного аккаунта, скользящим окном в 24 часа, и снижает при низкой активности кампаний — когда расхода, показов и кликов мало, частые запросы считаются нерациональной нагрузкой. Дождитесь восстановления лимита — работа продолжится с того же места.

Агент работает не в том кабинете. Так бывает при адресе без кабинета, когда токену доступно несколько аккаунтов. Назовите нужный кабинет репликой — «перейди в кабинет такой-то» — или закрепите его в адресе формой /c/<токен>/<кабинет>.

Ничего из этого не помогло. Опишите ситуацию в Telegram-сообществе. Приложите текст ошибки и адрес подключения без токена: адрес целиком равносилен паролю.

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

Нужно ли уметь программировать?

Нет. Подключение — это адрес в настройках агентной среды, дальше работа идёт обычными словами в диалоге. Какой инструмент вызвать и с какими параметрами, агент подбирает сам; от специалиста нужны рекламные решения. Начните с команд на чтение из раздела «Как убедиться, что получилось»: по ответу сразу видно, что связь есть.

Придётся ли давать агенту пароль от Яндекса?

Нет. Через click.ru доступ идёт по API-токену click.ru, а для кабинета, заведённого напрямую в Яндексе, — по OAuth-токену Яндекса. Пароль от аккаунта не участвует ни в одной форме адреса. Закрыть агенту доступ тоже можно без смены пароля: токен пересоздаётся в профиле click.ru.