Claude Code
ChatGPT Ads を Claude Code に接続するには、PaidSync.ai を追加します。claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp と入力して、PaidSync のログイン情報でサインインします。
Claude Code は 28 のツールで ChatGPT Ads にアクセスします。キャンペーン、広告グループ、広告のレポート、キャンペーン、広告グループ、チャットカード広告の作成、稼働中のものの停止・再開・更新・アーカイブに対応し、各ツールの実行前に確認します。
ビルド階層です。Claude Code は ChatGPT Ads のキャンペーン、広告グループ、広告を作成でき、新しい広告グループは再開するまで一時停止状態で始まります。
コマンド
Claude Code は、Streamable HTTP 経由でリモート MCP サーバーと通信します。PaidSync はそのひとつです。一度追加すれば、コードを編集するのと同じターミナルで、ChatGPT 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 タスク、$50 相当で $0、カード不要です。
2PaidSync ダッシュボードで ChatGPT Ads を接続
ChatGPT Ads の 接続 をクリックします。ChatGPT Ads Manager で広告アカウントを開ける OpenAI アカウントでサインインし、OpenAI Ads の API キーを貼り付けます。ads.openai.com の ChatGPT Ads Manager で、広告アカウントの Settings からキーを作成します。各キーは広告アカウントひとつだけに接続され、platform.openai.com のキーは拒否されます。PaidSync はキーを保存時に暗号化します。
すでに Claude Code の中にいますか？ connect_openai_ads を実行するよう頼んでください。このツールは PaidSync ダッシュボードへのリンクを返すので、そこでキーを貼り付けます。
3Claude Code が作業する広告アカウントを選択
セッション内で、list_openai_accounts が接続済みの ChatGPT Ads アカウントを表示し、set_active_openai_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 日間の ChatGPT Ads キャンペーンを、費用、クリック数、インプレッションとともに見せて」
Claude Code は各キャンペーンの費用、クリック数、インプレッションを返します。接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code 向け ChatGPT Ads プロンプト
以下の各プロンプトは、PaidSync の ChatGPT Ads グループのツールに対応しています。ツールは Claude Code が選びます。最後の列は、その呼び出しで広告アカウント内の何かが変わるかどうかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| 「ChatGPT Ads のアカウントを一覧表示して、Acme をアクティブにして」 | list_openai_accounts, set_active_openai_account | なし |
| 「直近 7 日間のキャンペーンを、費用、クリック数、インプレッションとともに見せて」 | list_openai_campaigns, get_openai_performance | なし |
| 「Spring Sale キャンペーンのすべての広告グループをステータスとともに一覧表示して」 | list_openai_adgroups | なし |
| 「現在配信中の広告はどれ」 | list_openai_ads | なし |
| 「Retargeting 広告グループを一時停止して」 | pause_openai_adgroup | はい、確認後に実行されます |
| 「日予算付きで Spring Launch というキャンペーンを作成して」 | create_openai_campaign | はい、確認後に実行されます |
| 「古い Winter キャンペーンをアーカイブして」 | archive_openai_campaign | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull last 7 days ChatGPT Ads performance by campaign and list the campaigns with spend and no clicks." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/chatgpt-ads-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
PaidSync には、読み取り、構築、管理を行う 28 の ChatGPT Ads ツールがあります。読み取りは、アカウント、キャンペーン、広告グループ、広告、パフォーマンス、ジオターゲットをカバーします。
続きを読む
書き込みは、キャンペーン、広告グループ、チャットカード広告の作成、クリエイティブ画像のアップロード、キャンペーン、広告グループ、広告の一時停止、再開、更新、アーカイブをカバーします。
作成と更新は dry_run でデフォルトでプレビューされ、一時停止、再開、アーカイブには明示的な確認が必要です。
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
ChatGPT Ads で Claude Code が不可なこと
- 動画クリエイティブはツールとして提供されていません。画像クリエイティブは
upload_openai_creative_imageでアップロードします。 - オーディエンス管理のツールはありません。オーディエンスの設定は ChatGPT Ads Manager で行います。
- 請求や支払いの変更はありません。予算は可能で、支払い方法は一切できません。
- アーカイブは元に戻せないため、Claude Code は実行前にそう伝えます。
- 広告グループ三つのキャンペーンを構築するのは、四つの個別のタスクで、タスクごとにオブジェクトひとつです。
よくある質問
ChatGPT Ads を Claude Code に接続するには？
paidsync.ai で登録し、ダッシュボードで ChatGPT Ads を接続したら、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで、PaidSync のログインでサインインします。
Claude Code は ChatGPT Ads のキャンペーンを作成できますか？
はい。ChatGPT Ads は PaidSync ではビルド階層のプラットフォームです。Claude Code は、キャンペーン、その広告グループ、チャットカード広告を作成し、クリエイティブ画像をアップロードできます。作成はまずドライランでプレビューされます。
OpenAI Ads の API キーはどこで入手できますか？
ads.openai.com の ChatGPT Ads Manager で、広告アカウントの Settings から作成します。各キーは広告アカウントひとつだけに接続されるため、アカウントごとにキーをひとつ接続します。platform.openai.com のキーは広告用としては拒否されます。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
ChatGPT Ads のレポートとキャンペーン構築を Claude Code で。