Claude Code
Google Ads を Claude Code に接続するには、PaidSync.ai を追加します。claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp と入力して、PaidSync のログイン情報でサインインします。
Claude Code は 158 個のツールで Google Ads アカウントに届きます。監査、検索語句、キーワード、予算、入札、キャンペーンの構築に対応します。Claude Code は各ツールの実行前に確認し、Google Ads へのほとんどの書き込みは先にドライランでプレビューされます。
コマンド一つ。OAuth で鍵の貼り付け不要。無料プラン月 100 タスク、$50 相当、カード不要。
コマンド
Claude Code は、Streamable HTTP でリモートの MCP サーバーと通信します。PaidSync もその一つです。一度追加すれば、コードを編集するのと同じターミナルから Google Ads アカウントを読み取り、変更できます。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpデフォルトでは、現在のプロジェクトにのみサーバーを登録します。--scope user を追加すると、お使いのマシン上のすべてのプロジェクトで利用できます。
claude mcp list を実行して登録を確認し、セッションを開始して /mcp と入力してサインインします。
5 ステップのセットアップ
1paidsync.ai/signup で登録
所要時間は 10 秒。Google またはメールでサインインします。無料プランは月 100 タスクで $0、カード不要です。
2PaidSync ダッシュボードで Google Ads を接続する
Google Ads の 接続 をクリックし、広告アカウントに届く Google アカウントでサインインします。Google Ads は Google OAuth で認可されます。PaidSync はトークンを AES-256-GCM で保存時に暗号化し、Google のパスワードを見ることはありません。
すでに Claude Code の中にいますか？ connect_google_ads の実行を頼んでください。ツールがブラウザで開く OAuth リンクを返します。
3Claude Code が参照するアカウントを選ぶ
サインイン後、PaidSync はそのログインで届く Google Ads アカウントを一覧表示します。このワークスペースに含めるものにチェックを入れます。セッション内では、list_accounts でそれらが表示され、set_active_account で Claude Code が作業するアカウントを選びます。
4PaidSync を Claude Code に追加する
ターミナルで次を実行します。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpセッションを開始して /mcp と入力し、paidsync を選んで、開いたブラウザウィンドウで PaidSync のログインでサインインします。OAuth トークンは Claude Code が保存します。キーはどこにも貼り付けません。
チームで設定しますか？リポジトリのルートに .mcp.json をコミットすれば、エンジニア全員が同じコネクタを使えます。
{
"mcpServers": {
"paidsync": { "type": "http", "url": "https://mcp.paidsync.ai/mcp" }
}
}ヘッドレス実行などで API キーを使いたいですか？ログに残ってしまう URL ではなく、ヘッダーで送ってください。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp --header "Authorization: Bearer $PAIDSYNC_API_KEY"コミットする .mcp.json には "headers": { "Authorization": "Bearer ${PAIDSYNC_API_KEY}" } を追加すると、キーは各エンジニアの環境に残り、git には入りません。Google Ads の変更の適用には、引き続き OAuth サインインが必要です。ほかのプラットフォームではキーでも変更を適用できるため、パスワードと同じように扱い、OAuth を優先してください。
5接続をテスト
Claude Code のセッションで次のように質問します。“過去 7 日間の Google Ads の成果をキャンペーン別に表示してください”
Claude Code は、有効なアカウントの各キャンペーンについて、インプレッション、クリック、費用、コンバージョンを返します。接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code の Google Ads 例
以下のプロンプトは、それぞれ PaidSync の Google Ads グループのツールに対応します。ツールは Claude Code が選びます。最後の列は、その呼び出しがアカウントを変更し得るかどうかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “アカウントを監査し、費用が最も多い修正点を五つ挙げてください” | run_account_audit | なし |
| “過去 30 日間のキャンペーン成果を費用順に、コンバージョンつきで表示してください” | get_campaign_performance | なし |
| 「今月、費用が発生したのにコンバージョンがゼロだった検索語句は？」 | get_search_terms_report, get_wasted_spend_report | なし |
| “過去 30 日間の検索語句を n-gram に分解し、除外キーワードを提案してください” | analyze_search_term_ngrams | なし |
| “それら五つの語を、ブランドキャンペーンにフレーズ一致の除外キーワードとして追加してください” | add_negative_keywords | はい、確認後に実行されます |
| “ジェネリックキャンペーンの日予算を 20 パーセント減らしてください” | update_campaign_budget | はい、確認後に実行されます |
| “先週、費用が発生したのにコンバージョンがなかったキャンペーンをすべて一時停止してください” | get_campaign_performance, pause_campaign | はい、確認後に実行されます |
| “新しい商品ラインの一時停止状態の Search キャンペーンを作成してください” | create_search_campaign | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull last 7 days Google Ads performance by campaign and flag any campaign that spent money with zero conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/google-ads-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
158 個の Google Ads ツールのうち、64 個は読み取り専用、94 個は書き込みができます。
続きを読む
読み取りは、パフォーマンス、キーワード、検索語句、品質スコア、オークション分析、予算ペース、変更履歴を対象とし、get_keyword_performance、get_quality_score_report、get_auction_insights、get_budget_pacing、get_change_history などのツールを使います。
書き込みは、予算、入札、キーワード、除外キーワード、広告、拡張機能、オーディエンス、キャンペーンの構築を対象とします。Google Ads の作成ツールとほとんどの書き込みは、dry_run により既定でプレビューされるため、最初の呼び出しで変更内容が表示され、二回目の呼び出しで適用されます。
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
知っておきたい制限
create_search_campaignは、Search のみのキャンペーンを一時停止の状態で構築します。検索パートナーとディスプレイネットワークはオフで始まり、地域ターゲティングは所在地のみ、入札は、別の戦略を指定しない限り手動 CPC です。- 予算の 50 パーセントを超える変更には、
confirm_large_changeが、confirm_destructiveに加えて必要です。このガードにより、予算が誤って 10x になったり、ゼロに設定されたりするのを防ぎます。 remove_campaignは Google Ads では元に戻せません。削除したキャンペーンを再び有効にすることはできません。配信を止めたいだけならpause_campaignを使ってください。アカウント監査は過去 30 日間を対象とし、各ディメンションの費用の上位部分をスキャンするため、スコアはすべてのキーワードではなく、お金が使われている箇所を反映します。
キーワードレポートは上位 100 件のキーワードを、品質スコアレポートは上位 200 件を返します。
よくある質問
Google Ads を Claude Code に接続するには？
paidsync.ai に登録し、ダッシュボードで Google OAuth により Google Ads を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで、PaidSync のログインでサインインします。
Claude Code は Google Ads のキャンペーンを変更できますか？
はい。Claude Code は、除外キーワードの追加、予算の変更、キャンペーンの一時停止と有効化、一時停止状態の Search キャンペーンの作成ができます。Claude Code は、許可していない限り、各ツールの実行前に確認します。ほとんどの書き込みは先にドライランとしてプレビューされ、削除、一時停止、予算の変更には明示的な確認が必要です。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
Google Ads のデベロッパートークンは必要ですか？
いいえ。PaidSync は https://mcp.paidsync.ai/mcp にあるホスト型サーバーです。Google Ads へは PaidSync ダッシュボードの Google OAuth で、PaidSync へは Claude Code の /mcp でサインインします。
無料ですか？
はい。無料プランは月 100 タスクが $0 でカード不要です。Pro は月 $99 から、Team は月 $249 からです。Claude Code 自体には、それを含む Anthropic のプランが必要です。
Google Ads ツール 158 個、Claude Code で一発。