MCP и API-доступ

Три факта, которых не видно на экране: агент подключается входом в аккаунт, а не ключом — вставили адрес, подтвердили на нашей странице, всё; ключ нужен для REST API — когда за данными приходит ваша система, а не агент; и то и другое работает только на платном тарифе. Первый раз здесь? MCP нужен, когда базовый цикл «поиск → сценарий» уже понятен и хочется звать его из чата или редактора — общий маршрут в вводном гайде.

Что выбрать: агент или REST

MCP — для AI-агента. Подключаете Viralmaxing как MCP-сервер к Claude (в браузере, в приложении, в Claude Code), Cursor или Codex и дальше прямо в чате: «покажи мои топ-видео за месяц», «что постят конкуренты в TikTok», «возьми этот ролик в работу». Подключение — по входу в аккаунт, ключ не нужен.

REST API — для своих систем. Ключ как обычный HTTP API, когда нужно встроить Viralmaxing в свой инструмент: выгрузить аналитику в отчёт, дашборд или базу. Справочник методов — во внешней документации API.

Подключить агента

Адрес MCP-сервера один для всех агентов:

https://api.viralmaxing.com/api/mcp

Куда его вставлять:

Claude на claude.ai и в приложении — Настройки → Коннекторы → Добавить свой коннектор, вставить адрес, «Подключить».
Claude Code — claude mcp add --transport http --scope project viralmaxing https://api.viralmaxing.com/api/mcp, затем /mcp в сессии (или claude mcp login viralmaxing) — откроется браузер.
Cursor и Codex — тот же адрес в настройках MCP-серверов, вход тоже через браузер.

Дальше одинаково: открывается страница Viralmaxing, где написано, какой агент запрашивает доступ и что он сможет делать. Подтвердили — агент вернулся к себе уже с доступом. Ключ при этом не создаётся и счётчик ключей не тратится.

Не хочется разбираться в настройках агента — в Настройки → API-ключи есть кнопка «Подключить к агенту»: там пошаговый гид и кнопка «Скопировать промпт для агента». Отдайте промпт агенту, он пропишет подключение сам. Проверьте стартовым вопросом «покажи список доступных инструментов»: перечислил — работает.

Гид подключения к агенту — Гид подключения к AI-агенту: шаги и кнопка «Скопировать промпт».

Отключить агента

Подключённые агенты видны в Настройки → API-ключи, раздел «Подключённые агенты»: название, когда подключён, когда последний раз обращался. Кнопка «Отключить» обрывает доступ немедленно — агент перестаёт получать данные с ближайшего запроса, даже если в нём самом коннектор остался. Подключить заново можно в любой момент, из самого агента.

Доступ в любом случае живёт, пока действует подписка: закончилась — агент получает отказ.

Ключи для REST API

Ключи живут там же, в Настройки → API-ключи. В шапке — счётчик N / 10: одновременно держится до десяти ключей, на десятом кнопка «Создать» блокируется (освободите слот, удалив ненужный).

Страница API-ключи: «Создать» (1) и «Подключить к агенту» (2).

При создании задаёте название (чтобы отличать ключи) и срок действия — Бессрочно, 30, 90 дней или 1 год. Полный ключ показывается один раз, сразу после создания, в зелёной плашке с кнопкой «Скопировать» — скопируйте, пока плашка открыта (закрыли — больше не покажется; потеряли — удаляйте старый и создавайте новый). По каждому ключу в списке видно название, префикс (vmx_...), даты создания и последнего использования (или «не использовался»), срок действия — дата последнего использования это единственный сигнал, что ключ утёк или забыт, следите за ней. Истёкший ключ не исчезает: на нём загорается бейдж «Истёк», авторизовать он перестаёт, но слот из десяти продолжает занимать — удаляйте такие вручную.

Подключить вручную (для продвинутых)

В гиде под промптом спрятан блок «Подключить вручную». --scope project кладёт сервер в .mcp.json текущего проекта; нужен во всех — поставьте --scope user. Cursor и любой другой агент с поддержкой MCP подключаются блоком в .mcp.json проекта — без ключей и заголовков:

{
  "mcpServers": {
    "viralmaxing": {
      "type": "http",
      "url": "https://api.viralmaxing.com/api/mcp"
    }
  }
}

Агент, который не умеет входить через браузер, — единственный случай, когда в MCP всё ещё нужен ключ: добавьте ему заголовок X-API-Key: vmx_....

Что умеет агент через MCP

Читать (энергию не тратит): свои и конкурентные аккаунты, их посты и метрики, агрегированный обзор за период; детали и историю метрик по посту, его существующий транскрипт; текущий баланс энергии; свой контент-план (список сценариев и полный текст любого); выгрузку отфильтрованных постов в CSV.

Действовать: взять видео в работу (take_into_work, 1) превращает ролик в сценарий плана — это единственное действие в MCP, которое тратит энергию, и транскрипт агент подтянет сам (не запускайте транскрипцию отдельно, иначе спишете лишнее); двигать сценарии по статусам (set_scenario_status) и править их текст, заголовок, дату (save_scenario) — бесплатно, потому что текст переписывает сам ваш агент, а продукт лишь сохраняет новую версию (это не платное AI-переписывание из приложения). Платное AI-переписывание (3), поиск идей (30) и подбор конкурентов (200) через MCP не запускаются — у агента нет таких инструментов, они идут только в самом приложении.

Куда попадают взятые в работу видео и как вести план — в разделе Контент-план. Полные цены всех операций — Тариф и энергия.

REST API

Базовый адрес — https://api.viralmaxing.com/api. Ключ передаётся одним из заголовков на выбор:

Authorization: Bearer vmx_...
X-API-Key: vmx_...

Минимальная проверка, что ключ работает, — список ваших ключей (self-serve эндпоинт /users/api-keys):

export VIRALMAXING_API_KEY=vmx_...
curl -H "X-API-Key: $VIRALMAXING_API_KEY" \
  https://api.viralmaxing.com/api/users/api-keys

Тем же ключом читаются ваши данные — те же сущности, что доступны агенту через MCP. Два частых запроса, когда аналитику нужно встроить в свою систему:

Посты отслеживаемых аккаунтов — GET /api/analytics/posts. Возвращает ролики из добавленных вами аккаунтов-конкурентов, а не глобальную базу: пока аккаунты не добавлены в отслеживание, ответ будет пустым. Фильтры идут query-параметрами — platforms (tiktok, instagram, youtube), start_date и end_date (период в формате YYYY-MM-DD), search_query (текст), sort_by, плюс пагинация limit (по умолчанию 50) и offset:

curl -H "X-API-Key: $VIRALMAXING_API_KEY" \
  "https://api.viralmaxing.com/api/analytics/posts?platforms=tiktok&start_date=2026-05-01&limit=20"

Топ-посты одного аккаунта — GET /api/analytics/accounts/{id}/top-posts, где {id} — id отслеживаемого аккаунта; sort задаёт метрику сортировки, limit — сколько вернуть (1–20, по умолчанию 5).

Параметров «хэштег» или «ниша» у этих методов нет: поиск роликов по слову и нише — это Поиск идей внутри приложения (30), через API он не запускается. Перечисленные чтения бесплатны (энергию не тратят) и сейчас не ограничены частотным лимитом. Ответы — JSON; полная схема полей, все методы и коды ошибок — в справочнике API.

Что важно учесть

Удаление ключа необратимо и мгновенно ломает всё, что им авторизуется. Перед удалением убедитесь, что ключ нигде не используется (смотрите дату последнего использования).
Один ключ источников не различает. По дате последнего использования не понять, какое из ваших приложений ходило — заводите отдельный ключ под каждое. У агентов такой проблемы нет: каждое подключение видно отдельной строкой.
Агент не видит инструменты? Проверьте по порядку: транспорт http (не stdio); адрес https://api.viralmaxing.com/api/mcp (без слеша в конце и без опечаток); подключение подтверждено — агент есть в списке «Подключённые агенты»; подписка активна. Если подключались ключом — он должен быть полный vmx_..., а не префикс, и не истёкший.