MCP経由でClaudeをGA4に接続するには?
GA4のワークフローでは、ログインしてメニューをたどり、データをエクスポートし、あらためて別に解釈するという手順が一般的です。MCP(Model Context Protocol)を使ってClaudeをGA4に接続すれば、この作業を1回の会話にまとめられます。このガイドでは、接続の設定方法、正しい認証方法、そしてライブの分析データに対して質問を始めるために必要なことを、具体的に解説します。
寄稿者
SaaS Hackers
簡単な答え:Google Analytics MCPサーバーを設定し、Claudeがプロパティのデータに直接アクセスできるようにすれば、ClaudeをGA4に接続できます。所要時間は20〜30分で、Google Cloudのサービスアカウント、有効化したGA4 Data API、ローカルのMCP設定ファイルが必要です。接続が完了すると、Claudeはクエリの実行、トレンドの抽出、ライブの分析データに基づく週次インサイトレポートの作成を行えます。
GA4からインサイトを得るには、たいていログインしてレポートをたどり、CSVをエクスポートし、数値の意味を読み解く必要があります。この作業は時間がかかり、つい後回しにしがちです。
MCP(Model Context Protocol)でClaudeをGA4に接続すると、この状況が変わります。Claudeに分析データへ直接アクセスさせ、普段使う言葉で質問できるようになります。このガイドでは、認証、最初のクエリの実行、B2B SaaSチーム向けに作成した週次インサイト用プロンプト集まで、設定の全体を解説します。
MCPとは何か、GA4でなぜ重要なのか
MCP(Model Context Protocol)は、Claudeのようなawait AIモデルを外部のデータソースやツールに接続するためのオープンスタンダードです。データをチャット画面にコピーする代わりに、Claudeがソースから直接読み取ります。
GA4の場合、MCPによってClaudeがリアルタイムで分析プロパティにクエリを実行できます。「先月、トライアル登録を最も多く獲得した流入チャネルはどれですか?」と尋ねると、汎用的なテンプレートではなく、実際のデータに基づく回答が返ってきます。
B2B SaaSチームにとって重要な理由:
- レポートを手作業でエクスポートする必要がなくなる
- アナリストでもそうでない人でも、すばやく答えを得られる
- Claudeが複数のディメンションにまたがるパターンを同時に見つけられる
- 週次レポートが、プロジェクトではなくプロンプトひとつになる
始める前に必要なもの
設定ファイルを触る前に、次のものを用意してください。
- データが流入しているGoogle Analytics 4プロパティ
- Google Cloudアカウント(無料枠で問題ありません)
- お使いのマシンにインストール済みのClaude Desktop
- インストール済みのNode.js(バージョン18以上)
- ターミナルのコマンド操作とJSONファイルの編集に慣れていること
Claude Desktopではなく、API経由でClaudeをご利用の場合は、MCPサーバーの設定方法が異なります。このガイドでは、Claude Desktopでの手順を説明します。
ステップ1:Google Cloudプロジェクトを作成する
- console.cloud.google.comにアクセスします
- 上部のプロジェクトを選択をクリックし、新しいプロジェクトを選びます
- 「Claude GA4 MCP」など、わかりやすい名前を付けます
- 作成をクリックし、プロジェクトの準備が整うまで待ちます
すでにGA4プロパティに接続されているGoogle Cloudプロジェクトがある場合は、それを使っても構いません。ただし、別のプロジェクトを作成すると権限を整理しやすくなります。
ステップ2:Google Analytics Data APIを有効にする
- 新しいプロジェクト内で、APIとサービス > ライブラリに移動します
- 「Google Analytics Data API」を検索します
- 検索結果をクリックし、有効にするを押します
これは、GA4のレポートデータにプログラムからアクセスするためのAPIです。有効化しないと、MCPサーバーはプロパティを読み取れません。
ステップ3:サービスアカウントを作成する
サービスアカウントは、MCPサーバーがGA4で認証するために使う、人間ではないGoogleのIDです。毎回のセッションでOAuthによる再認証が不要なため、ローカルツールにはこの方法が適しています。
- APIとサービス > 認証情報に移動します
- 認証情報を作成 > サービスアカウントをクリックします
- 「claude-ga4-reader」のような名前を付けます
- 作成して続行をクリックします
- ロールの手順では、ロールの追加をスキップします(アクセス権はGA4側で付与します)
- 完了をクリックします
次に、このサービスアカウントのキーを生成します。
- 一覧で、作成したサービスアカウントをクリックします
- キータブに移動します
- 鍵を追加 > 新しい鍵を作成をクリックします
- JSONを選択し、作成をクリックします
- JSONファイルがマシンにダウンロードされます。このファイルは認証情報そのものですので、安全に保管してください。
ステップ4:サービスアカウントにGA4プロパティへのアクセス権を付与する
サービスアカウントはGoogle Cloudには存在していますが、GA4はまだそれを認識していません。GA4内でユーザーとして追加する必要があります。
- analytics.google.comを開きます
- 管理 > プロパティのアクセス管理に移動します
- +ボタンをクリックし、ユーザーを追加を選択します
- サービスアカウントのメールアドレスを入力します(次のような形式です:
claude-ga4-reader@your-project.iam.gserviceaccount.com) - ロールを閲覧者に設定します
- 追加をクリックします
読み取り専用のクエリであれば、閲覧者権限で十分です。特別な理由がない限り、編集者や管理者の権限は付与しないでください。
ステップ5:GA4のプロパティIDを控える
MCPサーバーに接続先のプロパティを伝えるため、GA4のプロパティIDが必要です。
- GA4で、管理 > プロパティ設定に移動します
- 次の項目をコピーします: プロパティID (数値で、例:
123456789)
次の手順で使うので、手元に控えておいてください。
ステップ6:Google Analytics MCPサーバーをインストールする
ターミナルを開き、次のコマンドを実行します。
npm install -g @modelcontextprotocol/server-google-analyticsこのパッケージがお使いのnpmレジストリで利用できない場合は、多くのチームが使っているコミュニティ運営の選択肢として、insightfulpipe.comのものがあります。MCPのエコシステムは変化が速いため、正確なパッケージ名やバージョンの更新は、そちらでご確認ください。
別の方法として、ローカルのMCPサーバーを直接クローンして実行することもできます。
git clone https://github.com/[repo-name]/ga4-mcp-server
cd ga4-mcp-server
npm installステップ7:MCPサーバーを使うようにClaude Desktopを設定する
Claude Desktopは、設定ファイルを使って読み込むMCPサーバーを判断します。GA4サーバーを追加するには、このファイルを編集する必要があります。
設定ファイルの場所:
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
任意のテキストエディタでファイルを開きます。ファイルが存在しない場合は、新しく作成してください。
GA4 MCPサーバーの設定を追加します:
{
"mcpServers": {
"google-analytics": {
"command": "node",
"args": ["/path/to/your/ga4-mcp-server/index.js"],
"env": {
"GA4_PROPERTY_ID": "123456789",
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/service-account-key.json"
}
}
}
}プレースホルダーを置き換えます。
/path/to/your/ga4-mcp-server/index.jsサーバーファイルの実際のパス123456789実際のGA4プロパティID/path/to/your/service-account-key.jsonステップ3でダウンロードしたJSONキーのパス
ファイルを保存します。
ステップ8:Claude Desktopを再起動して接続をテストする
- Claude Desktopを完全に終了します(ウィンドウを閉じるだけでは不十分です)
- 再度起動します
- 画面上にツールまたはMCPのインジケーターが表示されていることを確認します(サーバーが読み込まれた証拠です)
簡単なプロンプトで接続をテストします。
"Using the GA4 MCP tool, show me sessions and users for the last 7 days."
Claudeがプロパティの実際の数値を返せば、接続は成功です。エラーが出た場合は、次の点を確認してください。
- 設定内のファイルパスが相対パスではなく、絶対パスになっている
- サービスアカウントのメールアドレスが、閲覧者権限でGA4に追加されている
- Google Analytics Data APIがCloudプロジェクトで有効になっている
- Claudeがコマンドを実行する際のパスから、Node.jsにアクセスできる
ClaudeでGA4の最初のクエリを実行する
接続が完了すると、普段使う言葉でClaudeにGA4クエリの実行を依頼できます。Claudeは依頼内容をGA4 Data APIの形式に変換してデータを取得し、整理した形で回答します。
まず試したい基本的なクエリ:
- 「先月のセッション数が多い上位10件のランディングページを教えてください」
- 「過去30日間の流入元別コンバージョン率を見せてください」
- 「第2四半期に最も多くのユーザーを送ってきた国はどこですか?」
- 「デバイスカテゴリ別の平均セッション時間を教えてください」
B2B SaaSに特化したクエリ:
- 「過去14日間にトライアル登録イベントを完了したユーザーは何人ですか?獲得チャネル別に内訳を教えてください」
- 「料金ページから登録ページまでの離脱率はどれくらいですか?」
- 「過去8週間のリピーターのセッションと新規ユーザーのセッションを、週ごとに比較して見せてください」
Claudeは、GA4の標準画面では扱いにくいディメンションと指標の組み合わせにも対応できます。流入元とエンゲージメント率のクロス集計や、2つの期間を並べた比較を依頼してみてください。オーガニック検索が自社の主要な成長チャネルである場合は、B2B SaaSのSEOエージェンシーと協業している先進的なSaaSチームの進め方と、自社のレポート作成フローを比較してみるのも有益です。
B2B SaaSチーム向けの週次インサイト用プロンプト
この連携の最も価値ある使い方のひとつは、手作業で行っていた週次の分析レビューを、構造化されたプロンプトのルーティンに置き換えることです。毎週月曜の朝に実行してください。
プロンプト1:トラフィックと獲得のサマリー
"Pull last week's sessions, new users, and returning users. Break sessions down by channel group. Compare to the previous week and flag any channel that changed by more than 15% in either direction."
プロンプト2:コンバージョンファネルの確認
"Show me the completion rate for [your key conversion event] last week versus the week before. Then show me the top 3 pages users visited before completing that event."
プロンプト3:コンテンツのパフォーマンス
"Which 5 pages had the highest engaged sessions last week? Which 5 had the lowest engagement rate with more than 100 sessions? Summarise what that pattern suggests."
プロンプト4:有料と自然流入の比較
"Compare sessions and conversion events from organic search versus paid search over the last 4 weeks. Show week-by-week. Identify the trend direction for each."
プロンプト5:異常検知
"Look at daily sessions for the last 30 days. Identify any days where sessions were more than 20% above or below the 30-day average. List the dates and the percentage deviation."
これらをテキストファイルまたはClaude Projectのプロンプトとして保存しておきましょう。5つすべてを実行しても5分もかからず、GA4を一度も開かずに、週の全体像を把握できます。こうしたインサイトをより広範なデマンドジェネレーション計画につなげたい場合は、B2B SaaSのPerformance Marketingエージェンシー、B2B SaaSのPPCエージェンシー、B2B SaaSのコンテンツマーケティングエージェンシーのアプローチを比較してみるのも役立つでしょう。
よくある設定エラーと対処法
エラー:「MCP server failed to start」
次のファイルパスが正しく、かつ絶対パスであることを確認してください: claude_desktop_config.json 相対パスは使えません。
エラー:「Permission denied on GA4 property」
サービスアカウントのメールアドレスがGA4に追加されていないか、誤ったプロパティに追加されています。メールアドレスが完全に一致しているか、あらためて確認してください。
エラー:「Google Analytics Data API not enabled」
Google Cloud Consoleに戻り、正しいプロジェクトでAPIが有効になっているかを確認してください。サービスアカウントとAPIは、同じプロジェクト内にある必要があります。
エラー:「Invalid property ID」
使っているのが、GA4の管理画面にある数値のプロパティIDであり、測定ID(G-で始まるもの)ではないことを確認してください。
よくある質問
ClaudeのGoogle Analytics MCPサーバーとは?
Google Analytics MCPサーバーは、Google Analytics Data API経由でClaude DesktopをGA4プロパティに接続するローカルプロセスです。Model Context Protocolの標準を採用しているため、Claudeは分析データを直接読み取り、手動でデータをエクスポートしなくても質問に答えられます。
Claude を GA4 に接続するのに、コーディングスキルは必要ですか?
ターミナルのコマンド操作と JSON ファイルの編集に、基本的に慣れていれば問題ありません。コードを書く必要はありませんが、npm コマンドの実行、Google Cloud でのサービスアカウントの作成、設定ファイルの編集は必要です。技術的なバックグラウンドが多少ある B2B SaaS の運用担当者であれば、ほとんどの方が30分以内に完了できます。
Claude を GA4 のデータに接続しても安全ですか?
はい、正しく設定すれば安全です。サービスアカウントには読み取り専用の Viewer 権限が付与されるため、Claude が GA4 プロパティやデータを変更することはできません。認証情報は、設定ファイル内に保存され、お使いのローカルマシンの外には出ません。サービスアカウントの JSON キーを公開リポジトリにコミットしないでください。
Claude Desktop ではなく、API 経由で Claude と一緒に使うことはできますか?
ここで説明している MCP サーバーの方法は、Claude Desktop 向けです。Claude API を直接使う場合は、自社アプリケーション内でツール呼び出しの結果として GA4 のデータを渡すことができますが、上記の設定ファイルによる方法ではなく、独自の開発が必要になります。
Windsor.ai で GA4 を Claude に接続する方法とは、どう違いますか?
Windsor.ai はノーコードのコネクターで、ローカルでの設定なしに GA4 のデータを Claude に同期できます。ここで説明している MCP の方法はローカルで動作し、Claude がアクセスするデータをより細かく管理でき、有料のサードパーティサービスも不要です。その代わり、MCP は初期設定に時間がかかります。
MCP を通じて、Claude は GA4 のどのデータにアクセスできますか?
Claude は、GA4 Data API で利用できるあらゆるデータにアクセスできます。セッション、ユーザー、イベント、コンバージョン、エンゲージメント指標、流入元、ページ単位のデータ、プロパティで設定したカスタムディメンションやカスタムイベントなどが含まれます。この方法では、BigQuery エクスポートのイベント単位の生データにはアクセスできません。
寄稿者
SaaS Hackers


