mcp-server-yandex-direct

MCP-сервер, CLI-утилита и библиотека Pydantic-моделей для Yandex Direct API v5.

• MCP-сервер — интеграция с Claude Code, Claude Desktop и другими MCP-клиентами
• CLI-утилита — работа с API из терминала, скрипты и автоматизация
• Pydantic-модели — типизированные модели API для использования в своих Python-программах

Все данные остаются на вашем компьютере — токен никуда не передаётся.

Оглавление

• Архитектура
• Доступные действия
• MCP-сервер
  • Установка
  • Подключение к Claude Code
  • Подключение к Claude Desktop
  • Подключение через --mcp-config
  • Примеры
• CLI-утилита
  • Установка
  • Использование
  • Примеры команд
• Pydantic-модели
  • Установка
  • Использование в своих программах
• Переменные окружения
• Разработка
• Лицензия

Архитектура

Сервер использует паттерн search + execute — вместо 79 отдельных инструментов предоставляет 2:

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

LLM: yd_search("остановить кампании")
→ [{"id": "campaigns-suspend", "params_schema": {"SelectionCriteria": {...}, ...}, ...}]

LLM: yd_execute("campaigns-suspend", '{"SelectionCriteria": {"Ids": [12345]}}')
→ {"SuspendResults": [...]}

Доступные действия (79)

MCP-сервер

Установка

Шаг 1. Получить OAuth-токен

1. Войдите в Яндекс Директ
2. Перейдите в Настройки → API
3. Создайте OAuth-токен с нужными правами
4. Скопируйте токен

Шаг 2. Подключить MCP-сервер

Подключение к Claude Code

Способ 1: через uvx (не требует установки пакета)

Требуется uv — если не установлен:

curl -LsSf https://astral.sh/uv/install.sh | sh

claude mcp add yandex-direct \
  -e YD_TOKEN=ваш_токен \
  -- uvx mcp-server-yandex-direct

Способ 2: через pip

pip install mcp-server-yandex-direct

claude mcp add yandex-direct \
  -e YD_TOKEN=ваш_токен \
  -- python -m mcp_server_yandex_direct

Для удаления:

claude mcp remove yandex-direct

Подключение к Claude

... View full README on GitHub