GA4 MCP Server
Google Analytics 4 (GA4) のデータを Claude などの LLM から取得・分析できる MCP (Model Context Protocol) サーバーです。
特徴
- 20種類の分析ツール: 単純なデータ取得だけでなく、実用的な分析ツールを多数搭載
- 日本語対応: 出力結果は日本語でフォーマット（例: "2分34秒", "45.2%"）
- 柔軟な期間指定: 相対日付（
7daysAgo,yesterday）と絶対日付の両方に対応 - 即座にインサイト: LLMが直接解釈しやすい形式でデータを返却
必要要件
- Node.js 18以上
- GA4 プロパティへのアクセス権を持つ Google アカウント
インストール
cd ga4-mcp-server
npm install
npm run build
認証設定
方法1: gcloud CLI を使う（推奨・簡単）
サービスアカウント不要で、自分の Google アカウントで認証できます。
1. gcloud CLI をインストール
# Windows (winget)
winget install Google.CloudSDK
# または https://cloud.google.com/sdk/docs/install からダウンロード
2. 認証を実行
gcloud auth application-default login --scopes="https://www.googleapis.com/auth/analytics.readonly"
ブラウザが開くので、GA4 にアクセス権のある Google アカウントでログインするだけ！
これだけで完了です。GOOGLE_APPLICATION_CREDENTIALS の設定は不要です。
方法2: サービスアカウントを使う（本番環境向け）
チーム共有や本番環境では、サービスアカウントを使用します。
1. Google Cloud Console でサービスアカウントを作成
- Google Cloud Console にアクセス
- プロジェクトを選択（または新規作成）
- 「IAM と管理」→「サービスアカウント」→「サービスアカウントを作成」
- 名前を入力して作成
- 「キー」タブ →「鍵を追加」→「新しい鍵を作成」→ JSON形式でダウンロード
2. API の有効化
「APIとサービス」→「ライブラリ」で以下を有効化:
- Google Analytics Data API
- Google Analytics Admin API
3. GA4 プロパティへのアクセス権付与
- Google Analytics にアクセス
- 「管理」→「プロパティのアクセス管理」
- サービスアカウントのメールアドレス（
xxx@xxx.iam.gserviceaccount.com）を「閲覧者」として追加
MCP 設定
gcloud CLI 認証を使う場合（推奨）
{
"mcpServers": {
"ga4": {
"command": "node",
"args": ["/path/to/ga4-mcp-server/dist/index.js"],
"env": {
"GA4_PROPERTY_ID": "123456789"
}
}
}
}
サービスアカウントを使う場合
{
"mcpServers": {
"ga4": {
"command": "node",
"args": ["/path/to/ga4-mcp-server/dist/index.js"],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account.json",
"GA4_PROPERTY_ID": "123456789"
}
}
}
}
設定ファイルの場所
| アプリ | 設定ファイル |
|---|---|
| Claude Desktop (Mac) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Cursor | .cursor/mcp.json（プロジェクトルート） |
環境変数
| 変数名 | 必須 | 説明 |
|---|---|---|
GOOGLE_APPLICATION_CREDENTIALS | × | サービスアカウントJSONキーのパス（gcloud CLI使用時は不要） |
GA4_PROPERTY_ID | △ | デフォルトのGA4プロパティID（ツール実行時に指定も可） |
利用可能なツール
基本ツール（5個）
| ツール名 | 説明 |
|---|---|
list_accounts | アカウント・プロパティ一覧取得 |
get_property_details | プロパティ詳細情報 |
run_report | 汎用レポート実行（メインツール） |
run_realtime_report | リアルタイムレポート |
get_metadata | 利用可能なディメンション・メトリクス一覧 |
分析ツール（15個）
| ツール名 | 説明 |
|---|---|
get_traffic_summary | トラフィックサマリー（PV/UU/セッション等） |
get_top_pages | 人気ページランキング |
get_traffic_sources | 流入元分析 |
get_device_breakdown | デバイス別アクセス比率 |
get_geo_breakdown | 地域別アクセス分析 |
compare_periods | 期間比較（前週比、前月比など） |
get_landing_pages | ランディングページ分析 |
get_exit_pages | 離脱ページ分析 |
get_user_journey | ユーザージャーニー（ページ遷移） |
get_conversion_funnel | コンバージョンファネル分析 |
get_hourly_traffic | 時間帯別アクセス分析 |
get_daily_trend | 日別トレンド |
get_new_vs_returning | 新規 vs リピーター分析 |
get_engagement_metrics | エンゲージメント指標 |
get_search_terms | サイト内検索キーワード |
使用例
基本的な質問
「今日のPV数を教えて」
→ get_traffic_summary (period: "today")
「今リアルタイムで何人見てる？」
→ run_realtime_report
ランキング系
「過去7日間のアクセス数が多いページTOP10」
→ get_top_pages (period: "7days", limit: 10)
「どこからアクセスが来てる？」
→ get_traffic_sources (period: "7days", groupBy: "channel")
比較・分析系
「先週と今週を比較して」
→ compare_periods (comparisonType: "previousPeriod", period: "7days")
「モバイルとPCの比率は？」
→ get_device_breakdown (period: "7days")
深堀り分析
「何時頃にアクセスが多い？」
→ get_hourly_traffic (period: "7days")
「このページを見た人は次にどこに行く？」
→ get_user_journey (pagePath: "/product/123", direction: "next")
開発
# 開発モード（ファイル変更を監視してリビルド）
npm run dev
# ビルド
npm run build
# 型チェック
npm run typecheck
注意事項
- レート制限: GA4 Data API には 1 プロジェクトあたり 1 日 50,000 リクエストの制限があります
- データの遅延: GA4のデータは通常24-48時間の遅延があります（リアルタイムレポートを除く）
- ファネル分析の制限: GA4 Data APIでは真のファネル分析に制限があります。より正確な分析にはBigQuery Exportが必要です
ライセンス
MIT