GA4 MCPサーバー × Claudeの連携方法

右上の【新しいプロジェクト】をクリック

• プロジェクト名前：任意のプロジェクト名（例：ga4-mcp）
• 組織：「組織内」
• 親リソース：「組織なし」

Google Cloud のロゴの右側のドロップダウンメニューで「組織なし」を選択し、作成した「ga4-mcp」が表示されていれば確認OKです。

• 作成したプロジェクト「ga4-mcp」に切り替わっていることを確認
• サイドメニューから「APIとサービス」 → 「ライブラリ」をクリック
• APIライブラリページが開く

以下のAPIをそれぞれ検索して、「有効にする」をクリック

• Google Analytics Admin API（アカウント・プロパティ構造の取得用）
• Google Analytics Data API（レポート・トラフィックデータの取得用）

この後、「Claude Desktop」の設定で使うので、プロジェクトID（ga4-mcp-xxxxxx のような形式）を控えておきます。上部の「プロジェクト選択」や「ダッシュボード」で確認できます。

• サイドメニューから「APIとサービス」 → 「OAuth 同意画面」をクリック
• 「OAuth の概要」画面が開くので、「開始」ボタンをクリック

• 「アプリ名」は、任意の名称を入力（例 ga4-mcp）
• 「ユーザーサポートメール」は、Googleメールアドレス
• 「次へ」ボタンをクリック

• 「対象」は、「外部」を選択
• 「次へ」ボタンをクリック

• 「連絡先情報」は、Googleメールアドレス
• 「次へ」ボタンをクリック

• 「Google APIサービス：ユーザーデータに関するポリシー」を確認
• 「同意します」のチェックボックスを選択
• 「続行」ボタンをクリック

• 画面内の「作成」ボタンをクリック

• OAuthの構成が作成されます。

• サイドメニューから「対象」をクリック
• 少しページをスクロールすると「テストユーザー」のセクションがあります。
• 「+ Add users」ボタンをクリック

• Googleメールアドレスを追加
• 「保存」ボタンをクリック

• サイドメニューから「クライアント」 をクリック
• クライアント画面のケバブメニュー（３点リーダー）をクリック
• 「＋クライアントを作成」ボタンをクリック

• 「アプリケーションの種類」から「デスクトップ アプリ」を選択
• 「名前」は、任意の名前を入力（例：ga4-mcp-desktop）
• 「作成」ボタンをクリック

• OAuth クライアントの作成完了のダイアログが表示される
• ダイアログ下部の「JSON をダウンロード」をクリック
• ダウンロードした JSONファイルを任意の場所に保管

• ターミナルを起動し、以下のコマンドを実行（ダウンロードしたJSONを指定して認証します）

ダウンロードフォルダに格納している場合

gcloud auth application-default login --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform --client-id-file=~/Downloads/ga4_client_secret.json

書類直下の任意のフォルダに格納している場合

gcloud auth application-default login --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform --client-id-file=/Users/あなたのユーザー名/Documents/任意のフォルダ名/ga4_client_secret.json

• ブラウザが開いたら、使用するGoogleのメールアドレスを選択

• 「このアプリはGoogleで確認できません」というメッセージが出る
• 「続行」ボタンをクリック

• 「すべて選択」をクリック
• 「実行」をクリック

Google アナリティクスのデータの参照、ダウンロード

GA4のデータを読み取るための権限で、参照(見る)とダウンロード(取得)だけで、書き換えや削除はできません。MCPでGA4を分析するのに必須です。

Google Cloud のデータの参照、編集、設定、削除、Google アカウントのメールアドレスの参照

これは認証時に付けた cloud-platform スコープで、文言上は「編集・削除」まで含む広めの権限です。ただし、これはGoogleが定義しているスコープの説明文がもともと広範囲なだけで、実際にできることは「どのGoogle Cloudプロジェクトを使うか」をMCPサーバーが認識するための確認に使われる程度です。GA4 MCPサーバー自体はデータの読み取りツールしか持っていないので、この権限を使って何かを削除したり壊したりすることはありません。

Credentials saved to file: [/Users/あなたのユーザ名/.config/gcloud/application_default_credentials.json]

ターミナルに認証情報の保存先が上記のような形で表示されます。

• 「Claude Desktop」を起動
• 「設定」→「開発者」→「設定を編集」ボタンを開く

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": ["run", "analytics-mcp"],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/Users/あなたのユーザー名/.config/gcloud/application_default_credentials.json",
        "GOOGLE_PROJECT_ID": "ga4-mcp-xxxxxx"
      }
    }
  }
}

• 「claude_desktop_config.json」ファイルを開き、上記のコードを追加する
• GOOGLE_APPLICATION_CREDENTIALS：ステップ５でコピーしたフルパスを貼り付け
• GOOGLE_PROJECT_ID：ステップ２で控えたプロジェクトID

• 「Claude Desktop」を「Cmd+Q」で完全終了後、再起動する
• 「設定」→「開発者」を開く
• analytics-mcp が「running」になっていれば成功です。

自然言語で質問するだけで、Google Analyticsのデータをもとに解析することができます。

Google AnalyticsのアカウントIDとプロパティIDを指定して質問してみましょう。

# 指示
GA4 MCPを使って、以下の条件に従ってログ解析し、結果をアーティファクトとして出力してください。

## 解析内容（全サイト共通）
- 指標：ページビュー数（screenPageViews）とセッション数（sessions）
- 集計単位：月別（ディメンション yearMonth でグルーピング）
- 出力先：アーティファクトとして出力する
- 出力形式：MCPが返した実データを用いた、インタラクティブなグループ化棒グラフ
  - 横軸：月（2025-01〜2025-12）
  - 縦軸：件数（PV・セッションを並べて表示）
  - ホバーで各月の数値を表示
  - グラフの下に元データの月別テーブル（PV・セッション）も併記する

## 解析期間（全サイト共通）
- 開始日：2025-01-01
- 終了日：2025-12-31

## アナリティクスアカウント（全サイト共通）
- taimatsu（12345）

## プロパティ（全サイト共通）
- test.taimatsu.jp（67890）