Google Ads MCP伺服器

概覽

Google Ads MCP 伺服器 是 Google 針對 Model Context Protocol (MCP) 的官方開源實作。它作為大型語言模型 (LLMs) 與 Google Ads API 之間一個安全且標準化的橋樑。

此伺服器允許 AI 助手使用自然語言指令來取得廣告活動資料、效能指標、預算、關鍵字和帳戶資訊 — 無需撰寫客製化的 API 程式碼或管理複雜的身份驗證流程。

目前為唯讀狀態（不支援如建立或編輯廣告活動等寫入操作），它正被積極維護並針對 Gemini CLI/Code Assist 等工具進行優化，同時完全相容於 Claude Desktop、Cursor 及其他 MCP 客戶端。

主要功能

• 自然語言存取：可提出如「我本週的廣告活動效能如何？」或「列出我的高成效關鍵字」等問題，並獲得結構化的回應。
• 支援 GAQL：完整存取 Google Ads 查詢語言，以實現強大、客製化的報告功能。
• 多帳戶支援：提供列出可存取客戶和經理帳戶的工具。
• 本地化與安全性：完全在你的機器上運行，並使用適當的 OAuth/服務帳戶憑證。
• 無需黏合程式碼：AI 客戶端可透過 MCP 標準自動發現並使用工具。
• 基於 Python：可直接透過 pipx 從 GitHub 儲存庫輕鬆安裝。

運作原理

伺服器作為一個本地 MCP 端點（stdio 傳輸）運行。當連接到 AI 客戶端時：

1. LLM 發現可用的工具（search 和 list_accessible_customers）。
2. 它根據使用者提示生成 GAQL 查詢。
3. 伺服器透過 Google Ads API 進行身份驗證，並返回乾淨、結構化的結果。
4. 結果回注入 LLM 的上下文，以供分析和總結。

設定與安裝

前置需求

• Google Ads 開發者令牌
• 啟用了 Google Ads API 的 Google Cloud 專案
• OAuth 憑證 (credentials.json) 或服務帳戶
• 已安裝 Python + pipx

快速開始

透過 pipx 執行：

pipx run git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

在您的 MCP 客戶端（例如 Gemini 的 settings.json 或 Claude/Cursor 設定檔）中配置必要的環境變數：

{
  "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-developer-token"
      }
    }
  }
}

可用工具

• search：執行任何 GAQL 查詢，以取得廣告活動、廣告、關鍵字、指標、預算等資料。
• list_accessible_customers：返回所有可存取客戶的 ID 和名稱（對經理帳戶很有幫助）。

使用案例

• 廣告活動分析：即時獲取成效摘要、識別表現不佳的廣告，或跨帳戶比較指標。
• 報表自動化：請 AI 生成每週報告或發現趨勢，無需登入 Google Ads 管理介面。
• 關鍵字與競爭對手洞察：透過自然語言查詢了解關鍵字表現與優化建議。
• 代理商工作流程：讓 AI 助手協助處理多個帳戶的客戶報告與診斷。
• 多 MCP 協作整合：結合其他 MCP 伺服器（如 Notion、日曆、分析工具）打造全漏斗行銷智能助手。

限制與安全須知

• 目前版本僅支援唯讀模式（無法建立或編輯廣告活動）。
• 資料將暴露給連線的 AI 助手/LLM —— 僅建議連接可信賴的用戶端。
• 需具備有效的 Google Ads 憑證與開發者權杖。
• 最適合用於分析與診斷任務；完整寫入功能可能在未來版本中新增。

快速開始

請前往官方儲存庫 github.com/googleads/google-ads-mcp 取得最新程式碼、議題回報與更新資訊。另可參閱 Google Ads API MCP 開發者指南 。

Google Ads MCP 伺服器是邁向智能代理廣告的重要一步 —— 將您的 Google Ads 數據轉化為可對話、AI 原生的資訊資源。