zaDojo
すべてのガイド

Google Analytics MCP：AIエージェント向けGA4データ

Google Cloudプロジェクトなしで、GA4をClaude、ChatGPT、Cursor、Codexに接続。読み取り専用の13ツールで、GA4の読み取りにクレジットは不要です。

著者: Denis Veisllari

zaDojoのMCPサーバーを使うと、AIエージェントがGoogle Analytics 4のプロパティを読めるようになります。訪問者、セッション、ページビュー、直帰率、キーイベント、収益を、チャネル、ページ、国、市区町村、デバイス、ブラウザ別に分けて確認でき、今サイトにいる人数もわかります。GA4は通常のGoogleサインインでzaDojoに接続するため、Google Cloudプロジェクトも、APIの有効化も、認証情報ファイルも不要です。Google Analyticsの読み取りにクレジットは使わず、同じデータはzaDojoアプリのダッシュボードにも表示されます。

3ステップで接続

  1. zaDojoのアカウントと、サイト用のプロジェクトを作成します。登録にカードは不要です。
  2. プロジェクトで My Site > Analytics を開き、Google Analyticsを接続します。GA4プロパティを閲覧できるGoogleアカウントでサインインし、読み取り専用のアクセスを承認して、プロパティを選びます。
  3. 下記のサーバーURLをAIクライアントに追加し、最初の接続時にzaDojoへのログインを承認します。
https://app.zadojo.com/mcp

Claude Code

claude mcp add --transport http --scope user zadojo https://app.zadojo.com/mcp

Codex CLI

codex mcp add zadojo --url https://app.zadojo.com/mcp

Cursor：Settings > Tools & Integrations > MCP Tools で、mcp.json に次を追加します。

{
  "mcpServers": {
    "zadojo": {
      "url": "https://app.zadojo.com/mcp"
    }
  }
}

Claude Desktop：Customize > Connectors を開き、Add custom connector を選んでURLを貼り付けます。

ChatGPT ではカスタム接続が必要です。手順と対応プランはChatGPTガイドにあります。リモートMCPサーバーに対応した他のクライアントでも同じURLを使え、各クライアントの手順はMCPセットアップガイドで説明しています。

エージェントが読めるもの

各ツールは1種類の質問に答えるため、エージェントはGA4のクエリを一から組み立てるのではなく、質問に合ったレポートを選びます。

質問ツール
サイト全体の調子は前の期間と比べてどうか？get_google_analytics_traffic_overview
どの国、地域、市区町村、ブラウザ、参照元が上位か？get_google_analytics_breakdown
今サイトに何人いるか？get_google_analytics_realtime_users
自然検索のトラフィックは伸びているか？get_google_analytics_organic_overview
どのページが自然検索の訪問者を集めているか？get_google_analytics_organic_landing_pages
どのページが読まれ、どれくらいの時間読まれているか？get_google_analytics_page_performance
どのチャネル、参照元、キャンペーンがセッションを生んでいるか？get_google_analytics_traffic_acquisition
どのキーイベントが、どのランディングページの後に発生するか？get_google_analytics_key_events
どの商品とランディングページが収益を生んでいるか？get_google_analytics_ecommerce_performance
訪問者はサイト内で何を検索しているか？get_google_analytics_site_search
どのデバイスと国か、リピーターは何人か？get_google_analytics_audience_breakdown
計測は正しく設定されているか？get_google_analytics_measurement_health
1ページ目に近く、改善する価値のあるページはどれか？get_search_opportunities

トラフィックの概要と内訳

トラフィックの概要はすべてのチャネルを対象にします。訪問者（GA4のアクティブユーザー）、セッション、ページビュー、直帰率、平均セッション継続時間、キーイベント、購入による収益を、それぞれ同じ長さの前の期間と比較して返し、日別の推移も示します。

概要と内訳は同じフィルタを使えます。チャネル、参照元、キャンペーン、ランディングページ、ページ、国、地域、市区町村、デバイス、ブラウザ、OSです。フィルタは組み合わせられるので、1つの質問で「Googleから来たドイツのモバイル訪問者」まで数字を絞り込めます。内訳はこれらのディメンションの1つについて上位50の値を一覧にします。エージェントは、これを使って国から、ある国の中の市区町村へと掘り下げます。

Search ConsoleとGA4の組み合わせ

プロジェクトにSearch Consoleも接続している場合、get_search_opportunities が2つを組み合わせます。Search Consoleで4〜20位にあるページを取り出し、GA4のセッションとキーイベントと突き合わせ、需要、ビジネス上の価値、1ページ目への近さでスコアを付けます。GA4にデータがないページも、スコアなしでリストに残ります。

同じデータをダッシュボードで

数字を見るのにエージェントは必要ありません。GA4を接続すると、zaDojoアプリの My Site > Analytics に次が表示されます。

  • 7つの主要指標（訪問者、セッション、ページビュー、直帰率、平均セッション、キーイベント、収益）と、それぞれの前の期間からの変化
  • 選んだ指標の日別グラフ
  • 4つのパネル：Sources（チャネル、参照元、キャンペーン）、Pages（ランディングページ、ページ）、Locations（国、地域、市区町村）、Devices（デバイス、ブラウザ、OS）
  • 過去30分間のサイト訪問者数のライブ表示（1分ごとに更新）

国やブラウザなど任意の行をクリックすると、ページ全体がそこに絞り込まれます。フィルタは重ねがけでき、期間は過去7日、28日、90日、過去12か月、または任意の日付から選べます。ダッシュボードの閲覧にクレジットは使いません。

尋ねる価値のある質問

  • 「ドイツからのモバイルトラフィックは、過去7日間で前の週と比べてどう変わった？」
  • 「今月、最も多くの訪問者を送ってきたアメリカの都市はどこ？」
  • 「登録につながる自然検索の訪問者を集めているランディングページはどれ？」
  • 「今サイトに誰かいる？」
  • 「Search Consoleで2ページ目にあり、GA4ではすでにコンバージョンしているページはどれ？」
  • 「サイト内検索の計測は有効になっている？どのキーイベントが設定されている？」

費用

Google Analyticsの読み取りは、質問の数にかかわらずクレジットを使わず、ダッシュボードも無料で閲覧できます。新しいアカウントでも、カードを登録せずにGA4を接続できます。

同じMCP接続では、キーワード調査（検索1回あたり約0.07ユーロ）、被リンク、順位計測といったzaDojoの有料調査ツールも使えます。これらはクレジットを使います。プランは月額10ユーロで、10ユーロ分の利用料が含まれます。各ツールの説明にクレジットを使うかどうかが書かれているので、エージェントは両者を区別できます。

設計上、読み取り専用

zaDojoはGoogleに analytics.readonly スコープを要求します。エージェントはレポートを読めますが、設定の変更、キーイベントの編集、ユーザーの追加、計測コードの変更はできません。zaDojoでいつでも接続を解除でき、Googleアカウントの設定からzaDojoのアクセス権を削除することもできます。

Google公式のMCPサーバーとの比較

GoogleはオープンソースのGoogle Analytics MCPサーバーを公開しており、実験的なものと位置づけています。Pythonで自分のコンピュータ上で動かし、設定も自分で行います。

  1. Google Cloudプロジェクトを作成するか選びます。
  2. Google Analytics Admin APIとData APIを有効にします。
  3. OAuthクライアントまたはサービスアカウントで、analytics.readonly スコープの認証情報を設定します。
  4. サーバーに認証情報ファイルとプロジェクトIDを指定します。
zaDojo MCPGoogleのAnalytics MCPサーバー
動作場所ホスト型、URL 1つ自分のコンピュータ（Python）
Google Cloudの設定不要、Googleでサインインするだけプロジェクト、2つのAPI、認証情報ファイル
ツール13ツール、それぞれ1種類の質問に対応run_report などの汎用ツール
リアルタイム過去30分間の訪問者あり、run_realtime_report 経由
Search Consoleとの連携ありなし
費用GA4の読み取りにクレジット不要無料のオープンソース

すべてを自分のマシン上で完結させたい場合や、ファネルやカスタムディメンションなどzaDojoが提供していないレポートが必要な場合は、Googleのサーバーのほうが適しています。zaDojoは、何もインストールせずに、今すぐGA4のデータをSearch Console、キーワード、順位のツールと並べてエージェントで使いたい人に向いています。

知っておきたい制限

  • レポートは完了した日のみを対象にします。期間は、プロパティのタイムゾーンで前日までです。
  • Googleはプライバシー保護のために一部のデータを伏せたりサンプリングしたりします。その場合、ツールはレポートに制限ありの印を付けます。欠けている行は不明であり、ゼロではありません。
  • 内訳は上位50の値を返します。任意の期間は最大366日まで指定できます。
  • フィルタは完全一致です。国はDEのような2文字のコードを使います。最も確実なのは、内訳で返された値でフィルタすることです。
  • リアルタイムの人数はサイト全体が対象で、フィルタは使えません。
  • ユーザー属性、ユーザー単位のデータ、カスタムディメンションはありません。
  • 対象はGA4プロパティのみです。接続するGoogleアカウントには、そのプロパティへのアクセス権が必要です。
  • Googleは、各プロパティで1時間あたり・1日あたりに実行できるレポートの量を制限しています。Googleが残りの割り当てを返した場合はレポートに表示されます。割り当てを使い切ると、ツールは部分的な数字ではなくエラーを返し、Googleが再試行の時刻を示した場合はそれも返します。

よくある質問

Google Cloudプロジェクトは必要ですか？

いいえ。zaDojoの中でGoogleにサインインし、読み取り専用のアクセスを承認するだけです。API接続はzaDojoが処理します。

Google Analyticsの読み取りにクレジットは使いますか？

いいえ。Google AnalyticsとSearch Consoleの読み取りは、アプリでもエージェント経由でもクレジットを使いません。

エージェントがGoogle Analyticsの内容を変更することはありますか？

いいえ。zaDojoは analytics.readonly スコープを要求するため、エージェントはレポートを読めますが、設定、イベント、ユーザーは変更できません。

どのAIクライアントで使えますか？

Claude Code、Claude Desktop、Cursor、Codex CLI、ChatGPTデスクトップアプリ内のCodex、カスタム接続を使ったChatGPT、その他リモートMCPサーバーに対応したクライアントです。

ユニバーサル アナリティクスでも使えますか？

いいえ。読み取れるのはGA4プロパティのみです。

zaDojo