tokportal-mcp

TokPortal — это управляемый API социальной инфраструктуры: реальные аккаунты TikTok, Instagram и YouTube, созданные, прогретые и управляемые людьми-менеджерами аккаунтов в 16+ странах — доступные как REST API и MCP-сервер. Никакого OAuth на аккаунт, никакого лимита в 25 постов в день, никакой проверки приложения.

Документация https://developers.tokportal.com · Базовый URL 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 — это официальный сервер Model Context Protocol для API TokPortal. Он предоставляет каждую публичную операцию API (91 инструмент) для Claude, Cursor, VS Code, Windsurf, Codex, Gemini CLI и любого другого MCP-клиента — создавайте пакеты, загружайте видео, настраивайте и публикуйте аккаунты, читайте аналитику, управляйте вебхуками.

Два способа использования:

Требуется Node.js 20 или новее для локального сервера. Получите API-ключ на https://app.tokportal.com/developer/api-keys (формат sk_ + 64 шестнадцатеричных символа).

Быстрый старт за 30 секунд

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

Сервер общается по MCP через stdio. Направьте на него любой MCP-клиент и спросите, например:

«Создай пакет TikTok в США с 5 видео, загрузи ./launch.mp4 как видео 1 с подписью «День 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-серверы, может подключиться к https://app.tokportal.com/api/ext/mcp с заголовком X-API-Key: sk_... или Authorization: Bearer sk_.... Пример для клиентов, использующих форму url:

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

Переменные окружения

Как работают инструменты

Сервер предоставляет действия API TokPortal как MCP-инструменты через stdio. Он генерируется из публичной схемы API и использует ту же аутентификацию X-API-Key, что и HTTP API.

• Имена инструментов — 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-сервер отправляет X-TokPortal-Client: tokportal-mcp/1.12.1 в API-запросах для наблюдаемости и диагностики поддержки.

Неудачные вызовы инструментов возвращают результат с ошибкой, содержащий объект diagnostics с полями request_id, retry_after_seconds и rate_limit, когда эти заголовки доступны.

Устаревшая конфигурация с использованием глобально установленного бинарного файла все еще работает:

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

Источник истины

Этот пакет генерируется из публичной OpenAPI-схемы TokPortal (https://developers.tokportal.com/openapi.json) в приватном монорепозитории TokPortal. src/generated.ts перегенерируется при каждом релизе — не редактируйте его вручную. См. CONTRIBUTING.md о том, какие PR мы принимаем, и 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