使用 Google Ad Manager MCP 服务器

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 项目，请参阅新项目。

启用该 API

Ad Manager MCP 服务器使用 OAuth 2.0 进行最终用户身份验证和授权。当 AI 客户端连接到 MCP 服务器时，它会以运行 AI 客户端的用户的身份进行身份验证。AI 智能体继承了用户在 Google Ad Manager 中的确切用户角色、广告资源网会员资格和权限。

  1. 在 Google Cloud 控制台中，前往 Google Auth Platform > 品牌推广。

    前往“品牌塑造”

  2. 如果您已配置 Google Auth Platform，则可以在品牌推广、受众群体和数据访问权限中配置以下 OAuth 同意屏幕设置。如果您看到一条消息，提示尚未配置 Google Auth Platform，请点击开始使用：

    1. 在应用信息部分，为应用名称输入 Ad Manager MCP Server 或您偏好的名称。
    2. 在用户支持邮箱中，选择您的电子邮件地址或相应群组。
    3. 点击下一步。
    4. 在受众群体部分，选择内部。
    5. 点击下一步。
    6. 在联系信息下，输入一个电子邮件地址，以便您接收有关项目变更的通知。
    7. 点击下一步。
    8. 在完成部分，查看 Google API 服务用户数据政策，如果您同意，请选择我同意 Google API 服务：用户数据政策。
    9. 点击继续。
    10. 点击创建。

  3. 依次点击数据访问权限 > 添加或移除范围。系统会显示一个面板，其中列出了您在 Google Cloud 项目中启用的每个 API 的范围。

    1. 在手动添加范围下，输入 Ad Manager MCP 服务器所需的 OAuth 范围：
      • https://www.googleapis.com/auth/admanager（拥有查看和管理广告系列的完整权限）
    2. 点击添加到表格。
    3. 点击更新。
    4. 选择应用所需的范围后，在数据访问权限页面上点击保存。

将 MCP 服务器添加到 AI 客户端

如需将 Ad Manager MCP 服务器添加到 AI 客户端，请按照相应客户端的说明操作：

Antigravity

如需将 Ad Manager MCP 服务器添加到 Antigravity，请完成以下步骤：

  1. 创建 OAuth 2.0 客户端 ID 和密钥：

    1. 在 Google API 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://antigravity.google/oauth-callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的地方。您只能复制一次。如果您丢失了该密钥，请删除该密钥并创建一个新密钥。

  2. 如需将 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 客户端凭据。

  3. 如需对 Ad Manager MCP 服务器进行身份验证，请参阅 Antigravity：使用 OAuth 进行身份验证。

Claude.ai

如需将 Ad Manager MCP 服务器添加到 Claude.ai，请使用 OAuth 客户端 ID 和 OAuth 客户端密钥配置自定义连接器：

  1. 创建 OAuth 2.0 客户端 ID 和密钥：

    1. 在 Google API 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://claude.ai/api/mcp/auth_callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的地方。您只能复制一次。如果您丢失了该密钥，请删除该密钥并创建一个新密钥。

  2. 按照相关说明创建自定义连接器。在高级设置菜单中输入您的客户端 ID 和密钥。

Claude Code

如需将 Ad Manager MCP 服务器添加到 Claude Code，请使用 OAuth 客户端 ID 和 OAuth 客户端密钥配置自定义连接器：

  1. 安装 Claude Code。

  2. 创建 OAuth 2.0 客户端 ID 和密钥：

    1. 在 Google API 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://claude.ai/api/mcp/auth_callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的地方。您只能复制一次。如果您丢失了该密钥，请删除该密钥并创建一个新密钥。

  3. 按照相关说明创建自定义连接器。在高级设置菜单中输入您的客户端 ID 和密钥。

Claude Desktop

如需将 Ad Manager MCP 服务器添加到 Claude Desktop，请使用 OAuth 客户端 ID 和 OAuth 客户端密钥配置自定义连接器：

  1. 安装 Claude Desktop。

  2. 创建 OAuth 2.0 客户端 ID 和密钥：

    1. 在 Google API 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://claude.ai/api/mcp/auth_callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的地方。您只能复制一次。如果您丢失了该密钥，请删除该密钥并创建一个新密钥。

  3. 按照相关说明创建自定义连接器。在高级设置菜单中输入您的客户端 ID 和密钥。

ChatGPT

您必须拥有 ChatGPT Business 订阅才能将 Ad Manager MCP 服务器与 ChatGPT 搭配使用。

如需将 MCP 服务器添加到 ChatGPT，请创建 Google OAuth 2.0 客户端 ID 和密钥，然后将 MCP 服务器添加为 ChatGPT 中的应用。

创建 OAuth 2.0 客户端 ID 和密钥

  1. 在 Google API 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

    前往“创建客户端”

    如果您未选择项目，系统会提示您创建一个项目。

  2. 在应用类型列表中，选择 Web 应用。

  3. 在名称字段中，为应用输入名称。

  4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://chatgpt.com/connector_platform_oauth_redirect。

  5. 点击创建。已创建客户端。

    系统会打开 OAuth 2.0 客户端已创建对话框。

  6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的地方。您只能复制一次。如果您丢失了该密钥，请删除该密钥并创建一个新密钥。

将 MCP 服务器添加为 ChatGPT 中的应用

  1. 登录 ChatGPT。
  2. 开启开发者模式。
  3. 打开 ChatGPT 应用设置。
  4. 点击创建应用，然后为远程 MCP 服务器创建应用。
  5. 在“OAuth”部分中，提供您的客户端 ID 和密钥。
  6. 确认您了解使用 MCP 服务器的相关风险，然后点击创建。

MCP 服务器显示在应用菜单中，可通过聊天提示随时使用。

光标

如需将 Ad Manager MCP 服务器添加到 Cursor，请创建客户端 ID 和密钥。使用静态 OAuth 配置 MCP 服务器。 Cursor 使用的重定向 URI 取决于您访问 Cursor 的方式，例如通过 Web 应用还是桌面应用。

  1. 创建 OAuth 2.0 客户端 ID 和密钥：

    Web 或 Cursor 智能体

    1. 在 Google API 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 https://www.cursor.com/agents/mcp/oauth/callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的地方。您只能复制一次。如果您丢失了该密钥，请删除该密钥并创建一个新密钥。

    桌面设备

    1. 在 Google API 控制台中，依次前往 Google Auth Platform > 客户端 > 创建客户端。

      前往“创建客户端”

      如果您未选择项目，系统会提示您创建一个项目。

    2. 在应用类型列表中，选择 Web 应用。

    3. 在名称字段中，为应用输入名称。

    4. 在已获授权的重定向 URI 部分中，点击 + 添加 URI，然后在 URI 字段中输入 http://localhost:8787/callback。

    5. 点击创建。已创建客户端。

      系统会打开 OAuth 2.0 客户端已创建对话框。

    6. 在客户端密钥部分中，复制客户端密钥并将其保存在安全的地方。您只能复制一次。如果您丢失了该密钥，请删除该密钥并创建一个新密钥。

  2. 按照说明使用静态 OAuth 配置 MCP 服务器。
  3. 在 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 服务器连接已正确配置。