Google Ad Manager 提供遠端 Model Context Protocol (MCP) 伺服器,可讓 AI 代理安全地與 Google Ad Manager 聯播網、廣告空間、訂單和使用者資料互動。設定 Ad Manager MCP 伺服器後,Google Antigravity、Claude 和 ChatGPT 等 AI 應用程式就能以 Ad Manager 使用者的身分執行動作。
MCP 伺服器位址為 https://admanager.googleapis.com/mcp。
必要條件
- 有權建立 Google Cloud 專案,或有權查看現有的 Google Cloud 專案。
- 在 AI 用戶端 (例如 ChatGPT 或 Claude) 中編輯連結或應用程式。
設定 Ad Manager MCP 伺服器
如要使用 Ad Manager MCP 伺服器,請完成下列步驟:
- 在 Google Cloud 專案中啟用 Ad Manager API。
- 設定 OAuth 2.0 使用者驗證。
- 將 MCP 伺服器新增至 AI 用戶端。
啟用 Ad Manager API
如要使用 Ad Manager MCP 伺服器,您必須在 Google Cloud 專案中啟用 Ad Manager API。如需建立 Google Cloud 專案,請參閱「新專案」。
設定驗證機制
Ad Manager MCP 伺服器會使用 OAuth 2.0 進行使用者驗證和授權。AI 用戶端連線至 MCP 伺服器時,會以執行 AI 用戶端的使用者身分進行驗證。AI 代理程式會完全沿用使用者的 Google Ad Manager 使用者角色、聯播網成員資格和權限。
在 Google Cloud 控制台中,前往「Google Auth Platform」>「Branding」(品牌)。
如果您已設定 Google 驗證平台,可以在「品牌」、「目標對象」和「資料存取權」中設定下列 OAuth 同意畫面設定。如果看到「尚未設定 Google 驗證平台」訊息,請按一下「開始使用」:
- 在「App Information」(應用程式資訊) 部分的「App name」(應用程式名稱) 欄位,輸入
Ad Manager MCP Server或偏好的名稱。 - 在「User support email」(使用者支援電子郵件) 中,選取您的電子郵件地址或適當的群組。
- 點選 [下一步]。
- 在「目標對象」部分,選取「內部」。
- 點選 [下一步]。
- 在「聯絡資訊」部分,輸入可接收專案異動通知的電子郵件地址。
- 點選 [下一步]。
- 在「完成」部分,請詳閱《Google API 服務使用者資料政策》,然後選取「我同意《Google API 服務:使用者資料政策》」。
- 按一下「繼續」。
- 點選「建立」。
- 在「App Information」(應用程式資訊) 部分的「App name」(應用程式名稱) 欄位,輸入
依序點選「資料存取」>「新增或移除範圍」。面板隨即顯示,列出您在 Google Cloud 專案中啟用的每個 API 範圍。
- 在「手動新增範圍」下方,輸入 Ad Manager MCP 伺服器所需的 OAuth 範圍:
https://www.googleapis.com/auth/admanager(可完整存取廣告活動,並進行管理)
- 按一下「新增至表格」。
- 按一下「更新」。
- 選取應用程式所需的範圍後,在「資料存取」 頁面上,按一下「儲存」。
- 在「手動新增範圍」下方,輸入 Ad Manager MCP 伺服器所需的 OAuth 範圍:
將 MCP 伺服器新增至 AI 用戶端
如要將 Ad Manager MCP 伺服器新增至 AI 用戶端,請按照用戶端的指示操作:
Antigravity
如要將 Ad Manager MCP 伺服器新增至 Antigravity,請完成下列步驟:
建立 OAuth 2.0 用戶端 ID 和密鑰:
-
在 Google API 控制台中,依序前往「Google Auth Platform」>「Clients」>「Create client」。
如果沒有選取專案,系統會提示您建立專案。
在「應用程式類型」清單中,選取「網頁應用程式」。
在「Name」(名稱) 欄位中,輸入應用程式的名稱。
在「已授權的重新導向 URI」部分,點選「+ 新增 URI」,然後在「URI」欄位中輸入
https://antigravity.google/oauth-callback。按一下「建立」,已建立用戶端。
「OAuth 2.0 用戶端已建立」對話方塊隨即開啟。
在「Client secrets」專區中,複製「Client secret」並妥善保存。你只能複製一次。如果遺失,請刪除密鑰並建立新的密鑰。
-
如要將 Ad Manager MCP 伺服器新增至 Antigravity,請更新
~/.gemini/config/mcp_config.json檔案:{ "mcpServers": { "AdManager-MCP": { // Use your chosen MCP server URL. "serverUrl": "https://admanager.googleapis.com/mcp", "oauth": { "clientId": "CLIENT_ID", "clientSecret": "CLIENT_SECRET" } } } }
將 CLIENT_ID 和 CLIENT_SECRET 替換為您的 OAuth 2.0 用戶端憑證。
如要驗證 Ad Manager MCP 伺服器,請參閱「Antigravity:使用 OAuth 進行驗證」。
Claude.ai
如要將 Ad Manager MCP 伺服器新增至 Claude.ai,請使用 OAuth 用戶端 ID 和 OAuth 用戶端密鑰設定自訂連結器:
建立 OAuth 2.0 用戶端 ID 和密鑰:
-
在 Google API 控制台中,依序前往「Google Auth Platform」>「Clients」>「Create client」。
如果沒有選取專案,系統會提示您建立專案。
在「應用程式類型」清單中,選取「網頁應用程式」。
在「Name」(名稱) 欄位中,輸入應用程式的名稱。
在「已授權的重新導向 URI」部分,點選「+ 新增 URI」,然後在「URI」欄位中輸入
https://claude.ai/api/mcp/auth_callback。按一下「建立」,已建立用戶端。
「OAuth 2.0 用戶端已建立」對話方塊隨即開啟。
在「Client secrets」專區中,複製「Client secret」並妥善保存。你只能複製一次。如果遺失,請刪除密鑰並建立新的密鑰。
-
- 按照操作說明建立自訂連接器。在「進階設定」選單中輸入用戶端 ID 和密鑰。
Claude Code
如要將 Ad Manager MCP 伺服器新增至 Claude Code,請使用 OAuth 用戶端 ID 和 OAuth 用戶端密鑰設定自訂連結器:
- 安裝 Claude Code。
建立 OAuth 2.0 用戶端 ID 和密鑰:
-
在 Google API 控制台中,依序前往「Google Auth Platform」>「Clients」>「Create client」。
如果沒有選取專案,系統會提示您建立專案。
在「應用程式類型」清單中,選取「網頁應用程式」。
在「Name」(名稱) 欄位中,輸入應用程式的名稱。
在「已授權的重新導向 URI」部分,點選「+ 新增 URI」,然後在「URI」欄位中輸入
https://claude.ai/api/mcp/auth_callback。按一下「建立」,已建立用戶端。
「OAuth 2.0 用戶端已建立」對話方塊隨即開啟。
在「Client secrets」專區中,複製「Client secret」並妥善保存。你只能複製一次。如果遺失,請刪除密鑰並建立新的密鑰。
-
- 按照操作說明建立自訂連接器。在「進階設定」選單中輸入用戶端 ID 和密鑰。
Claude Desktop
如要將 Ad Manager MCP 伺服器新增至 Claude Desktop,請使用 OAuth 用戶端 ID 和 OAuth 用戶端密碼設定自訂連結器:
- 安裝 Claude Desktop。
建立 OAuth 2.0 用戶端 ID 和密鑰:
-
在 Google API 控制台中,依序前往「Google Auth Platform」>「Clients」>「Create client」。
如果沒有選取專案,系統會提示您建立專案。
在「應用程式類型」清單中,選取「網頁應用程式」。
在「Name」(名稱) 欄位中,輸入應用程式的名稱。
在「已授權的重新導向 URI」部分,點選「+ 新增 URI」,然後在「URI」欄位中輸入
https://claude.ai/api/mcp/auth_callback。按一下「建立」,已建立用戶端。
「OAuth 2.0 用戶端已建立」對話方塊隨即開啟。
在「Client secrets」專區中,複製「Client secret」並妥善保存。你只能複製一次。如果遺失,請刪除密鑰並建立新的密鑰。
-
- 按照操作說明建立自訂連接器。在「進階設定」選單中輸入用戶端 ID 和密鑰。
ChatGPT
如要透過 ChatGPT 使用 Ad Manager MCP 伺服器,您必須訂閱 ChatGPT Business 方案。
如要將 MCP 伺服器新增至 ChatGPT,請建立 Google OAuth 2.0 用戶端 ID 和密鑰,然後將 MCP 伺服器新增為 ChatGPT 中的應用程式。
建立 OAuth 2.0 用戶端 ID 和密鑰
-
在 Google API 控制台中,依序前往「Google Auth Platform」>「Clients」>「Create client」。
如果沒有選取專案,系統會提示您建立專案。
在「應用程式類型」清單中,選取「網頁應用程式」。
在「Name」(名稱) 欄位中,輸入應用程式的名稱。
在「已授權的重新導向 URI」部分,點選「+ 新增 URI」,然後在「URI」欄位中輸入
https://chatgpt.com/connector_platform_oauth_redirect。按一下「建立」,已建立用戶端。
「OAuth 2.0 用戶端已建立」對話方塊隨即開啟。
在「Client secrets」專區中,複製「Client secret」並妥善保存。你只能複製一次。如果遺失,請刪除密鑰並建立新的密鑰。
在 ChatGPT 中將 MCP 伺服器新增為應用程式
- 登入 ChatGPT。
- 開啟開發人員模式。
- 開啟 ChatGPT 應用程式設定。
- 按一下「建立應用程式」,為遠端 MCP 伺服器建立應用程式。
- 在 OAuth 專區中,提供用戶端 ID 和密鑰。
- 確認您瞭解使用 MCP 伺服器相關的風險,然後按一下「建立」。
MCP 伺服器會顯示在「應用程式」選單中,並可透過聊天提示使用。
Cursor
如要將 Ad Manager MCP 伺服器新增至 Cursor,請建立用戶端 ID 和密鑰。使用靜態 OAuth 設定 MCP 伺服器。 Cursor 會根據您存取 Cursor 的方式 (例如透過網頁或桌面應用程式),使用重新導向 URI。
建立 OAuth 2.0 用戶端 ID 和密鑰:
Web 或 Cursor 代理程式
-
在 Google API 控制台中,依序前往「Google Auth Platform」>「Clients」>「Create client」。
如果沒有選取專案,系統會提示您建立專案。
在「應用程式類型」清單中,選取「網頁應用程式」。
在「Name」(名稱) 欄位中,輸入應用程式的名稱。
在「已授權的重新導向 URI」部分,點選「+ 新增 URI」,然後在「URI」欄位中輸入
https://www.cursor.com/agents/mcp/oauth/callback。按一下「建立」,已建立用戶端。
「OAuth 2.0 用戶端已建立」對話方塊隨即開啟。
在「Client secrets」專區中,複製「Client secret」並妥善保存。你只能複製一次。如果遺失,請刪除密鑰並建立新的密鑰。
電腦
-
在 Google API 控制台中,依序前往「Google Auth Platform」>「Clients」>「Create client」。
如果沒有選取專案,系統會提示您建立專案。
在「應用程式類型」清單中,選取「網頁應用程式」。
在「Name」(名稱) 欄位中,輸入應用程式的名稱。
在「已授權的重新導向 URI」部分,點選「+ 新增 URI」,然後在「URI」欄位中輸入
http://localhost:8787/callback。按一下「建立」,已建立用戶端。
「OAuth 2.0 用戶端已建立」對話方塊隨即開啟。
在「Client secrets」專區中,複製「Client secret」並妥善保存。你只能複製一次。如果遺失,請刪除密鑰並建立新的密鑰。
-
- 按照操作說明設定 MCP 伺服器,並使用靜態 OAuth。
- 在 Chat 中使用 MCP 伺服器。
測試 Ad Manager MCP 伺服器
設定及驗證 MCP 用戶端後,您可以在 AI 聊天介面中執行測試提示,驗證連線。
請嘗試向 AI 客戶提出下列問題:
「列出我有權存取的 Google Ad Manager 聯播網。」
用戶端會呼叫
list_networks,擷取並顯示與使用者帳戶相關聯的 Ad Manager 聯播網代碼和顯示名稱。「尋找聯播網代碼
NETWORK_CODE的詳細資料。」用戶端會使用
get_network擷取指定網路的中繼資料。「顯示網路
NETWORK_CODE的前 5 筆訂單。」用戶端會叫用
list_orders,查詢您網路中的訂單並彙整摘要。
如果工具順利執行並傳回 Google Ad Manager 資料,表示 MCP 伺服器連線設定正確。