Google Ads MCP thực tế · AI đọc và phân tích, người thực hiện thay đổi

Ba tool, chỉ đọc, và đủ cho phân tích

list_accessible_customers: liệt kê các tài khoản mà người đăng nhập có quyền; với MCC là toàn bộ tài khoản UA con.
search: agent tự viết truy vấn GAQL (resource, fields, conditions, orderings, limit) và nhận bảng kết quả. Có tham số login_customer_id để đi qua MCC.
get_resource_metadata: cho agent tra cứu field, metric, segment hợp lệ trước khi truy vấn, nên ít sai cú pháp.
Tool được đánh dấu readOnlyHint; máy chủ không có mutate, không có recommender, không có "write proxy".

Những gì máy chủ này không làm

Không ghi: agent không gửi được lô thay đổi bid hay ngân sách. Google dự kiến thêm quyền ghi, bật tùy chọn qua tools_config.yaml, nhưng chưa phát hành (issue #84).
Không có tool chẩn đoán hay gợi ý bid sẵn: chẩn đoán CPA, đề xuất bid là việc agent tự suy luận từ dữ liệu GAQL; resource recommendation chỉ cho đọc gợi ý của Google.
Không có LTV, retention, doanh thu: dữ liệu đó đi qua GA4 MCP hoặc BigQuery MCP (xem Bản đồ MCP của Google).
Vòng lặp vì thế khép ở người: bước 6–7 là người áp dụng thay đổi trong giao diện Google Ads hoặc Ads Editor, sau khi đọc đề xuất của agent.

Cấu hình tối thiểu cho tài khoản MCC

Một Google Cloud project của công ty, bật Google Ads API, có access level Explorer trở lên (Basic/Standard nếu truy vấn nhiều).
OAuth client (desktop hoặc web) trong project đó; đăng nhập ADC với scope adwords bằng tài khoản Google có quyền trên MCC.
Biến môi trường GOOGLE_ADS_LOGIN_CUSTOMER_ID = ID của MCC để mọi truy vấn đi qua manager account.
Chạy pipx run google-ads-mcp trong cấu hình MCP của Claude Desktop/Code; hoặc tự host dạng Streamable HTTP với OAuth proxy khi muốn dùng chung.

Three tools, read-only, and enough for analysis

list_accessible_customers: lists the accounts the signed-in user can reach; for an MCC that covers every child UA account.
search: the agent writes its own GAQL (resource, fields, conditions, orderings, limit) and receives a result table. A login_customer_id parameter routes the call through the MCC.
get_resource_metadata: lets the agent look up valid fields, metrics and segments before querying, so syntax errors are rare.
Every tool is flagged readOnlyHint; the server has no mutate tools, no recommender, no "write proxy".

What this server does not do

No writes: the agent cannot push batches of bid or budget changes. Google plans to add write access, opt-in through tools_config.yaml, but it has not shipped (issue #84).
No built-in diagnostics or bid suggestions: CPA diagnosis and bid proposals are inferred by the agent from GAQL data; the recommendation resource only reads Google's own suggestions.
No LTV, retention or revenue: that data comes through the GA4 MCP or BigQuery MCP (see the Google MCP map).
So the loop closes with a person: steps 6–7 are a human applying changes in the Google Ads UI or Ads Editor after reading the agent's proposal.

Minimum setup for an MCC account

A company Google Cloud project with the Google Ads API enabled and at least Explorer access level (Basic/Standard for heavy use).
An OAuth client (desktop or web) in that project; sign in to ADC with the adwords scope using a Google account that has access to the MCC.
Environment variable GOOGLE_ADS_LOGIN_CUSTOMER_ID = the MCC ID so every query goes through the manager account.
Run pipx run google-ads-mcp from the Claude Desktop/Code MCP config; or self-host it as Streamable HTTP with the OAuth proxy when it must be shared.

三个只读工具，足以支撑分析

list_accessible_customers：列出登录用户有权访问的账户；对 MCC 而言即全部子 UA 账户。
search：代理自行编写 GAQL（resource、fields、conditions、orderings、limit）并获得结果表。login_customer_id 参数使调用经由 MCC。
get_resource_metadata：让代理在查询前查到合法的字段、指标和维度，减少语法错误。
每个工具都带有 readOnlyHint 标记；服务器没有修改类工具、没有推荐器、没有“写代理”。

这台服务器不做的事

不写入：代理无法批量推送出价或预算更改。Google 计划通过 tools_config.yaml 以可选方式加入写权限，但尚未发布（issue #84）。
没有内置诊断或出价建议：CPA 诊断和出价建议由代理依据 GAQL 数据自行推断；recommendation 资源只能读取 Google 自己的建议。
没有 LTV、留存或收入：这些数据来自 GA4 MCP 或 BigQuery MCP（见 Google MCP 地图）。
因此闭环落在人身上：第 6–7 步是人在阅读代理建议后，在 Google Ads 界面或 Ads Editor 中应用更改。

MCC 账户的最小配置

一个公司的 Google Cloud 项目，启用 Google Ads API，访问级别至少为 Explorer（高频使用需 Basic/Standard）。
在该项目中创建 OAuth 客户端（桌面或网页）；用对 MCC 有权限的 Google 账号、带 adwords 范围登录 ADC。
环境变量 GOOGLE_ADS_LOGIN_CUSTOMER_ID 设为 MCC ID，使所有查询经由管理账户。
在 Claude Desktop/Code 的 MCP 配置中运行 pipx run google-ads-mcp；需要共享时可自托管为带 OAuth 代理的 Streamable HTTP。

Trois outils, lecture seule, et assez pour analyser

list_accessible_customers : liste les comptes accessibles à l'utilisateur connecté ; pour un MCC, tous les comptes UA enfants.
search : l'agent écrit lui-même le GAQL (resource, fields, conditions, orderings, limit) et reçoit un tableau. Le paramètre login_customer_id fait passer l'appel par le MCC.
get_resource_metadata : permet à l'agent de consulter les champs, métriques et segments valides avant d'interroger, d'où peu d'erreurs de syntaxe.
Chaque outil porte readOnlyHint ; le serveur n'a ni outil de modification, ni recommandeur, ni « proxy d'écriture ».

Ce que ce serveur ne fait pas

Pas d'écriture : l'agent ne peut pas pousser de lots de modifications d'enchères ou de budgets. Google prévoit un accès en écriture, activable via tools_config.yaml, mais il n'est pas publié (issue #84).
Pas de diagnostic ni de suggestion d'enchère intégrés : le diagnostic CPA et les propositions d'enchères sont déduits par l'agent des données GAQL ; la ressource recommendation ne fait que lire les suggestions de Google.
Pas de LTV, de rétention ni de revenus : ces données passent par le MCP GA4 ou le MCP BigQuery (voir la carte des MCP Google).
La boucle se referme donc sur l'humain : les étapes 6–7 sont une personne qui applique les changements dans l'interface Google Ads ou Ads Editor après lecture de la proposition.

Configuration minimale pour un compte MCC

Un projet Google Cloud de l'entreprise avec l'API Google Ads activée et un niveau d'accès Explorer au minimum (Basic/Standard pour un usage intensif).
Un client OAuth (desktop ou web) dans ce projet ; connexion ADC avec le scope adwords depuis un compte Google ayant accès au MCC.
Variable d'environnement GOOGLE_ADS_LOGIN_CUSTOMER_ID = l'ID du MCC pour que chaque requête passe par le compte administrateur.
Lancer pipx run google-ads-mcp depuis la configuration MCP de Claude Desktop/Code ; ou l'auto-héberger en Streamable HTTP avec le proxy OAuth s'il doit être partagé.

Google Ads MCP thực tế: AI đọc và phân tích, người thực hiện thay đổi

Google Ads MCP as it is: AI reads and analyses, people make the changes

真实的 Google Ads MCP：AI 读取与分析，由人执行更改

Le MCP Google Ads tel qu'il est : l'IA lit et analyse, l'humain applique les changements

Ba tool, chỉ đọc, và đủ cho phân tích

Những gì máy chủ này không làm

Cấu hình tối thiểu cho tài khoản MCC

Three tools, read-only, and enough for analysis

What this server does not do

Minimum setup for an MCC account

三个只读工具，足以支撑分析

这台服务器不做的事

MCC 账户的最小配置

Trois outils, lecture seule, et assez pour analyser

Ce que ce serveur ne fait pas

Configuration minimale pour un compte MCC