ガイド・MCP

GA4 MCPの設定方法と、試してわかった制限

Google公式のGoogle Analytics MCPサーバーを実際に入れて、質問する前に何が起きるかを測りました。

先に結論

GA4 MCP(Google公式のGoogle Analytics MCPサーバー)は無料で、読み取り専用です。Claude Desktop、Claude Code、Cursorのように自分のパソコンで動くアプリではよく動きます。使い始める前に、手順が5つあります。Python、2つのAPIを有効にしたGoogle Cloudプロジェクト、gcloudコマンド、正しいスコープでのログイン、絶対パスで書いた設定ファイルです。

claude.aiやChatGPTのWeb版では、自分でサーバーを公開しない限り使えません。また、10個のツールの定義だけで約57.9KB、およそ1万4,000トークンが、最初の質問の前に会話へ読み込まれます。

ツールごとの定義の大きさ

AIアプリは、最初の質問の前に各ツールの定義を読みます。バージョン1.1.0、読み取り専用モードで測った大きさです。

ツールバイト数
run_realtime_report15,769
run_conversions_report14,884
run_report14,764
run_funnel_report8,817
list_property_annotations835
list_key_events775
get_custom_dimensions_and_metrics598
list_google_ads_links583
get_property_details550
get_account_summaries273
10個の合計57,868

レポートを作る4つのツールが全体の94%を占めます。ディメンション、指標、フィルターについてのGoogleの説明をそれぞれが丸ごと持っているためです。AIが正しいレポートを書けるのは、この説明があるからです。必要なときだけ定義を読み込むアプリもあるので、実際の負担は使うアプリによって変わります。

GA4 MCPの設定手順

Googleの開発者向けガイドとGitHubのREADMEにある手順を、必要になる順に並べました。

  1. Python 3.10以上とpipxを入れます。サーバーは analytics-mcp というPythonパッケージです。テストではインストールに約17秒、起動に約2秒でした。
  2. Google Cloudプロジェクトで2つのAPIを有効にします。Google Analytics Admin APIとGoogle Analytics Data APIです。Google Cloudを使ったことがなければ、ここでプロジェクトを作ります。
    gcloud services enable analyticsadmin.googleapis.com analyticsdata.googleapis.com --project=YOUR_PROJECT_ID
  3. 読み取り専用のスコープでログインします。gcloudコマンドが必要です。READMEでは、同じCloudプロジェクトで作った自分のOAuthクライアントのファイルも渡します。
    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
    表示される認証情報のパスを控えておきます。
  4. GA4の権限を確認します。ログインしたGoogleアカウントに、対象プロパティの閲覧者以上の権限が必要です。
  5. AIアプリに追加します。Claude Codeの場合は次のとおりです。
    claude mcp add analytics-mcp --scope user -e GOOGLE_APPLICATION_CREDENTIALS=PATH_TO_CREDENTIALS_JSON -e GOOGLE_CLOUD_PROJECT=YOUR_PROJECT_ID -- pipx run analytics-mcp
    デスクトップアプリでは、パスを省略せずに書きます。設定ファイルの ~ や $HOME を展開しないアプリが多いためです。

テストでつまずいたところ

Googleにログインしていないパソコンでサーバーを起動しました。サーバーは普通に起動し、10個のツールをすべて表示し、接続済みに見えました。失敗がわかったのは、AIが最初の質問をしたときです。返ってきたのは、認証情報が見つからないというエラーでした。

つまり、AIアプリに「接続済み」と出ていても、動くとは限りません。設定が終わったら、「GA4のプロパティを一覧にして」のような簡単な質問をすぐに1つ試してください。403エラーが出る場合、Googleのチェックリストは原因を3つ挙げています。APIが有効になっていない、ログイン時のスコープが足りない、プロパティの閲覧者権限がない、のどれかです。

発注元や上司に「つながりました」と報告する前に、この1問を確かめておくと安心です。

制限

Cloudプロジェクトなしで使いたい場合

Googleのサーバーが向いているのは、GA4のどんなレポートでも出したい人、Claude Desktop、Claude Code、Cursorを使っている人、Google Cloudに慣れている人です。

もう1つの方法が、Harvvのコネクタ(harvv.com/mcp)です。Googleのログインで一度だけGA4をつなぐと(読み取り専用)、claude.ai、ChatGPT、デスクトップアプリのどれでも使えます。Harvvは決まった種類のGA4レポート(イベントとキーイベント、流入元とキャンペーン別のセッションと収益、ランディングページ)を毎日取り込み、Harvvのタグがページ上で記録した訪問者の行動と並べます。そのため、AIは「何件か」だけでなく「なぜこのページのコンバージョンが落ちたのか」に答えられます。思いつくレポートを何でも出せるわけではありません。それが必要なら、Googleのサーバーを使ってください。

Harvvの無料プランは3サイトまでです。くわしくはHarvvの紹介ページをご覧ください。Search Console、Google広告、Meta広告の公式サーバーについては、マーケティング向けMCPサーバーの一覧(英語)にまとめています。

テストの方法

2026年11月11日、Python 3.14を入れたMacで行いました。analytics-mcp 1.1.0をPyPIから新しい仮想環境に入れ、MCPで直接やり取りしました。起動、ツールの一覧、ツールを1つ呼び出す、の順です。

大きさは、サーバーが送ってきた各ツール定義のJSONのバイト数です。トークン数は1トークンを約4文字として見積もり、千の位で切り捨てました。

ログインがない場合にどう見えるかを確かめるため、わざとGoogleの認証情報なしで動かしました。このテストでは、Googleへのログインは完了していません。設定手順と割り当ては、同じ日に読んだGoogleのページによります。

よくある質問

Google公式のGoogle Analytics MCPサーバーはありますか?

あります。GoogleがGitHub(googleanalytics/google-analytics-mcp)とPyPI(analytics-mcp)で公開しています。自分のパソコンで動き、GoogleのAdmin APIとData APIを通じてGA4を読みます。--allow-write を付けて起動しない限り、読み取り専用です。2026年11月に試したバージョン1.1.0には、ツールが10個ありました。

GA4 MCPはclaude.aiやChatGPTで使えますか?

そのままでは使えません。公式サーバーは自分のパソコンで動き、Claude Desktop、Claude Code、Cursorのような同じパソコン上のアプリとやり取りします。claude.aiやChatGPTのようなWebアプリには、インターネット上のサーバーが必要です。HTTPモードがあるので、Google Cloud Runなどで自分で公開することはできます。

GA4 MCPがGA4の設定を変えることはありますか?

初期設定では変えません。analytics.readonly のスコープを求め、読み取りのツールだけを出します。書き込みのツール(アノテーション、キーイベント、カスタムディメンション)は、--allow-write を付けて起動し、analytics.edit のスコープを許可したときだけ現れます。

あわせて読む:デッドクリックとは?原因と直し方、外部送信規律とは?対象サイトと公表文の書き方、Microsoft Clarityとは?できること・できないこと。

自分のサイトで確かめる

Harvvはタグを1行入れるだけで、訪問者が実際に何をしたかを記録します。無料プランがあり、クレジットカードは不要です。管理画面とレポートは現在英語です。

無料で始めるHarvvについて(日本語)

この記事の作り方。英語版の記事(2026年11月11日公開)をもとに、AIアシスタントで日本語の下書きを作りました。測定値は英語版と同じ2026年11月11日のテストによるもので、設定手順と上限はGoogleの公開ページによります。日本語の表現は、日本語を母語とする担当者による確認の前です。

Read this article in English