MCP-сервер Яндекс API с админ-панелью

Yandex MCP Server

Многопользовательский MCP-сервер для Директа, Метрики, Вебмастера, Аудитории и Wordstat с веб-панелью управления токенами

MCP-серверРоссийский стек

mlenkov/yandex-mcp-serverАвтор:mlenkov

Установка

Ручная установка

uv sync --no-dev && cp .env.example .env && uv run alembic upgrade head && uv run python -m app.main

Локальный запуск на SQLite, перед этим нужно сгенерировать FERNET_KEY и вписать его в .env.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер на FastMCP и FastAPI дает 14 инструментов чтения по пяти API Яндекса: кампании и статистика Директа, счетчики Метрики, хосты Вебмастера, сегменты Аудитории, кампании AdMetrica и частотность Wordstat. К каждому API есть MCP-ресурс с краткой документацией, чтобы агент не выдумывал структуру данных, и три готовых промпта для анализа кампании, оптимизации бюджета и поиска слабых объявлений. Токены Яндекса хранятся в базе (SQLite или MySQL) в зашифрованном виде через Fernet и обновляются автоматически при истечении, привязка пользователя идет через заголовок X-Bifrost-User-Id от прокси. Есть отдельная веб-панель администратора для подключения интеграций и OAuth callback.

Для кого. Для команд, которые разворачивают собственный многопользовательский MCP-шлюз к Яндексу с веб-панелью для клиентов.

Подходит, если

Нужен один сервер сразу для Директа, Метрики, Вебмастера, Аудитории и Wordstat
Планируется несколько пользователей с разными аккаунтами Яндекса и веб-панель для подключения токенов
Хочется, чтобы агент читал документацию API через MCP-ресурсы вместо угадывания

Не подходит, если

Нужен простой однопользовательский сервер: здесь нужна база данных, Fernet-ключ и прокси-заголовок
Нужна запись в Директ или Метрику: реализовано только чтение

Пример запроса к агенту

Покажи статистику кампании 12345 за последние 7 дней и предложи, где урезать бюджет

Ограничения

Проект рассчитан на архитектуру с прокси Bifrost, который прокидывает заголовок X-Bifrost-User-Id, и на отдельную админ-панель для OAuth: без них многопользовательский режим не заработает. Нужен Fernet-ключ и своя база (SQLite для MVP, MySQL для нагрузки) с миграциями Alembic. Реализовано только чтение: кампании, счетчики, хосты, сегменты и статистика, изменить что-либо в Яндексе через этот сервер нельзя.

Как отключить. Остановите контейнеры docker compose down и удалите сервер из настроек MCP клиента.

MCP

Транспорт: http
Авторизация: OAuth

Переменные окружения
Переменные окружения
FERNET_KEY обязательная, секрет	Ключ шифрования токенов в базе данных
YANDEX_CLIENT_ID обязательная	ID OAuth-приложения Яндекса
YANDEX_CLIENT_SECRET обязательная, секрет	Секрет OAuth-приложения Яндекса

Проверка безопасности

Хранит OAuth-токены нескольких пользователей в общей базе, пусть и зашифрованными
Админ-панель дает доступ к добавлению и просмотру интеграций аккаунтов

Коротко о README

README показывает быстрый старт на SQLite и продакшн-деплой в Docker Compose на SQLite или MySQL за сетью Bifrost, структуру админ-панели, пример конфигурации Caddy с проксированием заголовка пользователя, полный список из 14 инструментов, 5 ресурсов документации и 3 промптов с примерами вызовов и структуру проекта app/.

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

Обязательна ли админ-панель?

Она нужна для многопользовательского OAuth и управления интеграциями, для одиночного локального теста можно ограничиться SQLite и .env.

Может ли сервер поставить кампанию на паузу?

Нет, все 14 инструментов только читают данные Директа, Метрики, Вебмастера, Аудитории и AdMetrica.

Скиллы DataLens

DataLens Skills

Официальный

Официальные скиллы DataLens (Яндекс) для Claude Code, Codex и OpenCode: SDK, HTML-отчеты и разбор прав RLS

СкиллСредний рискРоссийский стекБез VPN12

MCP Яндекс Метрики со всеми 108 методами API

Yandex Metrika MCP Server

Выбор редакции

MCP-сервер Яндекс Метрики, порожденный из спеки API: 108 методов, по умолчанию 10 инструментов, прозрачные фильтры и метаданные ответа

MCP-серверСредний рискРоссийский стекБез VPN2

OpenSEO