TokPortal

tokportal-mcp

TokPortal は、ソーシャルインフラを提供するマネージド API です。16 か国以上で、人間のアカウントマネージャーが実際の TikTok および Instagram のブランドアカウントを作成、ウォームアップ、運用し、それらを REST API と MCP サーバーとして提供します。ソーシャルアカウントすべてを OAuth で接続することなく、市場間で地理的シャーディングを実行できます。この API では YouTube バンドルの作成はできません。

サンドボックスを使用する前にアップグレードしてください： ローカルの tokportal-mcp で dry_run を使うには、バージョン 1.15.1 以降が必要です。バージョン 1.15.0 は引数を公開していましたが、サンドボックスヘッダーを送信していなかったため、プレビューで実際の操作が実行される可能性がありました。ローカルサーバーを更新するか、リモートコネクターを使用してください。

ドキュメント https://developers.tokportal.com · API ベース https://app.tokportal.com/api/ext · OpenAPI https://developers.tokportal.com/openapi.json · MCP リモート https://app.tokportal.com/api/ext/mcp · API キーを取得 https://app.tokportal.com/developer/api-keys?utm_source=npm&utm_medium=readme&utm_campaign=tokportal-mcp · llms.txt https://developers.tokportal.com/llms.txt

---

tokportal-mcp は、TokPortal API 用の公式モデルコンテキストプロトコルサーバーです。中核となるツールは引き続き、Claude、Cursor、VS Code、Windsurf、Codex、Gemini CLI などの MCP クライアントから利用できます。ワークスペースで AI が有効になっている場合、モデルの検索、見積もり付き生成、メディア管理、独立した AI USD ウォレットを扱う、厳選された追加ツール 7 つが利用可能になります。モデル固有のスキーマはオンデマンドで取得され、何百ものツールとして公開されることはありません。

利用方法は 2 つあります。

モード	トランスポート	用途
ローカル (npx tokportal-mcp)	stdio	デスクトップクライアント、ローカルエージェント、ディスクからのファイルアップロード
リモート (https://app.tokportal.com/api/ext/mcp)	ストリーマブル HTTP	ホスト型エージェント、インストール不要。同じツールカタログ

Node.js 20 以降が必要です。ローカルサーバーは Node.js 上で直接実行されます。API キーは https://app.tokportal.com/developer/api-keys?utm_source=npm&utm_medium=readme&utm_campaign=tokportal-mcp で取得できます（形式：sk_ + 64 桁の 16 進数）。

30 秒で始める

npm install -g [email protected]
TOKPORTAL_API_KEY=sk_your_key_here tokportal-mcp

サーバーは stdio 経由で MCP を使用します。任意の MCP クライアントから接続し、たとえば次のように依頼してください。

「利用可能な国、クレジット価格、自分の残高を読み取ってください。米国で TikTok アカウントのみのバンドルを dry_run: true でプレビューしてください。初期費用と継続費用を表示し、実際の購入を行う前に、私が GO と言うまで待ってください。」

プレビューでは { "dry_run": true, "body": { "bundle_type": "account_only", "platform": "tiktok", "country": "USA" } } を指定して tokportal_create_bundle を呼び出します。リクエストを検証し、作業を作成することなく、credits_charged: 0 とともに credits_would_charge を返します。ライブモードで作成すると、料金が即時に請求されます。プレビュー ID は仮のものであり、ライブリクエストでは決して再利用しないでください。GO の後、実際のリソースを作成し、そのライブ ID を使用してください。サンドボックスの仕様を参照してください。

MCP SDK を使ったプログラムによるスモークテスト：

import { Client } from "@modelcontextprotocol/sdk/client/index.js";
import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";

const client = new Client({ name: "demo", version: "1.0.0" });
await client.connect(
  new StdioClientTransport({
    command: "npx",
    args: ["-y", "tokportal-mcp"],
    env: { ...process.env, TOKPORTAL_API_KEY: process.env.TOKPORTAL_API_KEY },
  }),
);

const { tools } = await client.listTools(); // Core tools, plus 7 when AI is enabled
const me = await client.callTool({ name: "tokportal_get_current_user", arguments: {} });
console.log(tools.length, me.content[0].text);

AI 生成（段階的な提供）

AI の検出では、認証済みの GET /ai/status を呼び出します。利用できない場合は既存のカタログのみが表示され、プロバイダーへのフォールバックや自動決済は行われません。ローカル AI のサポートには 1.16.0 以降と、サーバー側での利用可能状態が必要です。このパッケージをインストールしても、生成が有効になったり、支出権限が付与されたり、課金が開始されたりすることはありません。バージョン 1.15.1 では、AI の検出機能はなく、既存のアカウント管理ツールが引き続き利用できます。リモートでの利用可能状態はサーバー側で制御されます。

生成には body: { quote_id, max_cost_usd } と idempotency_key が必要です。不確かな応答を受け取った場合は、同じキーを再利用してください。見積もりは 15 分以内に期限切れになります。返された有効期限を使用してください。AI 用ドルウォレットはアカウント管理用クレジットとは別です。AI ツールは従来の dry_run 契約を受け付けません。代わりに、課金対象のプロバイダー処理を開始しない見積もり操作を使用してください。キャンセルはベストエフォートであり、返金を保証するものではありません。作成しても公開はされません。返されたアセットを確認してから、既存の TokPortal スケジュール設定ツールを使用してください。

クライアントの設定

sk_your_key_here をキーに置き換えてください。以下の各スニペットはローカルの stdio サーバー用です。リモート URL 形式は最後に記載しています。

Cursor

~/.cursor/mcp.json（またはプロジェクト内の .cursor/mcp.json）：

{
  "mcpServers": {
    "tokportal": {
      "command": "npx",
      "args": ["-y", "tokportal-mcp"],
      "env": { "TOKPORTAL_API_KEY": "sk_your_key_here" }
    }
  }
}

Claude Desktop

claude_desktop_config.json（macOS：~/Library/Application Support/Claude/、Windows：%APPDATA%\Claude\）：

{
  "mcpServers": {
    "tokportal": {
      "command": "npx",
      "args": ["-y", "tokportal-mcp"],
      "env": { "TOKPORTAL_API_KEY": "sk_your_key_here" }
    }
  }
}

Claude Code

claude mcp add tokportal -e TOKPORTAL_API_KEY=sk_your_key_here -- npx -y tokportal-mcp
# or the remote server:
claude mcp add --transport http tokportal https://app.tokportal.com/api/ext/mcp --header "X-API-Key: sk_your_key_here"

VS Code（GitHub Copilot エージェントモード）

.vscode/mcp.json：

{
  "servers": {
    "tokportal": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "tokportal-mcp"],
      "env": { "TOKPORTAL_API_KEY": "sk_your_key_here" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "tokportal": {
      "command": "npx",
      "args": ["-y", "tokportal-mcp"],
      "env": { "TOKPORTAL_API_KEY": "sk_your_key_here" }
    }
  }
}

OpenAI Codex CLI

~/.codex/config.toml：

[mcp_servers.tokportal]
command = "npx"
args = ["-y", "tokportal-mcp"]
env = { TOKPORTAL_API_KEY = "sk_your_key_here" }

Gemini CLI

~/.gemini/settings.json：

{
  "mcpServers": {
    "tokportal": {
      "command": "npx",
      "args": ["-y", "tokportal-mcp"],
      "env": { "TOKPORTAL_API_KEY": "sk_your_key_here" }
    }
  }
}

リモートサーバー（Streamable HTTP）

リモート MCP サーバーに対応するクライアントであれば、X-API-Key: sk_... ヘッダーまたは Authorization: Bearer sk_... を使用して https://app.tokportal.com/api/ext/mcp に接続できます。url 形式を使用するクライアントの例：

{
  "mcpServers": {
    "tokportal": {
      "url": "https://app.tokportal.com/api/ext/mcp",
      "headers": { "X-API-Key": "sk_your_key_here" }
    }
  }
}

環境変数

変数	必須	説明
TOKPORTAL_API_KEY	はい	API キー（sk_ + 64 桁の 16 進数）。サーバー側には SHA-256 ハッシュのみが保存されます。
TOKPORTAL_BASE_URL	いいえ	デフォルトは https://app.tokportal.com/api/ext です。

ツールの仕組み

サーバーは、stdio 経由で TokPortal API の操作を MCP ツールとして公開します。公開 API スキーマから生成され、HTTP API と同じ X-API-Key 認証を使用します。

• ツール名は tokportal_<operation_id_snake_case> です（tokportal_create_bundle、tokportal_list_accounts など）。パスパラメーターとクエリパラメーターはトップレベルの入力として指定し、JSON 本文は body に指定します。
• すべてのツールに title、readOnlyHint、destructiveHint、idempotentHint、openWorldHint が付与されています。各ツールのアノテーションを確認してください。削除を伴わない場合でも、課金対象の操作や取り消し不能な操作は破壊的とみなされることがあります。
• GET 以外のすべてのツールは、トップレベルの dry_run: true を受け付け、X-TokPortal-Dry-Run: true として送信します。クエリやリクエスト本文には含めません。ドライランでは通常のレート制限が適用されますが、idempotency_key は消費されません。操作が冪等性に対応している場合、後続の実リクエストでも同じキーを使用してください。
• マルチパートアップロードツールも OpenAPI から生成されます。バイナリフィールドは file_path などのローカルパス入力として公開され、残りのフォームフィールドはスキーマで定義された名前で公開されます。
• ミューテーションでは、シークレットを扱う操作（認証情報の表示、確認コード、Webhook の作成、署名付きアップロード URL、レポートの作成）を除き、任意の idempotency_key を受け付けます（Idempotency-Key として送信）。これらの操作は再実行されません。

MCP サーバーは、可観測性とサポート診断のため、API リクエストに X-TokPortal-Client: tokportal-mcp/1.22.0 を送信します。

ツール呼び出しに失敗すると、利用可能な場合は request_id、retry_after_seconds、rate_limit を含む diagnostics オブジェクト付きのエラー結果が返されます。

グローバルにインストールされたバイナリを使用する従来の設定も引き続き機能します。

{
  "mcpServers": {
    "tokportal": {
      "command": "tokportal-mcp",
      "env": {
        "TOKPORTAL_API_KEY": "sk_your_key_here"
      }
    }
  }
}

信頼できる情報源

このパッケージは、非公開の TokPortal モノレポジトリにある TokPortal 公開 OpenAPI スキーマ (https://developers.tokportal.com/openapi.json) から生成されています。src/generated.ts はリリースのたびに再生成されます。手動で編集しないでください。受け付ける PR については CONTRIBUTING.md を、脆弱性の報告については SECURITY.md をご覧ください。

リンク

• ドキュメント：https://developers.tokportal.com
• MCP ガイド：https://developers.tokportal.com/mcp
• SDK と CLI：https://developers.tokportal.com/sdks-cli
• API リファレンス（OpenAPI）：https://developers.tokportal.com/openapi.json
• その他のパッケージ：@tokportal/node · @tokportal/cli · tokportal (PyPI) · github.com/tokportal/tokportal-go

MIT © TokPortal

接続済みアナリティクス（1.18.0）

tokportal_get_analytics_account_insights に { "id": "saved-account-uuid" } を指定すると、Instagram アカウントの期間別リーチ／ビュー数／エンゲージメントと、対象となる TikTok 投稿の視聴時間／完了率／トラフィックデータを読み取れます。Creator 以上のプランが必要です。既存のプラン制限も引き続き適用されます。接続されていないアカウント、または未確認のアカウントでは、available: false と connected_analytics: null が返されます。これは読み取り専用であり、更新処理は開始されません。欠損している指標は省略され、完了率は 0～1 の割合、トラフィック／オーディエンスの内訳は 0～100 のパーセンテージ、視聴時間は秒単位です。同じブロックは tokportal_get_analytics_account にも含まれます。完全な仕様。

受信トレイのアクションと Business 設定（1.19.0）

tokportal_get_account_inbox で、スコープ内の受信コメントと Instagram メッセージを読み取れます。tokportal_create_account_comment_reply で公開返信できます（0 クレジット。署名付き返信機能、安定したリクエストキー、最新の Coverage、およびアカウントのクォータが必要です）。tokportal_get_account_comment_reply で配信状況を確認してください。不明な結果を確認せずに再送信しないでください。

tokportal_get_account_business_setup で進行状況を読み取れます。tokportal_request_account_business_setup では、音楽の制限について明示的に確認した後、Instagram アカウントごとに 1 回、5 クレジットでマネージャーのタスクを依頼できます。TikTok の DM は利用できません。公開メタデータの Webhook で、接続、受信アクティビティ、返信結果、Business タスクの変更が通知されます。仕様と制限については、Connection & Inbox ガイドをご覧ください。

キーワードコメントのモデレーション

tokportal_get_account_comment_moderation で、アカウントのルールと結果履歴を読み取れます。 tokportal_update_account_comment_moderation で、Instagram と TikTok のキーワード／例外ルールを明示的に保存できます。最初に設定バージョンを読み取ってください。デフォルトでは無効で、DM もクレジットの請求もありません。保存後に処理されるのは新しいコメントのみです。TikTok では現在、非表示解除が不安定です。また、ルールを無効にしても、非表示にしたコメントは復元されません。保存せずに検証するには dry_run: true を使用してください。

Instagram のメッセージ送信とコメントからの DM

受信メッセージから 24 時間以内に既存の Instagram の会話に返信するには、tokportal_send_account_inbox_message を使用します。コメントごとに 7 日以内に一度だけ、tokportal_create_account_private_reply を使用します。接続権限で許可されている場合、Creator と Business が対象となります。アカウントに紐づく参照情報は tokportal_get_account_inbox で取得してください。任意の宛先 ID は受け付けられません。これらのアクションに現在クレジットはかかりません。

tokportal_get_account_comment_dm と tokportal_update_account_comment_dm は、アカウントごとに 1 つのオプトインキーワードルールを管理します。任意で、所有する投稿に対象を限定できます。ルールは無効の状態で開始され、新しいオリジナルコメントのみを処理し、永続的な履歴を公開します。アカウント間で共有されるクールダウン、Coverage、厳密な ID 確認、永続的なリクエストキーの重複排除が適用されます。配信状況が不明な場合、確認せずに再送してはいけません。ステータスの確認には tokportal_get_account_message_operation を使用してください。プライベート返信だけでは、その後の DM 送信は許可されません。TikTok の DM は提供していません。

詳細ガイド：https://developers.tokportal.com/account-connection-inbox

コメントの手動操作（1.22.0）

tokportal_create_account_comment_action は、コメントの actions に表示されている場合に限り、削除、非表示、Instagram での非表示解除、および TikTok のトップレベルコメントの固定／固定解除に対応します。正確な署名付きアクション参照と投稿参照を渡してください。完全削除を行う前に、必ずユーザーに確認してください。クレジットは 0 です。サーバーは共有アカウントリースを確保する前に、権限、Coverage、現在の接続状態、プロバイダーの機能を確認します。安定した request_key を使用してください。結果が不確かな場合は tokportal_get_account_comment_action を使用してください。処理中または結果不明の書き込みを、確認せずに繰り返してはいけません。dry_run: true を指定すると、コメントを変更せずに検証できます。inbox.comment.action.updated に含まれるのは結果メタデータのみです。このリリースでは、TikTok での非表示解除と「いいね」は利用できません。Retry-After に従って待機してください。クォータは安全なアクティビティ目標ではなく、アカウントが制限されないことを保証するものでもありません。