# TokPortal

MCP-сервер TokPortal для управления аккаунтами TikTok и Instagram через REST API. Даёт агентам доступ к готовым аккаунтам, которыми занимаются живые менеджеры в 16+ странах.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 у репозитория
- Автор: tokportal
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/tokportal/tokportal-mcp
- Обновлён: 2026-10-16
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/tokportal

## Что делает

TokPortal предоставляет брендовые аккаунты TikTok и Instagram, которые создают, прогревают и ведут люди. Сервер открывает инструменты для работы с аккаунтами, публикациями и медиа через MCP. Если в воркспейсе включён AI, добавляются семь инструментов для поиска моделей, генерации контента по квоте и работы с отдельным кошельком в долларах.

Работает в двух режимах: локальный (`npx tokportal-mcp`) через stdio — для десктопных клиентов и загрузки файлов с диска, удалённый (`https://app.tokportal.com/api/ext/mcp`) через HTTP — для хостинговых агентов без установки. Требуется Node.js 20 или новее и API-ключ формата `sk_` + 64 шестнадцатеричных символа.

Генерация через AI требует `quote_id`, `max_cost_usd` и `idempotency_key`. Квоты действуют 15 минут, кошелёк для AI независим от кредитов на управление аккаунтами. Предпросмотр бандла (`dry_run: true`) возвращает стоимость без списания, но использует синтетический ID — его нельзя переносить в боевой запрос.

## Требования
- Нужно: Node.js (команды через npx)
- Удалённый сервер: `https://app.tokportal.com/api/ext/mcp`
- Переменные окружения: `TOKPORTAL_API_KEY` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

1. **Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http mcp https://app.tokportal.com/api/ext/mcp
```

2. **Командой платформы**
```bash
claude mcp add --env TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> --transport stdio tokportal -- npx -y tokportal-mcp
```
Вместо <…> подставьте свои значения

### Codex

1. **Командой платформы: удалённый сервер**
```bash
codex mcp add tokportal --url https://app.tokportal.com/api/ext/mcp
```

2. **Командой платформы**
```bash
codex mcp add tokportal --env TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> -- npx -y tokportal-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tokportal": {
            "url": "https://app.tokportal.com/api/ext/mcp"
        }
    }
}
```
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tokportal": {
            "command": "npx",
            "args": [
                "-y",
                "tokportal-mcp"
            ],
            "env": {
                "TOKPORTAL_API_KEY": "<TOKPORTAL_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tokportal": {
            "type": "http",
            "url": "https://app.tokportal.com/api/ext/mcp"
        }
    }
}
```
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tokportal": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "tokportal-mcp"
            ],
            "env": {
                "TOKPORTAL_API_KEY": "<TOKPORTAL_API_KEY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

1. **Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http tokportal https://app.tokportal.com/api/ext/mcp
```

2. **Командой платформы**
```bash
gemini mcp add -e TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> tokportal npx -y tokportal-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- управлять TikTok и Instagram аккаунтами через API без OAuth каждого профиля
- раскатать контент по рынкам в разных странах с уже готовыми аккаунтами
- посмотреть стоимость бандла до покупки через `dry_run`
- сгенерировать контент по квоте с отдельным долларовым балансом
- загрузить медиафайл с диска и опубликовать его в соцсетях

## Примеры запросов агенту
- Покажи доступные страны, цены на кредиты и мой баланс. Сделай предпросмотр TikTok-бандла `account_only` в США с `dry_run: true` и выведи стоимость — жду подтверждения перед покупкой.
- Получи квоту на генерацию видео для TikTok, проверь срок действия и верни `quote_id`.
- Загрузи `promo.mp4` в TokPortal, запланируй публикацию в аккаунте `acc_12345` на завтра 15:00 UTC.

## Похожие
- [Upload-Post](https://affpapa.org/nevibecode/mcp/upload-post.md) — MCP-сервер · ★ 21 у репозитория
- [social-short-production](https://affpapa.org/nevibecode/skills/social-short-production.md) — скилл · 263 установки
- [caption-writer-sms](https://affpapa.org/nevibecode/skills/caption-writer-sms.md) — скилл · 2100 установок
- [content-planner](https://affpapa.org/nevibecode/skills/content-planner.md) — скилл · 297 установок
- [xpoz](https://affpapa.org/nevibecode/mcp/xpoz.md) — MCP-сервер · 4846 установок
- [Mysocial](https://affpapa.org/nevibecode/mcp/mysocial.md) — MCP-сервер

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
