How to setup Google AD MCP

1

我來為您提供從零開始設定 Google Ads MCP 的完整教學。由於您剛建立 GCP 帳號，我需要帶您完成「雙平台」設定：Google Cloud Platform + Google Ads Manager Account。

讓我先搜尋最新的設定流程確認細節：
以下是從零開始（新 GCP 帳號 + 新 Google Ads 帳號）建立 Google Ads MCP 存取權的完整教學。這是雙平台設定：您需要同時完成 Google Ads Manager Account (MCC) 和 Google Cloud Platform 的設定。

第一階段：建立 Google Ads Manager Account (MCC)

重要前提：Developer Token 只能從 Manager Account (MCC) 取得，一般廣告帳戶無法取得 。即使您只管理一個帳戶，也必須建立 MCC。

Step 1: 建立 MCC 帳戶

  1. 前往 Manager Account 建立頁面
  2. 點擊「建立 Manager 帳戶」
  3. 填寫基本資訊（請謹慎選擇，設定後無法更改）：
    • 帳戶名稱：您的公司名稱（客戶會看到這個名稱，不能包含網址）
    • 使用目的：選擇「管理其他公司的帳戶」或「管理自己的帳戶」
    • 國家/地區：選擇您的營運地區
    • 時區：選擇您的工作時區（永久設定，無法更改）
    • 幣別：選擇您慣用的分析幣別（永久設定，無法更改）
  4. 點擊「提交」

建立完成後，右上角會顯示 10 位數字的 Manager Account ID（格式：123-456-7890），請記下這個數字，這就是您的 Login Customer ID

Step 2: 連結廣告帳戶（可選）

如果您已有現有的 Google Ads 帳戶：

  1. 在 MCC 中點擊「帳戶」→「子帳戶設定」
  2. 點擊「連結現有帳戶」
  3. 輸入客戶帳戶的 10 位數 Customer ID
  4. 等待客戶端接受連結請求

第二階段：取得 Developer Token（開發者令牌）

Developer Token 是 Google Ads API 的通行證，具有三種權限等級 ：

  • Test access：僅能存取測試帳戶（新帳戶預設）
  • Basic access：可存取少量生產帳戶資料（需申請）
  • Standard access：完整存取（需申請並審核）

Step 3: 申請 Developer Token

  1. 在 MCC 中點擊右上角的「工具與設定」（扳手圖示）
  2. 在「設定」欄位下找到「API Center」
  3. 填寫 API 使用目的表單（說明您將如何使用 API）
  4. 同意條款並點擊「建立權杖」
  5. 複製顯示的 Developer Token（英數字組合，如：1234567890abcdef）

:warning: 重要提醒：

  • 新申請的 Token 預設為「Test access」等級，只能操作測試帳戶
  • 若要存取正式生產帳戶，必須點擊「申請基本存取權 (Apply for Basic access)」並等待 Google 審核（通常 1-2 個工作天）

第三階段：設定 Google Cloud Platform (GCP)

Step 4: 建立 GCP 專案

您已建立 GCP 帳號，現在需要建立專案：

  1. 前往 Google Cloud Console
  2. 點擊頂部「專案下拉選單」→「建立專案」
  3. 輸入專案名稱（建議：google-ads-mcp-integration）
  4. 選擇帳單帳戶（即使免費層也需要設定）
  5. 點擊「建立」

Step 5: 啟用 Google Ads API

  1. 在 GCP Console 搜尋欄輸入「API Library」
  2. 搜尋「Google Ads API」
  3. 點擊「啟用」（Enable）

Step 6: 設定 OAuth 同意畫面

這是 OAuth 認證的前置步驟：

  1. 左側選單「API 和服務」→「OAuth 同意畫面」
  2. 選擇「外部」（External，除非您是 Google Workspace 用戶）
  3. 填寫必要資訊：
    • 應用程式名稱：Google Ads MCP Integration
    • 使用者支援電子郵件：您的 Email
    • 開發人員聯絡資訊：您的 Email
  4. 點擊「儲存並繼續」

Step 7: 建立 OAuth 用戶端 ID 和密鑰

這是取得 client_id 和 client_secret 的步驟：

  1. 進入「憑證」→「建立憑證」→「OAuth 用戶端 ID」
  2. 應用程式類型：選擇「桌面應用程式」（Desktop application）
    • 雖然是伺服器應用，但 MCP 通常使用桌面應用程式類型取得 Refresh Token 後再轉移
  3. 名稱：Google Ads MCP Client
  4. 點擊「建立」
  5. 立即下載 JSON 檔案（client_secret_xxx.json）
  6. 開啟該 JSON 檔案，記下：
    • client_id（格式：123456789-xxx.apps.googleusercontent.com）
    • client_secret（格式：GOCSPX-xxx）

:warning: 安全提醒：client_secret 是機密資訊，請妥善保管，不要上傳到 GitHub

第四階段：取得 Refresh Token

Refresh Token 是 MCP Server 自動運作的關鍵，只需取得一次，永久有效（除非您撤銷權限）。

Step 8: 產生 Refresh Token

有兩種方法：

方法一：使用 Google 官方範例（推薦）

# 1. 安裝 Google Ads Python 函式庫
pip install google-ads

# 2. 下載官方範例
git clone https://github.com/googleads/google-ads-python.git
cd google-ads-python/examples/authentication

# 3. 執行認證產生工具
python3 generate_user_credentials.py --client_secrets_path="/path/to/your/client_secret_xxx.json"

方法二：手動流程

  1. 在瀏覽器輸入以下網址（替換 $CLIENT_ID）：

    https://accounts.google.com/o/oauth2/auth?client_id=$CLIENT_ID&redirect_uri=http://localhost&response_type=code&scope=https://www.googleapis.com/auth/adwords&access_type=offline

  2. 登入您的 Google Ads 帳號並授權

  3. 授權後會導向 http://localhost/?code=4/0Axxxxx，複製網址中的 code 參數（即 Authorization Code）

  4. 使用 curl 取得 Refresh Token：

    curl --request POST \
--data "code=您的_AUTHORIZATION_CODE&client_id=您的_CLIENT_ID&client_secret=您的_CLIENT_SECRET&redirect_uri=http://localhost&grant_type=authorization_code" \
https://oauth2.googleapis.com/token

成功回應：

{
  "access_token": "ya29.a0AfH6SMB...",
  "expires_in": 3599,
  "refresh_token": "1//0dx..._token",  ← 這就是您需要的
  "scope": "https://www.googleapis.com/auth/adwords",
  "token_type": "Bearer"
}

:warning: 關鍵提醒：refresh_token 只在第一次授權時顯示，請立即複製並安全儲存。如果遺失，需要重新執行 OAuth 流程

第五階段：理解 Login Customer ID

這是 MCP 設定中最容易混淆的參數 ：

情境 設定值
單一帳戶（沒有 MCC） 不需要設定，或設為您的帳戶 CID
透過 MCC 管理子帳戶 必須設定為 MCC 的 Customer ID（10 位數字，去除破折號）

格式範例：6574399463（不是 657-439-9463）

這個 ID 就是您在 MCC 右上角看到的 10 位數字

第六階段：設定 MCP Server

Step 9: 設定 Claude Desktop Config

將以上所有資訊填入 claude_desktop_config.json：

{
  "mcpServers": {
    "google-ads": {
      "command": "pipx",
      "args": [
        "run",
        "--spec",
        "git+https://github.com/googleads/google-ads-mcp.git",
        "google-ads-mcp"
      ],
      "env": {
        "GOOGLE_ADS_DEVELOPER_TOKEN": "您的_DEVELOPER_TOKEN",
        "GOOGLE_ADS_CLIENT_ID": "您的_CLIENT_ID.apps.googleusercontent.com",
        "GOOGLE_ADS_CLIENT_SECRET": "您的_CLIENT_SECRET",
        "GOOGLE_ADS_REFRESH_TOKEN": "您的_REFRESH_TOKEN",
        "GOOGLE_ADS_LOGIN_CUSTOMER_ID": "您的_MCC_ID_去除破折號_如適用"
      }
    }
  }
}

Step 10: 驗證設定

  1. 重啟 Claude Desktop
  2. 詢問：「幫我列出我的 Google Ads 廣告活動」
  3. 若出現錯誤，請檢查：
    • Developer Token 是否已審核通過（Basic/Standard access）
    • Login Customer ID 是否正確（如使用 MCC）
    • OAuth 憑證是否正確

常見錯誤排除

錯誤訊息 原因 解決方案
QuotaCheckError.DEVELOPER_TOKEN_NOT_APPROVED Developer Token 還在測試權限 申請 Basic Access 並等待審核
AuthenticationError.CLIENT_CUSTOMER_ID_IS_REQUIRED 缺少 Login Customer ID 確認是否使用 MCC，並正確設定 ID
User permission denied 授權的 Email 沒有帳戶權限 確認 OAuth 登入的 Email 有該 Ads 帳戶的存取權
invalid_grant Authorization Code 過期 重新執行 OAuth 流程取得新的 Code
Request had insufficient authentication scopes OAuth 範圍不正確 確認 OAuth 同意畫面加入了 adwords 範圍

總結檢查清單

  • 建立 Google Ads Manager Account (MCC)
  • 取得 Developer Token（並申請 Basic Access 以存取生產帳戶）
  • 在 GCP 建立專案並啟用 Google Ads API
  • 建立 OAuth 用戶端 ID 和密鑰（桌面應用程式類型）
  • 取得 Refresh Token
  • 記下 Login Customer ID（MCC ID，去除破折號）
  • 設定 MCP 設定檔並測試連線

整個流程通常需要 30-60 分鐘，其中 Developer Token 審核可能需要 1-2 個工作天（若申請 Basic Access）。