MCP server for Yandex Direct API v5 — campaigns, ads, keywords, bids, audiences
Copy the AI prompt to install this server into Claude Code, Cursor, or another agent — or use 1-click editor setup below.
We haven't yet run this listing's install command through our automated sandbox check. This isn't a red flag — we're steadily working through the catalog.
💡 Paste the JSON block into your client's configuration file under mcpServers, then restart the application.
MCP-сервер, CLI-утилита и библиотека Pydantic-моделей для Yandex Direct API v5.
Все данные остаются на вашем компьютере — токен никуда не передаётся.
Сервер использует паттерн search + execute — вместо 79 отдельных инструментов предоставляет 2:
| Инструмент | Описание |
|---|---|
yd_search | Поиск действий по описанию на естественном языке |
yd_execute | Выполнение действия по ID |
| Домен | Кол-во | Описание |
|---|---|---|
campaigns | 8 | Кампании: создание, управление, архивация |
adgroups | 4 | Группы объявлений |
ads | 9 | Объявления: создание, управление, модерация |
keywords | 6 | Ключевые слова |
bidding | 7 | Ставки и корректировки ставок |
assets | 11 | Быстрые ссылки, изображения, видео, расширения |
audience | 10 | Аудитории и ретаргетинг |
negkeywords | 4 | Общие списки минус-слов |
feeds | 4 | Фиды для динамических объявлений |
creatives | 2 | Креативы для медийных объявлений |
research | 2 | Исследование ключевых слов |
leads | 1 | Лиды из форм лидогенерации |
changes | 3 | Отслеживание изменений |
account | 6 | Аккаунт, справочники, клиенты агентства |
turbopages | 1 | Турбо-страницы |
reports | 1 | Отчёты (TSV/CSV) |
Способ 1: через uvx (не требует установки пакета)
Требуется uv — если не установлен:
Способ 2: через pip
Для удаления:
Добавьте в конфигурационный файл:
| Клиент | ОС | Путь к файлу |
|---|---|---|
| Claude Code | все | ~/.claude/settings.json (секция mcpServers) |
| Claude Desktop | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop | Windows | %APPDATA%\Claude\claude_desktop_config.json |
| Claude Desktop | Linux | ~/.config/Claude/claude_desktop_config.json |
Через uvx:
Через pip (после pip install mcp-server-yandex-direct):
Подключает сервер только на время одной сессии Claude, не сохраняя в настройки. Токен хранится в отдельном .env.mcp файле, а не в конфиге Claude.
Из JSON-строки:
Из файла:
Пример ~/mcp-servers.json:
Пример ~/.env.mcp:
Попросите Claude: «Покажи список кампаний» — он вызовет yd_search, получит схему campaigns-get, затем yd_execute.
Claude автоматически использует yd_search для поиска нужного действия, затем yd_execute для его выполнения:
yd_search("кампании") → yd_execute("campaigns-get", ...)yd_search("остановить кампании") → yd_execute("campaigns-suspend", ...)yd_search("объявления") → yd_execute("ads-get", ...)yd_search("ключевые слова добавить") → yd_execute("keywords-add", ...)yd_search("справочники") → yd_execute("dictionaries-get", ...)yd_search("отчёт") → yd_execute("reports-get", ...)Переменная окружения YD_TOKEN должна быть установлена:
Или через файл:
Формат файла — KEY=VALUE, по одной переменной на строку, #-комментарии.
Без аргументов запускается MCP-сервер, с командой — CLI. Все команды выводят JSON.
Пакет содержит типизированные Pydantic-модели всех объектов API. Модели можно использовать в своих Python-программах для валидации данных и автодополнения в IDE.
Все модели используют extra="allow" для forward compatibility — неизвестные поля API не вызывают ошибок.
Полный список моделей: models/
| Переменная | Обязательная | По умолчанию | Описание |
|---|---|---|---|
YD_TOKEN | да | — | OAuth-токен Yandex Direct API |
YD_CLIENT_LOGIN | нет | — | Логин клиента для агентских аккаунтов |
YD_LANG | нет | — | Язык ответов: ru, en, uk |
YD_TIMEOUT | нет | 30 | Таймаут HTTP-запросов к API (секунды) |
YD_FILE_TIMEOUT | нет | 120 | Таймаут отчётов Reports API (секунды) |
MIT
No reviews yet — be the first to share how this listing worked for you.
Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.
[](https://allmcps.com/mcp/yandex-direct-2)<a href="https://allmcps.com/mcp/yandex-direct-2"><img src="https://allmcps.com/api/badge/yandex-direct-2?style=directory" alt="Yandex Direct on AllMCPs" /></a>