Google Analytics
Claude Codeに渡せる権限の範囲と、つなぎ方を、公式の資料から読み取れる範囲でまとめました。
← ラボ / Claude Code ガイド / 連携台帳
Google・ノーコード・分析・海外 公式サイト
ウェブサイト・アプリのトラフィックを計測・分析するGoogleのサービス。GA4向けにData API(レポート取得)とAdmin API(設定の作成・変更・削除)があり、GitHubに公式のMCPサーバー(実験的)が公開されている。
Claude Codeに、どこまで権限を渡せるか
- 読み取り専用で渡せるか あり
- 公式MCPのREADMEに、認証情報はGoogle Analytics read-only scope(https://www.googleapis.com/auth/analytics.readonly)を含む必要があると記載。ツールは7つ(アカウント・プロパティ情報、Google広告リンク、レポート、ファネル、リアルタイム、カスタムディメンション・指標)で書き込みツールの記載なし。READMEはサーバー全体を『読み取り専用』とは明記していない。サンプルのgcloudコマンドには cloud-platform スコープも含まれる。https://github.com/googleanalytics/google-analytics-mcp
- 権限(スコープ)を選べるか あり
- MCPは analytics.readonly スコープの認証情報で使う。Admin APIのプロパティ削除は analytics.edit スコープ(properties.delete のリファレンス)。GAのユーザーロールでも権限を絞れる(前回調査の記載、今回は再確認していない)。
- 危険な操作の既定
- 公式MCPは参照系ツールのみで、危険操作のツールの記載なし。Admin APIの削除に確認ステップの記載なし(制御の記載なし)。
- 削除ができるか できる
- 【API】Admin APIの properties.delete は「soft-deleted(trashed)」にする。APIでは復元できず、ごみ箱(Trash Can UI)から復元できる。期限までに復元しないとプロパティと子リソースは完全に削除される(保持日数はそのページに記載なし)。https://developers.google.com/analytics/devguides/config/admin/v1/rest/v1beta/properties/delete 公式MCPに削除ツールの記載なし。
- 取り消し方(キー・接続)
- 公式MCPが使うADC(アプリケーションのデフォルト認証情報)は `gcloud auth application-default revoke` で失効できる(gcloud auth application-default login で作った認証情報を取り消し、ローカルの認証情報ファイルを削除する。別の方法で設定した認証情報には影響しない、とリファレンスにある)。Googleアカウントに連携したアプリのアクセスは https://myaccount.google.com/linkedapps?filters=3 から削除でき、削除後はアプリがデータにアクセスできなくなる(Googleアカウントヘルプ)。(根拠: https://docs.cloud.google.com/sdk/gcloud/reference/auth/application-default/revoke)
つなぎ方(公式の資料にある範囲)
公式MCP あり
googleanalytics組織のリポジトリ「Google Analytics MCP Server (Experimental)」。ツール:get_account_summaries、get_property_details、list_google_ads_links、run_report、run_funnel_report、get_custom_dimensions_and_metrics、run_realtime_report(いずれもアカウント情報の参照とレポート取得)。認証情報にはスコープ https://www.googleapis.com/auth/analytics.readonly が必要と記載。ライセンスApache-2.0。 googleanalytics組織の一覧ページの表示では google-analytics-mcp は Python/Apache-2.0、最終更新 2026-07-27(組織の36リポジトリのうち最初の10件のみ表示)。リポジトリ自体のReleasesは0件。
つなぎ方(公式の記載)
READMEの案内:claude mcp add analytics-mcp --scope user に、-e で GOOGLE_APPLICATION_CREDENTIALS とプロジェクトIDの環境変数を渡し、-- pipx run analytics-mcp を付ける(READMEのClaude Code向けコマンド例は GOOGLE_APPLICATION_CREDENTIALS と GOOGLE_PROJECT_ID。Gemini向けの説明文は GOOGLE_CLOUD_PROJECT を勧めており、表記が揺れている)。認証はADC(gcloud auth application-default login)。
公式CLI 記載なし
Google Analytics 専用のコマンドラインツールは、開発者向けトップ(developers.google.com/analytics)と、googleanalytics GitHub 組織の全リポジトリ(page1の30件とpage2の6件、計36件)に見当たらない。リポジトリはサンプル、クライアント、MCPサーバー(google-analytics-mcp)、アーカイブ済みのものなど。gcloud はMCPのREADMEが認証に使う記載のみ。
公式API あり
Google Analytics Data API v1(レポートデータへのプログラム的アクセス。runReport、runRealtimeReport、オーディエンスエクスポート等)と、Admin API v1(設定データへのアクセス)。Admin APIには properties.create / patch / delete(Beta)、dataStreams.create / patch / delete(Beta)、accessBindings の create / patch / delete(Alpha)がある。ユニバーサルアナリティクスのプロパティには非対応。
第三者製MCP(公式ではない) 2件
- analytics(ai.mcpanalytics/analytics)(作者: embeddedlayers(GitHub)・最終更新: 2026-03-27(公式MCPレジストリの公開日、バージョン1.0.5))
書き込み・削除: レジストリの説明は「Analytics for business data: upload CSV or connect GA4/GSC, run ML/stats, get HTML reports.」。GAへの書き込み・削除の可否はREADME未読で未確認。
GA4/Search Console接続。READMEは未読。
https://github.com/embeddedlayers/mcp-analytics - google-analytics-mcp(surendranb)(作者: surendranb(掲載ページの表記))
書き込み・削除: 未確認(READMEを読んでいない)
検索結果に出た第三者のレジストリ掲載ページのURL。GitHubの元リポジトリのURL・更新日は確認していない。
https://glama.ai/mcp/servers/surendranb/google-analytics-mcp
第三者製のMCPは、サービスの運営元が作ったものではありません。作者と中身を確かめてから使うかどうかを決めてください。ここに載せているのは、公式のレジストリやGitHubで見つかったものを、書かれている範囲でまとめたもので、おすすめではありません。
探した場所(2件)
- https://registry.modelcontextprotocol.io/v0/servers?search=analytics&limit=15
- WebSearch(Google Analytics MCP server)
できる操作
読み取りでできる操作
- 【MCP】アカウント/プロパティ情報の参照、Google広告リンク一覧、標準レポート、ファネルレポート、リアルタイムレポート、カスタムディメンション・指標の取得
- 【API】Data API v1でレポートデータの取得(runReport、runRealtimeReport等)
書き込みでできる操作
- 【API】Admin API v1でプロパティ・データストリームの作成と更新(Beta)、アクセス権バインディングの作成と更新(Alpha)
- 【MCP】公式MCPの書き込みツールは記載なし(ツール一覧は参照・レポート取得のみ)
管理者操作(削除・課金・設定変更など)
- 【API】Admin API v1でプロパティの削除(properties.delete は「soft-deleted(trashed)」にする。認可スコープは https://www.googleapis.com/auth/analytics.edit)、データストリームの削除(dataStreams.delete)、アクセス権バインディングの削除(Alpha)
- 【MCP】公式MCPには管理者操作のツール記載なし
制限
- MCPはREADMEのタイトルが「Experimental」(実験的)
- Admin APIのプロパティ・データストリーム操作はBeta、アクセス権バインディングはAlpha(「early preview stage」)
- Data API・Admin APIはユニバーサルアナリティクスのプロパティには非対応(GA4のみ)
- 割り当て(クォータ)の数値は読んだページに記載なし
- 公式MCPは参照系ツールのみだが、レポートの内容(アクセス解析データ)が外部のAIに渡る
- Admin API(公式MCP外)でプロパティ・データストリームを削除できる。properties.delete のリファレンスには、プロパティを soft-deleted(trashed)にし、APIでは復元できないがごみ箱(Trash Can UI)から復元できる、期限までに復元しないとプロパティと子リソースは完全に削除される、と記載(日数はそのページになし)。dataStreams.delete とアクセス権バインディングの削除の復元は確認していない
- GAの閲覧者ロールは完全な読み取り専用ではなく、レポートの表示データの変更や自分のexplorationの作成・編集・削除ができると記載。読み取り専用はMCPの analytics.readonly スコープで担保する形
- 環境変数名がREADMEの本文と例で揺れている(GOOGLE_CLOUD_PROJECT / GOOGLE_PROJECT_ID)
認証・料金・日本語・実機検証
- 認証方式
- MCP:Application Default Credentials(gcloud auth application-default login。ユーザー認証情報+OAuthクライアントJSON、またはサービスアカウントの権限借用)。使うGoogleアカウントは対象のGAアカウント/プロパティへのアクセス権が必要。
- 公表されている料金(2026年10月16日確認)
- GA(無料版)は公式のアナリティクス製品ページに「free of charge」と記載。Analytics 360 の価格は読んだページに記載なし。日本語ヘルプに「Google アナリティクス 360」の項目があることは確認(2026年10月16日確認)。 料金ページ
- 日本語対応
- あり。日本語のヘルプセンター(support.google.com/analytics/?hl=ja、「アナリティクス ヘルプ」)がある。管理画面の日本語表示は確認していない。API・MCPのドキュメント(開発者向け・GitHub)は英語を読んだ。
- Claude Code実機検証
- 未検証(この台帳は、動かして確かめた記録ではありません。Akiraが試したときは、検証日つきで書き換えます)
確認できていない点(10件)
- Analytics 360 の価格
- Data APIの認可スコープ名、Admin APIのうち properties.delete 以外のスコープ名、クォータ
- 削除したプロパティの復元期限の日数、データストリーム・アクセス権バインディングの削除の復元可否、アカウントの削除
- Measurement Protocol(データ送信用API)の内容は開いていない
- 公式CLIの有無(googleanalytics組織の一覧は36件中26件が未表示)
- 公式MCPリポジトリ自体のページに最終更新日の表示なし(組織の一覧では 2026-07-27、Releasesは0件)
- 第三者製MCP(embeddedlayers、surendranb)のREADME、書き込み・削除の可否、surendranb製の元リポジトリと更新日
- 管理画面(GA本体)の日本語表示
- 2026-10-17再確認で残った点: GAのユーザー(アクセス権)を管理者が削除する手順の公式ヘルプは今回開いていない
- 2026-10-17再確認で残った点: 「CLIなし」は開発者向けトップと36リポジトリの範囲での判断。ドキュメント全体の目次までは見ていない
出典(14件)
- google-analytics-mcp README(GitHub / googleanalytics)(確認日 2026-10-16)
- Admin API v1(Google for Developers)(確認日 2026-10-16)
- Data API v1(Google for Developers)(確認日 2026-10-16)
- Google Analytics for developers(Google for Developers)(確認日 2026-10-16)
- [GA4] アクセスとデータ制限の管理/ユーザー管理(Google アナリティクス ヘルプ)(確認日 2026-10-16)
- [GA4] ロール(Google アナリティクス ヘルプ)(確認日 2026-10-16)
- アナリティクス ヘルプ(日本語)(Google)(確認日 2026-10-16)
- MCPレジストリ検索結果(modelcontextprotocol.io)(確認日 2026-10-16)
- properties.delete(Google for Developers)(確認日 2026-10-16)
- Google アナリティクス(Google マーケティング プラットフォーム)(確認日 2026-10-16)
- googleanalytics(GitHub組織)(確認日 2026-10-16)
- gcloud auth application-default revoke(Google Cloud)(確認日 2026-10-17)
- Google アカウントに連携したアプリのアクセス権(Google アカウント ヘルプ)(確認日 2026-10-17)
- googleanalytics 組織のリポジトリ一覧(GitHub)(確認日 2026-10-17)
この台帳は、公式の資料を読んだ範囲のことで、動かして確かめたものではありません。確認日: 2026年10月16日。
ラボの資料は、公式の文書を読んでまとめたもので、実際に使って確かめた記録ではありません。日付や仕様は変わるので、使う前に各ページの出典で確かめてください。事実と「僕らの見立て」は、分けて書いています。