Google Ads MCP 伺服器：開發人員整合指南

Model Context Protocol (MCP) 是一項開放標準，可讓大型語言模型 (LLM) 安全地與外部資料和應用程式互動。Google Ads MCP 伺服器提供 Google Ads API 的標準化橋接器，讓 AI 代理程式使用自然語言分析及擷取廣告活動資料。

技術總覽

導入這個 MCP 伺服器後，您就不必為 Google Ads API 驗證、資源擷取和資料剖析編寫自訂「黏合程式碼」。伺服器會公開特定工具，供 LLM 探索及自主叫用。

主要規格

  • 通訊協定：MCP (Model Context Protocol)
  • 模式： 唯讀 (目前版本)
  • 語言：Python
  • 傳輸：標準輸入/輸出 (stdio)
  • 驗證：OAuth 2.0 或服務帳戶

互動迴圈的運作方式

  1. 要求：使用者提交查詢，例如「本週廣告活動成效如何？」。
  2. 探索：LLM 會檢查可用的工具，並找出google-ads-mcp搜尋功能。
  3. 執行：MCP 伺服器會執行基礎 Python 邏輯，查詢 Google Ads API。
  4. 脈絡注入：結構化結果會傳回至 LLM 的脈絡視窗。
  5. 回覆：LLM 會將資料統整為使用者可理解的答案。

開始使用

請按照下列步驟設定及使用 Google Ads MCP 伺服器。

必要條件

設定前，請確認您擁有 Google Ads 開發人員控制台的下列憑證：

  • 開發人員權杖：您專屬的 22 個字元存取字串。
  • 專案 ID：Google Cloud 專案 ID。
  • 憑證檔案：已授權的 credentials.json (OAuth 2.0 或服務帳戶)。

設定

如要將伺服器整合至與 MCP 相容的主機，請在主機的 MCP 設定檔 (例如 settings.json)。請參閱主機的說明文件，瞭解這項設定的確切位置和檔案名稱。

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/your/credentials.json",
        "GOOGLE_PROJECT_ID": "YOUR_PROJECT_ID",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "YOUR_DEVELOPER_TOKEN"
      }
    }
  }
}

核心功能 (工具)

伺服器會公開專為帳戶探索和成效報表設計的工具：

  • list_accessible_customers：傳回已通過驗證的使用者可存取的 Google Ads 客戶 ID 和帳戶名稱清單。
  • search：執行 Google Ads 查詢語言 (GAQL) 要求，擷取廣告活動指標、預算和狀態。

入門提示範例

詢問伺服器可執行的操作：

What can the google-ads-mcp server do?

詢問顧客：

What customers do I have access to?

詢問廣告活動：

How many active campaigns do I have?
How is my campaign performance this week?

社群資源和支援