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

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

社区资源和支持

GitHub 代码库：在 google-ads-mcp 代码库中查找演示、示例，并报告 bug 或提出功能建议。

使用“问题”标签页报告 bug 和提出功能请求。
社区：加入 #ads-api-ai-tools 频道，加入 Google 广告社区 Discord。

技术概览

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

主要规范

协议： MCP（Model Context Protocol，模型上下文协议）
模式：只读（当前版本）
语言： Python
传输：标准输入/输出 (stdio)
身份验证： OAuth 2.0 或服务账号

互动循环的工作原理

请求：用户提交查询，例如“我的广告系列在本周的效果如何？”。
发现： LLM 检查其可用工具，并识别 google-ads-mcp 搜索功能。
执行： MCP 服务器执行底层 Python 逻辑来查询 Google Ads API。
上下文注入：结构化结果会返回到 LLM 的上下文窗口。
响应： 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?