この記事の目次
この手順の対象と完了条件1．利用許可と分析の前提をそろえる2．Pythonとpipxを準備する3．APIとOAuthクライアントを準備する4．ADC認証を作る5．クライアントへ登録し、小さく試す接続できないときの確認順完了記録と出典この手順の対象と完了条件
対象はWindowsでGoogle公式のローカルAnalytics MCPを使う担当者です。MCPはAIがツールを呼び出すための接続方法で、イベント計測を新たに作る仕組みではありません。未計測の問い合わせを接続だけで取得することはできません。
公式資料を照合した設定ガイドです。編集部による実GA4アカウントへの接続・第三者再現は未実施です。 Googleはこのサーバーを実験的なプロジェクトとして提供しています。バージョンや画面が変わった場合は、末尾の公式資料と照合してください。
完了は「起動した」だけではありません。対象プロパティの名前とIDが一致し、日付を指定したレポートが取得でき、その条件と数値を記録できた状態です。ClaudeまたはGeminiのどちらか一方の接続記事まで進めて確認します。
1．利用許可と分析の前提をそろえる
最初に前提条件シートを用意します。事業の目的、指標、比較期間、計測変更、回答ルールが未確認なら、その項目を未確認のまま明示します。
| 用意するもの | 確認する場所・判断 |
|---|---|
| 対象GA4プロパティの閲覧権限 | GA4管理画面で対象が見えること。管理者権限を一律に付与する必要はありません |
| 数値のプロパティID | GA4の管理→プロパティの詳細。G-から始まる測定IDとは別です |
| Google Cloudプロジェクト | API有効化とOAuth設定を行える担当者を決める |
| データのAI送信許可 | 会社の契約・データ利用規則で、このAIと集計データの送信が許可されていること |
| 実行環境 | Python 3.10以上、pipx、Google Cloud CLI、選択するMCPクライアント |
AIとの契約やCloud側の利用条件は別途確認します。この記事は料金が無料であることを保証するものではありません。個人名・メール・ユーザーID・URLの機密パラメータは分析対象に含めません。
2．Pythonとpipxを準備する
PythonとGoogle Cloud CLIを公式手順で導入します。PowerShellを開き、次を一行ずつ実行します。組織管理PCでは許可された導入方法を優先してください。
py --version
py -m pip install --user pipx
py -m pipx ensurepath
PowerShellを閉じて開き直し、次を確認します。
pipx --version
gcloud --version
(Get-Command pipx).Source
最後に表示されるpipxの絶対パスはクライアント設定に使います。コマンドが見つからなければ、まずPATH反映とインストール先を確認します。エラーのまま次の工程へ進みません。Analytics MCPはクライアント起動時にpipx run analytics-mcpで取得・起動する構成です。初回はネットワーク接続が必要です。
3．APIとOAuthクライアントを準備する
- Google Cloudコンソールで使用するプロジェクトを選び、プロジェクトIDを控えます。
- 「APIとサービス」→「ライブラリ」でGoogle Analytics Admin APIとGoogle Analytics Data APIをそれぞれ探して有効化します。
- Google Auth Platformでアプリのブランド情報、対象ユーザー、必要なデータアクセスを設定します。外部・テスト状態なら認証するGoogleアカウントをテストユーザーに登録します。組織の管理者が設定を担当する場合は、ここまでを依頼します。
- OAuthクライアントをデスクトップアプリとして作成し、クライアントJSONをダウンロードします。公開サイトのフォルダへ保存しないでください。
画面が異なる場合はOAuthクライアントの公式手順で確認します。ここで取得するクライアントJSONと、次に作るADC認証ファイルは別物です。
4．ADC認証を作る
次は記入例です。YOUR_PROJECT_IDとE:/private/oauth-client.jsonを自分の値へ置き換えます。後者は手順3で保存したファイルです。コマンドは1行ずつ実行します。
gcloud config set project YOUR_PROJECT_ID
gcloud auth application-default login --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform --client-id-file="E:/private/oauth-client.json"
開いた認証画面では、対象GA4を閲覧できるアカウントを選びます。成功時に出る「Credentials saved to file」の保存先を控えます。クライアントへ渡すのはこちらのADCファイルのパスです。中身をAIへ貼り付けません。 認証に失敗したら、OAuthの対象ユーザー、アカウント、組織の制限を確認します。
この読み取りスコープはGA4設定変更の許可ではありません。一方でAIに渡したデータの利用条件は別問題なので、読み取り専用という理由だけで社内承認を省略しません。
5．クライアントへ登録し、小さく試す
次のどちらかへ進みます。Claude Desktopの登録手順とGemini CLIの登録手順は選択肢であり、両方の導入は不要です。
GA4の分析前に接続先だけ確認してください。
get_account_summariesで閲覧可能な一覧を取得し、
私が指定したプロパティIDと一致する名前・IDだけを示してください。
別プロパティのデータ取得や設定変更は依頼していません。
対象を人が確認するまで分析を始めないでください。
その後、確定済みの7日間、指標sessions、ディメンションなしで1件の合計を要求します。出力に取得日、対象ID、開始・終了日、指標名を添えさせます。接続確認後は最初の分析の照合へ進みます。
接続できないときの確認順
| 症状 | 最初に確認すること | 再試行の条件 |
|---|---|---|
| サーバーが起動しない | pipxの絶対パス、Pythonの版、ネットワーク | PowerShellでpipxの版を表示できる |
| 認証ファイルが見つからない | ADCとクライアントJSONの取り違え、JSONのパス表記 | 対象ファイルがローカルに存在する |
| 403・権限エラー | GA4閲覧権限、API有効化、認証アカウント、quota projectに関するエラー本文 | 不足権限を管理者が確認。権限を闇雲に増やさない |
| invalid_grant | 認証の失効・取消・OAuthテスト状態 | 同じ手順で再認証し、クライアントを再起動 |
| 0件・プロパティ不一致 | 対象ID、期間、データの有無 | 正しいIDと期間を人が確認 |
ログを共有する際もトークンとファイル内の認証情報を除外します。利用終了時はクライアントのサーバー設定を削除し、不要になったADCはgcloud auth application-default revokeで取り消します。他のアプリが同じADCを使っている場合は担当者と調整します。
完了記録と出典
記録する項目はOS、Python・pipx・クライアントの版、MCPの利用版、確認日、プロパティID、取得条件、結果、未解決エラーです。秘密情報を記録する欄は作りません。サーバー更新後も同じ小さな取得で確認します。
確認日：2026年10月4日。小さく取得して条件を記録する流れと完了基準は編集上の提案です。
制作：AI支援による構成・原稿作成。公式資料照合済み。実GA4アカウントへの接続、実務者監修、第三者再現は未実施です。教材の数値は架空例です。 公式資料確認日：2026年10月4日。次回確認予定：2027年1月4日。
