Google Ads MCP 設定指南：OpenClaw 整合
由 Tenten 編製 — 2026 年 3 月
本指南涵蓋範圍
完整的 Google Ads MCP 資料源接入 OpenClaw 代理設定流程。本指南比較所有主流社群方案 — 從零設定的遠端 MCP 服務到 Google 官方自架伺服器 — 讓你依照時程、預算與控制需求選擇最適合的路徑。
Google Ads MCP 的核心挑戰： 不同於 Google Analytics（只需要 Service Account），Google Ads 需要 Developer Token（開發者權杖） — 這是一個需要申請審核的受管控憑證，審核流程可能耗時數天到數週。這個單一需求決定了哪種方案最適合你的狀況。
方案比較總覽
| 比較項目 | Adspirer 遠端 MCP | Otto 遠端 MCP | Google 官方 MCP | 社群自架方案 |
|---|---|---|---|---|
| 設定時間 | 約 10 分鐘 | 約 10 分鐘 | 1–3 小時 + 等待審核 | 2–4 小時 + 等待審核 |
| 需要 Developer Token | 否（服務端處理） | 否（服務端處理） | 是 | 是 |
| OAuth 設定 | 自動（瀏覽器流程） | 自動（瀏覽器流程） | 手動（ADC 或 yaml） | 手動 |
| 讀取/寫入 | 讀取 + 寫入（100+ 工具） | 讀取 + 寫入 | 僅讀取 | 依實作而定 |
| 多平台支援 | Google + Meta + TikTok + LinkedIn | 僅 Google Ads | 僅 Google Ads | 僅 Google Ads |
| 費用 | 免費方案：15 次/月；付費自 $49/月起 | 免費方案可用 | 免費（API 本身免費） | 免費（API 本身免費） |
| OpenClaw 支援 | 原生插件 + SKILL.md | 通用 MCP 設定 | 通用 MCP 設定 | 通用 MCP 設定 |
| 可自架 | 否（遠端服務） | 否（遠端服務） | 是（本地 Python） | 是（本地 Python/Node） |
| 最適合 | 快速 PoC、多平台、代理商 | 僅需 Google Ads 的簡單場景 | 完全控制、合規需求 | 想要客製化的開發者 |
方案 A：Adspirer 遠端 MCP（推薦快速啟動）
為什麼選擇這個方案
Adspirer 是目前最熱門的廣告平台 MCP 整合社群方案。它處理 OAuth、權杖管理和多平台連接，不需要你自行取得 Google Ads Developer Token。它具備原生 OpenClaw 支援，內建 14.4KB 的 SKILL.md，詳細記錄所有 100+ 工具的使用方式。
設定步驟
步驟 1：安裝 OpenClaw 插件
openclaw plugin install adspirer
或透過 ClawHub 手動新增。
步驟 2：認證
openclaw adspirer login
這會開啟瀏覽器視窗。使用你的 Google 帳號登入並授權存取你的 Google Ads 帳戶。你也可以在同一流程中連接 Meta、TikTok 和 LinkedIn。
步驟 3：OpenClaw YAML 設定
agents:
- id: marketing-director
name: "行銷總監"
model: anthropic/claude-sonnet-4-5
mcp_servers:
- name: adspirer
transport: http
url: "https://mcp.adspirer.com/mcp"
若需要在遠端/無頭伺服器上使用 API Key：
- name: adspirer
transport: http
url: "https://mcp.adspirer.com/mcp"
env:
ADSPIRER_API_KEY: "${ADSPIRER_API_KEY}"
步驟 4：Claude Desktop 設定（測試用）
{
"mcpServers": {
"adspirer": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.adspirer.com/mcp"]
}
}
}
可用工具（Google Ads 部分）
| 工具 | 說明 |
|---|---|
get_campaign_performance |
廣告活動指標：花費、轉換、ROAS、CTR |
get_keyword_performance |
關鍵字層級數據，含 CPC 和品質分數 |
research_keywords |
關鍵字建議，含真實 CPC 數據和競爭程度 |
create_search_campaign |
端到端建立 Google 搜尋廣告活動 |
create_pmax_campaign |
建立最高成效廣告活動（含素材） |
switch_primary_account |
切換多個 Google Ads 帳戶 |
get_search_terms_report |
觸發你廣告的搜尋字詞報告 |
optimize_budget |
預算重新分配建議 |
定價方案
| 方案 | 每月工具呼叫次數 | 價格 |
|---|---|---|
| Free | 15 | $0 |
| Plus | 150 | $49/月 |
| Pro | 600 | $99/月 |
| Max | 3,000 | $199/月 |
遠端伺服器 / Docker 設定
適用於無頭環境（例如你的 Mac Mini M4）：
# 在 adspirer.ai/keys 產生 API Key
openclaw adspirer login --token sk_live_your_key_here
# 或設定環境變數
export ADSPIRER_API_KEY="sk_live_your_key_here"
在任何瀏覽器上透過 adspirer.ai/connections 連接廣告平台的 OAuth 授權。
方案 B：Otto 遠端 MCP（僅 Google Ads，最簡單）
為什麼選擇這個方案
Otto 是一個輕量級遠端 MCP，專注於 Google Ads。不需要 Developer Token，基於 OAuth 認證，免費即可開始。
設定步驟
Claude Desktop / OpenClaw 設定：
{
"mcpServers": {
"google-ads-otto": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://googleads.hireotto.com/mcp"]
}
}
}
Claude.ai 連接器設定：
Settings → Connectors → Add Custom Connector → 貼上：
https://googleads.hireotto.com/mcp
會跳出 Google 登入視窗進行 OAuth 授權，選擇 Otto 可以存取的 Google Ads 帳戶。
功能特色
- 廣告活動 / 廣告群組 / 關鍵字管理（讀取 + 寫入）
- RSA 文案撰寫和關鍵字新增
- 自動標記檢查和不合格素材快照
- 依裝置、地區、搜尋字詞的成效報告
方案 C：Google 官方 MCP 伺服器（自架，僅讀取）
為什麼選擇這個方案
這是 Google 自己的開源 MCP 伺服器（googleads/google-ads-mcp）。提供直接、自架的存取方式，無需依賴第三方。最適合需要完全資料主權、合規要求或自訂擴展的組織。代價是：需要 Developer Token，且僅限讀取（無法建立或修改廣告活動）。
先決條件
| 需求 | 說明 |
|---|---|
| Python 3.12+ | 需安裝 pipx 或 uv |
| Google Cloud 專案 | 已啟用 Google Ads API |
| Developer Token | 從你的 Google Ads Manager 帳戶（API Center）取得 |
| OAuth 憑證 | Application Default Credentials（ADC）或 google-ads.yaml |
了解 Developer Token 存取層級
這是最關鍵的門檻。Google 最近推出了新的 Explorer Access 層級：
| 層級 | 可存取正式帳戶 | 每日操作上限 | 是否需要申請 | 備註 |
|---|---|---|---|---|
| Test Account | 否 | 15,000 | 否（自動取得） | 僅限測試帳戶 |
| Explorer | 是 | 2,880 | 否（自動升級） | 新層級 — 註冊後可能自動核發 |
| Basic | 是 | 15,000 | 是（填表 + 審核） | 審核目前積壓中（可能需數週） |
| Standard | 是 | 無限制 | 是（填表 + 審核） | 需符合 RMF 合規要求 |
目前狀況（2026 年 3 月）： Google 已承認 Basic 和 Standard Access 申請存在嚴重積壓，原因是 MCP 伺服器和 Explorer Access 發布後需求大幅增加。審核時間目前已超過 Basic 的 2 個工作天和 Standard 的 10 個工作天標準。Google 已增派審核人員以清理積壓案件。
建議： 先使用 Explorer Access（自動核發，每日 2,880 次操作），這對大多數 MCP 報告用途已經足夠。同時並行申請 Basic Access 以備日後需要更高配額。
步驟 1：取得 Developer Token
1. 登入你的 Google Ads Manager 帳戶
2. 前往「工具與設定」→「設定」→「API Center」
3. 完成 API 存取表單
4. 接受條款和條件
5. 記錄你的 22 字元 Developer Token
你的權杖一開始是 Test Account Access 層級。Google 可能在幾天內自動升級至 Explorer Access。
步驟 2：設定憑證（兩種選擇）
選項 A：Application Default Credentials（ADC）— 推薦
# 在 GCP Console 建立 OAuth 用戶端（Desktop 類型）
# 下載用戶端 JSON 檔案後執行：
gcloud auth application-default login \
--scopes https://www.googleapis.com/auth/adwords,https://www.googleapis.com/auth/cloud-platform \
--client-id-file=YOUR_CLIENT_JSON_FILE
記錄認證完成後印出的 PATH_TO_CREDENTIALS_JSON 路徑。
選項 B：google-ads.yaml
如果你已經有 Google Ads Python 用戶端函式庫的 google-ads.yaml，可以直接重複使用：
# ~/google-ads.yaml
developer_token: "YOUR_DEVELOPER_TOKEN"
client_id: "YOUR_CLIENT_ID"
client_secret: "YOUR_CLIENT_SECRET"
refresh_token: "YOUR_REFRESH_TOKEN"
login_customer_id: "YOUR_MCC_ID" # 如果使用 MCC
步驟 3：安裝與設定
OpenClaw YAML 設定（ADC 方式）：
agents:
- id: marketing-director
name: "行銷總監"
model: anthropic/claude-sonnet-4-5
mcp_servers:
- name: google-ads
command: pipx
args:
- "run"
- "--spec"
- "git+https://github.com/googleads/google-ads-mcp.git"
- "google-ads-mcp"
env:
GOOGLE_APPLICATION_CREDENTIALS: "${GADS_CREDENTIALS_PATH}"
GOOGLE_PROJECT_ID: "${GCP_PROJECT_ID}"
GOOGLE_ADS_DEVELOPER_TOKEN: "${GADS_DEVELOPER_TOKEN}"
如果透過 MCC（管理員帳戶）存取，需額外加入：
GOOGLE_ADS_LOGIN_CUSTOMER_ID: "${GADS_MCC_CUSTOMER_ID}"
Claude Desktop 設定：
{
"mcpServers": {
"google-ads-mcp": {
"command": "pipx",
"args": [
"run",
"--spec",
"git+https://github.com/googleads/google-ads-mcp.git",
"google-ads-mcp"
],
"env": {
"GOOGLE_APPLICATION_CREDENTIALS": "/path/to/credentials.json",
"GOOGLE_PROJECT_ID": "your-project-id",
"GOOGLE_ADS_DEVELOPER_TOKEN": "your-22-char-token"
}
}
}
}
可用工具
| 工具 | 說明 |
|---|---|
search |
執行 GAQL（Google Ads Query Language）查詢以獲取任何指標 |
list_accessible_customers |
列出已認證使用者可存取的所有 Google Ads 帳戶 |
官方伺服器設計上刻意精簡，且嚴格僅限讀取。無法修改出價、暫停廣告活動或建立新素材。如需寫入操作，請使用方案 A 或 B。
步驟 4：驗證連線
使用以下提示測試：
「列出我可以存取的 Google Ads 帳戶」
「客戶 ID 1234567890 有多少個啟用中的廣告活動？」
「顯示過去 30 天的廣告活動成效」
「哪些關鍵字在燒預算卻沒有轉換？」
方案 D：社群自架方案（cohnen/mcp-google-ads）
為什麼選擇這個方案
cohnen/mcp-google-ads 專案提供比 Google 官方伺服器更多的工具（5 個 vs 2 個），支援 OAuth 和 Service Account 認證，並包含廣告活動成效和廣告成效的便捷工具。MIT 授權。
設定方式
git clone https://github.com/cohnen/mcp-google-ads.git
cd mcp-google-ads
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
# .env
GOOGLE_ADS_CLIENT_ID="your_client_id"
GOOGLE_ADS_CLIENT_SECRET="your_client_secret"
GOOGLE_ADS_REFRESH_TOKEN="your_refresh_token"
GOOGLE_ADS_DEVELOPER_TOKEN="your_developer_token"
GOOGLE_ADS_LOGIN_CUSTOMER_ID="your_mcc_id"
OpenClaw 設定：
- name: google-ads
command: python3
args:
- "/path/to/mcp-google-ads/server.py"
env:
GOOGLE_ADS_CLIENT_ID: "${GADS_CLIENT_ID}"
GOOGLE_ADS_CLIENT_SECRET: "${GADS_CLIENT_SECRET}"
GOOGLE_ADS_REFRESH_TOKEN: "${GADS_REFRESH_TOKEN}"
GOOGLE_ADS_DEVELOPER_TOKEN: "${GADS_DEV_TOKEN}"
GOOGLE_ADS_LOGIN_CUSTOMER_ID: "${GADS_MCC_ID}"
可用工具
| 工具 | 說明 |
|---|---|
list_accounts |
列出可存取的帳戶 |
execute_gaql_query |
執行任意 GAQL 查詢 |
get_campaign_performance |
預建的廣告活動成效報告 |
get_ad_performance |
預建的廣告成效報告 |
run_gaql |
替代 GAQL 執行方式 |
決策指南：你應該選擇哪個方案？
選擇 Adspirer（方案 A）如果：
- 你需要在 30 分鐘內開始運作
- 你想要 Google Ads + Meta Ads + 其他平台在同一個 MCP
- 你沒有（或不想等待）Developer Token
- 你是管理多個客戶帳戶的代理商
- 你需要廣告活動建立功能（不只是讀取）
- 你使用 OpenClaw 並想要內建的 SKILL.md
選擇 Otto（方案 B）如果：
- 你只需要 Google Ads（不需要 Meta/TikTok/LinkedIn）
- 你想要最簡單的零設定方案
- 你偏好更輕量的遠端服務
選擇 Google 官方（方案 C）如果：
- 資料主權和合規是優先考量
- 你需要完全控制基礎設施
- 你已經有 Developer Token
- 僅讀取報告就足夠
- 你想要用自訂工具擴展伺服器
選擇社群自架（方案 D）如果：
- 你想要比官方伺服器更多的內建工具
- 你想要客製化並貢獻程式碼
- 你已經有 Developer Token 和 OAuth 設定
- 你偏好 MIT 授權的開源方案
混合策略（推薦用於正式環境）
對大多數團隊來說，最佳方案是分階段混合：
第 1 階段（第 1 天）： Adspirer 遠端 MCP → 即時 PoC
第 2 階段（第 1-2 週）： 申請 Developer Token（Explorer 自動核發 + Basic 申請）
第 3 階段（第 2-4 週）： 部署 Google 官方 MCP 與 Adspirer 並行
第 4 階段（持續）： Adspirer 用於寫入操作，官方用於讀取/合規
組合 OpenClaw 設定
agents:
- id: marketing-director
name: "行銷總監"
model: anthropic/claude-sonnet-4-5
mcp_servers:
# Adspirer — 多平台、讀寫、即時設定
- name: adspirer
transport: http
url: "https://mcp.adspirer.com/mcp"
env:
ADSPIRER_API_KEY: "${ADSPIRER_API_KEY}"
# Google 官方 — 自架、僅讀取、完全控制
- name: google-ads-official
command: pipx
args:
- "run"
- "--spec"
- "git+https://github.com/googleads/google-ads-mcp.git"
- "google-ads-mcp"
env:
GOOGLE_APPLICATION_CREDENTIALS: "${GADS_CREDENTIALS_PATH}"
GOOGLE_PROJECT_ID: "${GCP_PROJECT_ID}"
GOOGLE_ADS_DEVELOPER_TOKEN: "${GADS_DEVELOPER_TOKEN}"
# GA4 — 沿用先前設定
- name: ga4
command: npx
args: ["-y", "mcp-server-google-analytics"]
env:
GOOGLE_CLIENT_EMAIL: "${GA4_CLIENT_EMAIL}"
GOOGLE_PRIVATE_KEY: "${GA4_PRIVATE_KEY}"
GA_PROPERTY_ID: "${GA4_PROPERTY_ID}"
SOUL.md 整合
強化你的代理以行銷總監的角色運用 Google Ads 數據：
# 行銷總監 — SOUL.md
## 身分
你是一位數位行銷績效總監，擁有即時存取
Google Ads、Google Analytics、Meta Ads 和 ERP 數據的能力。
## Google Ads 工作流程
### 每日績效檢查
1. 拉取過去 7 天的廣告活動成效
2. 與前一期間比較（週對週）
3. 標記 ROAS 低於目標的廣告活動
4. 找出燒預算但零轉換的關鍵字
5. 檢查品質分數分布
### 每週優化檢討
1. 檢視搜尋字詞報告 — 為不相關字詞新增排除關鍵字
2. 分析裝置和地區成效
3. 比較廣告文案成效（CTR、轉換率）
4. 根據 ROAS 提出預算重新分配建議
5. 檢查最高成效廣告的頻道分布（v23+）
### 關鍵指標
- 依廣告活動和平台的 ROAS
- CPC 趨勢和預算消耗進度
- 品質分數分布
- 依裝置和地區的轉換率
- 搜尋曝光比重和損失的 IS（預算 vs 排名）
## 安全規則
- 建立或修改廣告活動前，必須先與使用者確認
- 未經明確同意，不得超過設定的每日預算
- 單日花費異常（超過每日預算 150%）時立即示警
疑難排解
| 問題 | 原因 | 解決方式 |
|---|---|---|
| 「Developer token not approved」 | Token 仍在 Test 層級 | 等待 Explorer 自動升級，或申請 Basic Access |
| Basic Access 申請積壓 | Google 審核隊列超載 | 先使用 Explorer Access（每日 2,880 次操作），同時等待審核 |
| 「Permission denied on customer ID」 | 帳戶未連結到 MCC | 將帳戶連結到你的 MCC，或使用帳戶擁有者的 OAuth 憑證 |
| 「LOGIN_CUSTOMER_ID required」 | 透過 MCC 存取帳戶 | 新增 GOOGLE_ADS_LOGIN_CUSTOMER_ID 並填入你的 MCC 客戶 ID |
| 「pipx not found」 | 未安裝 pipx | 執行 pip install pipx 然後 pipx ensurepath |
| GAQL 查詢錯誤 | 查詢語法無效 | 先使用 Google 的 GAQL 互動工具驗證查詢語法 |
| Adspirer 「rate limited」 | 超過免費方案額度 | 升級方案，或切換到自架方案處理大量報告 |
| OAuth token 過期 | Refresh token 失效 | 重新認證；自架方案需重新產生 refresh token |
安全最佳實踐
| 實踐 | 實施方式 |
|---|---|
| 先讀取後寫入 | 先從僅讀取權限開始；驗證後再新增寫入功能 |
| Developer Token 安全 | 絕對不要在客戶端程式碼或公開 Repo 中暴露 Developer Token |
| MCC 隔離 | 使用專用 MCC 進行 API 存取，與手動帳戶管理分開 |
| OAuth 範圍最小化 | 只請求 adwords 範圍；不要綁定不必要的 GCP 範圍 |
| 網路綁定 | 將自架 MCP 伺服器綁定到 127.0.0.1 |
| 稽核日誌 | 在 GCP Console → APIs & Services → Quotas 監控 API 使用量 |
| 遠端 MCP 評估 | 使用 Adspirer/Otto 時，檢視其安全政策；數據會經過他們的伺服器 |
| 環境變數 | 將所有 Token/Key 存放在 .env 檔案中，絕不硬編碼 |
快速參考卡
| 項目 | 值 |
|---|---|
| Google 官方 MCP | github.com/googleads/google-ads-mcp（Python，pipx） |
| 社群 MCP | github.com/cohnen/mcp-google-ads（Python，FastMCP） |
| Adspirer 遠端 | https://mcp.adspirer.com/mcp（Streamable HTTP） |
| Otto 遠端 | https://googleads.hireotto.com/mcp（Streamable HTTP） |
| Developer Token | Google Ads Manager →「工具與設定」→「API Center」 |
| 存取層級 | Test → Explorer（自動）→ Basic（申請）→ Standard（申請） |
| GAQL 參考 | developers.google.com/google-ads/api/docs/query/overview |
| API 版本 | v23（2026 年 1 月起為最新版） |
由 Tenten AI 編製 — tenten.co