TikTok Ads について
TikTok Ads 向けの MCP サーバーで、キャンペーンレポート、ネイティブアセットの確認、アカウント変更を扱います。クエリプランナーが互換性のない指標とディメンションの組み合わせに対応し、任意の書き込みにはプレビューと確認が必要です。
主な機能
- 0135 個の読み取りツール
- 02キャンペーン、クリエイティブ、オーディエンス
- 03277 個の指標と 16 個のディメンション
- 04クエリを分割・統合するプランナー
- 0530 個の任意の書き込みツール
- 06書き込み前のプレビューと確認
活用シーン
- 01TikTok キャンペーンの成果を確認
- 02互換性のある指標の組み合わせを照会
- 03クリエイティブと配信診断を確認
- 04キャンペーンや予算の変更を準備
MCP 対応
35 個の読み取りツールと 30 個の任意の書き込みツールで、TikTok Ads のレポートとアカウント操作を提供します。書き込みは初期状態で無効で、プレビューを確認した場合にのみ適用されます。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
npx -y @getmcpads/tiktok-ads-mcp-serverTIKTOK_ACCESS_TOKENシークレットTikTok Business API access token.TIKTOK_APP_IDApp ID the token belongs to.TIKTOK_ADVERTISER_IDSComma-separated advertiser IDs this server may access. Recommended; required from 3.0.0.TIKTOK_APP_SECRETシークレットApp secret, for endpoints needing app authentication.TIKTOK_ADVERTISER_IDDefault advertiser ID. When TIKTOK_ADVERTISER_IDS is set, must be one of them.TIKTOK_BC_IDDefault Business Center ID, for Business Center scoped reads.TIKTOK_BUSINESS_CENTER_IDAlias of TIKTOK_BC_ID, read when TIKTOK_BC_ID is unset.TIKTOK_ENABLE_WRITEStrue exposes 30 write tools. Defaults to false. Calls preview unless confirm is true.TIKTOK_ENVIRONMENTproduction (default) or sandbox. Sandbox binds every call to one advertiser ID.LOG_LEVELdebug, info (default), warn or error. Logs go to stderr.ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。
ツール
35掲載時のツール一覧 · 3 日前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| advertiserId | string | いいえ | 検証する広告主 ID。デフォルトでは TIKTOK_ADVERTISER_ID を使用し、次に最初のアクセス可能な広告主を使用します。 |
詳細
TikTok Ads MCP サーバー
TikTok 広告を理解しましょう。
MCP クライアントからキャンペーンのパフォーマンスを確認し、ネイティブアセットを調査して、変更を準備できます。
動画を見る · 新着情報 · インストール · ツールリファレンス · ホスト版 getmcpads を試す
この動画では、サンプルデータを使ったホスト版 getmcpads を紹介しています。クリエイティブギャラリーやアラートから Google Sheets へのエクスポート、キャンペーンの一括開始まで、MCP Apps はホスト版製品の機能です。このリポジトリでは、単体で利用できるネイティブ API ツールを提供しています。
読み取りツール 35 個 · 書き込みツール 30 個(デフォルトでは無効)
独自のプラットフォーム認証情報と、Claude Desktop、Claude Code、Cursor など stdio MCP に対応したクライアントを使って、ローカルで実行できます。リクエストはプラットフォームに直接送信されます。対応する ChatGPT のセットアップを含む、管理された接続を利用する場合は、ホスト版をご利用ください。
新着情報
v2.1.1:Zod 4 セキュリティアップデート · 2026 年 10 月 26 日
zodを 4.6.7 に更新しました。4.6.6 より前のすべての Zod リリースは、重大度の高いアドバイザリ GHSA-mrhx-c7xc-m3w5 の対象です。サイズ制限付きコレクションのサイズが大きすぎる場合に検証でメモリを使い果たす可能性があり、この修正を含む Zod 3 のリリースはありません。npm audit --omit=devで、再び脆弱性が報告されなくなりました。- Zod 3 の検証動作を維持します。パラメーターのデフォルト値は引き続き使用前に検証・補完されるため、省略されたオブジェクトにも必須フィールドを指定する必要があります。
- パラメーターが省略可能またはデフォルト値を持つ場合も、各パラメーター固有の説明を維持します。Zod 4 では説明がラップされたスキーマにのみ保存されるため、共通のフォールバック説明で置き換えられる可能性があります。
- MCP 経由で公開されるツール名、パラメーター、説明に変更はありません。
server-card.jsonは Zod 4 の JSON Schema 出力で再生成されています。一部の制約の表記が異なります。
以前のリリース
| バージョン | 日付 | 主な変更点 |
|---|---|---|
| 2.1.0 | 2026 年 10 月 23 日 | 広告主のスコープ設定とアカウント名の変更 |
| 2.0.1 | 2026 年 9 月 23 日 | 公開リポジトリを復旧 |
| 2.0.0 | 2026 年 9 月 20 日 | ゲートウェイとの同期とセキュリティ修正 |
| 1.1.0 | 2026 年 9 月 13 日 | プラットフォーム機能の同期と品質契約 |
| 1.0.2 | 2026 年 8 月 30 日 | MCP 経由でパッケージのバージョンを通知 |
| 1.0.1 | 2026 年 8 月 30 日 | 公式 MCP Registry 向けに、com.getmcpads/tiktok-ads の server.json と mcpName を追加 |
| 1.0.0 | 2026 年 8 月 29 日 | 最初のオープンソースリリース |
ソースの同期について:SOURCE_SYNC.md。
アップグレードに関する注意事項
Node.js 22.23.4、24.22.1、26.12.1、またはそれ以降のリリースが必要です。これらのバージョンには2026年10月のセキュリティ修正が含まれており、古いバージョンで実行すると、サーバーは stderr に警告を出力します。CI では Node 22、24、26 を対象にしています。
破壊的変更はありません。 2.0 の設定はそのまま機能します。次の点にご注意ください。
TIKTOK_ADVERTISER_IDSは任意です。設定しない場合、トークンでアクセスできるすべての広告主が引き続き利用可能で、サーバーは設定を推奨するメッセージを stderr に1行出力します。このサーバーで使用できる広告主を設定してください。TIKTOK_ENABLE_WRITESは引き続き1、yes、onをtrueとして読み込み、stderr に非推奨を知らせるメッセージを1行出力します。TIKTOK_ENABLE_WRITES=trueを使用してください。- バージョン 2.0.1 は
TIKTOK_ENVIRONMENT=sandboxを無視し、すべてのリクエストを本番環境に送信していました。バージョン 2.1.0 はリクエストをsandbox-ads.tiktok.comに送信し、1つの広告主に紐付けます。対象となるのは、TIKTOK_ADVERTISER_IDSに指定された単一の ID、またはTIKTOK_ADVERTISER_IDです。どちらも設定されていない場合、サンドボックスへの呼び出しは拒否されます。
3.0.0 での変更を予告しています: TIKTOK_ADVERTISER_IDS が必須になり、値が厳密に true の場合のみ書き込みが有効になります。
保存済みの引数を再利用する前に、現在のツールスキーマを確認してください。書き込みは引き続き任意で、明示的な確認が必要です。ホスト型クリエイティブ連携と MCP Apps UI は今回のリリースの対象外です。
このリリースをインストールする
これは GitHub のソースリリースです。npm と MCP Registry のバージョンは別途公開されます。以下のコマンドはこのバージョンを正確に指定します。このドキュメントの後半にある、バージョンを固定していない npx の例では、npm で現在公開されているバージョンが選択されます。
git clone --branch v2.1.1 --depth 1 https://github.com/get-mcp-ads/tiktok-ads-mcp-server.git
cd tiktok-ads-mcp-server
npm ci
npm run build
MCP クライアントが node を実行し、以下に記載するプラットフォームの認証情報を使用して、dist/cli.js の絶対パスを指定するように設定してください。
マネージド接続をご希望ですか? ホスト型の getmcpads を使って TikTok Ads を利用する。アカウントを接続し、アシスタントがアクセスできるデータを選択して、ホスト型 MCP 接続を使用します。最新の機能とプランについてはサイトをご覧ください。
利用できる機能
| 35 個の読み取りツール | キャンペーン、広告グループ、広告、クリエイティブ、オーディエンス、ピクセル、イベント、Spark Ads、カタログ、配信診断 |
| 30 個の書き込みツール | デフォルトでは無効です。キャンペーン、広告グループ、広告、Smart+ エンティティの作成と設定、ステータス、予算、名称変更、メディアのアップロードに対応します。すべての操作で、適用前にプレビューを表示します |
| 277 個の指標 | クライアント側で計算する派生指標を含みます |
| 16 個のディメンション | API に送信する前に無効な組み合わせを検出する互換性マトリクスを備えています |
| 5 個のリソース | モデルが読み取れるライブカタログ:指標、ディメンション、互換性ルール、12 個のワークフローレシピ |
| キーワード調査 | TikTok Search Ads 向けの tiktok_search_keywords と tiktok_get_search_ads_maturity |
| 前方互換性のある読み取り | tiktok_get_read_endpoint、tiktok_get_entities_raw、tiktok_get_report_raw を使って、このサーバーがまだモデル化していないエンドポイントにもアクセスできます |
クエリプランナー
TikTok は多くの指標とディメンションの組み合わせを拒否しますが、そのエラーメッセージから理由が分かることはほとんどありません。 このサーバーは互換性マトリクスを備えているため、実行できないリクエストを複数の有効な API 呼び出しに分割し、結果を統合します。失敗することはありません。
tiktok_validate_query を使うと、モデルは呼び出しを実行する前に組み合わせを確認できます。
このサーバーが対処する落とし穴
TikTok は呼び出しが失敗しても HTTP 200 を返します。 成否を決めるのはアプリケーションレベルの code フィールドです。HTTP ステータスを信頼するクライアントは、実際には返されていないデータに基づいてモデルが推論する原因となる、架空の成功を報告します。このサーバーでは、すべての呼び出しで最初に code を確認します。
トークンの取得
TikTok では、値が 1 つではなく 2 つ必要です。アクセストークンと、それに対応する App ID です。
- TikTok for Business 開発者ポータルで開発者アプリを作成します。
- アプリのページで App ID と App Secret を控えます。
- 利用したい広告主アカウントを認可します。TikTok は広告主ごとにアクセス権を付与するため、 ここで選ばなかったアカウントは、トークンで許可されていてもサーバーからは見えません。
- OAuth 認可フローを完了し、返された
auth_codeを アクセストークンと交換します。TikTok の長期トークンは 固定のスケジュールでは失効しませんが、認可を取り消すと無効になります。 - トークンを
TIKTOK_ACCESS_TOKENに、App ID をTIKTOK_APP_IDに設定します。
📖 TikTok API for Business のドキュメント
最初の呼び出しでは tiktok_health_check を実行してください。認証情報を検証し、実際にアクセスできる広告主アカウントを一覧表示して、不足しているものを報告します。トークンは出力されません。
必要な権限
| スコープグループ | 必要な場合 |
|---|---|
| レポートおよび読み取りスコープ | 常に必要です。 キャンペーン、広告グループ、広告、インサイト |
| キャンペーン管理スコープ | TIKTOK_ENABLE_WRITES=true を設定する場合のみ |
| カタログおよび Business Center スコープ | tiktok_get_shop_catalog_diagnostics 用のオプション |
セットアップ
Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json(macOS)
または %APPDATA%\Claude\claude_desktop_config.json(Windows):
{
"mcpServers": {
"tiktok-ads": {
"command": "npx",
"args": ["-y", "@getmcpads/tiktok-ads-mcp-server"],
"env": {
"TIKTOK_ACCESS_TOKEN": "your-token-here",
"TIKTOK_APP_ID": "your-app-id-here",
"TIKTOK_ADVERTISER_IDS": "your-advertiser-id"
}
}
}
}
Claude Desktop を再起動します。「TikTok の広告主アカウントを一覧表示して」と尋ねてください。
Claude Code
claude mcp add tiktok-ads --env TIKTOK_ACCESS_TOKEN=your-token --env TIKTOK_APP_ID=your-app-id --env TIKTOK_ADVERTISER_IDS=your-advertiser-id -- npx -y @getmcpads/tiktok-ads-mcp-server
Cursor
プロジェクト内の .cursor/mcp.json に、上記の Claude Desktop 設定と同じ形式で記述します。
ソースから実行
git clone https://github.com/get-mcp-ads/tiktok-ads-mcp-server.git
cd tiktok-ads-mcp-server
npm install && npm run build
cp .env.example .env # then fill in your credentials
npm start
設定
| 変数 | デフォルト | 説明 |
|---|---|---|
TIKTOK_ACCESS_TOKEN | なし | 必須。 アクセストークン |
TIKTOK_APP_ID | なし | 必須。 トークンに対応する App ID |
TIKTOK_ADVERTISER_IDS | なし | 推奨。3.0.0 以降は必須です。 このサーバーがアクセスできる広告主 ID のカンマ区切りリスト。設定すると、他の広告主へのアクセスはリクエスト前に拒否され、検出結果には指定した広告主のみが表示されます。未設定の場合は、トークンでアクセスできるすべての広告主にアクセスできます |
TIKTOK_APP_SECRET | なし | アプリ認証を必要とするエンドポイント用のオプション設定 |
TIKTOK_ADVERTISER_ID | なし | オプションのデフォルト値。毎回指定する手間を省けます。TIKTOK_ADVERTISER_IDS が設定されている場合は、そのいずれかの ID を指定する必要があります |
TIKTOK_BC_ID | なし | オプションの Business Center ID。未設定の場合は TIKTOK_BUSINESS_CENTER_ID が読み込まれます |
TIKTOK_ENABLE_WRITES | false | true にすると、30 個の書き込みツールが登録されます。1、yes、on も引き続き使用できますが、3.0.0 までは非推奨の通知が表示されます |
TIKTOK_ENVIRONMENT | production | production または sandbox。Sandbox では、すべての呼び出しが 1 つの広告主に制限されます。TIKTOK_ADVERTISER_IDS に指定した単一の ID、または TIKTOK_ADVERTISER_ID が使用されます |
LOG_LEVEL | info | debug、info、warn、error |
セットアップはいつでも確認できます。
npm run doctor
書き込み機能と、最初にプレビューを表示する理由
書き込みツールは、デフォルトで無効になっています。TIKTOK_ENABLE_WRITES=true で有効にしてください。
有効にしても、すべての書き込みツールはプレビューを返すだけで、何も変更しません。
// tiktok_update_adgroup_budget { advertiserId: "7...", adGroupId: "1...", budget: 50 }
{
"applied": false,
"action": "tiktok_update_adgroup_budget",
"change": { "advertiser": "7...", "adGroup": "1...", "newBudget": 50,
"budgetMode": "BUDGET_MODE_DAY" },
"message": "Preview only, nothing was changed. Repeat the same call with confirm: true to apply this change to the live account."
}
実際のアカウントに変更を加えるには、confirm: true を指定して、2 回目の呼び出しを行う必要があります。
これは意図的な設計です。アシスタントがこれらの呼び出しを組み立てる際、誤った広告主やキャンペーンを選んだり、予算の桁を間違えたりする可能性があります。必須のプレビューによって、費用が発生する前に間違いを確認でき、プロトコル自体では保証されない、人間が止められる段階を設けています。
もう 1 つの安全策として、tiktok_create_campaign は常にキャンペーンを DISABLE の状態で作成します。 実行中の状態で作成するオプションはありません。
| ツール | 変更内容 |
|---|---|
tiktok_update_campaign_status / tiktok_update_adgroup_status | 一時停止または再開 |
tiktok_update_campaign_budget / tiktok_update_adgroup_budget | アカウントの通貨で予算を変更 |
tiktok_create_campaign | キャンペーンを作成します。常に DISABLE の状態です |
ツール
すべてのツールを以下に示します。パラメーターと出力の完全なスキーマについては、server-card.json を参照してください。
35 個の読み取りツール
| ツール | 目的 | | --- | --- | | `tiktok_health_check` | TikTok の認証情報、アクセス可能な広告主、広告主情報を読み取り専用で確認します。 | | `tiktok_list_advertisers` | 現在のトークンでアクセス可能なすべての TikTok 広告主アカウントを一覧表示します。 | | `tiktok_get_advertiser_info` | 特定の TikTok 広告主アカウントの詳細情報(通貨、タイムゾーン、ステータス、残高)を取得します。 | | `tiktok_get_campaigns` | TikTok 広告主アカウントのキャンペーンを一覧表示します。 | | `tiktok_get_adgroups` | ターゲティング、カスタム/類似オーディエンスの参照と除外、地域、言語、年齢/性別、掲載面、興味・行動、予算、スケジュールを含む、ネイティブな広告グループ設定全体を読み取ります。 | | `tiktok_get_targeting` | 設定済みの広告グループのターゲティングとオーディエンス参照(カスタム/類似オーディエンスの包含/除外、地域、言語、年齢/性別、掲載面、興味・行動)を読み取ります。 | | `tiktok_get_audience_report` | 広告主、キャンペーン、広告グループ、広告の各レベルで、年齢または性別ごとの TikTok AUDIENCE パフォーマンスレポートを読み取ります。配信対象となる Smart+ キャンペーンからの配信も含みます。 | | `tiktok_get_ads` | TikTok 広告主の広告を一覧表示します。 | | `tiktok_get_insights` | 現在のネイティブ/計算指標カタログとクエリプランニングを使用して、TikTok Ads のパフォーマンスインサイトをクエリします。 | | `tiktok_get_creatives` | TikTok 広告主アカウントの特定の広告について、クリエイティブの詳細(動画、画像、テキスト)を取得します。 | | `tiktok_get_audiences` | TikTok 広告主アカウントのカスタムオーディエンスと類似オーディエンスを一覧表示します。 | | `tiktok_search_keywords` | TikTok Search Ads のキーワード候補を取得します。 | | `tiktok_validate_query` | 実行前に TikTok の指標とディメンションの組み合わせを検証します。 | | `tiktok_get_pixels` | TikTok ピクセルと、権限がある場合は広告主のピクセルイベントメタデータを一覧表示します。 | | `tiktok_get_events` | 広告主のピクセル/アプリイベント、またはアクセス可能なトラッキング診断情報を検出します。 | | `tiktok_get_delivery_status` | キャンペーン、広告グループ、広告の配信ステータス/operation_status を集計し、簡易診断情報とともに返します。 | | `tiktok_get_async_report_status` | 非同期レポートエンドポイントが利用可能な場合、taskId によって TikTok の非同期レポートタスクのステータスを確認します。 | | `tiktok_get_video_assets` | 利用可能な場合、ad/get および動画素材エンドポイントから、広告に関連付けられた TikTok 動画素材のメタデータを返します。 | | `tiktok_get_spark_ads` | 利用可能な広告フィールドから Spark Ads の情報を返します。Spark 固有のフィールドがサポートされていない場合は、保守的な代替処理を行います。 | | `tiktok_get_audience_details` | TikTok DMP エンドポイントにアクセスできる場合、カスタム/類似/保存済みオーディエンスの詳細を取得します。 | | `tiktok_get_shop_catalog_diagnostics` | TikTok Shop/カタログ/e コマースの診断情報を読み取り専用で取得します。 | | `tiktok_get_search_ads_maturity` | キーワード/検索語句レポートと、任意のキーワード推薦エンドポイントから、TikTok Search Ads の成熟度を診断します。 | | `tiktok_get_creative_fatigue_recipes` | 広告レベルの日次レポートから、クリエイティブ疲労の可能性が高いパターンを見つけ、読み取り専用の更新手順を返します。 | | `tiktok_get_audience_overlap` | 広告グループ、カスタムオーディエンス、保存済みオーディエンス、ターゲティングフィールド間のオーディエンス重複を読み取り専用で診断します。 | | `tiktok_get_spark_organic_joins` | 権限がある場合、アクセス可能な Spark Ads フィールドと、有料のページ/投稿レポート、および任意のオーガニック ID/投稿エンドポイントを結合します。 | | `tiktok_list_ad_videos` | 広告主の動画ライブラリ全体(ファイル/動画/広告/検索)を一覧表示します。ファイル名、再生時間、寸法、シグネチャー、一般公開されているプレビュー URL とカバー URL を含みます。 | | `tiktok_list_ad_images` | 広告主の画像ライブラリ全体(ファイル/画像/広告/検索)を一覧表示します。ファイル名、寸法、シグネチャー、カルーセルでの使用可否、約 30 日間有効な署名付きの一般公開画像 URL を含みます(正確な時刻は image_url_expires_at で確認できます)。 | | `tiktok_get_asset_urls` | 特定の TikTok ライブラリ素材(file/video/ad/info および file/image/ad/info)について、新しい、一般公開されて取得可能な URL を再解決します。 | | `tiktok_get_entities_raw` | 呼び出し元が選択したネイティブフィールド、フィルタリング、並べ替え、ページネーションを使用して、TikTok のキャンペーン、広告グループ、広告を一覧表示します。 | | `tiktok_get_report_raw` | 呼び出し元が選択したディメンションと指標で、ネイティブ TikTok BASIC または AUDIENCE の同期レポートを実行します。 | | `tiktok_get_targeting_catalog` | TikTok のターゲティングおよびプランニングカタログ(地域、言語、興味、行動、ハッシュタグ、Search Ads のキーワード候補/健全性、デバイス、通信事業者、コンテキストタグ、コンテンツ除外、タイムゾーン)を読み取ります。 | | `tiktok_get_read_endpoint` | 専用 MCP ツールでまだモデル化されていない、ドキュメント化済み JSON 読み取りエンドポイントにアクセスするための、上級者向け GET 専用 TikTok Business API エスケープハッチです。 | | `tiktok_get_carousel_music` | 標準的なカタログなし画像広告(1 枚のカード)またはカルーセルでアップロードされた画像と完全に一致する、TikTok の音楽候補を取得します。 | | `tiktok_get_uploaded_video` | この広告主のメディアライブラリから、アップロード済み動画を 1 本読み取ります。 | | `tiktok_get_write_context` | 編集または新しい設定の作成前に、正確な TikTok エンティティ、親設定、広告主の通貨/タイムゾーンを読み取ります。 |30 個の書き込みツール
デフォルトでは無効です。明示的に確認しない限り、呼び出しはプレビューのみを行います。使用前に設定と正確なスキーマを確認してください。
| ツール | 目的 |
|---|---|
tiktok_create_cta_portfolio | この広告主向けに creative/cta/recommend が返した、承認済みの正確な推奨内容から動的な CTA ポートフォリオを作成します。 |
tiktok_create_custom_identity | Pangle または Global App Bundle 用に、広告主が所有する CUSTOMIZED_USER 広告アイデンティティを作成します。 |
tiktok_create_campaign_advanced | 無効状態の従来型 TikTok キャンペーンを作成します。 |
tiktok_update_campaign_configuration | 従来型 TikTok キャンペーンを更新します。 |
tiktok_create_adgroup | 無効状態の従来型 TikTok 広告グループを作成します。 |
tiktok_update_adgroup_configuration | 従来型 TikTok 広告グループを更新します。 |
tiktok_create_ads | 無効状態の従来型 TikTok 広告(動画、画像、カルーセル、または許可された Spark コンテンツ)を作成します。 |
tiktok_update_ads | 従来型 TikTok 広告(動画、画像、カルーセル、または許可された Spark コンテンツ)を更新します。 |
tiktok_create_smart_plus_campaign | 無効状態のアップグレード版 Smart+ TikTok キャンペーンを作成します。 |
tiktok_update_smart_plus_campaign | アップグレード版 Smart+ TikTok キャンペーンを更新します。 |
tiktok_create_smart_plus_adgroup | 無効状態のアップグレード版 Smart+ TikTok 広告グループを作成します。 |
tiktok_update_smart_plus_adgroup | アップグレード版 Smart+ TikTok 広告グループを更新します。 |
tiktok_create_smart_plus_ad | 無効状態のアップグレード版 Smart+ TikTok 広告(動画、画像、カルーセル、または許可された Spark コンテンツ)を作成します。 |
tiktok_update_smart_plus_ad | アップグレード版 Smart+ TikTok 広告(動画、画像、カルーセル、または許可された Spark コンテンツ)を更新します。 |
tiktok_update_ad_status | 従来型広告を1件だけ一時停止または再開します。 |
tiktok_update_smart_plus_campaign_status | Smart+ キャンペーンを1件だけ一時停止または再開します。 |
tiktok_update_smart_plus_adgroup_status | Smart+ 広告グループを1件だけ一時停止または再開します。 |
tiktok_update_smart_plus_ad_status | Smart+ 広告を1件だけ一時停止または再開します。 |
tiktok_update_smart_plus_material_status | アップグレード版 Smart+ 広告1件のクリエイティブ素材から、選択したものを一時停止または再開します。 |
tiktok_rename_campaign | 従来型 TikTok キャンペーンの名前を変更します。 |
tiktok_rename_adgroup | 従来型 TikTok 広告グループの名前を変更します。 |
tiktok_rename_ad | 従来型 TikTok 広告の名前を変更します。 |
tiktok_rename_advertiser | TikTok 広告アカウント(広告主)自体の名前を変更します。 |
tiktok_upload_ad_image | 公開 HTTPS メディア URL または base64 ファイルから画像をインポートします(最大 5 MiB)。 |
tiktok_upload_ad_video | 公開 HTTPS メディア URL または base64 ファイルから動画をインポートします(最大 5 MiB)。 |
tiktok_update_campaign_status | TikTok キャンペーンを一時停止または再開します。 |
tiktok_create_campaign | TikTok キャンペーンを作成します。 |
tiktok_update_campaign_budget | アカウントの通貨で TikTok キャンペーンの予算を変更します。 |
tiktok_update_adgroup_status | TikTok 広告グループを一時停止または再開します。 |
tiktok_update_adgroup_budget | TikTok 広告グループの予算を変更します。 |
5 個のリソース
| URI | 内容 |
|---|---|
tiktok://manifest | このサーバーが公開する内容と現在のモード |
tiktok://metrics | カテゴリと形式を含む全277指標 |
tiktok://dimensions | 全16ディメンションと、それぞれが有効な場所 |
tiktok://compatibility | 互換性マトリックス |
tiktok://recipes | 12 個のステップごとのワークフロー |
セキュリティ
このサーバーは、稼働中の広告アカウントを読み取り、必要に応じて変更できる認証情報を保持します。 具体的には、次のとおりです。
- トークンはログに記録されません。 デバッグ出力では
Access-Token: [redacted]と表示されます。 - リクエストの送信先は
business-api.tiktok.comのみです。TIKTOK_ENVIRONMENT=sandboxの場合はsandbox-ads.tiktok.comのみとなり、パスも/open_api/v1.3/配下に限定されます。 それ以外のホストやパスへのリクエストは拒否され、送信されません。テストで確認済みです。 TIKTOK_ADVERTISER_IDSを設定すると、指定した広告主のみにアクセスします。 それ以外の広告主へのリクエストは送信前に拒否され、検出結果も指定リストに絞り込まれます。 テストで確認済みです。- すべてのリクエストには30秒のタイムアウトと20 MBのレスポンス上限が適用されます。 プロバイダーのエラーテキストは、ログへの記録や返却の前にトークンとアプリシークレットが除去されます。
- トークンを付加した後のリダイレクトは拒否されます。 そのため、リダイレクトによって認証情報が別の場所に転送されることはありません。
- 汎用の読み取りパスでは、変更操作とOAuthのエンドポイントがブロックされます。 テストで確認済みです。
- テレメトリーはありません。 このサーバーが行うネットワーク通信はTikTok Business API宛てのみです。
ソース内で
fetchを検索すると確認できます。
ポリシーの全文と報告手順については、SECURITY.mdをご覧ください。
マネージド型のマルチプラットフォーム版をお探しですか?
ローカルサーバーを運用せずにこのソースを使いたい場合は、ホスト型TikTok Adsをお試しください。 getmcpadsは、1つのMCP URLを通じて広告、Search Console、GA4にも接続できます。 利用可能なソースとプランの上限はサイトに記載されています。アカウントへの接続は引き続き必要です。
- TikTok Ads接続ガイドに従います。
- アシスタントに読み取りを許可するアカウントまたはプロパティを選択します。
- Claude、 ChatGPT、または Codexを接続します。
- 読み取り専用のレビューを試します。「期間全体にわたるキャンペーン配信とコンバージョンの傾向を比較してください。データが不足している場合はその旨を伝え、何も変更しないでください。」
有料プランを選ぶ前に、現在のホスト型ツールカタログと料金をご確認ください。 このApache 2.0アダプターは、ご自身の認証情報を使って引き続き独立してご利用いただけます。
コントリビューション
Issueやプルリクエストを歓迎します。CONTRIBUTING.mdをご覧ください。 セキュリティ関連の報告を行う前に、SECURITY.mdをお読みください。
ライセンス
Apache License 2.0。NOTICEもご覧ください。
TikTokおよびTikTok for Businessは、ByteDance Ltd.およびその関連会社の商標です。 このプロジェクトはTikTokまたはByteDanceと提携、推奨、後援関係にありません。 公開APIを利用する独立したクライアントです。
MCPコントラクトとデスクトップバンドル
すべてのツールは、読み取り/書き込みのアノテーション、パラメーターの説明、構造化出力スキーマを宣言します。成功した呼び出しではペイロードが structuredContent.result として公開され、エラーでは isError: true が保持されます。生成されたサーバーカードには定義のみが含まれます。
npm run bundle -- /path/to/output を実行すると、現在のカタログから .mcpb デスクトップバンドルをビルドできます。認証情報はインストール時にローカルで入力します。書き込みツールは明示的に有効化しない限り無効のままです。
getmcpadsのその他のプロジェクト
Meta Ads · Google Ads · Google Analytics 4 · Google Search Console · Pinterest Ads · X Ads
getmcpadsにてEmmanuelがメンテナンスしています。お問い合わせ:[email protected]。
コメント
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。
