Yandex Metrica MCP

Yandex Metrica MCP は、AIアプリケーションをウェブサイトのウェブ解析に接続します。訪問者がどこから来ているのか、コンバージョンがどう変化しているのか、直帰率がどこで伸びているのかを自然言語で質問すると、アシスタントがあなたのカウンターからデータを取得して結果を説明します。接続はダイアログ内でそのまま始まります。事前にトークンを作成したり、設定を編集したりする必要はありません。

• 8つのツール。 メトリカのカウンター、目標、レポート、アクセス権の接続・切断、そしてAPIへの汎用リクエスト1つ。

• レポートとコンバージョン。 選択した期間の訪問数、ユーザー数、ページビュー数、直帰数、滞在時間、流入元、デバイス、目標。

• チャットでの接続。 Yandexがログインページを開きます。ワンタイムコードの有効期限は10分で、サーバーは接続直後にカウンターへのアクセスを確認します。

• 通常のリクエストは読み取り専用。 専用ツールはメトリカのカウンター、目標、データを変更しません。

• 黙って切り詰めない。 レポートには合計値とサンプリングの有無が表示されます。大量のデータがある場合、サーバーは制限に達したことを明示します。

最初のメッセージでお試しください：

先週、私のサイトの訪問数、ユーザー数、直帰数はどれくらいでしたか？

サーバーを接続する · シナリオを見る · 技術ドキュメントを開く

動作を1分で確認

あなた： Yandex Metricaを接続してください。

アシスタント： Yandexへのログインリンクを提示します。必要なカウンターへのアクセス権があるアカウントで開き、アクセスを承認して、表示されたコードを送信してください。

あなた： Yandexのページからコードを送信します。

アシスタント： メトリカを接続し、カウンターが見えるか確認して、結果を報告します。アプリケーションの再起動は不要です。

あなた： 過去30日間のトラフィックソースと「注文完了」目標のコンバージョンを見せてください。

アシスタント： 目標を見つけ、ソース別レポートを作成し、訪問数、目標達成数、コンバージョンを表示します。メトリカがサンプリングを適用した場合は、数値が概算であることを明記します。

Related MCP server: ya-metrics-mcp

目次

• クイックスタート

• 任せられること

• 仕組み

• データを変更する可能性があるもの

• 接続と設定

• データとテレメトリ

• 制限事項

• 技術ドキュメント

• サポート

クイックスタート

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

1. AIアプリケーションにサーバーを追加します — 以下にCodexの例を開いています。その他のアプリケーションは折りたたみ式の手順にまとめています。

2. 「Yandex Metricaを接続してください」と入力します。アシスタントがYandexへのログインを案内し、カウンターが見えることをすぐに確認します。

3. 最初の質問をします。例：「先月、最も多くの訪問をもたらしたソースはどれですか？」

アプリケーションのインターフェースから：

1. Settings → Plugins → MCP servers を開きます。

2. Add server をクリックします。

3. 起動コマンド npx -y mcp-yandex-metrica@latest を追加します。

コマンドラインから：

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

接続を確認します：

codex mcp list

その後、Codexのチャットで「Yandex Metricaを接続してください」と依頼します。

Codex公式手順

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

サーバーをコマンドで確認します：

claude mcp list

その後、メトリカの接続を依頼してダイアログを開始します。

Claude Codeドキュメント

Settings → Developer → Edit Config を開き、claude_desktop_config.json にサーバーを追加します：

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

保存後、新しいダイアログを開いてメトリカの接続を依頼します。

すべてのプロジェクトで使用する場合は ~/.cursor/mcp.json を、現在のプロジェクトのみで使用する場合は .cursor/mcp.json を作成します：

{
  "mcpServers": {
    "yandex-metrica": {
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

Cursorのチャットで、サーバーが利用可能なツールとして表示されます。メトリカの接続を依頼し、Yandexでログインを完了してください。

Cursorドキュメント

コマンドパレットを開き、MCP: Open User Configuration を実行します。mcp.json に追加します：

{
  "servers": {
    "yandex-metrica": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-yandex-metrica@latest"]
    }
  }
}

MCP: List Servers コマンドで起動を確認し、チャットを開いてメトリカの接続を依頼します。

VS Codeドキュメント

任せられること

サイトの状況を把握する

• 「先週の訪問数、ユーザー数、ページビュー数はどれくらいでしたか？」

• 「6月の日別アクセス数の推移を見せてください。」

• 「どのデバイスで直帰率が高いですか？」

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

• 「1ヶ月のトラフィックソースを訪問数で並べて表示してください。」

• 「オーガニック検索と広告をユーザー数と直帰数で比較してください。」

• 「今週、最も多くの遷移をもたらしたソースはどれですか？」

コンバージョンを分析する

• 「カウンターにはどのような目標が設定されていますか？」

• 「30日間の『注文完了』目標のコンバージョンはどれくらいですか？」

• 「最も多くの目標達成をもたらしたソースを表示してください。」

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

• 「どのカウンターにアクセスできますか？」

• 「メトリカへの接続ステータスを表示してください。」

• 「このレポートのデータは正確ですか、それともメトリカはサンプリングを使用しましたか？」

仕組み

サーバーは3つの馴染みのあるエンティティを扱います：

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

データを変更する可能性があるもの

サーバーは任意の書き込みを潜在的に破壊的な操作としてマークします。AIアプリケーションがどのように確認を求めるかは、アプリケーション自体に依存します。そのようなリクエストの前に、パス、メソッド、データを確認してください。

接続と設定

通常の使用では、事前にトークンは必要ありません：

1. チャットでYandex Metricaの接続を依頼します。

2. 必要なカウンターへのアクセス権があるアカウントでYandex OAuthのリンクを開きます。

3. アクセスを承認し、コードをアシスタントに送信します。コードの有効期限は10分で、実行中のサーバー内でのみトークンに交換されます。

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

CIや標準的でない環境では、環境変数による設定が利用可能です：

独自のOAuthアプリケーションを使用する場合は、そのアプリケーションで 「統計の取得、自社および信頼できるカウンターのパラメータの読み取り」（metrika:read）権限をリクエストしてください。

データとテレメトリ

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

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

ASKADS_TELEMETRY=0

制限事項

• メトリカのサンプリング。 長い期間や複雑なレポートでは、APIが概算データを返す場合があります。sampled フィールドと sample_share フィールドを確認してください。より正確な計算が必要な場合は、期間を狭めるか、accuracy: "full" を使用してください。

• レポートのサイズ。 1回のリクエストで最大10,000行が返されます。自動ページネーションは最大100ページ、100,000行、または約1MBのデータで停止し、不完全な応答を _truncated フィールドでマークします。

• リクエストの再試行。 1回のリクエストのタイムアウトは60秒です。サーバーは一時的なエラー時に最大3回再試行します：GET はネットワークエラー、429、5xx の場合。POST と DELETE は変更操作を繰り返さないよう 429 の場合のみ。遅延は Retry-After を考慮し、30秒を超えません。

• 本番データ。 メトリカにはサンドボックスがありません。専用ツールはデータを読み取りますが、任意のリクエストによる POST と DELETE は実際のオブジェクトを変更します。

• バックグラウンド監視なし。 サーバーはAIアプリケーションが呼び出したときに動作し、指標を自動的に監視しません。アプリケーションがスケジュールタスクをサポートしている場合は、定期的なレポートリクエストを設定できます。

技術ドキュメント

• MCP機能カタログ — 各ツールのユーザータスク別ページ。

• 全ツール — 各ツールのパラメータ、応答、制限。

• 開発ドキュメント — プロジェクトの構成とデモの操作。

• npmのパッケージ。

• Yandex Metrica API。

サポート

エラーを見つけた、またはシナリオが足りない？ issueを作成 または Telegram にご連絡ください。