mcp-google-ads MCP — ユースケース, インストール & ライブデモ

なぜ使うのか

主な機能

GAQL passthrough — full query power, not just pre-baked reports
OAuth (for individuals) or Service Account (for automation)
Campaign, ad group, ad, and keyword metrics
Impressions, clicks, conversions, cost, CTR, avg CPC
Python 3.11+; .env-based config

ライブデモ

実際の動作

google-ads.replay ▶ 準備完了

0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-ads": {
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "google-ads",
      "command": "uvx",
      "args": [
        "mcp-google-ads"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json

{
  "context_servers": {
    "google-ads": {
      "command": {
        "path": "uvx",
        "args": [
          "mcp-google-ads"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add google-ads -- uvx mcp-google-ads

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方： mcp-google-ads

Weekly campaign health check across accounts

👤 Paid marketing managers, agencies ⏱ ~20 min intermediate

使うタイミング： Weekly — which campaigns are burning budget with poor CTR / high CPA?

前提条件

Google Ads Developer Token (approved) — ads.google.com > Tools > API Center — 1-3 business days
OAuth client OR service account with Ads access — Google Cloud Console

フロー

List accounts

List all Google Ads accounts I can access.✓ コピーしました

→ MCC + child accounts
Pull performance

For each account, pull last 7 days: campaign name, cost, clicks, conversions, CPA. Flag campaigns where CPA > $100.✓ コピーしました

→ Ranked hot-spot list
Propose action

For the worst 3 campaigns, suggest: pause, lower bid, or investigate further based on the numbers.✓ コピーしました

→ Action plan

結果： Weekly hotspot review in minutes.

注意点

Attribution windows differ by conversion action — Include segments.conversion_action_name and check each separately

組み合わせ： notion

Mine search terms for negative keywords

👤 Performance marketers ⏱ ~15 min intermediate

使うタイミング： Regular account hygiene — catch wasteful queries before they add up.

フロー

Pull search terms

GAQL: search_term_view for last 30 days, columns [search_term, campaign, cost, conversions]. Cost > $10 and conversions = 0.✓ コピーしました

→ Wasteful query list
Group and recommend

Group by recurring phrases. Suggest negative keywords to add at account or campaign level.✓ コピーしました

→ Negative list with level

結果： A tidy negative-keyword list to apply.

注意点

Broad-matching negatives can block legit traffic — Use exact or phrase negatives first; broad only when very confident

Audit ad copy performance across a campaign

👤 Copywriters, PPC leads ⏱ ~15 min intermediate

使うタイミング： You launched 3 responsive ads and want to know which combos perform.

フロー

Pull ad stats

For campaign X, list all ads + their 30-day CTR + conv rate. Sort by conv rate desc.✓ コピーしました

→ Ad performance ranked
Recommend

What patterns distinguish top-performing ad copy? What should I iterate on?✓ コピーしました

→ Copy insights

結果： Data-driven creative iteration.

注意点

Low-volume ads look worse than they are due to variance — Require minimum 100 impressions before comparing rates

組み合わせ

他のMCPと組み合わせて10倍の力を

google-ads + notion

Weekly marketing digest

Pull last week's Google Ads performance + biggest wins/losses; create a Notion page in 'Marketing Weekly'.✓ コピーしました

google-ads + postgres

Join Google Ads data with your DB for full-funnel view

Get conversion counts from Google Ads for campaign X. Query the DB for actual closed deals originating from that campaign.✓ コピーしました

ツール

このMCPが提供する機能

ツール	入力	呼び出すタイミング	コスト
list_accessible_accounts		Discover the account graph	1 API call
run_gaql	customer_id, query: str	Any custom report	1 API call
campaign_performance	customer_id, date_range	Quick campaign digest	1 API call
ad_performance	customer_id, campaign_id?, date_range	Creative audit	1 API call

コストと制限

運用コスト

APIクォータ: Google Ads API: generous per-day quota; rate-limited per QPS
呼び出しあたりのトークン: Results depend heavily on date range and segments — cap rows
金額: API is free; you pay for ads separately
ヒント: Always include a date range in GAQL. Running without LIMITs can return 100k rows.

セキュリティ

権限、シークレット、影響範囲

最小スコープ： Read-only on the Ads accounts where possible

認証情報の保管： Service account JSON or OAuth refresh token — env vars or secret manager

データ送信先： Performance data goes to your LLM provider

絶対に付与しない： Admin on the Ads account to an agent that does more than read

Developer Token approval has tiers — test tokens have low quota. Apply for production.
Service account must be added as a user in Ads MCC with appropriate role.

トラブルシューティング

よくあるエラーと対処法

AUTHENTICATION_ERROR or PERMISSION_DENIED

Service account email not added to MCC with access, or developer_token wrong. Check ads.google.com > Access & Security.

Too many metrics for segment

GAQL has restrictions on which metrics can be combined with which segments. Query a simpler subset.

確認： Read the GAQL compatibility table

Test token quota exceeded

Apply for production token; until then, test on small accounts with low query frequency.

代替案

mcp-google-ads 他との比較

代替案	代わりに使う場面	トレードオフ
Google Ads UI / Editor	You only occasionally pull reports	Manual; no LLM insight
Meta Ads MCP	You also run Meta ads	Different platform; own auth

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る