Claude Code
TikTok Ads を Claude Code に接続するには、claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行し、/mcp で PaidSync.ai にサインインします。
これで Claude Code は24個のツールで TikTok の広告主アカウントにアクセスできます。広告主、キャンペーン、広告グループ、広告レベルのパフォーマンスに加え、既存キャンペーンの停止、再開、予算、入札の変更が可能です。Claude Code は各ツールを実行する前に確認します。
管理ティア。Claude Code はすでに運用中のキャンペーンを扱います。新しい TikTok キャンペーンは作成しません。
コマンド
Claude Code は Streamable HTTP でリモート MCP サーバーと通信します。PaidSync もその一つです。一度追加すれば、コードを編集する同じターミナルから TikTok キャンペーンのレポートと管理ができます。
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 ダッシュボードで TikTok Ads を接続
TikTok Ads の 接続 をクリックし、広告主アカウントにアクセスできる TikTok アカウントでサインインします。TikTok Ads は TikTok OAuth で認証されます。PaidSync はトークンを AES-256-GCM で暗号化して保存します。
すでに Claude Code を使っていますか。connect_tiktok_ads の実行を頼んでください。ツールがブラウザで開く OAuth リンクを返します。
3Claude Code で扱う広告主を選択
セッション内では、list_tiktok_advertisers が TikTok サインインで利用できるすべての広告主アカウントを表示し、set_active_tiktok_advertiser が Claude Code で扱うアカウントを選びます。TikTok への書き込みには、先に有効な広告主が必要です。
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日間の TikTok の費用とコンバージョンをキャンペーン別に見せて”
Claude Code は各キャンペーンのインプレッション、クリック、CTR、CPC、CPM、費用、コンバージョンを返します。接続は有効です。
無料プランは月 100 タスク付き。Pro は月 $99 から、Team は $249 からです。
Claude Code 向け TikTok Ads プロンプト
以下の各プロンプトは、PaidSync の TikTok Ads グループのツールに対応しています。ツールは Claude Code が選びます。右端の列は、その呼び出しで広告主アカウントに変更が入るかどうかを示します。
| 依頼内容 | 呼び出すツール | アカウントが変更されるか |
|---|---|---|
| “TikTok の広告主アカウントを一覧にして、Acme を有効にして” | list_tiktok_advertisers, set_active_tiktok_advertiser | なし |
| “過去7日間の費用、CTR、コンバージョンをキャンペーン別に見せて” | get_tiktok_performance | なし |
| “上位キャンペーンを広告レベルで掘り下げて” | get_tiktok_performance, list_tiktok_ads | なし |
| “このキャンペーンの広告グループをステータスと予算つきで一覧にして” | list_tiktok_adgroups | なし |
| “コンバージョン単価が最も悪いキャンペーンを停止して” | pause_tiktok_campaign | はい、確認後に実行されます |
| “Spring Sale キャンペーンの予算を $150 に上げて” | update_tiktok_campaign_budget | はい、確認後に実行されます |
| “この広告グループの入札を $0.80 に下げて” | update_tiktok_adgroup | はい、確認後に実行されます |
ヘッドレスで実行 claude -p
-p フラグは、対話セッションなしで Claude Code を実行します。/mcp で一度サインインすれば、保存された OAuth トークンが引き継がれます。ファイルに出力されるレポートは次のようになります。
claude -p "Pull last 7 days TikTok performance at ad level and list the ads with the highest spend and no conversions." \
--allowedTools "mcp__paidsync" \
--output-format json > reports/tiktok-ads-$(date +%F).json読み取りも書き込みもそのまま実行されます。--allowedTools "mcp__paidsync" は、書き込みを含むすべての PaidSync ツールを、プロンプトなしで許可します。
無人のジョブでは、必要な読み取りツールだけを、mcp__paidsync__tool_name の形式で個別に名前を指定して許可します。
何を読み取り、何を書き込むか
24個の TikTok Ads ツールのうち、11個は読み取り専用、11個は書き込みができます。読み取りの対象は、広告主、キャンペーン、広告グループ、広告、パフォーマンスです。
続きを読む
書き込みの対象は、キャンペーンの停止と再開、キャンペーン予算、キャンペーン名、広告グループのステータス、予算、入札、名前です。
広告グループの変更とキャンペーンの予算、名前の変更は、dry_run でデフォルトでプレビューされます。キャンペーンの停止と再開にはドライランがなく、明示的な確認が必要です。
MCP では、承認の手順は Claude Code 自身のプロンプトです。--allowedTools または設定で許可していない限り、ツールの実行前に確認します。PaidSync 側でもチェックを追加しています。削除、一時停止、予算変更には confirm_destructive が必要で、書き込み前のルールチェックが安全でない引数をブロックします。承認カードと、安全に元に戻せる変更の適用済みカードでの元に戻す操作は、PaidSync ワークスペースでのみ使えます。
ChatGPT に追加：ChatGPT のプラグインディレクトリで PaidSync.ai を開き、インストールしてからサインインします。
Claude に追加：Claude のコネクタディレクトリで PaidSync.ai を開き、「接続」をクリックしてからサインインします。
TikTok で Claude Code にできないこと
- PaidSync は TikTok のキャンペーン、広告グループ、広告を作成しません。TikTok Ads Manager で作成してから、Claude Code で管理してください。
- PaidSync には、TikTok 向けのオーディエンスツールやクリエイティブのアップロードツールはありません。
update_tiktok_campaignが変更するのは名前のみです。ステータスはpause_tiktok_campaignとenable_tiktok_campaignで、予算はupdate_tiktok_campaign_budgetで変更します。- 広告グループの入札価格の変更は、その広告グループがカスタム入札タイプを使っている場合にのみ適用されます。
- TikTok のレポートは一、二時間遅れで反映されるため、午前9時の確認で見られるデータは午前7時か8時ごろまでです。
よくある質問
TikTok Ads を Claude Code に接続するには
paidsync.ai に登録し、ダッシュボードで TikTok OAuth 経由で TikTok Ads を接続してから、ターミナルで claude mcp add --transport http paidsync https://mcp.paidsync.ai/mcp を実行します。セッション内で /mcp と入力し、paidsync を選んで、PaidSync のログインでサインインします。
Claude Code で TikTok キャンペーンを作成できますか
はい。PaidSync は TikTok のキャンペーン、広告グループ、動画広告をすべて一時停止の状態で作成します。Claude Code は既存のキャンペーンのレポート、一時停止と有効化、予算と広告グループの入札の変更もできます。
Claude Code で TikTok の予算を変更できますか
はい。update_tiktok_campaign_budget はキャンペーン予算を、update_tiktok_adgroup は広告グループの予算を変更します。どちらも最初にドライランとしてプレビューされ、Claude Code は各ツールを実行する前に確認します。
claude -p でヘッドレスモードでも動きますか？
はい。/mcp でサインインしておけば、claude -p は保存された OAuth トークンを再利用します。読み取りはそのまま実行されます。書き込みには注意が必要です。Claude Code のプロンプトに答える人がいないため、--allowedTools で許可した書き込みツールはそのまま実行されます。無人のジョブでは、必要な読み取りツールだけを許可してください。
無料ですか？
はい。無料プランは月 100 タスクまで $0 で、カード不要です。Pro は月 $99 から、Team は月 $249 からです。
TikTok のレポートとキャンペーン管理を、Claude Code のコマンド一つで。