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

Yandex Metrika MCP Server

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

MCP-серверВыбор редакцииРоссийский стек

artgas1/yandex-metrika-mcpАвтор:artgas1

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/artgas1-yandex-metrika-mcp

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio --env 'YANDEX_API_KEY=<ваш YANDEX_API_KEY>' yandex-metrika-mcp-server -- npx -y yandex-metrika-mcp-server@3.3.1

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "yandex-metrika-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "yandex-metrika-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"yandex-metrika-mcp-server","type":"stdio","command":"npx","args":["-y","yandex-metrika-mcp-server@3.3.1"],"env":{"YANDEX_API_KEY":"<ваш YANDEX_API_KEY>"}}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "yandex-metrika-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add yandex-metrika-mcp-server --env 'YANDEX_API_KEY=<ваш YANDEX_API_KEY>' -- npx -y yandex-metrika-mcp-server@3.3.1

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.yandex-metrika-mcp-server]
command = "npx"
args = ["-y", "yandex-metrika-mcp-server@3.3.1"]
env = { YANDEX_API_KEY = "<ваш YANDEX_API_KEY>" }

Если файл уже есть, допишите блок в конец.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-metrika-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "yandex-metrika-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "yandex-metrika-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-metrika-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "yandex-metrika-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "environment": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "yandex-metrika-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "yandex-metrika-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "yandex-metrika-mcp-server@3.3.1"
      ],
      "env": {
        "YANDEX_API_KEY": "<ваш YANDEX_API_KEY>"
      }
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

YANDEX_API_KEYсекрет, обязательная: OAuth-токен Яндекса с доступом к Метрике. Без него сервер не стартует.
METRIKA_PROFILEнеобязательная: Какая часть каталога объявляется: core (10 инструментов, умолчание), read (51 читающий), all (все 108).
METRIKA_ALLOW_WRITESнеобязательная: 1 разрешает и объявляет 57 инструментов, меняющих данные. Пока не задана — их нет в tools/list вовсе.
METRIKA_TOOLSнеобязательная: Своя выборка инструментов через запятую: раздел (stat, logs, management), префикс имени или точное имя. Задана — побеждает METRIKA_PROFILE.
METRIKA_TRAFFIC_FILTERнеобязательная: Условие сегментации, которое добавляется к отчётам Stat. По умолчанию ym:s:isRobot=='no'.
METRIKA_MAX_OUTPUT_CHARSнеобязательная: Потолок длины ответа одного вызова в символах. По умолчанию 120000.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: Node.js

Сверено с репозиторием 25 сент. 2026, коммит 000a016.

Текст для агента

Получи OAuth-токен Яндекса с доступом к Метрике, затем запусти npx -y yandex-metrika-mcp-server@3 с переменной YANDEX_API_KEY и добавь его в конфигурацию MCP клиента, начав с профиля по умолчанию core.

Другие способы из описания автора

npx -y yandex-metrika-mcp-server

Быстрый запуск без установки пакета.

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

Что делает

Сервер покрывает все 108 методов API Яндекс Метрики: 95 методов Management API в 21 ресурсе, 7 методов Logs API и 6 методов Stat API. Инструменты не пишутся руками, а порождаются из спеки, которую сервер сам собирает построчным сканером CSS-классов со страниц официальной документации на движке Diplodoc, потому что публичного openapi.json у Метрики нет. По умолчанию объявляется только 10 инструментов профиля core, остальное открывается переменной METRIKA_PROFILE со значениями read (51 читающий метод) или all (все 108), а пишущие инструменты дополнительно требуют METRIKA_ALLOW_WRITES=1, без чего они вообще не попадают в список tools/list. У каждого ответа есть блок _meta с applied_by_server, notes, retries, rows_total, truncated и truncated_by_server: сервер честно показывает, что добавил от себя, например фильтр роботов ym:s:isRobot=='no', и что обрезал по лимиту длины. Есть отдельный инструмент metrika_catalog_list, который без токена и сети показывает, что скрыто и как это включить.

Для кого. Для тех, кому кроме полного охвата API Метрики важна прозрачность: точно знать, что сервер добавил от себя в запрос и ответ.

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

Нужен полный доступ ко всем 108 методам API Метрики, включая редкие ресурсы Management API
Важно точно знать, какие фильтры и допущения сервер применил без явного запроса
Нужен контролируемый рост поверхности инструментов: от 10 базовых до всех 108 по явной переменной

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

Нужны пишущие инструменты сразу из коробки: они скрыты по умолчанию и требуют METRIKA_ALLOW_WRITES=1
Не хочется разбираться в профилях core, read и all: сервер сознательно ограничивает набор ради экономии контекста модели, а не отдает все сразу

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

Откуда приходили люди за неделю и сколько дошло до цели?

Ограничения

Лицензия в метаданных GitHub определена как NOASSERTION, хотя README и файл LICENSE указывают MIT. Разбор спеки привязан к конкретной версии движка документации Яндекса Diplodoc, расхождение версии останавливает сборку спеки при обновлении. Полный профиль all с включенными записями заметно увеличивает объем описаний инструментов в контексте модели, около 73 тысяч токенов по замеру автора. Logs API может не поместиться в лимит длины одного ответа, тогда результат обрезается с пометкой в метаданных.

Как отключить. Удалите сервер из конфигурации MCP клиента и отзовите OAuth-токен на oauth.yandex.ru.

MCP

Транспорт: stdio, http
Авторизация: API-ключ

Переменные окружения
Переменные окружения
YANDEX_API_KEY обязательная, секрет	OAuth-токен Яндекса с доступом к Метрике, без него сервер не стартует
METRIKA_PROFILE	Какая часть каталога объявляется: core (10 инструментов), read (51), all (все 108)
METRIKA_ALLOW_WRITES	1 объявляет 57 пишущих инструментов, без этой переменной их нет в tools/list
METRIKA_TRAFFIC_FILTER	Условие сегментации для отчетов Stat, по умолчанию исключает роботов
METRIKA_MAX_OUTPUT_CHARS	Потолок длины ответа одного вызова, по умолчанию 120000 символов

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

С METRIKA_ALLOW_WRITES=1 открываются 57 пишущих инструментов, меняющих счетчики, цели и сегменты
Читает коммерчески чувствительную статистику трафика и конверсий
По умолчанию пишущие инструменты скрыты, риск возникает только после осознанного включения

Коротко о README

README на русском с английской версией отдельным файлом подробно описывает контракт сервера: никакой молчаливой подмены запроса, все добавленное сервером видно в _meta, отказ остается отказом с телом ошибки API, обрезание выдачи объявляется, секреты редактируются в показанных URL. Объясняется устройство сборки спеки построчным сканером по CSS-классам документации и тест на дрейф API. Дана таблица переменных окружения для профиля, включения записи, ручного отбора инструментов, фильтра трафика и лимита длины ответа, а также замер размера манифеста tools/list по профилям в байтах и токенах. Отдельно описан фильтр роботов по умолчанию и особенность сравнения периодов без дат, где Метрика молча сравнивает период сам с собой. Лицензия MIT.

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

Как узнать, какие инструменты скрыты, не читая README?

Вызвать metrika_catalog_list: он объявлен в любом профиле, работает без токена и сети и прямо показывает, сколько методов скрыто и как расширить профиль.

Можно ли включить запись без включения всех 108 методов?

Нет, пишущие инструменты появляются только вместе с профилем all и переменной METRIKA_ALLOW_WRITES=1, частичного включения только записи не предусмотрено.

Скиллы DataLens

DataLens Skills

Официальный

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

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

OpenSEO

Официальный

Открытый MCP-сервер и набор агентских скиллов для SEO: keyword research, конкуренты, обратные ссылки и аудит сайта по данным DataForSEO

MCP-серверСредний риск21,5 тыс.

Claude SEO

Плагин Claude Code для SEO-аудита: технический SEO, E-E-A-T, schema, локальный и AI-поиск силами параллельных агентов

ПлагинВысокий риск17,9 тыс.

GEO-SEO Claude

Набор скиллов Claude Code для аудита сайта под AI-поиск: цитируемость, доступ AI-краулеров, llms.txt, разметка и отчеты

СкиллСредний риск10,9 тыс.

Установка

Что делает

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

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

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

Ограничения

MCP

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

Коротко о README

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

Похожие

Скиллы DataLens

OpenSEO

Claude SEO

GEO-SEO Claude