google-ads-manager-mcp

Google Ads Manager MCP

非公式のコミュニティ運営プロジェクトです。Google との提携、承認、後援は受けていません。 「Google Ads」は Google LLC の商標です。

AI アシスタントが Google Ads アカウントを読み取り、管理できるローカル MCP（Model Context Protocol）サーバーです。GAQL レポートの実行、キャンペーンの作成、一時停止／有効化、キーワードの追加ができます。

Google は公式の Google Ads MCP サーバーも公開していますが、こちらは読み取り専用（レポート／診断のみ）です。このプロジェクトは同じレポート機能を備え、さらにキャンペーン、予算、広告グループ、キーワード、広告の作成や編集といった書き込みにも対応しています。誤操作によるアカウント変更を防ぐため、下書き／確認の安全レイヤーを設けています。

すべての書き込みは、下書き → 確認の安全フローを通ります。「作成」または「更新」を行うツールは、Google の API（validate_only）に対して変更を検証するだけで、プレビュー付きのdraftIdを返します。そのdraftIdを指定してconfirm_writeを呼び出すまで、Ads アカウントには何も変更されません。下書きは10分後に期限切れになります。

ツール

読み取り専用：

• list_accessible_customers — このリフレッシュトークンでアクセスできるアカウント
• search_gaql — 任意の生の GAQL SELECT クエリを実行
• get_campaigns — ステータス、予算、主要な指標を含むキャンペーン
• get_ad_groups — 広告グループ（任意でキャンペーンに絞り込み）と指標
• get_keywords — マッチタイプ、ステータス、指標を含むキーワード条件
• get_search_terms — 広告が表示されるきっかけとなった実際の検索語句。除外キーワード候補の特定に使用

書き込み（下書き → 確認）：

• create_campaign — 新しいキャンペーンと予算を作成。特に指定がなければPAUSEDで作成
• update_campaign_status — キャンペーンを有効化／一時停止／削除
• update_campaign_budget — 既存キャンペーンの日予算を変更
• add_keywords — 広告グループにキーワード条件を追加
• create_ad_group — 既存キャンペーン内に新しい広告グループを作成
• update_ad_group_status — 広告グループを有効化／一時停止／削除
• update_keyword_status — キーワード条件を有効化／一時停止／削除
• add_negative_keywords — 広告グループに除外キーワード条件を追加
• create_responsive_search_ad — 新しいレスポンシブ検索広告を作成。特に指定がなければPAUSEDで作成
• confirm_write — 以前に返されたdraftIdを実際に実行

セットアップ

1. Google Ads デベロッパートークン

Google Ads → ツールと設定 → API センター。テストアカウント用のトークンはすぐに発行されます。本番環境レベルのトークンには Google による手動審査が必要（通常1～2週間）なため、テストアカウント以外で使用する場合は早めに申請してください。

2. OAuth クライアント

Google Cloud Console → API とサービス → 認証情報 → 認証情報を作成 → OAuth クライアント ID。 アプリケーションの種類にデスクトップアプリを選択します。クライアント ID とクライアントシークレットをコピーしてください。

3. 環境を設定

cp .env.example .env

GOOGLE_ADS_CLIENT_ID、GOOGLE_ADS_CLIENT_SECRET、GOOGLE_ADS_DEVELOPER_TOKEN、GOOGLE_ADS_CUSTOMER_ID（このサーバーで管理するアカウント。10桁で、ハイフンは省略可能）を入力します。そのアカウントがマネージャー（MCC）アカウント配下のクライアントである場合は、GOOGLE_ADS_LOGIN_CUSTOMER_IDにもマネージャーアカウントの ID を設定してください。

4. リフレッシュトークンを取得

npm install
npm run auth

認証 URL が開きます。URL を開き、Ads アカウントにアクセスできる Google アカウントでログインし、adwordsスコープを承認してください。スクリプトにGOOGLE_ADS_REFRESH_TOKENが表示されるので、.envに追加します。

5. ビルド

npm run build

6. MCP クライアントから接続

Claude Desktop／Claude Code の場合、MCP 設定に次を追加します。

{
  "mcpServers": {
    "google-ads-manager": {
      "command": "node",
      "args": ["/absolute/path/to/google ads manger mcp/build/index.js"],
      "env": {
        "GOOGLE_ADS_CLIENT_ID": "...",
        "GOOGLE_ADS_CLIENT_SECRET": "...",
        "GOOGLE_ADS_DEVELOPER_TOKEN": "...",
        "GOOGLE_ADS_REFRESH_TOKEN": "...",
        "GOOGLE_ADS_CUSTOMER_ID": "..."
      }
    }
  }
}

（またはenvブロックを省略し、.envが設定済みであることを確認してください。サーバーを直接実行すると、ローカルでの反復開発中にnpm run devを実行する場合など、dotenvを使って読み込まれます。）

注意事項

• これは単一の Google Ads アカウント（GOOGLE_ADS_CUSTOMER_ID）を対象としています。1 つのマネージャー アカウント配下の複数のクライアント アカウントを管理するには、顧客 ID ごとに 1 つのインスタンスを実行するか、googleAdsClient.ts を拡張して各ツールの呼び出し時に customerId 引数を受け取るようにしてください。
• 新しいキャンペーンはデフォルトで PAUSED（startEnabled: false）に設定されるため、明示的に有効にするまで費用は発生しません。

コントリビューション

Issue や PR を歓迎します。レポートタイプの追加、キャンペーン単位の除外キーワード対応、複数アカウント（MCC）の処理が、今後特に有用な追加機能です。

ライセンス

MIT