io.github.askadsPublished by GitHub account askadsv1.5.5Updated Nov 3, 2026
MCP server for Yandex Metrica API: list counters, goals and pull web-analytics statistics.
Local MCP server for Yandex Metrica that lets an assistant list counters and goals and pull website traffic, source and conversion reports.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
[npm] [CI] [Glama] [License: MIT]
Яндекс Метрика MCP подключает AI-приложение к веб-аналитике сайта. Спросите на естественном языке, откуда приходят посетители, как меняется конверсия или где растёт доля отказов — ассистент возьмёт данные из вашего счётчика и объяснит результат. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.
Попробуйте первым сообщением:
Сколько визитов, пользователей и отказов было у моего сайта за последнюю неделю?
Подключить сервер · Посмотреть сценарии · Открыть техническую документацию
Вы: Подключи Яндекс Метрику.
Ассистент: Даёт ссылку на вход в Яндекс. Откройте её под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердите доступ и пришлите показанный код.
Вы: Отправляет код из страницы Яндекса.
Ассистент: Подключает Метрику, проверяет, видны ли счётчики, и сообщает результат. Перезапускать приложение не нужно.
Вы: За последние 30 дней покажи источники трафика и конверсию по цели «Оформление заказа».
Ассистент: Находит цель, строит отчёт по источникам и показывает визиты, достижения цели и конверсию. Если Метрика применила выборку, отмечает, что цифры приблизительные.
Нужен Node.js 20 или новее. Сервер запускается через npx, поэтому отдельно устанавливать пакет не требуется.
Через интерфейс приложения:
npx -y mcp-yandex-metrica@latest.Через командную строку:
Проверьте подключение:
Затем в чате Codex попросите: «Подключи Яндекс Метрику».
Проверьте сервер командой:
Затем начните диалог с просьбы подключить Метрику.
Откройте Settings → Developer → Edit Config и добавьте сервер в claude_desktop_config.json:
После сохранения откройте новый диалог и попросите подключить Метрику.
Для всех проектов создайте ~/.cursor/mcp.json; только для текущего проекта — .cursor/mcp.json:
В чате Cursor сервер появится среди доступных инструментов. Попросите подключить Метрику и пройдите вход через Яндекс.
Откройте палитру команд и выполните MCP: Open User Configuration. Добавьте в mcp.json:
Проверьте запуск командой MCP: List Servers, затем откройте чат и попросите подключить Метрику.
Сервер работает с тремя привычными сущностями:
Обычно ассистент сначала находит доступный счётчик, затем — при необходимости — цель, и только после этого строит отчёт. В ответе Метрики есть итог по всем строкам, размер выдачи и признак выборки.
Сервер помечает произвольную запись как потенциально разрушительное действие. Как именно AI-приложение запрашивает подтверждение, зависит от самого приложения; перед таким запросом проверьте путь, метод и данные.
Для обычного использования токен заранее не нужен:
Сервер использует PKCE: код из чата сам по себе нельзя обменять на токен. Полученный токен хранится локально в ~/.config/mcp-yandex-metrica/credentials.json с правами только для владельца. При сохранённом refresh-токене доступ продлевается автоматически.
Для CI и нестандартных установок доступна настройка через переменные окружения:
Если используете собственное OAuth-приложение, запросите в нём право «Получение статистики, чтение параметров своих и доверенных счётчиков» (metrika:read).
По умолчанию сервер отправляет анонимную техническую телеметрию: случайный идентификатор установки, имя события или инструмента, версию сервера, версию Node.js, ОС и сведения о подключившемся AI-клиенте. При вызове инструмента сервер также отправляет его исход, а при ошибке - фрагмент её текста: код и сообщение, в которых e-mail, адреса, токены, числа от 4 цифр и текст в кавычках заменены на «#». Если в тексте ошибки есть значение из запроса, оно тоже может попасть во фрагмент. В телеметрию не попадают токен, данные счётчиков, аргументы инструментов, ваши сообщения и значения переменных окружения.
Чтобы отключить телеметрию для MCP-серверов Ask Ads, задайте переменную окружения:
sampled и sample_share; для более точного расчёта сузьте период или используйте accuracy: "full"._truncated.GET — при сетевой ошибке, 429 и 5xx; POST и DELETE — только при 429, чтобы не повторить изменяющее действие. Задержка учитывает Retry-After и не превышает 30 секунд.POST и DELETE через произвольный запрос меняют реальные объекты.Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.
Source: README.md at commit 8c887d3
Статус подключения к Метрике
Показывает, подключена ли Яндекс Метрика: есть ли токен, откуда он взят (переменная окружения YANDEX_METRIKA_TOKEN или сохранённый вход), когда истекает и где лежит файл с сохранёнными данными. Ничего не отправляет в сеть и не показывает сам токен. Вызовите это, если инструменты Метрики отвечают, что подключение не настроено.
Takes no parameters.
Начать подключение Метрики
Первый шаг подключения Яндекс Метрики без правки конфигурации и без перезапуска клиента. Возвращает ссылку на страницу Яндекс OAuth. Покажите ссылку пользователю целиком и попросите: открыть её в браузере под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердить доступ и прислать показанный код подтверждения. Полученный код передайте в finish_login. Код действует 10 минут. Сам по себе код бесполезен для постороннего: обменять его может только этот сервер.
Takes no parameters.
Завершить подключение Метрики
Второй шаг подключения: обменивает код подтверждения из start_login на токен доступа, сохраняет его в файл только для владельца (0600) и сразу проверяет живым запросом к Метрике. После успеха остальные инструменты работают немедленно — перезапускать клиент не нужно. Код одноразовый и живёт 10 минут: если он не принят, вызовите start_login заново и попросите свежий.
coderequiredОтключить Метрику
Удаляет сохранённый токен Метрики с диска. Токен, заданный переменной окружения YANDEX_METRIKA_TOKEN, не трогает — его нужно убирать из конфигурации клиента вручную. Доступ, выданный приложению, остаётся активным на стороне Яндекса: отозвать его можно в Яндекс ID.
Takes no parameters.
Список счётчиков Метрики
Возвращает счётчики Яндекс Метрики, доступные токену (Management API). У каждого счётчика есть id, name и site2 (домен сайта) — id используется в get_statistics и list_goals. Фильтр по подстроке имени или сайта задаётся параметром `search`. На один сайт бывает несколько счётчиков (старый и новый, тестовый, отдельный для поддомена) — у каждого свои данные.
offsetsearchperPageСписок целей счётчика
Возвращает цели (конверсии), настроенные на счётчике Метрики (Management API). Идентификаторы целей нужны, чтобы запросить метрики конверсий (ym:s:goal<id>reaches / ym:s:goal<id>conversionRate) в get_statistics. counterId обязателен: id счётчика даёт list_counters.
counterIdrequiredСтатистика
Запрашивает Reporting API Яндекс Метрики (stat/v1/data) по счётчику. ПО УМОЛЧАНИЮ возвращает одну строку, агрегированную за период (без измерений), с visits/users/pageviews/bounceRate/avgVisitDurationSeconds. `dimensions` разбивает результат на строки (ym:s:date — динамика по дням, ym:s:lastTrafficSource — источники трафика, ym:s:deviceCategory — устройства), `metrics` задаёт нужные метрики — для конверсий это ym:s:goal<goalId>reaches / ym:s:goal<goalId>conversionRate (идентификаторы целей даёт list_goals). Префиксы не смешиваются: ym:s:* (визиты) и ym:pv:* (просмотры страниц) в одном запросе сочетаются только через filters. Ответ 400 «Incorrectly specified attribute» значит, что такого поля нет: не перебирать варианты имени, а взять поле из списка в `dimensions`. В ответе есть `totals` (итог по ВСЕМ строкам — для вопросов «сколько всего» суммировать не нужно), `total_rows` и `sampled`/`sample_share` (sampled=true означает, что данные приблизительные; для точных цифр нужно сузить период или передать accuracy=full). users — уникальные посетители за весь период: сумма users по дням их не даёт. counterId обязателен: id счётчика даёт list_counters.
sortdate1date2limitoffsetfiltersmetricsaccuracymaxPagescounterIdrequireddimensionsautoPaginate+1 moreПроизвольный запрос к API Яндекс Метрики
Универсальный запрос: обращается напрямую к любому пути API Яндекс Метрики — например "management/v1/counters", "management/v1/counter/{id}/goals", "stat/v1/data". Нужен для эндпоинтов, у которых нет отдельного инструмента. `query` уходит в строку запроса, `body` отправляется как JSON для POST. GET выполняется свободно; POST и DELETE — это запись, им нужен confirmWrite=true.
bodypathrequiredquerymethodconfirmWrite90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latestcodex mcp listclaude mcp add --transport stdio --scope user yandex-metrica -- npx -y mcp-yandex-metrica@latestclaude mcp list{ "mcpServers": { "yandex-metrica": { "command": "npx", "args": ["-y", "mcp-yandex-metrica@latest"] } }}{ "mcpServers": { "yandex-metrica": { "command": "npx", "args": ["-y", "mcp-yandex-metrica@latest"] } }}{ "servers": { "yandex-metrica": { "type": "stdio", "command": "npx", "args": ["-y", "mcp-yandex-metrica@latest"] } }}ASKADS_TELEMETRY=0