先に結論
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_report | 15,769 |
run_conversions_report | 14,884 |
run_report | 14,764 |
run_funnel_report | 8,817 |
list_property_annotations | 835 |
list_key_events | 775 |
get_custom_dimensions_and_metrics | 598 |
list_google_ads_links | 583 |
get_property_details | 550 |
get_account_summaries | 273 |
| 10個の合計 | 57,868 |
レポートを作る4つのツールが全体の94%を占めます。ディメンション、指標、フィルターについてのGoogleの説明をそれぞれが丸ごと持っているためです。AIが正しいレポートを書けるのは、この説明があるからです。必要なときだけ定義を読み込むアプリもあるので、実際の負担は使うアプリによって変わります。
GA4 MCPの設定手順
Googleの開発者向けガイドとGitHubのREADMEにある手順を、必要になる順に並べました。
- Python 3.10以上とpipxを入れます。サーバーは
analytics-mcpというPythonパッケージです。テストではインストールに約17秒、起動に約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 - 読み取り専用のスコープでログインします。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 - GA4の権限を確認します。ログインしたGoogleアカウントに、対象プロパティの閲覧者以上の権限が必要です。
- 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問を確かめておくと安心です。
制限
- 自分のパソコンで動きます。claude.aiやChatGPTのWeb版からは届きません。ログイン付きのHTTPモードがあり、Google Cloud Runなどで公開できますが、その場合はサーバーを自分で運用することになります。
- Googleの割り当てはそのままかかります。標準のGA4プロパティは1日20万、1時間4万の割り当てトークンを持ち、1つのCloudプロジェクトが1つのプロパティに使えるのは1時間1万4,000までです(Googleの割り当てのページ)。これはGoogle側のトークンで、AIのトークンとは別です。質問の多い午後には、1時間の上限に当たることがあります。
- わかるのはGA4が知っていることだけです。セッション、イベント、キーイベント、流入元、ページです。訪問者がどこをクリックしたか、何を見つけられなかったか、GA4が人として数えた訪問がボットだったかどうかは、わかりません。
- 初期設定は読み取り専用です。安全のためです。アノテーションやキーイベントを追加するには、
--allow-writeを付けて起動し、analytics.editのスコープでログインし直します。
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の公開ページによります。日本語の表現は、日本語を母語とする担当者による確認の前です。