Яндекс Директ·Yurich-ru
Яндекс Директ MCP — подключение и инструкция
Yandex Ads MCP помогает агенту работать с рекламными кампаниями Яндекс Директа, отчётами и связанными сервисами аналитики.
Что умеет этот сервер
Yandex Ads MCP помогает агенту работать с рекламными кампаниями Яндекс Директа, отчётами и связанными сервисами аналитики.
Проект Yurich-ru объединяет Директ, Метрику, Аудитории и дополнительные сценарии.
Начни с чтения кампаний и отчёта за конкретный период.
Задача для знакомства
Через Yandex Ads MCP прочитай кампании и подготовь отчёт за указанный период. Покажи IDs и допущения; ставки, бюджеты и объявления не меняй.
Уточнить результат
Сверь кампанию, аккаунт, даты и показатели с интерфейсом Директа. Отдели расход, конверсии и атрибуцию; при ошибке API проверь права и лимиты, а не повторяй изменение ставок.
Как подключить
Выберите подходящий способПодключить Яндекс Директ MCP
Склонируй репозиторий, создай venv и установи requirements.txt. Скопируй .env.example в локальный .env и заполни нужные параметры. В MCP-клиенте задай полный путь к Python из venv и server.py.
Что понадобится
- Python с venv, зависимости из requirements.txt и OAuth-доступы Яндекса. Для отдельных сценариев README использует YC_FOLDER_ID; его назначение не заменяет OAuth-права Директа.
- 01
Подготовь окружение
Python с venv, зависимости из requirements.txt и OAuth-доступы Яндекса. Для отдельных сценариев README использует YC_FOLDER_ID; его назначение не заменяет OAuth-права Директа.
- 02
Установи и настрой
Склонируй репозиторий, создай venv и установи requirements.txt. Скопируй .env.example в локальный .env и заполни нужные параметры. В MCP-клиенте задай полный путь к Python из venv и server.py.
- 03
Открой новую сессию
Убедись, что клиент видит инструменты именно этого сервера, и выполни первый небольшой сценарий.
Первый запрос — пример для чата агента
Через Yandex Ads MCP прочитай кампании и подготовь отчёт за указанный период. Покажи IDs и допущения; ставки, бюджеты и объявления не меняй.Как проверить
Сверь кампанию, аккаунт, даты и показатели с интерфейсом Директа. Отдели расход, конверсии и атрибуцию; при ошибке API проверь права и лимиты, а не повторяй изменение ставок.
Подставь собственные пути, адреса и доступы только в локальные настройки. Команды запуска, MCP-конфигурация и текст первого запроса вводятся в разных местах; их назначение указано над примером.
README и установка автораЧто умеет Яндекс Директ
Yandex Ads MCP помогает агенту работать с рекламными кампаниями Яндекс Директа, отчётами и связанными сервисами аналитики.
Проект Yurich-ru объединяет Директ, Метрику, Аудитории и дополнительные сценарии. Это community-сервер на Python; права на каждый сервис и набор доступных методов нужно проверять отдельно.
Что подготовить перед подключением
Python с venv, зависимости из requirements.txt и OAuth-доступы Яндекса. Для отдельных сценариев README использует YC_FOLDER_ID; его назначение не заменяет OAuth-права Директа.
Как установить и подключить
Склонируй репозиторий, создай venv и установи requirements.txt. Скопируй .env.example в локальный .env и заполни нужные параметры. В MCP-клиенте задай полный путь к Python из venv и server.py.
Добавь выбранную запись в существующую конфигурацию клиента, сохранив остальные серверы. Формат и расположение настроек зависят от клиента: JSON-пример для Claude Desktop не нужно целиком вставлять в TOML-файл другого приложения. После изменения перечитай конфигурацию или открой новую сессию.
Как пользоваться: первый сценарий
Начни с чтения кампаний и отчёта за конкретный период. Укажи клиентский логин и валюту/условия отчёта, если это требуется API. Рекомендации по ставкам и объявлениям сначала выводи планом.
Как проверить результат и решить проблемы
Сверь кампанию, аккаунт, даты и показатели с интерфейсом Директа. Отдели расход, конверсии и атрибуцию; при ошибке API проверь права и лимиты, а не повторяй изменение ставок.
Если инструмент не появился, проверь запуск процесса или доступность endpoint, журнал клиента и права доступа. Если соединение есть, но операция не выполняется, сверяй входные параметры и ограничения сервиса; повторять изменяющий запрос без проверки результата не стоит.
Ограничения
Изменения рекламы могут влиять на расход бюджета. Наличие функций Метрики или Wordstat в наборе не означает, что все сервисы доступны одному токену.
Исходники и документация
Репозиторий: Yurich-ru/yandex-ads-mcp. В README доступны актуальные варианты установки, требования и примеры настройки. Перед обновлением сохрани рабочую конфигурацию и проверь изменения версии.
Другие подключения — в каталоге MCP-серверов Нейролюба.