English Français العربية

Google Ads

السجل الرسمي البحث والويب

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

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

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

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  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.

الأسئلة الشائعة

ما هو Google Ads؟

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

كيف أثبّت Google Ads؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http google-ads 'https://api.mcp.ai/p_google_ads'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج Google Ads إلى مفتاح API؟

لا يذكر إدراجه في السجل أي مفتاح أو سر إلزامي. قد تتطلب بعض الميزات حسابًا لدى الخدمة التي يتصل بها.

هل Google Ads مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون Google Ads؟

ينشره mcp-dir. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.