/ Diretório / Playground / google-meta-ads-ga4-mcp
● Comunidade irinabuht12-oss ⚡ Instantâneo

google-meta-ads-ga4-mcp

por irinabuht12-oss · irinabuht12-oss/google-meta-ads-ga4-mcp

Unified MCP server for Google Ads, Meta Ads, and GA4 — 250+ tools for campaign management, analytics, and optimization.

google-meta-ads-ga4-mcp provides a single MCP server that unifies management of Google Ads (150+ tools), Meta Ads (80+ tools), and Google Analytics 4 (20+ tools). It handles campaign creation, keyword research, ad management, audience targeting, creative assets, performance analytics, and conversion tracking. Uses OAuth 2.1 for secure authentication without local API key storage.

Por que usar

Principais recursos

Demo ao vivo

Como fica na prática

google-meta-ads-ga4.replay ▶ pronto
0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "google-meta-ads-ga4": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "google-meta-ads-ga4",
      "command": "TODO",
      "args": [
        "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json
{
  "context_servers": {
    "google-meta-ads-ga4": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add google-meta-ads-ga4 -- TODO 'See README: https://github.com/irinabuht12-oss/google-meta-ads-ga4-mcp'

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: google-meta-ads-ga4-mcp

How to compare ad performance across Google and Meta with one prompt

👤 Digital marketers managing multi-platform campaigns ⏱ ~15 min intermediate

Quando usar: Your weekly performance review needs data from both Google Ads and Meta Ads.

Pré-requisitos
  • OAuth authentication complete — Follow the setup guide to authorize Google and Meta accounts
Fluxo
  1. Pull cross-platform metrics
    Show me last week's performance for all active campaigns across Google Ads and Meta Ads. Include spend, impressions, clicks, CTR, and CPA.✓ Copiado
    → Combined table with metrics from both platforms
  2. Identify underperformers
    Which campaigns have a CPA more than 2x our target of $25? Recommend whether to pause, adjust budget, or change targeting.✓ Copiado
    → Specific recommendations with data backing

Resultado: A unified performance view with actionable optimization recommendations.

Armadilhas
  • Attribution windows differ between platforms — Specify the same date range and note that Google and Meta may count conversions differently

Create a Meta Ads campaign from scratch with AI assistance

👤 Small business owners running their own ads ⏱ ~20 min beginner

Quando usar: You want to set up a new Meta Ads campaign without navigating the complex Ads Manager UI.

Pré-requisitos
  • Meta Ads account authorized — Complete OAuth setup for your Meta Business account
Fluxo
  1. Create the campaign
    Create a Meta Ads campaign for my online store targeting women 25-45 interested in organic skincare. Daily budget $50, optimizing for purchases.✓ Copiado
    → Campaign, ad set, and targeting configured
  2. Upload creative
    Upload these 3 product images as ad creatives and create carousel ads with them.✓ Copiado
    → Ads created with images and copy

Resultado: A complete Meta Ads campaign ready to launch.

Armadilhas
  • Audience too narrow leads to high CPMs — Start with broader targeting and narrow based on performance data

Analyze website traffic patterns using GA4 tools

👤 Growth marketers and product managers ⏱ ~15 min beginner

Quando usar: You want to understand where your traffic comes from and how users behave.

Pré-requisitos
  • GA4 property authorized — Complete OAuth setup for your Google Analytics account
Fluxo
  1. Pull traffic report
    Show me a GA4 report of traffic sources for the past 30 days. Break down by channel, with sessions, engagement rate, and conversions.✓ Copiado
    → Channel breakdown with key metrics
  2. Analyze user behavior
    For organic search traffic, what are the top landing pages and average engagement time? Which pages have the highest bounce rate?✓ Copiado
    → Page-level analysis with actionable insights

Resultado: Clear understanding of traffic patterns and user behavior for optimization.

Armadilhas
  • GA4 data can have 24-48 hour processing delays — Use realtime reporting for today's data, standard reports for historical analysis

Combinações

Combine com outros MCPs para 10× de alavancagem

google-meta-ads-ga4 + filesystem

Export campaign performance data to CSV files for further analysis

Export last month's Google Ads campaign performance to a CSV file in ~/reports/.✓ Copiado

Ferramentas

O que este MCP expõe

FerramentaEntradasQuando chamarCusto
google_ads_campaigns account_id, filters? List or manage Google Ads campaigns 1 API call
meta_ads_campaigns account_id, filters? List or manage Meta Ads campaigns 1 API call
ga4_report property_id, date_range, dimensions, metrics Pull GA4 analytics reports 1 API call
keyword_research seed_keywords, language, location Research keywords for Google Ads campaigns 1 API call
meta_audience_create targeting_spec Create a custom or lookalike audience on Meta 1 API call

Custo e limites

O que custa rodar

Cota de API
Subject to Google Ads API and Meta Marketing API rate limits
Tokens por chamada
300–2000 tokens depending on report size
Monetário
The MCP server itself requires setup — check pricing at the project's site. API calls are free within platform quotas.
Dica
Pull aggregated reports instead of item-by-item queries to stay within rate limits.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Google Ads API read/write Meta Marketing API read/write GA4 reporting
Armazenamento de credenciais: OAuth 2.1 — credentials managed server-side, not stored locally
Saída de dados: Calls to Google Ads API, Meta Marketing API, and Google Analytics Data API
Nunca conceda: Account-level admin access unless you need to create new campaigns

Solução de problemas

Erros comuns e correções

OAuth authentication failed

Re-authorize through the setup flow. Ensure your Google/Meta accounts have the required API access enabled.

Verificar: Check the server logs for specific OAuth error messages
No data returned from GA4

GA4 data has a 24-48 hour processing delay. For recent data, use realtime reporting.

Verificar: Try pulling data from 3+ days ago
Rate limit exceeded

Google Ads and Meta APIs have different rate limits. Reduce query frequency or batch requests.

Verificar: Check API quota dashboards in Google/Meta developer consoles

Alternativas

google-meta-ads-ga4-mcp vs. outros

AlternativaQuando usarTroca
Direct API accessYou need fine-grained control over API parameters not exposed by the MCP toolsMore flexibility but requires writing API code yourself

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills