Claude Code
Pinterest Ads を Claude Code に接続するには、PaidSync.ai を追加します。claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp と入力して、PaidSync のログイン情報でサインインします。
Claude Code は 14 のツールで Pinterest 広告アカウントにアクセスします。キャンペーン別のパフォーマンスに加え、既存キャンペーンの一時停止、有効化、予算、広告グループの変更が可能です。Claude Code は各ツールの実行前に確認を求めます。
管理ティア。Claude Code は運用中のキャンペーンを対象にします。新しい Pinterest キャンペーンは作成しません。
コマンド
Claude Code は Streamable HTTP でリモート MCP サーバーと通信します。PaidSync もそのひとつです。一度追加すれば、コードを編集するのと同じターミナルから、Pinterest のキャンペーンのレポートや管理ができます。
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 ダッシュボードで Pinterest Ads を接続する
Pinterest Ads の 接続 をクリックし、広告アカウントを開ける Pinterest ログインでサインインします。Pinterest Ads は Pinterest OAuth で認可され、PaidSync が Pinterest のパスワードを見ることはありません。
すでに Claude Code を使っていますか？ connect_pinterest_ads の実行を依頼してください。ツールが、ブラウザで開くリンクを返します。
3Claude Code が作業する広告アカウントを選択
セッション内では、list_pinterest_accounts がサインインで利用できるすべての広告アカウントを表示し、set_active_pinterest_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 日間の Pinterest の費用とコンバージョンをキャンペーン別に表示してください”
Claude Code は各キャンペーンの費用、インプレッション数、クリック数、コンバージョン数を返します。接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code 向け Pinterest Ads プロンプト
以下の各プロンプトは、PaidSync の Pinterest Ads グループのツールに対応しています。ツールは Claude Code が選びます。最後の列は、その呼び出しが広告アカウントを変更する可能性があるかどうかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “Pinterest の広告アカウントを一覧表示し、Acme をアクティブにしてください” | list_pinterest_accounts, set_active_pinterest_account | なし |
| “過去 30 日間のキャンペーンを、費用、インプレッション数、クリック数、コンバージョン数付きで表示してください” | get_pinterest_performance | なし |
| “広告グループをステータス、予算、入札戦略付きで一覧表示してください” | list_pinterest_adgroups | なし |
| “アカウントで配信中の広告を一覧表示してください” | list_pinterest_ads | なし |
| “Spring Home Refresh キャンペーンを一時停止してください” | list_pinterest_campaigns, pause_pinterest_campaign | はい、確認後に実行されます |
| “Holiday Gifts キャンペーンの日次支出上限を 20 パーセント上げてください” | update_pinterest_campaign_budget | はい、確認後に実行されます |
| “Retargeting 広告グループを自動入札に切り替えてください” | update_pinterest_adgroup | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull last 30 days Pinterest performance by campaign and list the campaigns with spend and no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/pinterest-ads-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
14 の Pinterest Ads ツールのうち、7 は読み取り専用で、5 は書き込みができます。読み取りは、広告アカウント、キャンペーン、広告グループ、広告、キャンペーンパフォーマンスを対象とします。
続きを読む
書き込みは、キャンペーンの一時停止と有効化、キャンペーンの予算と名前、広告グループのステータス、予算、入札単価、入札戦略、名前を対象とします。
予算と広告グループの変更は、デフォルトで dry_run によりプレビューされ、PaidSync は適用後に各変更を Pinterest から読み戻して確認します。
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
Claude Code が Pinterest でできないこと
- PaidSync は Pinterest のキャンペーン、広告グループ、広告を作成しません。Pinterest Ads Manager で作成してから、Claude Code で管理してください。
- ピンや商品カタログのツールはありません。ピンの作成とカタログの管理は Pinterest で行います。
- パフォーマンスはキャンペーン単位で返され、広告グループや広告ごとではありません。
- オーディエンスやキーワードのツールはありません。広告グループ設定以外のターゲティングは Pinterest Ads Manager で行います。
- 予算の金額は広告アカウント自体の通貨です。
よくある質問
Pinterest Ads を Claude Code に接続するには？
paidsync.ai でサインアップし、ダッシュボードで OAuth により Pinterest Ads を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで PaidSync のログインでサインインします。
Claude Code は Pinterest キャンペーンを作成できますか？
いいえ。PaidSync では Pinterest は管理ティアのプラットフォームです。Claude Code は既存キャンペーンのレポート、一時停止と有効化、予算と広告グループ設定の変更ができます。新しいキャンペーンは Pinterest Ads Manager で作成します。
Claude Code は Pinterest の予算を変更できますか？
はい。update_pinterest_campaign_budget はキャンペーンの支出上限を、update_pinterest_adgroup は広告グループの予算または入札単価を変更します。どちらもまずドライランでプレビューされ、Claude Code は各ツールの実行前に確認を求めます。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
Pinterest のレポートとキャンペーン管理を、Claude Code のワンコマンドで。