GA4 MCPサーバーの設定方法【Claude Code・Gemini CLI対応】

Google公式のGA4 MCPサーバーを設定すれば、Claude CodeやGemini CLIから自然言語でGA4のデータを取得・分析できるようになります。

「昨日のセッション数は？」「過去30日で最もPVが多いページは？」といった質問を投げるだけで、GA4の管理画面を開かずにデータを取得できます。

ただしセットアップにはGoogle Cloudプロジェクトの作成やAPI認証の設定が必要で、非エンジニアにはハードルが高い部分もあります。

この記事では、つまずきやすいポイントを補足しながら、設定完了までの手順を順を追って解説します。

＼ GA4 × サーチコンソールを一元管理 ／

inSite（インサイト）

GA4やサーチコンソールのデータをわざわざ確認しに行く手間を削減。サイト内のページ情報を自動収集し、検索パフォーマンスやインデックス状態を一元管理できます。

MCP連携でAIからデータを取得する環境を作ったら、日常の監視はinSiteで自動化しましょう。

無料で試してみる ↗

GA4 MCPサーバーとは

GA4 MCPサーバーとは、Google Analytics 4のデータをMCP（Model Context Protocol）経由でAIツールに接続するためのサーバーです。

Googleが公式にオープンソースとして公開しており、GitHubスター数は1,400超（2026年3月時点）。Claude Code、Gemini CLI、Cursorなど、MCPに対応したAIツールから利用できます。

Google公式のMCPページでは以下のように紹介されています。

The Google Analytics Model Context Protocol (MCP) server lets you connect your Analytics data to an LLM, like Gemini. You can use the MCP server to chat with your data, build custom agents with access to your data, and more.

Google for Developers - Try the Google Analytics MCP server

できること・できないこと

提供されるツール一覧

MCPサーバーが提供するツール（関数）は以下の5つです。

セットアップの全体像

設定は大きく3ステップです。

所要時間は15〜30分程度です。Google Cloudプロジェクトを既に持っている場合はもっと短くなります。

STEP 1：Google Cloud プロジェクトの準備

1-1. プロジェクトの作成

Google Cloud Consoleにアクセスし、新規プロジェクトを作成します（既存プロジェクトを使う場合はスキップ）。

プロジェクト名は任意ですが、ga4-mcp など用途がわかる名前にしておくと管理しやすいです。

1-2. APIの有効化

以下の2つのAPIを有効にします。

Google Cloud Consoleの「APIとサービス」→「APIとサービスの有効化」から検索して有効化できます。

gcloud CLIがインストール済みなら、以下のコマンドでも有効化できます。

gcloud services enable analyticsadmin.googleapis.com analyticsdata.googleapis.com

1-3. OAuthクライアントの作成

ADC（Application Default Credentials）認証を使うため、OAuthクライアントIDを作成します。

STEP 2：認証情報（ADC）の設定

gcloud CLIのインストール

Google Cloud CLIをインストールし、初期設定を行います。

gcloud init

プロジェクトの選択では、STEP 1で作成したプロジェクトを選びます。

ADC認証の実行

ダウンロードしたOAuthクライアントのJSONファイルを使って、ADC認証を実行します。

gcloud auth application-default login \
  --scopes https://www.googleapis.com/auth/analytics.readonly,https://www.googleapis.com/auth/cloud-platform \
  --client-id-file=YOUR_CLIENT_JSON_FILE

YOUR_CLIENT_JSON_FILE は、STEP 1-3でダウンロードしたJSONファイルのパスに置き換えてください。

実行するとブラウザが開き、Googleアカウントの認証画面が表示されます。GA4にアクセス権限があるアカウントでログインしてください。

認証が完了すると、ターミナルに認証情報ファイルのパスが表示されます。このパスを次のステップで使うので、コピーしておきましょう。

Credentials saved to file: [PATH_TO_CREDENTIALS_JSON]

Windowsの場合、通常は C:\Users\ユーザー名\AppData\Roaming\gcloud\application_default_credentials.json に保存されます。

inSite

ADC（Application Default Credentials）は、自分のGoogleアカウントの権限をローカル環境で使う仕組みです。サービスアカウントキーのような機密ファイルを管理する必要がなく、個人利用であればこちらが推奨されています。

STEP 3：MCPクライアントへの設定追加

Claude Codeの場合

Claude Codeでは、プロジェクトルートの .mcp.json またはホームディレクトリの ~/.claude.json にMCPサーバーの設定を追加します。

プロジェクト単位で設定する場合（.mcp.json）：

{
  "mcpServers": {
    "google-analytics": {
      "command": "pipx",
      "args": [
        "run",
        "analytics-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}

設定後、Claude Codeを再起動すると google-analytics のMCPサーバーが認識されます。

Gemini CLIの場合

Gemini CLIでは ~/.gemini/settings.json に設定を追加します。

{
  "mcpServers": {
    "analytics-mcp": {
      "command": "pipx",
      "args": [
        "run",
        "analytics-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "PATH_TO_CREDENTIALS_JSON",
        "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}

設定後、Gemini CLIを起動して /mcp コマンドを実行すると、analytics-mcp がリストに表示されます。

動作確認

MCPサーバーが正しく接続されたら、以下のようなプロンプトで動作を確認しましょう。

GA4のアカウント一覧を取得してください

初回実行時にはプロパティの選択を求められる場合があります。プロパティIDがわからない場合は、GA4管理画面の「管理」→「プロパティの詳細」で確認できます（123456789 のような数字の文字列です）。

レスポンスが返ってくれば設定完了です。

SEO担当者向け活用プロンプト集

GA4 MCPサーバーは自然言語でデータを取得できるため、GA4の操作に慣れていなくても分析が可能です。

基本的なデータ取得

SEO分析向け

サーチコンソール MCPとの併用

GA4 MCPサーバーとサーチコンソールのMCPサーバー（mcp-server-gsc）を併用すれば、検索パフォーマンスとサイト内行動の両方をAIで一括分析できます。設定方法は以下の記事で解説しています。

サーチコンソールで過去28日のクエリデータを取得して、
CTRが低い（3%未満）のにインプレッションが多い（1000以上）キーワードを
GA4のランディングページデータと突き合わせて改善候補を提案して

トラブルシューティング

「Permission denied」エラーが出る

ADC認証に使用したGoogleアカウントにGA4の閲覧権限がない可能性があります。GA4の管理画面で「管理」→「プロパティのアクセス管理」から、該当アカウントに「閲覧者」以上のロールが付与されているか確認してください。

「API not enabled」エラーが出る

Google Analytics Admin APIまたはData APIが有効化されていません。STEP 1-2に戻り、APIを有効化してください。

MCPサーバーが認識されない

「Quota exceeded」エラーが出る

GA4 Data APIにはレート制限があります。短時間に大量のリクエストを送ると制限に引っかかる場合があります。数分待ってから再試行してください。

サービスアカウント方式での設定（上級者向け）

ADC方式はブラウザ認証が必要なため、CI/CDパイプラインや複数プロジェクトでの共有には向きません。そのような場合はサービスアカウント方式を使います。

サービスアカウントの作成

GA4でのアクセス権限付与

MCP設定

{
  "mcpServers": {
    "google-analytics": {
      "command": "pipx",
      "args": [
        "run",
        "analytics-mcp"
      ],
      "env": {
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/service-account-key.json",
        "GOOGLE_CLOUD_PROJECT": "YOUR_PROJECT_ID"
      }
    }
  }
}

よくある質問

まとめ

GA4 MCPサーバーを活用すれば、GA4の管理画面を開かずに自然言語でデータにアクセスできます。サーチコンソールのMCPサーバーと併用すれば、検索データ × サイト行動データの統合分析も可能です。

Claude codeを使ったSEO記事の作成方法は、以下の記事で解説しています。

＼ GA4 × サーチコンソールを一元管理 ／

inSite（インサイト）

MCPでGA4データにAIからアクセスできる環境を作ったら、日常の監視はinSiteで自動化。サイト内のページ情報を自動収集し、検索パフォーマンスやインデックス状態を一元管理できます。

ムダな管理の時間を、ほぼゼロに。今すぐサイト管理を自動化しましょう。

無料で試してみる ↗