Claude Code
X Ads を Claude Code に接続するには、claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp で PaidSync.ai にサインインします。
これで Claude Code は14個のツールで X の広告アカウントにアクセスできます。アカウント、キャンペーン、ラインアイテム別のパフォーマンスに加え、既存キャンペーンの停止、再開、予算、入札の変更が可能です。Claude Code は各ツールを実行する前に確認します。
管理ティア。Claude Code はすでに運用中のキャンペーンを扱います。新しい X キャンペーンは作成しません。
コマンド
Claude Code は Streamable HTTP でリモート MCP サーバーと通信します。PaidSync もその一つです。一度追加すれば、コードを編集する同じターミナルから X キャンペーンのレポートと管理ができます。
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 ダッシュボードで X Ads を接続
X Ads の 接続 をクリックし、広告アカウントを開ける X アカウントでサインインしてから、PaidSync を認可します。X Ads は X OAuth で認証され、PaidSync が X のパスワードを見ることはありません。
すでに Claude Code を使っていますか。connect_x_ads の実行を頼んでください。ツールがブラウザで開くリンクを返します。
3Claude Code が作業する広告アカウントを選択
セッション内では、list_x_accounts が X ログインで利用できるすべての広告アカウントを表示し、set_active_x_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日間の X の費用、インプレッション、クリックをキャンペーン別に見せて”
Claude Code は各キャンペーンの費用、インプレッション、クリック、エンゲージメントを返します。接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code で試せる X Ads のプロンプト
以下の各プロンプトは、PaidSync の X Ads グループのツールに対応しています。ツールは Claude Code が選びます。右端の列は、その呼び出しで広告アカウントに変更が入るかどうかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “X の広告アカウントを一覧にして、Acme を有効にして” | list_x_accounts, set_active_x_account | なし |
| “過去7日間のキャンペーンを、費用、インプレッション、クリック、エンゲージメントつきで見せて” | get_x_performance | なし |
| “過去30日間で最も費用を使ったラインアイテムはどれ” | get_x_performance | なし |
| “このキャンペーンのラインアイテムを一覧にして” | list_x_line_items | なし |
| “Spring Launch キャンペーンを一時停止して” | list_x_campaigns, pause_x_campaign | はい、確認後に実行されます |
| “Retargeting キャンペーンの一日予算を80に設定して” | update_x_campaign_budget | はい、確認後に実行されます |
| “Lookalikes ラインアイテムの入札を1.50に下げて” | list_x_line_items, update_x_line_item | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull last 30 days X performance at line item level and list the line items with the highest spend and no clicks." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/x-ads-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
14個の X Ads ツールのうち、7個は読み取り専用、5個は書き込みができます。読み取りの対象は、広告アカウント、キャンペーン、ラインアイテム、プロモーテッドポスト、パフォーマンスです。
続きを読む
書き込みの対象は、キャンペーンの停止と再開、キャンペーンの一日予算、ラインアイテムのステータスと入札、キャンペーンとラインアイテムの名前です。
更新ツールによる予算、入札、名前、ステータスの編集は、dry_run でデフォルトでプレビューされ、PaidSync は変更後に X から各変更を読み戻します。
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
X で Claude Code にできないこと
- PaidSync は X のキャンペーン、ラインアイテム、プロモーテッドポストを作成しません。X Ads Manager で作成してから、Claude Code で管理してください。
- クリエイティブのアップロードツールはありません。
- PaidSync には、ターゲティング、カスタムオーディエンス、コンバージョンレポートに対応する X ツールはありません。
- ラインアイテムの停止と再開は
update_x_line_itemで、キャンペーンはpause_x_campaignとenable_x_campaignで行います。 - 金額は広告アカウント自身の通貨とタイムゾーンに基づきます。
よくある質問
X Ads を Claude Code に接続するには
paidsync.ai に登録し、ダッシュボードで OAuth 経由で X Ads を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで、PaidSync のログインでサインインします。
Claude Code で X のキャンペーンを作成できますか
いいえ。PaidSync では X Ads は管理ティアのプラットフォームです。Claude Code は既存キャンペーンのレポート、停止と再開、予算とラインアイテム入札の変更ができます。新しいキャンペーンは X Ads Manager で作成します。
Claude Code で X Ads の予算を変更できますか
はい。update_x_campaign_budget はキャンペーンの日予算を、update_x_line_item はラインアイテムの入札を変更します。どちらも最初にドライランでプレビューされ、Claude Code は各ツールを実行する前に確認します。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
X Ads のレポートとキャンペーン管理を、Claude Code のコマンドひとつで。