Google Ads MCP 服务器

概述

Google Ads MCP 服务器是谷歌官方开源的模型上下文协议（Model Context Protocol，MCP）实现。它充当大型语言模型（LLMs）与 Google Ads API 之间安全、标准化的桥梁。

该服务器允许 AI 智能体使用自然语言提示获取广告系列数据、性能指标、预算、关键词和账户信息 —— 无需编写自定义 API 代码或管理复杂的身份验证流程。

目前为只读状态（不支持创建或编辑广告系列等写入操作），它正被积极维护并针对 Gemini CLI/Code Assist 等工具进行了优化，同时完全兼容 Claude Desktop、Cursor 以及其他 MCP 客户端。

核心功能

• 自然语言访问：提出诸如"我这周的广告系列表现如何？"或"列出我的效果最佳的关键词"等问题，即可获得结构化答案。
• 支持 GAQL：完全支持 Google Ads 查询语言（GAQL），可用于强大的自定义报告。
• 多账户支持：提供工具列出可访问的客户和管理员账户。
• 本地且安全：完全在您的本地机器上运行，使用正确的 OAuth/服务账户凭据。
• 零胶水代码：AI 客户端通过 MCP 标准自动发现并使用工具。
• 基于 Python：可通过 pipx 直接从 GitHub 仓库轻松安装。

工作原理

该服务器作为本地 MCP 端点（stdio 传输）运行。当连接到 AI 客户端时：

1. LLM 发现可用工具（search 和 list_accessible_customers）。
2. 它根据用户提示生成 GAQL 查询。
3. 服务器通过 Google Ads API 进行身份验证，并返回清晰的结构化结果。
4. 结果被注入回 LLM 上下文，以便进行分析和总结。

设置与安装

先决条件

• Google Ads 开发者令牌
• 已启用 Google Ads API 的 Google Cloud 项目
• OAuth 凭据（credentials.json）或服务账户
• 已安装 Python 和 pipx

快速开始

通过 pipx 运行：

pipx run git+https://github.com/googleads/google-ads-mcp.git google-ads-mcp

配置您的 MCP 客户端（例如 Gemini 的 settings.json 或 Claude/Cursor 配置），填入所需的环境变量：

{
  "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/credentials.json",
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "your-developer-token"
      }
    }
  }
}

可用工具

• search：执行任何 GAQL 查询以获取广告系列、广告、关键词、指标、预算等数据。
• list_accessible_customers：返回所有可访问的客户 ID 和名称（对管理员账户非常有用）。

用例

• 广告活动分析：即时获取绩效摘要，识别表现欠佳的广告，或跨账户进行指标对比。
• 报告自动化：让AI生成周报或发现趋势，无需登录Google Ads控制面板。
• 关键词与竞争对手洞察：通过自然语言查询关键词表现和优化建议。
• 代理商工作流程：利用AI助手处理跨多个账户的客户报告和诊断。
• 多MCP协同：与其他MCP服务器（Notion、日历、分析工具）结合，打造全漏斗营销智能体。

限制与安全须知

• 当前版本为只读模式（无法创建或编辑广告活动）。
• 数据将暴露给连接的AI智能体/LLM——请仅连接可信客户端。
• 需要有效的Google Ads凭据和开发者令牌。
• 最适合分析与诊断场景；完整的写入功能可能在后续版本中提供。

快速开始

请访问官方仓库 github.com/googleads/google-ads-mcp 获取最新代码、问题反馈和更新信息。同时查阅 Google Ads API MCP 开发者指南 。

Google Ads MCP服务器是迈向智能体化广告的重要一步——它将您的Google Ads数据转化为可对话的、原生AI驱动的资源。