{
"markdown": "# Яндекс Метрика MCP\n\n[](https://www.npmjs.com/package/mcp-yandex-metrica)\n[](https://github.com/askads/mcp-yandex-metrica/actions/workflows/ci.yml)\n[](https://glama.ai/mcp/servers/askads/mcp-yandex-metrica)\n[](./LICENSE)\n\n**Яндекс Метрика MCP** подключает AI-приложение к веб-аналитике сайта. Спросите на естественном языке, откуда приходят посетители, как меняется конверсия или где растёт доля отказов — ассистент возьмёт данные из вашего счётчика и объяснит результат. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.\n\n- **Восемь инструментов.** Счётчики, цели и отчёты Метрики, подключение и отключение доступа, а также один универсальный запрос к API.\n- **Отчёты и конверсии.** Визиты, пользователи, просмотры, отказы, длительность визита, источники, устройства и цели за выбранный период.\n- **Подключение в чате.** Яндекс откроет страницу входа; одноразовый код действует 10 минут, а сервер проверит доступ к счётчикам сразу после подключения.\n- **Обычные запросы — только чтение.** Специализированные инструменты не меняют счётчики, цели или данные Метрики.\n- **Без молчаливого обрезания.** В отчёте видны итоговые значения и признак выборки; при большой выдаче сервер отмечает, если упёрся в лимит.\n\nПопробуйте первым сообщением:\n\n> Сколько визитов, пользователей и отказов было у моего сайта за последнюю неделю?\n\n[Подключить сервер](#быстрый-старт) · [Посмотреть сценарии](#что-можно-поручить) · [Открыть техническую документацию](#техническая-документация)\n\n---\n\n## Увидеть работу за минуту\n\n> **Вы:** Подключи Яндекс Метрику.\n>\n> **Ассистент:** Даёт ссылку на вход в Яндекс. Откройте её под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердите доступ и пришлите показанный код.\n>\n> **Вы:** Отправляет код из страницы Яндекса.\n>\n> **Ассистент:** Подключает Метрику, проверяет, видны ли счётчики, и сообщает результат. Перезапускать приложение не нужно.\n>\n> **Вы:** За последние 30 дней покажи источники трафика и конверсию по цели «Оформление заказа».\n>\n> **Ассистент:** Находит цель, строит отчёт по источникам и показывает визиты, достижения цели и конверсию. Если Метрика применила выборку, отмечает, что цифры приблизительные.\n\n## Содержание\n\n- [Быстрый старт](#быстрый-старт)\n- [Что можно поручить](#что-можно-поручить)\n- [Как это работает](#как-это-работает)\n- [Что может изменить данные](#что-может-изменить-данные)\n- [Подключение и настройка](#подключение-и-настройка)\n- [Данные и телеметрия](#данные-и-телеметрия)\n- [Ограничения](#ограничения)\n- [Техническая документация](#техническая-документация)\n- [Поддержка](#поддержка)\n\n## Быстрый старт\n\nНужен Node.js 20 или новее. Сервер запускается через `npx`, поэтому отдельно устанавливать пакет не требуется.\n\n1. Добавьте сервер в AI-приложение — ниже открыт пример для Codex, остальные приложения собраны в сворачиваемые инструкции.\n2. Напишите: «Подключи Яндекс Метрику». Ассистент проведёт через вход в Яндекс и сразу проверит, что ему видны ваши счётчики.\n3. Задайте первый вопрос, например: «Какие источники дали больше всего визитов за прошлый месяц?»\n\n\nCodex
\n\n
\n\n**Через интерфейс приложения:**\n\n1. Откройте **Settings → Plugins → MCP servers**.\n2. Нажмите **Add server**.\n3. Добавьте команду запуска `npx -y mcp-yandex-metrica@latest`.\n\n**Через командную строку:**\n\n```bash\ncodex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest\n```\n\nПроверьте подключение:\n\n```bash\ncodex mcp list\n```\n\nЗатем в чате Codex попросите: «Подключи Яндекс Метрику».\n\n[Официальная инструкция Codex](https://learn.chatgpt.com/docs/extend/mcp?surface=cli)\n\n \n\n\nClaude Code
\n\n
\n\n```bash\nclaude mcp add --transport stdio --scope user yandex-metrica -- npx -y mcp-yandex-metrica@latest\n```\n\nПроверьте сервер командой:\n\n```bash\nclaude mcp list\n```\n\nЗатем начните диалог с просьбы подключить Метрику.\n\n[Документация Claude Code](https://docs.anthropic.com/en/docs/claude-code/mcp)\n\n \n\n\nClaude Desktop
\n\n
\n\nОткройте **Settings → Developer → Edit Config** и добавьте сервер в `claude_desktop_config.json`:\n\n```json\n{\n \"mcpServers\": {\n \"yandex-metrica\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-yandex-metrica@latest\"]\n }\n }\n}\n```\n\nПосле сохранения откройте новый диалог и попросите подключить Метрику.\n\n \n\n\nCursor
\n\n
\n\nДля всех проектов создайте `~/.cursor/mcp.json`; только для текущего проекта — `.cursor/mcp.json`:\n\n```json\n{\n \"mcpServers\": {\n \"yandex-metrica\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-yandex-metrica@latest\"]\n }\n }\n}\n```\n\nВ чате Cursor сервер появится среди доступных инструментов. Попросите подключить Метрику и пройдите вход через Яндекс.\n\n[Документация Cursor](https://docs.cursor.com/context/model-context-protocol)\n\n \n\n\nVS Code
\n\n
\n\nОткройте палитру команд и выполните **MCP: Open User Configuration**. Добавьте в `mcp.json`:\n\n```json\n{\n \"servers\": {\n \"yandex-metrica\": {\n \"type\": \"stdio\",\n \"command\": \"npx\",\n \"args\": [\"-y\", \"mcp-yandex-metrica@latest\"]\n }\n }\n}\n```\n\nПроверьте запуск командой **MCP: List Servers**, затем откройте чат и попросите подключить Метрику.\n\n[Документация VS Code](https://code.visualstudio.com/docs/agent-customization/mcp-servers)\n\n \n\n## Что можно поручить\n\n### Понять, что происходит с сайтом\n\n- «Сколько было визитов, пользователей и просмотров за последнюю неделю?»\n- «Покажи динамику посещаемости по дням за июнь».\n- «На каких устройствах доля отказов выше?»\n\n### Найти источник трафика и оценить его качество\n\n- «Покажи источники трафика за месяц и отсортируй по визитам».\n- «Сравни органический поиск и рекламу по пользователям и отказам».\n- «Какие источники дали больше всего переходов на этой неделе?»\n\n### Разобраться с конверсиями\n\n- «Какие цели настроены в счётчике?»\n- «Какая конверсия по цели „Оформление заказа“ за 30 дней?»\n- «Покажи источники, которые принесли больше всего достижений цели».\n\n### Проверить доступ и точность данных\n\n- «Какие счётчики мне доступны?»\n- «Покажи статус подключения к Метрике».\n- «Данные в этом отчёте точные или Метрика использовала выборку?»\n\n## Как это работает\n\nСервер работает с тремя привычными сущностями:\n\n| Сущность | Что можно узнать |\n|---|---|\n| **Счётчик** | Название сайта, его идентификатор и доступность для вашего аккаунта. |\n| **Цель** | Настроенные на счётчике конверсии и их идентификаторы. |\n| **Отчёт** | Метрики и срезы за период: например, визиты по дням, источникам или устройствам. |\n\nОбычно ассистент сначала находит доступный счётчик, затем — при необходимости — цель, и только после этого строит отчёт. В ответе Метрики есть итог по всем строкам, размер выдачи и признак выборки.\n\n## Что может изменить данные\n\n| Действие | Что происходит |\n|---|---|\n| Список счётчиков, целей и отчёты | Только чтение данных Метрики. |\n| Подключение | Сохраняет токен доступа локально на вашем компьютере и проверяет его чтением счётчиков. В Метрике ничего не меняет. |\n| Отключение | Удаляет только сохранённый на компьютере токен. Доступ приложения в Яндекс ID остаётся; его можно отозвать там отдельно. |\n| Произвольный запрос к API | `GET` читает данные. `POST` и `DELETE` могут менять реальные объекты Метрики и выполняются только с `confirmWrite=true`. |\n\nСервер помечает произвольную запись как потенциально разрушительное действие. Как именно AI-приложение запрашивает подтверждение, зависит от самого приложения; перед таким запросом проверьте путь, метод и данные.\n\n## Подключение и настройка\n\nДля обычного использования токен заранее не нужен:\n\n1. В чате попросите подключить Яндекс Метрику.\n2. Откройте ссылку на Яндекс OAuth под аккаунтом с доступом к нужным счётчикам.\n3. Подтвердите доступ и пришлите код ассистенту. Он действует 10 минут и меняется на токен только внутри работающего сервера.\n\nСервер использует PKCE: код из чата сам по себе нельзя обменять на токен. Полученный токен хранится локально в `~/.config/mcp-yandex-metrica/credentials.json` с правами только для владельца. При сохранённом refresh-токене доступ продлевается автоматически.\n\nДля CI и нестандартных установок доступна настройка через переменные окружения:\n\n| Переменная | Назначение |\n|---|---|\n| `YANDEX_METRIKA_TOKEN` | Готовый OAuth-токен с правом `metrika:read`; имеет приоритет над подключением из чата. |\n| `YANDEX_METRIKA_COUNTER_ID` | Счётчик по умолчанию для запросов без `counterId`. |\n| `YANDEX_METRIKA_OAUTH_CLIENT_ID` | Client ID собственного OAuth-приложения вместо приложения Ask Ads. |\n| `YANDEX_METRIKA_LANG` | Язык подписей в ответах API; по умолчанию `ru`. |\n| `YANDEX_METRIKA_TIMEOUT_MS` | Таймаут запроса; по умолчанию 60 000 мс. |\n| `YANDEX_METRIKA_MAX_RETRIES` | Число повторов при временных ошибках; по умолчанию 3. |\n| `YANDEX_METRIKA_API_BASE` | Базовый адрес API; по умолчанию `https://api-metrika.yandex.net`. |\n\nЕсли используете собственное OAuth-приложение, запросите в нём право **«Получение статистики, чтение параметров своих и доверенных счётчиков»** (`metrika:read`).\n\n## Данные и телеметрия\n\nПо умолчанию сервер отправляет анонимную техническую телеметрию: случайный идентификатор установки, имя события или инструмента, версию сервера, версию Node.js, ОС и сведения о подключившемся AI-клиенте. В неё не попадают токен, данные счётчиков, аргументы инструментов, ваши сообщения и значения переменных окружения.\n\nЧтобы отключить телеметрию для MCP-серверов Ask Ads, задайте переменную окружения:\n\n```bash\nASKADS_TELEMETRY=0\n```\n\n## Ограничения\n\n- **Выборка Метрики.** На больших периодах или сложных отчётах API может вернуть приблизительные данные. Смотрите поля `sampled` и `sample_share`; для более точного расчёта сузьте период или используйте `accuracy: \"full\"`.\n- **Размер отчёта.** Один запрос возвращает до 10 000 строк. Автоматическая пагинация останавливается не более чем на 100 страницах, 100 000 строках или примерно 1 МБ данных и помечает неполный ответ полем `_truncated`.\n- **Повторы запросов.** Таймаут одного запроса — 60 секунд. Сервер делает до трёх повторов при временной ошибке: `GET` — при сетевой ошибке, `429` и `5xx`; `POST` и `DELETE` — только при `429`, чтобы не повторить изменяющее действие. Задержка учитывает `Retry-After` и не превышает 30 секунд.\n- **Боевые данные.** У Метрики нет песочницы. Специализированные инструменты читают данные, но `POST` и `DELETE` через произвольный запрос меняют реальные объекты.\n- **Нет фонового наблюдения.** Сервер работает, когда его вызывает AI-приложение, и сам не следит за показателями. Если приложение поддерживает запланированные задания, можно настроить в нём периодический запрос отчёта.\n\n## Техническая документация\n\n- [Каталог MCP-возможностей](./docs/capabilities/index.md) — страницы по пользовательским задачам для каждого инструмента.\n- [Все инструменты](./docs/TOOLS.md) — параметры, ответы и границы каждого инструмента.\n- [Документация по разработке](./docs/DEVELOPMENT.md) — устройство проекта и работа с демо.\n- [Пакет в npm](https://www.npmjs.com/package/mcp-yandex-metrica).\n- [API Яндекс Метрики](https://yandex.ru/dev/metrika/).\n\n## Поддержка\n\nНашли ошибку или не хватает сценария? [Создайте issue](https://github.com/askads/mcp-yandex-metrica/issues) или напишите в [Telegram](http://t.me/gistrec).\n",
"bytes": 11688,
"sha": "ec527c7ea72d1ea89e8eb58ca0561a12e354373279c49b94c7c9da326a37faca",
"repo_slug": "askads/mcp-yandex-metrica",
"fonte": "repo",
"truncated": false,
"api": "https://agentalog.com/api/listings/mcp_io_github_askads_mcp_yandex_metrica_370a5490/readme"
}