Yandex Metrica MCP: подключение к Cursor

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → Yandex Metrica, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

Yandex Metrica + Cursor

Подключите ИИ к веб-аналитике Яндекс Метрики: счётчики, цели, фильтры и сегменты, табличные отчёты, отчёты по времени, drill-down и сравнения по визитам, источникам, страницам и конверсиям, а также сырые визиты и хиты через Logs API.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

YANDEX_METRICA_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 5 минут. Нужен аккаунт Яндекса, которому принадлежат счётчики Метрики или у которого есть к ним доступ, и собственное приложение, зарегистрированное на oauth.yandex.com.

1. Создайте на oauth.yandex.com приложение типа For API access or debugging (для доступа к API или отладки) с правом доступа metrika:read (статистика Метрики, настройки счётчиков, список счётчиков). Запишите его ClientID.
2. Войдя под аккаунтом Яндекса, которому принадлежат счётчики или который их видит, откройте https://oauth.yandex.com/authorize?response_type=token&client_id=<ClientID> со своим ClientID и скопируйте токен (начинается с y0_) в YANDEX_METRICA_TOKEN, без OAuth или Bearer в начале.
3. Установите коннектор и запустите yandex_metrica_list_counters: он проверит токен и покажет id счётчиков, нужные остальным инструментам.

Cloud и self-hosting работают одинаково: вы вставляете токен, а коннектор передаёт его в каждом вызове как Authorization: OAuth .... Redirect URL в AnythingMCP указывать не нужно.

Токен действует около года: пока им пользуются, срок продлевается. Для всего здесь хватает доступа на чтение: metrika:read покрывает отчёты, настройки счётчиков и запросы к Logs API.

Сначала счётчики и цели: id счётчика передаётся в отчётах как ids, а во всех остальных инструментах как counterId. yandex_metrica_list_goals даёт id целей, которые входят в названия метрик целей, например ym:s:goal123reaches и ym:s:goal123conversionRate.

Метрики, даты и фильтры: метрики и группировки начинаются с ym:s: для визитов и ym:pv: для просмотров, например ym:s:visits, ym:s:bounceRate или ym:s:lastTrafficSource. Даты задаются как YYYY-MM-DD, today, yesterday или 30daysAgo. Фильтры используют ==, !=, =@ (содержит) и =~ (регулярное выражение), объединённые через AND и OR; сохранённые сегменты из yandex_metrica_list_segments можно использовать как фильтры. Строки листаются через limit (по умолчанию 100, не больше 100 000) и offset, который начинается с 1.

Сэмплирование: в ответах отчётов есть sampled и sample_share. Если sampled равно true, цифры приблизительные: для коротких периодов запросите полную точность (accuracy full) или используйте Logs API.

Logs API: сырые, несэмплированные визиты и хиты готовятся на стороне Яндекса. ИИ проверяет через yandex_metrica_evaluate_log_request, можно ли создать запрос, создаёт его, ждёт статуса processed и скачивает каждую часть как текст с разделителями-табуляциями, где в первой строке названия полей. Период не может включать сегодняшний день, а подготовленные логи учитываются в квоте хранения логов счётчика.

Лимиты: 5 000 запросов в сутки на пользователя, 200 запросов отчётов за 5 минут на пользователя, 3 параллельных запроса на пользователя и 30 запросов в секунду с одного IP-адреса (10 для Logs API). При превышении Яндекс отвечает 429: подождите и повторите.

Частые ошибки: 401 — токен неверный, истёк или отозван: получите новый с ClientID вашего приложения, как в шаге 2. 403 — токен работает, но у его аккаунта нет доступа к этому счётчику или у приложения нет metrika:read. 400 — неверная метрика, группировка или фильтр, и сообщение называет, какая именно.

Что читает коннектор: счётчики с сайтом, зеркалами, статусом, часовым поясом, статусом кода, владельцем и вашим уровнем доступа, а также метки (папки), по которым они разложены; цели с типом, условиями, шагами и ценностью; фильтры данных, операции над URL, сохранённые сегменты и список тех, у кого есть доступ к счётчику; табличные отчёты, отчёты по времени, drill-down и сравнения по визитам, посетителям, отказам, источникам трафика, страницам, странам, устройствам и конверсиям целей; а также сырые, несэмплированные визиты и хиты из Logs API.

Отключено при установке: yandex_metrica_clean_log_request. Он удаляет подготовленные файлы обработанного запроса Logs API, чтобы освободить квоту хранения логов счётчика, и после этого файлы уже нельзя скачать. Включайте его на странице коннектора, только если он нужен; перед каждым изменением ИИ спрашивает ваше подтверждение. yandex_metrica_create_log_request и yandex_metrica_cancel_log_request включены: они только запускают или останавливают подготовку выгрузки сырых данных на стороне Яндекса и не меняют ни счётчики, ни цели, ни настройки.

Не входит: создание и изменение счётчиков, целей, фильтров и доступов, а также загрузка офлайн-конверсий, звонков, расходов, параметров посетителей и данных CRM.

Шаг 2 — Установите адаптер

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Шаг 3 — Добавьте коннектор в Cursor

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Cursor читает MCP-серверы из ~/.cursor/mcp.json. Добавь эту запись:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти Cursor.
3. Открой Cursor → Settings → MCP и проверь, что anythingmcp есть в списке и подключён.
4. Начинай общаться: агент теперь может вызывать инструменты Yandex Metrica.

Доступные инструменты

Примеры запросов

• «Какие источники трафика принесли больше всего визитов в прошлом месяце и какой у них был показатель отказов?»
• «Как менялась по неделям за последние три месяца конверсия моей цели по заказам?»
• «Сравните визиты и достижения целей по источникам трафика за октябрь и сентябрь.»
• «У каких страниц вчера было больше всего просмотров и с каких устройств?»
• «Выгрузите через Logs API сырые, несэмплированные визиты за прошлую неделю и посчитайте их по регионам.»

FAQ

Поддерживает ли Cursor собственные MCP-серверы на бесплатном тарифе? Да — MCP доступен на тарифах Hobby, Pro и Business.

Следующие шаги

• Страница коннектора
• Подключить к Claude