English Français العربية

Google Ads

Registre officiel Recherche et web

Full Google Ads management: read (campaigns, performance, ROAS, keywords, search terms) and write (p

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http google-ads 'https://api.mcp.ai/p_google_ads'
Configuration JSON (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "google-ads": {
            "type": "http",
            "url": "https://api.mcp.ai/p_google_ads"
        }
    }
}

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Google Ads
  2. Instalar em 1 clique
  3. Exemplos de uso
  4. 29 ferramentas disponíveis
  5. Preços
  6. Privacidade & LGPD
  7. Perguntas frequentes
  8. Suporte
  9. Licença

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

ToolDescrição
google_ads_list_accountsList all Google Ads MCCs and ALL customer accounts the OAuth token can access (via customers:listAccessibleCustomers — not just hierarchy of the MCC).
google_ads_statusWithout account: overview of all Google Ads MCCs and customer_ids.
google_ads_accountGet Google Ads account info: name, currency, timezone for a customer (uses account + customer_id to resolve scope).
google_ads_campaignsList Google Ads campaigns with status and budgets.
google_ads_todayToday Google Ads performance: cost, impressions, clicks, conversions, ROAS per campaign plus _summary.
google_ads_roasROAS for a date range (defaults to current month).
google_ads_adsList 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_keywordsKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_search_termsKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_statusKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_diagnosticsKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_keywords_rawKeyword analytics, search terms, status/policy diagnostics, auction diagnostics, or custom GAQL SELECT.
google_ads_performanceDaily performance breakdown: cost, impressions, clicks, conversions, revenue per day.
google_ads_changesChange history / audit log: who changed what in the account and when.
google_ads_campaign_update_statusPause, enable or remove one or more Google Ads campaigns.
google_ads_campaign_update_budgetUpdate the daily budget of a campaign.
google_ads_ad_group_update_statusPause, enable or remove ad groups.
google_ads_ad_update_statusPause, 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_statusPause, enable or remove keywords.
google_ads_keyword_update_bidUpdate max CPC for one or more keywords.
google_ads_campaign_budget_createCreate 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_createCreate 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_createCreate an ad group inside a campaign.
google_ads_keyword_addAdd positive keywords to an ad group.
google_ads_negative_keyword_addAdd negative keywords at campaign or ad group scope.
google_ads_responsive_search_ad_createCreate a Responsive Search Ad (RSA) inside an ad group.
google_ads_sitelinksList 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_createCreate sitelink extensions and attach them to a campaign (default), the whole account (scope=customer) or an ad group.
google_ads_sitelink_removeDetach 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

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.

Questions fréquentes

Qu'est-ce que Google Ads ?

Full Google Ads management: read (campaigns, performance, ROAS, keywords, search terms) and write (p

Comment installer Google Ads ?

Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http google-ads 'https://api.mcp.ai/p_google_ads'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour Google Ads ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

Google Ads est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient Google Ads ?

Il est publié par mcp-dir. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.