/ Каталог / Песочница / google-meta-ads-ga4-mcp
● Сообщество irinabuht12-oss ⚡ Сразу

google-meta-ads-ga4-mcp

автор 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.

Зачем использовать

Ключевые функции

Живое демо

Как выглядит на практике

google-meta-ads-ga4.replay ▶ готово
0/0

Установка

Выберите клиент

~/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
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.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 использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

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
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "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
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

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

Continue использует массив объектов серверов, а не 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"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

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

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: 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

Когда использовать: Your weekly performance review needs data from both Google Ads and Meta Ads.

Предварительные требования
  • OAuth authentication complete — Follow the setup guide to authorize Google and Meta accounts
Поток
  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.✓ Скопировано
    → 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.✓ Скопировано
    → Specific recommendations with data backing

Итог: A unified performance view with actionable optimization recommendations.

Подводные камни
  • 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

Когда использовать: You want to set up a new Meta Ads campaign without navigating the complex Ads Manager UI.

Предварительные требования
  • Meta Ads account authorized — Complete OAuth setup for your Meta Business account
Поток
  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.✓ Скопировано
    → Campaign, ad set, and targeting configured
  2. Upload creative
    Upload these 3 product images as ad creatives and create carousel ads with them.✓ Скопировано
    → Ads created with images and copy

Итог: A complete Meta Ads campaign ready to launch.

Подводные камни
  • 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

Когда использовать: You want to understand where your traffic comes from and how users behave.

Предварительные требования
  • GA4 property authorized — Complete OAuth setup for your Google Analytics account
Поток
  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.✓ Скопировано
    → 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?✓ Скопировано
    → Page-level analysis with actionable insights

Итог: Clear understanding of traffic patterns and user behavior for optimization.

Подводные камни
  • GA4 data can have 24-48 hour processing delays — Use realtime reporting for today's data, standard reports for historical analysis

Комбинации

Сочетайте с другими MCP — эффект x10

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/.✓ Скопировано

Инструменты

Что предоставляет этот MCP

ИнструментВходные данныеКогда вызыватьСтоимость
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

Стоимость и лимиты

Во что обходится

Квота API
Subject to Google Ads API and Meta Marketing API rate limits
Токенов на вызов
300–2000 tokens depending on report size
Деньги
The MCP server itself requires setup — check pricing at the project's site. API calls are free within platform quotas.
Совет
Pull aggregated reports instead of item-by-item queries to stay within rate limits.

Безопасность

Права, секреты, радиус поражения

Минимальные скоупы: Google Ads API read/write Meta Marketing API read/write GA4 reporting
Хранение учётных данных: OAuth 2.1 — credentials managed server-side, not stored locally
Исходящий трафик: Calls to Google Ads API, Meta Marketing API, and Google Analytics Data API
Никогда не давайте: Account-level admin access unless you need to create new campaigns

Устранение неполадок

Частые ошибки и исправления

OAuth authentication failed

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

Проверить: 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.

Проверить: 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.

Проверить: Check API quota dashboards in Google/Meta developer consoles

Альтернативы

google-meta-ads-ga4-mcp в сравнении

АльтернативаКогда использоватьКомпромисс
Direct API accessYou need fine-grained control over API parameters not exposed by the MCP toolsMore flexibility but requires writing API code yourself

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills