# Google Ads MCP伺服器

Google官方開源的模型上下文協議（MCP）伺服器。讓Gemini、Claude與Cursor等AI代理能夠透過GAQL，以自然語言安全地查詢和分析Google Ads廣告活動、效能指標及帳戶資料。

Canonical URL: https://a2a-mcp.org/entry/google-ads-mcp-zh-TW

Language: zh-TW

Category: MCP Servers

Updated: 2026-03-21

## 概覽

**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 執行：

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

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

```json
{
  "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](https://github.com/googleads/google-ads-mcp) 取得最新程式碼、議題回報與更新資訊。另可參閱 [Google Ads API MCP 開發者指南](https://developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server)。

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

## Tags

- google-ads
- mcp
- mcp伺服器
- google-ads-api
- ai整合
- 行銷
- 廣告
- gaql
- 唯讀
- gemini
- claude
- cursor

## Sources

- [Project website](https://github.com/googleads/google-ads-mcp)