tokportal-mcp

TokPortalは、管理されたソーシャルインフラストラクチャAPIです。16か国以上のアカウントマネージャーによって作成、ウォームアップ、運用される実際のTikTok、Instagram、YouTubeアカウントを、REST APIおよびMCPサーバーとして公開します。アカウントごとのOAuthは不要、1日25投稿の制限もなく、アプリレビューも必要ありません。

ドキュメント 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 · llms.txt https://developers.tokportal.com/llms.txt

tokportal-mcp は、TokPortal APIの公式Model Context Protocolサーバーです。すべての公開API操作（91ツール）をClaude、Cursor、VS Code、Windsurf、Codex、Gemini CLI、その他のMCPクライアントに公開します。バンドルの作成、動画のアップロード、アカウントの設定と公開、分析の読み取り、ウェブフックの管理が可能です。

2つの使用方法があります:

ローカルサーバーにはNode.js 20以降が必要です。APIキーはhttps://app.tokportal.com/developer/api-keysで取得してください（形式は sk_ + 64桁の16進数）。

30秒クイックスタート

npm install -g tokportal-mcp
TOKPORTAL_API_KEY=sk_your_key_here tokportal-mcp

サーバーはstdio経由でMCPを話します。任意のMCPクライアントからこのサーバーを指定し、例えば次のように依頼します:

「アメリカで5本の動画からなるTikTokバンドルを作成し、./launch.mp4 を動画1としてキャプション「Day 1」でアップロードし、その後バンドルを公開してください。」

この呼び出しチェーンは、tokportal_create_bundle → tokportal_upload_video_direct → tokportal_configure_bundle_video → tokportal_publish_bundle を使用します。

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(); // 91 tools
const me = await client.callTool({ name: "tokportal_get_current_user", arguments: {} });
console.log(tools.length, me.content[0].text);

クライアント設定

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のアクションをMCPツールとしてstdio経由で公開します。公開APIスキーマから生成され、HTTP APIと同じ X-API-Key 認証を使用します。

• ツール名は tokportal_<operation_id_snake_case> です（tokportal_create_bundle、tokportal_list_accounts など）。パスパラメータとクエリパラメータはトップレベルの入力で、JSONボディは body に入ります。

• すべてのツールにはMCPアノテーションが付いています: title、readOnlyHint（GET）、destructiveHint（DELETE / cancel / unpublish / reset / unschedule / revoke）、idempotentHint（GET/PUT/DELETE）、および openWorldHint: false。これにより、破壊的な呼び出しに対してクライアントが確認を求めることができます。

• マルチパートアップロードツールもOpenAPIから生成されます。バイナリフィールドは file_path などのローカルパス入力として公開され、残りのフォームフィールドはスキーマ名で公開されます。

• 変更操作はオプションの idempotency_key（Idempotency-Key として送信）を受け入れます。ただし、機密情報を含む操作（資格情報の開示、確認コード、ウェブフック作成、署名付きアップロードURL、レポート作成）は再実行されません。

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

失敗したツール呼び出しは、それらのヘッダーが利用可能な場合、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 はリリースのたびに再生成されます。手動で編集しないでください。プルリクエストとして受け入れている内容については 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