PiratePressPiratePress

MCP-сервер PiratePress: генерация видео из AI-агентов

«MCP-сервер PiratePress» — способ отдать производство видео AI-агенту: ты пишешь «сделай ролик про …», агент сам заказывает, ждёт и забирает mp4. Разберём, что такое MCP, какие инструменты даёт сервер и как поставить его за минуту.

Что нужно подготовить

  1. AI-агент с поддержкой MCP — Claude Code, Kimi Code, Cursor, Claude Desktop или любой другой клиент Model Context Protocol.
  2. API-ключ. Бот @piratepress_bot → /apikey. Ключ pp_… показывается один раз.
  3. Минута на установку — однострочник делает всё сам.

Как подключить и использовать

Шаг 1. Установи одной командой:

curl -fsSL https://piratepress.fun/install.sh | PIRATEPRESS_API_KEY=pp_... bash

Установщик кладёт сервер в ~/.piratepress/mcp/, регистрирует его в Claude Code (если установлен) и ставит скилл через skills CLI с авто-детектом твоих агентов. Ничего вне $HOME не трогается. Ручная установка — npm-пакет @piratepress/mcp, конфиги для клиентов в README.

Шаг 2. Познакомься с инструментами. Основные:

  • generate_video — рекомендуемый дефолт: явные параметры (вся поверхность POST /videos: theme, lang, duration, bg_ai, music, caption_mode, placement, cta, count и т.д.). Возвращает {id, cost, eta_seconds}.
  • quick_video — один свободный промпт; LLM маппит его в параметры. Только для разовых размытых заказов.
  • get_video_status — статус заказа; при done отдаёт result_url и постинг-пак.
  • wait_video — блокирующее ожидание финала (поллит каждые 20 с с прогресс-нотификациями, таймаут по умолчанию 30 минут).
  • review_video — решение по сценарию в режиссёрском режиме: approve / edit / regen.
  • upload_asset / list_assets — медиатека: свои фоны, треки, образцы голоса (возвращённый id идёт в поля *_asset_id).
  • list_bg_presets — валидные id стоковых фонов для bg_preset.
  • get_balance — кошелёк: дублоны, подписка, остаток fair-use.

Шаг 3. Отдай задачу агенту. «Сделай пять 30-секундных роликов про космос на английском» — агент проверит баланс, создаст заказы через generate_video, дождётся через wait_video и скачает mp4 с постинг-паками.

Частые ошибки

quick_video как дефолт. Свободный промпт удобен, но маппинг LLM может уехать от темы, цена известна только после создания, а маппер троттлится до нескольких вызовов в час. Для потока — generate_video с явными параметрами.

Заказ без проверки баланса. Агент, который сразу ставит 20 роликов, упрётся в insufficient_funds. Правильный флоу: get_balance → расчёт стоимости → заказ.

Игнорирование refunded. При фейле генерации дублоны возвращаются, заказ уходит в refunded. Агент должен отличать его от error и уметь перезаказать.

Частые вопросы

Зачем MCP, если есть REST API? REST — для твоего кода, MCP — для готовых AI-агентов: ноль интеграции, инструменты появляются в агенте сразу после установки.

Нужен ли отдельный сервер? Нет, MCP-сервер — локальный процесс на твоей машине, ходит в публичное API по твоему ключу.

Что с безопасностью ключа? Ключ хранится локально в конфиге агента. Перевыпуск в боте отзывает старый автоматически.

Поддерживается ли режиссёрский режим? Да: director_mode ставит заказ на паузу с ревью сценария, агент решает через review_video.

Можно ли использовать сервер в команде? Да: каждый ставит локально со своим ключом. Баланс при этом у каждого свой — ключ привязан к аккаунту, а не к машине.

Что делать, если агент не видит инструменты? Перезапусти клиент после установки: регистрация MCP подхватывается на старте. Проверить можно командой списка серверов в твоём клиенте.

Есть ли ограничения по параллельным заказам? Очередь генерации общая для аккаунта: пакеты до 50 роликов в заказе — штатный режим. Для фанатичных объёмов разумно растянуть заказы по времени.

Можно ли совместить MCP с собственным кодом? Да: ключ один и тот же, API общее. Агент может ставить заказы через MCP, а твой сервис — забирать результаты по REST. Разделение труда наоборот тоже работает.

Что логировать в агентском флоу? Id заказа, его стоимость и финальный статус: этого хватает для учёта расходов и разбора фейлов. Тексты ошибок API человекочитаемы — сохраняй их целиком.

Подключение занимает минуту: забери ключ в @piratepress_bot командой /apikey и выполни однострочник — дальше ролики делает агент.