Google Ads MCP 服务器：开发者集成指南

Model Context Protocol (MCP) 是一种开放标准，可让大语言模型 (LLM) 安全地与外部数据和应用进行交互。Google Ads MCP 服务器提供了一个通往 Google Ads API 的标准化桥梁，使 AI 智能体能够使用自然语言分析和检索广告系列数据。

技术概览

通过实现此 MCP 服务器，您无需为 Google Ads API 身份验证、资源提取和数据解析编写自定义“粘合代码”。服务器会公开 LLM 可以自主发现和调用的特定工具。

主要规范

  • 协议：MCP（模型上下文协议）
  • 模式： 只读（当前版本）
  • 语言：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 项目标识符。
  • 凭据文件：经过授权的 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?

社区资源和支持