Google Ads

Google Ads

Google Ads para Claude, ChatGPT e agentes de IA

Gestão completa de Google Ads: leitura (campanhas, performance, ROAS, keywords, termos de busca) e escrita (pausar/ativar/remover campanhas, ad groups, ads e keywords, ajustar orçamento e lance, criar budget, campanha, ad group, keywords positivas/negativas e RSAs). Você fornece developer token, OAuth client_id/secret, refresh_token e MCC, sem etapa OAuth no servidor.

• 📊 29 ferramentas
• ✏️ Leitura e escrita
• 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
• 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes

---

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome Google Ads e URL https://api.mcp.ai/p_google_ads.

Cursor

➕ Instalar Google Ads no Cursor

VS Code (Copilot Chat)

➕ Instalar Google Ads no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_google_ads

Detalhes por cliente: INSTALL.md.

---

Exemplos de uso

Liste minhas contas Google Ads acessíveis pela MCC
Quanto gastei hoje em Google Ads e qual o ROAS por campanha?
Top 10 palavras-chave por custo nos últimos 7 dias

---

29 ferramentas disponíveis

Tool	Descrição
google_ads_list_accounts	List all Google Ads MCCs and ALL customer accounts the OAuth token can access (via customers:listAccessibleCustomers — not just hierarchy of the MCC).
google_ads_status	Without account: overview of all Google Ads MCCs and customer_ids.
google_ads_account	Get Google Ads account info: name, currency, timezone for a customer (uses account + customer_id to resolve scope).
google_ads_campaigns	List Google Ads campaigns with status and budgets.
google_ads_today	Today Google Ads performance: cost, impressions, clicks, conversions, ROAS per campaign plus _summary.
google_ads_roas	ROAS for a date range (defaults to current month).
google_ads_ads	List enabled ads with type, status, campaign name and ad_group_ad.policy_summary (approval_status, review_status, policy_topic_entries) — answers "why is my ad not serving?" without opening the Google Ads UI.
google_ads_keywords_keywords	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_search_terms	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_status	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_diagnostics	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_raw	Keyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_performance	Daily performance breakdown: cost, impressions, clicks, conversions, revenue per day.
google_ads_changes	Change history / audit log: who changed what in the account and when.
google_ads_campaign_update_status	Pause, enable or remove one or more Google Ads campaigns.
google_ads_campaign_update_budget	Update the daily budget of a campaign.
google_ads_ad_group_update_status	Pause, enable or remove ad groups.
google_ads_ad_update_status	Pause, enable or remove ads. Each entry needs ad_group_id + ad_id because the ad resource is keyed by both (customers/X/adGroupAds/{ad_group_id}~{ad_id}). Bulk support: accepts customer_ids for batched execution.
google_ads_keyword_update_status	Pause, enable or remove keywords.
google_ads_keyword_update_bid	Update max CPC for one or more keywords.
google_ads_campaign_budget_create	Create a campaign_budget. Required to create a campaign. Amount is daily, in account currency unit (50 = R$50/day). Bulk support: accepts customer_ids for batched execution.
google_ads_campaign_create	Create a Google Ads campaign. Defaults to channel_type=SEARCH, status=PAUSED (safe), bidding_strategy=MANUAL_CPC. Provide budget_id from google_ads_campaign_budget_create. Declares no EU political advertising by defau…
google_ads_ad_group_create	Create an ad group inside a campaign.
google_ads_keyword_add	Add positive keywords to an ad group.
google_ads_negative_keyword_add	Add negative keywords at campaign or ad group scope.
google_ads_responsive_search_ad_create	Create a Responsive Search Ad (RSA) inside an ad group.
google_ads_sitelinks	List sitelink assets in the account and where they are attached (campaign / account / ad group level), with each link's resource_name (pass it to google_ads_sitelink_remove) and status.
google_ads_sitelink_create	Create sitelink extensions and attach them to a campaign (default), the whole account (scope=customer) or an ad group.
google_ads_sitelink_remove	Detach sitelinks from a campaign / account / ad group.

Detalhe de cada tool: docs/ferramentas.md

---

Preços

Grátis.

---

Privacidade & LGPD

• Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
• Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

---

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_google_ads.

---

Suporte

• 📧 google_ads@mcp.ai
• 🐛 GitHub Issues
• 📄 docs/

---

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_google_ads é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.