Claude Code
Microsoft Ads を Claude Code に接続するには、PaidSync.ai を追加します。claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp と入力して、PaidSync のログイン情報でサインインします。
Claude Code は 156 のツールで Microsoft Ads にアクセスします。キャンペーン、広告グループ、キーワード、検索語句のレポートに加え、既存キャンペーン内の一時停止、予算、除外キーワード、新しい広告グループ・キーワード・広告の追加に対応し、各ツールの実行前に確認します。
構築ティア。Claude Code は既存キャンペーン内で作業し、新しい広告グループ、キーワード、広告は、指定しない限りすべて一時停止の状態で始まります。
コマンド
Claude Code は Streamable HTTP でリモート MCP サーバーと通信します。PaidSync もそのひとつです。一度追加すれば、コードを編集するのと同じターミナルから、Microsoft のキャンペーンのレポートや管理ができます。
claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcpデフォルトでは、現在のプロジェクトにのみサーバーを登録します。--scope user を追加すると、お使いのマシン上のすべてのプロジェクトで利用できます。
claude mcp list を実行して登録を確認し、セッションを開始して /mcp と入力してサインインします。
5 ステップのセットアップ
1paidsync.ai/signup で登録
所要時間は 10 秒。Google またはメールでサインインします。無料プランは月 100 タスク、$50 相当で $0、カード不要です。
2PaidSync ダッシュボードで Microsoft Ads を接続する
Microsoft Ads の 接続 をクリックし、Microsoft Advertising アカウントを開ける Microsoft アカウントでサインインします。Microsoft Ads は Microsoft OAuth で認可され、デベロッパートークンは PaidSync 側で処理します。
すでに Claude Code を使っていますか？ connect_microsoft_ads の実行を依頼してください。ツールが、ブラウザで開くリンクを返します。
3Claude Code が作業する広告アカウントを選択
セッション内では、list_ms_accounts がサインインで利用できる Microsoft Ads アカウントを表示し、set_active_microsoft_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 のセッションで次のように尋ねます：“過去 30 日間の Microsoft Ads キャンペーンを、費用、クリック数、コンバージョン数、ROAS 付きで表示してください”
Claude Code は各キャンペーンの費用、クリック数、インプレッション数、コンバージョン数、収益、CTR、平均 CPC、ROAS を返します。接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code 向け Microsoft Ads プロンプト
以下の各プロンプトは、PaidSync の Microsoft Ads グループのツールに対応しています。ツールは Claude Code が選びます。最後の列は、その呼び出しが広告アカウントを変更する可能性があるかどうかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “Microsoft Ads アカウントを一覧表示し、Acme をアクティブにしてください” | list_ms_accounts, set_active_microsoft_account | なし |
| “過去 30 日間のキャンペーンを、費用、クリック数、コンバージョン数、ROAS 付きで表示してください” | get_ms_performance | なし |
| “過去 30 日間に費用が発生したのにコンバージョンがなかった検索語句は” | get_ms_search_query_performance | なし |
| “ワースト五件を完全一致の除外キーワードとして Brand Search キャンペーンに追加してください” | add_ms_negative_keywords | はい、確認後に実行されます |
| “Spring Sale キャンペーンを一時停止してください” | pause_ms_campaign | はい、確認後に実行されます |
| “Brand Search キャンペーンの日予算を $80 に上げてください” | update_ms_campaign_budget | はい、確認後に実行されます |
| “Running キャンペーンに Trail Shoes という広告グループを、フレーズ一致キーワード五つとレスポンシブ検索広告ひとつで追加してください” | create_ms_adgroup, add_ms_keywords, add_ms_responsive_search_ad | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull last 30 days Microsoft Ads search terms and list the terms that spent money with no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/microsoft-ads-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
156 の Microsoft Ads ツールのうち、82 は読み取り専用で、72 は書き込みができます。読み取りは、キャンペーン、広告グループ、キーワード、検索語句、コンバージョン、地域、オーディエンスのパフォーマンスを対象とします。
続きを読む
書き込みは、一時停止、予算、広告グループとキーワードの変更、除外キーワード、新しい広告グループ、キーワード、レスポンシブ検索広告、オーディエンス、UET タグ、コンバージョンゴールを対象とします。
予算、除外キーワード、広告グループ、キーワード、広告の変更は、デフォルトで dry_run によりプレビューされ、新しい広告グループ、キーワード、広告は一時停止の状態で始まります。
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
Claude Code が Microsoft でできないこと
- PaidSync は Microsoft Ads でショッピングキャンペーンやオーディエンスキャンペーンを作成しません。それらは Microsoft Advertising で作成するか、Google Ads からインポートしてください。その後は PaidSync がその中で構築します。
- 入札戦略やラベル用の Microsoft Ads ツールはありません。
- PaidSync が Microsoft Ads で作成または編集する広告タイプは、レスポンシブ検索広告のみです。
- PaidSync は広告、広告グループ、キーワードを削除しません。代わりに一時停止します。
- 一時停止したキャンペーンは
enable_ms_campaignで再び有効にできます。
よくある質問
Microsoft Ads を Claude Code に接続するには？
paidsync.ai でサインアップし、ダッシュボードで Microsoft Ads を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで PaidSync のログインでサインインします。
Claude Code は Microsoft Ads キャンペーンを作成できますか？
PaidSync は検索キャンペーンと Performance Max キャンペーンを一時停止の状態で作成し、既存キャンペーン内では新しい広告グループ、キーワード、レスポンシブ検索広告を構築します。ショッピングキャンペーンとオーディエンスキャンペーンは Microsoft Advertising で作成します。
Claude Code は Microsoft Ads の予算を変更できますか？
はい。update_ms_campaign_budget はキャンペーンの予算を変更します。まずドライランでプレビューし、適用後は Microsoft から新しい予算を読み戻して確認します。Claude Code はツールを実行する前に確認を求めます。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
Microsoft Ads のレポートと変更を Claude Code で。