Yandex Metrica MCP

Яндекс Метрика MCP

Яндекс Метрика MCP подключает AI-приложение к веб-аналитике сайта. Спросите на естественном языке, откуда приходят посетители, как меняется конверсия или где растёт доля отказов — ассистент возьмёт данные из вашего счётчика и объяснит результат. Подключение начинается прямо в диалоге: не нужно заранее создавать токен или редактировать конфигурацию.

• Восемь инструментов. Счётчики, цели и отчёты Метрики, подключение и отключение доступа, а также один универсальный запрос к API.
• Отчёты и конверсии. Визиты, пользователи, просмотры, отказы, длительность визита, источники, устройства и цели за выбранный период.
• Подключение в чате. Яндекс откроет страницу входа; одноразовый код действует 10 минут, а сервер проверит доступ к счётчикам сразу после подключения.
• Обычные запросы — только чтение. Специализированные инструменты не меняют счётчики, цели или данные Метрики.
• Без молчаливого обрезания. В отчёте видны итоговые значения и признак выборки; при большой выдаче сервер отмечает, если упёрся в лимит.

Попробуйте первым сообщением:

Сколько визитов, пользователей и отказов было у моего сайта за последнюю неделю?

Подключить сервер · Посмотреть сценарии · Открыть техническую документацию

Увидеть работу за минуту

Вы: Подключи Яндекс Метрику.

Ассистент: Даёт ссылку на вход в Яндекс. Откройте её под аккаунтом, у которого есть доступ к нужным счётчикам, подтвердите доступ и пришлите показанный код.

Вы: Отправляет код из страницы Яндекса.

Ассистент: Подключает Метрику, проверяет, видны ли счётчики, и сообщает результат. Перезапускать приложение не нужно.

Вы: За последние 30 дней покажи источники трафика и конверсию по цели «Оформление заказа».

Ассистент: Находит цель, строит отчёт по источникам и показывает визиты, достижения цели и конверсию. Если Метрика применила выборку, отмечает, что цифры приблизительные.

Содержание

• Быстрый старт
• Что можно поручить
• Как это работает
• Что может изменить данные
• Подключение и настройка
• Данные и телеметрия
• Ограничения
• Техническая документация
• Поддержка

クイックスタート

Node.js 20 以降が必要です。サーバーは npx で起動するため、パッケージを別途インストールする必要はありません。

1. サーバーを AI アプリに追加します。以下では Codex の例を示し、その他のアプリについては折りたたみ式の手順にまとめています。
2. 「Yandex Metrica に接続して」と伝えます。アシスタントが Yandex へのログインを案内し、すぐにカウンターを確認できることを確かめます。
3. 「先月、最も多くの訪問数をもたらした流入元は？」など、最初の質問をします。

codex mcp add yandex-metrica -- npx -y mcp-yandex-metrica@latest

codex mcp list

claude mcp add --transport stdio --scope user yandex-metrica -- npx -y mcp-yandex-metrica@latest

claude 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"]
    }
  }
}

依頼できること

サイトの状況を把握する

• 「先週の訪問数、ユーザー数、ページビュー数は？」
• 「6 月の日別の訪問数の推移を見せて」
• 「どのデバイスで直帰率が高い？」

トラフィックの流入元を見つけ、品質を評価する

• 「月間のトラフィック流入元を訪問数順に並べて」
• 「ユーザー数と直帰率について、オーガニック検索と広告を比較して」
• 「今週、最も多くの訪問をもたらした流入元は？」

コンバージョンを確認する

• 「カウンターにはどの目標が設定されている？」
• 「過去 30 日間の『注文手続き』目標のコンバージョン率は？」
• 「目標の達成数を最も多くもたらした流入元を見せて」

アクセス権とデータの精度を確認する

• 「自分が利用できるカウンターは？」
• 「Metrica への接続状況を見せて」
• 「このレポートのデータは正確？それとも Metrica はサンプリングを使用した？」

仕組み

サーバーは、次の 3 つの使い慣れたエンティティを扱います：

通常、アシスタントはまず利用可能なカウンターを見つけ、必要に応じて目標を確認してから、レポートを作成します。Metrica の応答には、全行の合計、結果の件数、サンプリングの有無が含まれます。

データを変更する可能性がある操作

サーバーは、任意の書き込みを破壊的な操作となる可能性があるものとしてマークします。AI アプリが確認を求める方法はアプリによって異なります。そのようなリクエストを行う前に、パス、メソッド、データを確認してください。

接続と設定

通常の使用では、あらかじめトークンを用意する必要はありません。

1. チャットで、Yandex メトリカへの接続を依頼します。
2. 必要なカウンターへのアクセス権を持つアカウントで、Yandex OAuth のリンクを開きます。
3. アクセスを承認し、コードをアシスタントに送信します。コードの有効期限は10分で、稼働中のサーバー内でのみトークンに交換されます。

サーバーは PKCE を使用します。チャット内のコードだけでは、トークンに交換できません。取得したトークンは、所有者のみがアクセスできる権限で ~/.config/mcp-yandex-metrica/credentials.json にローカル保存されます。refresh トークンが保存されている場合、アクセスは自動的に更新されます。

CI や標準以外のインストールでは、環境変数による設定を利用できます。

独自の OAuth アプリを使用する場合は、アプリに**「統計の取得、自分のカウンターおよび信頼済みカウンターの設定の読み取り」**（metrika:read）権限をリクエストしてください。

データとテレメトリ

デフォルトでは、サーバーは匿名の技術テレメトリを送信します。内容は、ランダムなインストール ID、イベント名またはツール名、サーバーのバージョン、Node.js のバージョン、OS、接続した AI クライアントの情報です。トークン、カウンターのデータ、ツールの引数、お客様のメッセージ、環境変数の値は含まれません。

Ask Ads の MCP サーバーのテレメトリを無効にするには、環境変数を設定します。

ASKADS_TELEMETRY=0

制限事項

• メトリカのサンプリング。 長期間のデータや複雑なレポートでは、API が概算データを返す場合があります。sampled フィールドと sample_share フィールドを確認してください。より正確に計算するには、期間を短くするか、accuracy: "full" を使用してください。
• レポートのサイズ。 1回のリクエストで返される行数は最大 10 000 です。自動ページネーションは、最大100ページ、100 000行、または約1 MBのデータで停止し、不完全なレスポンスには _truncated フィールドが付与されます。
• リクエストの再試行。 1回のリクエストのタイムアウトは60秒です。一時的なエラーが発生した場合、サーバーは最大3回再試行します。GET はネットワークエラー、429、5xx の場合に再試行します。POST と DELETE は、変更操作の重複を防ぐため、429 の場合にのみ再試行します。待機時間は Retry-After を考慮し、30秒を超えません。
• 本番データ。 メトリカにはサンドボックスがありません。専用ツールはデータを読み取りますが、任意のリクエストによる POST と DELETE は実際のオブジェクトを変更します。
• バックグラウンドでの監視なし。 サーバーは AI アプリから呼び出されたときに動作し、指標を自ら監視することはありません。アプリがスケジュール済みタスクに対応している場合は、定期的にレポートをリクエストするよう設定できます。

Техническая документация

• Каталог MCP-возможностей — страницы по пользовательским задачам для каждого инструмента.
• Все инструменты — параметры, ответы и границы каждого инструмента.
• Документация по разработке — устройство проекта и работа с демо.
• Пакет в npm.
• API Яндекс Метрики.

Поддержка

Нашли ошибку или не хватает сценария? Создайте issue или напишите в Telegram.