zaDojo
所有指南

Google Analytics MCP：給 AI 代理的免費 GA4 資料

不需 Google Cloud 專案，就能把 Google Analytics 4 連接到 Claude、ChatGPT、Cursor 或 Codex。十三種唯讀工具，讀取 GA4 不需點數。

作者：Denis Veisllari

zaDojo 的 MCP 伺服器讓你的 AI 代理讀取你的 Google Analytics 4 資源：訪客、工作階段、瀏覽量、跳出率、重要事件與收益，可依管道、頁面、國家、城市、裝置或瀏覽器細分，還能看到目前在網站上的人數。你在 zaDojo 中用一般的 Google 登入連接 GA4，不需要 Google Cloud 專案、不必啟用 API，也不需要憑證檔。讀取 Google Analytics 不需點數，同樣的資料也會以儀表板形式顯示在 zaDojo 應用程式中。

三個步驟完成連接

  1. 建立 zaDojo 帳號，並為你的網站建立專案。註冊無需信用卡。
  2. 在專案中打開 My Site > Analytics 並連接 Google Analytics。使用能看到該 GA4 資源的 Google 帳號登入，核准唯讀存取，並選擇資源。
  3. 將下方的伺服器網址加入你的 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 並貼上網址。

ChatGPT 需要自訂連線；ChatGPT 指南列出了步驟與支援的方案。其他支援遠端 MCP 伺服器的用戶端也使用同一個網址，MCP 設定指南涵蓋了每個用戶端。

你的代理能讀取什麼

每個工具回答一類問題，所以代理會根據你的問題挑選正確的報表，而不必從頭建構 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
哪些接近第一頁的頁面值得改善？get_search_opportunities

流量總覽與細分

流量總覽涵蓋所有管道。它會回傳訪客（GA4 的活躍使用者）、工作階段、瀏覽量、跳出率、平均工作階段時間長度、重要事件與購買收益，每一項都和相同長度的上一期比較，並附上每日趨勢。

總覽與細分都接受相同的篩選條件：管道、來源、廣告活動、到達網頁、頁面、國家、地區、城市、裝置、瀏覽器與作業系統。篩選條件可以組合，所以一個問題就能把數字縮小到「來自德國、透過 Google 進來的行動裝置訪客」。細分會列出其中一個維度的前 50 個值，代理就是這樣從國家深入到某個國家內的城市。

Search Console 與 GA4 結合

如果專案也已連接 Search Console，get_search_opportunities 會把兩者結合。它取出在 Search Console 中排名第 4 到 20 名的頁面，對應它們在 GA4 中的工作階段與重要事件，並依需求、商業價值以及離第一頁有多近來評分。GA4 沒有資料的頁面仍會留在清單中，但不評分。

同樣的資料也是儀表板

你不需要代理也能看到數字。連接 GA4 後，zaDojo 應用程式中的 My Site > Analytics 會顯示：

  • 七個主要數字（訪客、工作階段、瀏覽量、跳出率、平均工作階段、重要事件與收益），每一個都附上與上一期的變化；
  • 你選擇的任一數字的每日圖表；
  • 四個面板：Sources（管道、來源、廣告活動）、Pages（到達網頁、頁面）、Locations（國家、地區、城市）與 Devices（裝置、瀏覽器、作業系統）；
  • 過去 30 分鐘內網站上訪客的即時人數，每分鐘更新。

點選任一列，例如某個國家或瀏覽器，整個頁面就會縮小到該範圍。篩選條件可以疊加，你可以選擇過去 7、28 或 90 天、過去 12 個月，或自訂日期。查看儀表板不需點數。

值得問的問題

  • 「過去 7 天來自德國的行動裝置流量，和前一週相比有什麼變化？」
  • 「這個月哪些美國城市帶來最多訪客？」
  • 「哪些到達網頁帶來後續會註冊的自然搜尋訪客？」
  • 「現在網站上有人嗎？」
  • 「哪些頁面在 Search Console 中排在第二頁，而且在 GA4 中已經有轉換？」
  • 「站內搜尋追蹤有開啟嗎？設定了哪些重要事件？」

費用

讀取 Google Analytics 不需點數，不論你問多少問題，儀表板也可以免費查看。新帳號不需輸入信用卡就能連接 GA4。

同一個 MCP 連線也提供 zaDojo 的付費研究工具，例如關鍵字研究（每次搜尋約 €0.07）、反向連結與排名追蹤。這些會使用點數：方案為每月 €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 伺服器
執行位置託管服務，一個網址在你的電腦上（Python）
Google Cloud 設定不需要，用 Google 登入即可專案、兩個 API 與一個憑證檔
工具13 種工具，各自對應一類問題通用工具，例如 run_report
即時資料過去 30 分鐘內的訪客有，透過 run_realtime_report
結合 Search Console有無
費用讀取 GA4 不需點數免費且開源

如果你想把一切都放在自己的電腦上，或需要 zaDojo 沒有提供的報表（例如漏斗或自訂維度），Google 的伺服器是更好的選擇。zaDojo 適合想要今天就在代理中使用 GA4 資料、並和 Search Console、關鍵字與排名工具放在一起，而且什麼都不用安裝的人。

需要了解的限制

  • 報表只涵蓋完整的天數。範圍結束於昨天，以你資源的時區為準。
  • Google 會為了隱私保留或抽樣部分資料。發生這種情況時，工具會把報表標示為受限，缺少的列代表未知，而不是零。
  • 細分會回傳前 50 個值。自訂日期範圍最長可涵蓋 366 天。
  • 篩選條件必須完全相符。國家使用兩個字母的代碼，例如 DE，最保險的篩選值是細分所回傳的值。
  • 即時人數涵蓋整個網站，不接受篩選條件。
  • 沒有人口統計、使用者層級資料或自訂維度。
  • 僅支援 GA4 資源。你連接的 Google 帳號需要有該資源的存取權。
  • Google 會限制每個資源每小時與每天能執行的報表量。當 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 伺服器的用戶端。

它支援 Universal Analytics 嗎？

不支援。它只讀取 GA4 資源。

zaDojo