Claude Code
Meta Ads を Claude Code に接続するには、claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp で PaidSync.ai にサインインします。
Claude Code は 92 のツールで Meta 広告アカウントにアクセスします。配置、年齢、国、デバイス別の成果、広告セット、オーディエンス、クリエイティブ、キャンペーン構築に対応し、各ツールの実行前に確認します。Meta の書き込みの多くは先にドライランでプレビューします。
コマンド一つ。OAuth で鍵の貼り付け不要。無料プラン月 100 タスク、$50 相当、カード不要。
コマンド
Claude Code は Streamable HTTP でリモート MCP サーバーと通信します。PaidSync はその一つです。一度追加すれば、コードを編集するのと同じターミナルから、Meta 広告アカウントの読み取りと変更ができます。
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 ダッシュボードで Meta Ads を接続する
Meta Ads の接続をクリックし、Business Manager を管理している Facebook アカウントでサインインします。Meta Ads は、ads_read と ads_management の権限で Facebook OAuth により認可されます。PaidSync はトークンを AES-256-GCM で暗号化して保存します。
すでに Claude Code の中にいますか。connect_facebook_ads の実行を依頼してください。ブラウザで開く OAuth リンクがツールから返ります。
3Claude Code が作業する広告アカウントを選択
サインイン後、PaidSync はそのログインでアクセスできる Meta 広告アカウントを一覧表示します。このワークスペースで使うものにチェックを入れてください。セッション内では、list_fb_ad_accounts がそれらを表示し、set_fb_ad_account がアクティブなアカウントを選びます。
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 日間の Meta の成果をキャンペーン別に見せて”
Claude Code は、アクティブな広告アカウントの各キャンペーンについて、費用、インプレッション、クリック、CTR、CPC、ROAS を返します。接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code 向け Meta Ads プロンプト
以下の各プロンプトは、PaidSync の Meta Ads グループのツールに対応します。ツールは Claude Code が選びます。最後の列は、その呼び出しが広告アカウントの何かを変更できるかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “過去 7 日間のキャンペーンの成果を、費用、CTR、CPC、ROAS つきで見せて” | get_fb_performance | なし |
| “今月、最も安くコンバージョンを獲得した配置はどれですか” | get_fb_performance_by_placement | なし |
| “過去 14 日間のすべての広告を CTR 順にランク付けして” | get_fb_ad_performance | なし |
| “アクティブなアカウントの今月の予算ペースはどうですか” | get_fb_budget_pacing | なし |
| “結果あたりの費用が最も高い三つの広告セットを停止して” | get_fb_adset_performance, pause_fb_adset | はい、確認後に実行されます |
| “最も成果の良い広告セットを、広告ごと Prospecting キャンペーンに複製して” | duplicate_fb_adset | はい、確認後に実行されます |
| “米国の Purchasers オーディエンスの 1% 類似オーディエンスを作って” | create_fb_lookalike_audience | はい、確認後に実行されます |
| “日予算 $50 の売上キャンペーンを下書きして、プレビューを見せて” | create_fb_campaign | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull last 7 days Meta performance by placement and list the placements with the highest cost per result." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/meta-ads-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
92 個の Meta Ads ツールのうち、53 個は読み取り専用で、36 個は書き込みができます。
読み取りの対象は、キャンペーン、広告セット、広告レベルの成果、年齢と性別、国、デバイス、配置、時間帯別の内訳、予算ペース、ピクセル、カタログ、アカウントのアクティビティログです。
続きを読む
書き込みの対象は、キャンペーン、広告セット、広告、クリエイティブ、オーディエンス、リードフォーム、自動ルール、予算スケジュールです。いずれもデフォルトで dry_run によりプレビューされますが、upload_fb_ad_image と upload_fb_ad_video は最初の呼び出しで適用されます。
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
知っておきたい制限
delete_fb_campaignとdelete_fb_audienceは完全な削除です。履歴を残したい場合は、代わりに停止してください。- 複製した広告セットは停止状態で作成され、デフォルトでは広告は含まれません。広告もコピーするには
deep_copyを渡してください。 get_fb_leadsは名前、メールアドレス、電話番号を返します。出力をリポジトリ内のファイルに書き込む場合は、そのファイルをバージョン管理に含めないでください。- 予算をどこに置くかで、残りが決まります。キャンペーンに予算を置くと、Meta がそれを広告セットに分配します。置かなければ、各広告セットがそれぞれ予算を持ちます。
よくある質問
Claude Code で Meta Ads を接続するにはどうすればよいですか。
paidsync.ai に登録し、ダッシュボードで Facebook OAuth により Meta Ads を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで、PaidSync のログインでサインインしてください。
Claude Code は Meta キャンペーンを作成できますか。
はい。Meta Ads は PaidSync の構築階層のプラットフォームです。Claude Code は、キャンペーン、広告セット、広告、オーディエンスを作成できます。ほとんどの書き込みはまずドライランとしてプレビューされ、Claude Code は各ツールを実行する前に確認します。画像と動画のアップロードは最初の呼び出しで適用されます。
PaidSync はどの Meta 権限を要求しますか。
PaidSync は Facebook OAuth を通じて ads_read と ads_management を要求します。これは、接続した広告アカウントのキャンペーン、広告セット、広告、オーディエンス、成果データの読み取りと書き込みをカバーします。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
Meta Ads ツール 92 個を Claude Code で。