# Google Ads MCP 服务器

谷歌官方开源的模型上下文协议（MCP）服务器。使 Gemini、Claude 和 Cursor 等 AI 代理能够通过 GAQL 使用自然语言安全地查询和分析谷歌广告系列、性能指标和账户数据。

Canonical URL: https://a2a-mcp.org/entry/google-ads-mcp-zh

Language: zh

Category: MCP Servers

Updated: 2026-03-21

## 概述

**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 运行：

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

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

```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/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](https://github.com/googleads/google-ads-mcp) 获取最新代码、问题反馈和更新信息。同时查阅 [Google Ads API MCP 开发者指南](https://developers.google.com/google-ads/api/docs/developer-toolkit/mcp-server)。

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

## Tags

- 谷歌广告
- mcp
- mcp-服务器
- 谷歌广告-api
- ai-集成
- 营销
- 广告
- gaql
- 只读
- gemini
- claude
- cursor

## Sources

- [Project website](https://github.com/googleads/google-ads-mcp)