GA4教學｜數據工程師教你使用GA4 MCP

2026 年Google 官方提供了 GA4 MCP ，讓你可以在本地 (你的電腦)，不用打開GA4 介面就可以直接調閱數據、快速進行數據閱覽、分析。

把 GA4 接上 AI 工具其實沒有想像中複雜，但中間有幾個小細節可能會卡住。建議如果你要串接GA4 MCP 先使用個人帳號來下載 Service Account 才不會遇到權限限制問題。

一、為什麼要 GA4 接上 AI?

MCP(Model Context Protocol)讓 AI 工具可以直接讀取 GA4 的數據，不用每次都自己手動跑報表、匯出 CSV、再貼到對話視窗裡。設定好以後，在 Claude 或 VS Code 裡面用對話的方式拿到網站的流量、轉換、來源、使用者行為等數據。

但我認為 MCP 還是有他的一定限制。例如，數據量的問題，以及撈取指標、維度是否真的符合情境需求。因為這些指標維度，全部都是由AI 透過用戶的對話判斷。如果你也是要串接 MCP 的用戶，那麼這一篇可以閱讀下去。

二、創立服務帳號

不要用公司 Google 帳號

很多公司的 GCP 組織會預設「禁止建立服務帳戶金鑰」這條政策，等你走到下載 JSON 那一步，畫面會直接跳出這個訊息：

服務帳戶金鑰建立功能已停用 貴組織已強制執行組織政策,禁止建立服務帳戶金鑰。 強制執行的組織政策 ID:iam.disableServiceAccountKeyCreation

這條政策要由具備「組織政策管理員」(roles/orgpolicy.policyAdmin)角色的人才能關掉，一般員工通常碰不到。所以最快的處理方式是：

• 改用個人 Google 帳號登入 GCP
• 開一個新的專案來做這件事

三、啟用兩支必要的 API

Google Analytics Admin API

這支 API 主要管帳號層級的東西。例如，帳戶、資源(Property)、資料串流的設定查詢。

啟用步驟：

• 進到 GCP Console 的「API 和服務」→「程式庫」
• 搜尋「Google Analytics Admin API」
• 點進去按「啟用」

Google Analytics Data API

這支才是真正在拉報表數據的 API 維度、指標、流量、轉換通通靠它。

啟用步驟

跟上面流程一樣,在程式庫搜尋「Google Analytics Data API」後按啟用。

為什麼兩支都要開?

• 只開 Data API → 抓帳戶哪些 Property。
• 只開 Admin API → 拉實際的報表數據。
• 兩支都開 AI 才能完整操作，從抓帳號至抓數據。

四、建立服務帳戶並下載 JSON 金鑰

API 開好之後,要建立一個「服務帳戶」,當作 AI 跟 GA4 之間的橋樑。

第一步:建立服務帳戶

• 進到「API 和服務」→「憑證」
• 上方點「建立憑證」
• 下拉選單裡選「服務帳戶」

注意這裡有三個選項：API 金鑰、OAuth 用戶端 ID、服務帳戶。 要選的是服務帳戶，不是另外兩個。

接著會跳到建立畫面填這幾個欄位，你可以依照我這樣填寫就好：

填好後按「建立並繼續」，後面兩個步驟(權限、具備存取權的主體)都可以跳過，直接按「完成」。

第二步:下載 JSON 金鑰

服務帳戶建好之後，點進去這個帳戶，切到上面的「金鑰」分頁。

1. 點「新增鍵」→「建立新的金鑰」
2. 索引鍵類型選 JSON(Google 官方建議的格式)
3. 按「建立」，瀏覽器會直接下載一個 .json 檔

關於這個 JSON 檔的幾件事

• 只會下載一次，弄丟了只能重新建一把新的
• 裡面有私鑰，等於你的帳密，不要外流、不要傳到 GitHub、不要丟到雲端硬碟分享連結
• 建議放在固定資料夾，例如 ~/.config/gcp/ 或專案資料夾底下
• 如果是放在程式專案裡，記得把它加進 .gitignore

五、把服務帳戶加進 GA4

到這邊 GCP 的部分就結束了，接著回到 GA4 後台，讓這個服務帳戶有權限讀你的 GA4 資料。

步驟：

• 打開 GA4
• 進入要授權的「資源」(Property)
• 左下角「管理」→「資源存取權管理」
• 右上角加號 →「新增使用者」
• 在 email 欄位，貼上剛剛複製的服務帳戶 email

格式長這樣：mcp-539@你的專案.iam.gserviceaccount.com

• 角色至少給「檢視者」就夠了
• 按「新增」

六、在本地設定 GA4 MCP

接下來移到本地電腦操作。Claude Desktop 跟 VS Code 兩種都可以選，看你習慣哪一邊。我的範例以 WINDOW 作為示範，如果你是MAC 會稍微有點不同哦~

找到設定檔

APPDATA\Claude\claude_desktop_config.json

編輯設定檔內容

在 mcpServers 區塊加上 GA4 的設定，大致長這樣：

{ "mcpServers": { "ga4": { "command": "npx"， "args": ["-y"， "mcp-server-ga4"]， "env": { "GOOGLE_APPLICATION_CREDENTIALS": "/你的路徑/key.json"， "GA_PROPERTY_ID": "你的 GA4 Property ID" } } } }

要改的有兩個地方：

• GOOGLE_APPLICATION_CREDENTIALS:剛剛下載的 JSON 檔的完整路徑
• GA_PROPERTY_ID:GA4 後台「管理 → 資源設定」裡的那串純數字

重啟 Claude Desktop

關掉再打開，新對話視窗會看到 GA4 工具已經連上，可以開始問問題。

七、開始用 AI 操作 GA4 數據

設定都搞定之後，就可以直接用人話下指令。下面是一些實際用得到的問法。

常見的問法

• 「幫我看上週這個網站的流量，跟前一週比有沒有變化」
• 「上個月轉換最多的前五個來源是哪些?」
• 「最近七天哪幾頁跳出率最高?順便給我點擊數」
• 「行動裝置跟桌機的工作階段時間差多少?分週呈現」
• 「過去三十天有沒有哪一天流量特別異常?幫我抓出來」

AI 會自己決定要呼叫哪個 MCP 工具、傳什麼參數，把回來的數據整理成你看得懂的格式。比較複雜的問題它還會分多次查詢，最後合在一起回答。

用起來會更順的小提示

• 先講清楚時間範圍：不然 AI 預設可能會抓很大一段，跑很慢
• 不確定要看什麼的時候，先列清單：可以請它先列維度跟指標清單，確認方向再深入查
• 數字對不起來時，先檢查時區：GA4 Property 的時區設定會影響日期切分，跟你本地時區不一定一樣
• 複雜分析分階段問：不要一次塞五個問題，拆開來問結果會更乾淨

八、常見問題排查

Q1:跑出來說「沒有權限」或「PERMISSION_DENIED」?

九成是服務帳戶忘了加進 GA4，或加錯 Property。回去 GA4 後台「資源存取權管理」確認一次。

Q2:JSON 路徑明明對，還是讀不到?

檢查幾個地方：

• 路徑有沒有特殊字元、空白、中文資料夾名稱
• Windows 路徑記得用兩個反斜線 \\ 或一律改成正斜線 /
• JSON 檔有沒有被防毒軟體擋下來
• 檔案有沒有讀取權限

Q3:換另一個 Property 怎麼辦?

同一把金鑰可以對應多個 Property，只要把新的 Property 也加上這個服務帳戶 email，本地設定改 GA_PROPERTY_ID 即可，不用重建金鑰。

Q4:可以多服務帳戶用同一個 Project 嗎?

可以，而且建議這樣做。不同用途的服務帳戶分開建立，出事的時候直接停用單一帳戶就好，不會影響其他應用。

整個流程其實只有四個關鍵動作：

• 用個人帳號開 GCP，啟用 Admin API 跟 Data API
• 建服務帳戶、下載 JSON 金鑰(這一步公司帳號會卡住)
• 把服務帳戶 email 加進 GA4的資源存取權
• 本地 Claude 或 VS Code 設定 MCP，指向那把金鑰

最容易卡的還是一開始的帳號選擇。公司帳號的組織政策幾乎一定會擋，直接用個人帳號開新專案最省事。後面都是制式流程，跟著走通常不會出問題。

設定完之後，日常看數據就可以告別「打開 GA4 → 切到報表 → 設條件 → 匯出」這套流程，直接用對話的方式問，效率差很多。

小結

整個流程其實只有四個關鍵動作：

• 用個人帳號開 GCP,啟用 Admin API 跟 Data API
• 建服務帳戶、下載 JSON 金鑰(這一步公司帳號會卡住)
• 把服務帳戶 email 加進 GA4 的資源存取權
• 本地 Claude 或 VS Code 設定 MCP 指向那把金鑰

最容易卡的還是一開始的帳號選擇。公司帳號的組織政策幾乎一定會擋，直接用個人帳號開新專案最省事。