[Английский] | Русский

MCP-сервер MnogoReels

MCP-сервер MnogoReels превращает длинные видео в вертикальные Shorts/Reels с субтитрами, расшифровки и статьи. Работайте с ним из любого MCP-клиента: отправьте AI-ассистенту ссылку на YouTube, VK Video, RuTube, Dzen, Twitch, Yandex Disk, Google Drive или прямую ссылку на видео. Ассистент выберет лучшие моменты, изменит кадрирование на 9:16, добавит субтитры и цепляющий заголовок, а затем вернёт ссылки на готовые ролики. Для работы используется ваша учётная запись MnogoReels.

Установка в один клик

Клиент	Сервер на хостинге (установка не требуется)	Локальный сервер (Node.js 22+, `npx`)
Cursor
VS Code
VS Code Insiders
Kiro
Claude Desktop	недоступно при использовании API-ключа (см. ниже)
Smithery

Кнопки для Cursor и Kiro используют переменную MNOGOREELS_API_KEY из окружения. Задайте её и перезапустите редактор либо замените ${env:…} на свой ключ в конфигурации, которую откроет редактор. В VS Code кнопки запрашивают ключ.

Прямые ссылки для запуска приложения (если кнопка не открывает редактор)

GitHub не делает ссылки cursor:// и vscode: кликабельными, поэтому скопируйте нужную ссылку в адресную строку браузера.

Cursor, сервер на хостинге:

cursor://anysphere.cursor-deeplink/mcp/install?name=mnogoreels&config=eyJ1cmwiOiJodHRwczovL21jcC5tbm9nby1yZWVscy5ydS9tY3AiLCJoZWFkZXJzIjp7IkF1dGhvcml6YXRpb24iOiJCZWFyZXIgJHtlbnY6TU5PR09SRUVMU19BUElfS0VZfSJ9fQ%3D%3D

Cursor, локальный сервер:

cursor://anysphere.cursor-deeplink/mcp/install?name=mnogoreels&config=eyJjb21tYW5kIjoibnB4IiwiYXJncyI6WyIteSIsIm1ub2dvcmVlbHMtbWNwQGxhdGVzdCJdLCJlbnYiOnsiTU5PR09SRUVMU19BUElfS0VZIjoiJHtlbnY6TU5PR09SRUVMU19BUElfS0VZfSJ9fQ%3D%3D

VS Code, сервер на хостинге (запрашивает ключ):

vscode:mcp/install?%7B%22name%22%3A%22mnogoreels%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.mnogo-reels.ru%2Fmcp%22%2C%22headers%22%3A%7B%22Authorization%22%3A%22Bearer%20%24%7Binput%3Amnogoreels_api_key%7D%22%7D%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22mnogoreels_api_key%22%2C%22description%22%3A%22MnogoReels%20API%20key%20(mrfrt_usr_...)%22%2C%22password%22%3Atrue%7D%5D%7D

VS Code, локальный сервер (запрашивает ключ):

vscode:mcp/install?%7B%22name%22%3A%22mnogoreels%22%2C%22type%22%3A%22stdio%22%2C%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22mnogoreels-mcp%40latest%22%5D%2C%22env%22%3A%7B%22MNOGOREELS_API_KEY%22%3A%22%24%7Binput%3Amnogoreels_api_key%7D%22%7D%2C%22inputs%22%3A%5B%7B%22type%22%3A%22promptString%22%2C%22id%22%3A%22mnogoreels_api_key%22%2C%22description%22%3A%22MnogoReels%20API%20key%20(mrfrt_usr_...)%22%2C%22password%22%3Atrue%7D%5D%7D

Пакет Claude Desktop (.mcpb) открывает окно установки, где можно указать ключ и при необходимости включить режим только для чтения. Ссылки для Goose и всех остальных клиентов приведены в разделе «Быстрый старт».

Получение API-ключа

Войдите в учётную запись или зарегистрируйтесь на сайте mnogo-reels.ru.
Откройте раздел Разработчикам → API keys и создайте ключ. Он начинается с mrfrt_usr_.
Добавьте ключ в конфигурацию клиента, как показано ниже: для локального сервера используйте MNOGOREELS_API_KEY, а для сервера на хостинге — заголовок Authorization: Bearer.

Ключ позволяет расходовать ваши кредиты. Используйте отдельный ключ для каждого клиента или устройства. Не вставляйте его в чаты, обращения в поддержку или URL. Когда ключ больше не нужен, отзовите его на той же странице.

Список инструментов доступен без ключа. Без него также работают get_account, get_options_guide, check_video_source и quote_clip_job для новой ссылки. Для всех операций, которые читают данные о ваших задачах или создают новые, требуется ключ.

Быстрый старт

Сервер на хостинге (рекомендуемый вариант)

URL: https://mcp.mnogo-reels.ru/mcp (Streamable HTTP). Передавайте ключ в заголовке:

{
  "mcpServers": {
    "mnogoreels": {
      "type": "http",
      "url": "https://mcp.mnogo-reels.ru/mcp",
      "headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" }
    }
  }
}

Если клиент не позволяет задать Authorization, вместо него укажите X-API-Key: mrfrt_usr_YOUR_KEY.
https://mcp.mnogo-reels.ru/mcp/readonly — тот же сервер, но без инструментов, которые создают задачи или расходуют кредиты.
Не указывайте ключ в URL: сервер отклоняет такие запросы.

Локальный сервер (stdio)

Требуется Node.js версии 22 или новее. Сервер напрямую подключается к https://api.mnogo-reels.ru с вашего компьютера.

{
  "mcpServers": {
    "mnogoreels": {
      "command": "npx",
      "args": ["-y", "mnogoreels-mcp@latest"],
      "env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
    }
  }
}

Значение "type": "http" используется в Claude Code, VS Code и Cursor. Для Cline требуется "streamableHttp", для Windsurf — serverUrl, для Gemini CLI — httpUrl. Точные конфигурации для каждого клиента приведены ниже. Готовые файлы доступны в examples/, а в docs/clients.md собраны более подробные инструкции для каждого клиента.

Claude Code

Размещённый сервер:

claude mcp add --transport http mnogoreels https://mcp.mnogo-reels.ru/mcp --header "Authorization: Bearer mrfrt_usr_YOUR_KEY"

Локальный сервер:

claude mcp add mnogoreels --env MNOGOREELS_API_KEY=mrfrt_usr_YOUR_KEY -- npx -y mnogoreels-mcp@latest

Плагин (размещённый сервер и навык make-shorts; при включении запрашивает ключ):

/plugin marketplace add RealSatanyan/mnogoreels-mcp
/plugin install mnogoreels@mnogoreels

Claude Desktop

Скачайте mnogoreels-mcp.mcpb и дважды щёлкните по файлу или перетащите его в Settings → Extensions. Claude Desktop запросит API-ключ и запустит сервер с помощью встроенного Node.js.

Также можно добавить локальный сервер в claude_desktop_config.json (Settings → Developer → Edit Config):

{
  "mcpServers": {
    "mnogoreels": {
      "command": "npx",
      "args": ["-y", "mnogoreels-mcp@latest"],
      "env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
    }
  }
}

Пользователи индивидуальной версии Claude Desktop не могут добавлять удалённые подключения с постоянным заголовком API-ключа. Используйте пакет или локальный сервер.

Cursor

Воспользуйтесь кнопками выше или добавьте конфигурацию в ~/.cursor/mcp.json (для всех проектов) либо в .cursor/mcp.json (для одного проекта):

{
  "mcpServers": {
    "mnogoreels": {
      "url": "https://mcp.mnogo-reels.ru/mcp",
      "headers": { "Authorization": "Bearer ${env:MNOGOREELS_API_KEY}" }
    }
  }
}

Для локального варианта используйте приведённый выше блок локального сервера. Если ключ хранится в переменных окружения, укажите "MNOGOREELS_API_KEY": "${env:MNOGOREELS_API_KEY}".

VS Code (GitHub Copilot)

Воспользуйтесь кнопками выше или создайте файл .vscode/mcp.json. VS Code запросит ключ один раз и сохранит его в защищённом хранилище:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "mnogoreels_api_key",
      "description": "MnogoReels API key (mrfrt_usr_...)",
      "password": true
    }
  ],
  "servers": {
    "mnogoreels": {
      "type": "http",
      "url": "https://mcp.mnogo-reels.ru/mcp",
      "headers": { "Authorization": "Bearer ${input:mnogoreels_api_key}" }
    }
  }
}

В файле .mcp.json в рабочей области используется формат mcpServers из раздела о размещённом сервере. Не добавляйте в репозиторий файл, содержащий ваш ключ.

OpenAI Codex

Размещённый сервер в ~/.codex/config.toml (экспортируйте MNOGOREELS_API_KEY в оболочке, из которой запускается Codex):

[mcp_servers.mnogoreels]
url = "https://mcp.mnogo-reels.ru/mcp"
bearer_token_env_var = "MNOGOREELS_API_KEY"
tool_timeout_sec = 120

Локальный сервер:

[mcp_servers.mnogoreels]
command = "npx"
args = ["-y", "mnogoreels-mcp@latest"]
env_vars = ["MNOGOREELS_API_KEY"]
startup_timeout_sec = 60
tool_timeout_sec = 120

Или добавьте сервер из командной строки:

codex mcp add mnogoreels --env MNOGOREELS_API_KEY=mrfrt_usr_YOUR_KEY -- npx -y mnogoreels-mcp@latest

Стандартного времени ожидания запуска в 10 секунд часто недостаточно для первой загрузки через npx, поэтому укажите startup_timeout_sec = 60.

Gemini CLI

Установите расширение. Оно запросит ключ и сохранит его в системном хранилище ключей:

gemini extensions install https://github.com/RealSatanyan/mnogoreels-mcp

Также можно добавить размещённый сервер в ~/.gemini/settings.json:

{
  "mcpServers": {
    "mnogoreels": {
      "httpUrl": "https://mcp.mnogo-reels.ru/mcp",
      "headers": { "Authorization": "Bearer $MNOGOREELS_API_KEY" }
    }
  }
}

Windsurf

Добавьте конфигурацию в ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "mnogoreels": {
      "serverUrl": "https://mcp.mnogo-reels.ru/mcp",
      "headers": { "Authorization": "Bearer ${env:MNOGOREELS_API_KEY}" }
    }
  }
}

Zed

Размещённый сервер в settings.json:

{
  "context_servers": {
    "mnogoreels": {
      "url": "https://mcp.mnogo-reels.ru/mcp",
      "headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" }
    }
  }
}

Локальный сервер:

{
  "context_servers": {
    "mnogoreels": {
      "command": "npx",
      "args": ["-y", "mnogoreels-mcp@latest"],
      "env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
    }
  }
}

Cline

Добавьте в cline_mcp_settings.json один из следующих блоков. Локальный сервер:

{
  "mcpServers": {
    "mnogoreels": {
      "command": "npx",
      "args": ["-y", "mnogoreels-mcp@latest"],
      "env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Размещённый сервер:

{
  "mcpServers": {
    "mnogoreels": {
      "type": "streamableHttp",
      "url": "https://mcp.mnogo-reels.ru/mcp",
      "headers": { "Authorization": "Bearer mrfrt_usr_YOUR_KEY" },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Для удалённого сервера обязательно укажите type: если его не указать, Cline будет считать подключение устаревшим SSE, который этот сервер не поддерживает. Cline также может настроить сервер автоматически по инструкции из llms-install.md.

Goose

Вставьте одну из ссылок в адресную строку браузера: GitHub не отображает ссылки goose:// как кликабельные. Локальный сервер; Goose запросит ключ:

goose://extension?name=MnogoReels&cmd=npx&arg=-y&arg=mnogoreels-mcp%40latest&env=MNOGOREELS_API_KEY%3DMnogoReels%20API%20key%20(mrfrt_usr_...)&timeout=120&description=Turn%20long%20videos%20into%20captioned%20vertical%20clips%2C%20transcripts%20and%20articles

Размещённый сервер: перед открытием замените mrfrt_usr_YOUR_KEY своим ключом:

goose://extension?name=MnogoReels&url=https%3A%2F%2Fmcp.mnogo-reels.ru%2Fmcp&header=Authorization%3DBearer%20mrfrt_usr_YOUR_KEY&timeout=120&description=Turn%20long%20videos%20into%20captioned%20vertical%20clips%2C%20transcripts%20and%20articles

Либо запустите goose configure → Add Extension → Command-line Extension, указав команду npx -y mnogoreels-mcp@latest и переменную MNOGOREELS_API_KEY. Пример файла config.yaml доступен в examples/goose-config.yaml.

Kiro

Воспользуйтесь кнопками выше или добавьте конфигурацию в ~/.kiro/settings/mcp.json (либо в .kiro/settings/mcp.json в проекте):

{
  "mcpServers": {
    "mnogoreels": {
      "url": "https://mcp.mnogo-reels.ru/mcp",
      "headers": { "Authorization": "Bearer ${MNOGOREELS_API_KEY}" }
    }
  }
}

JetBrains AI Assistant, Warp, Amazon Q, LM Studio

Эти клиенты поддерживают универсальный JSON-формат mcpServers. Вставьте блок размещённого или локального сервера в настройки MCP (JetBrains: Settings → Tools → AI Assistant → Model Context Protocol; Warp: Settings → AI → MCP servers; Amazon Q: ~/.aws/amazonq/mcp.json; LM Studio: mcp.json). Если клиент не поддерживает удалённые серверы с заголовками, используйте блок локального сервера.

Continue

Сохраните конфигурацию в файле .continue/mcpServers/mnogoreels.yaml и добавьте секрет MNOGOREELS_API_KEY в Continue:

name: MnogoReels
version: 1.0.0
schema: v1
mcpServers:
  - name: MnogoReels
    type: streamable-http
    url: https://mcp.mnogo-reels.ru/mcp
    requestOptions:
      headers:
        Authorization: 'Bearer ${{ secrets.MNOGOREELS_API_KEY }}'

n8n

Добавьте узел MCP Client Tool в AI Agent:

Транспорт сервера: HTTP Streamable
Конечная точка: https://mcp.mnogo-reels.ru/mcp
Аутентификация: Header Auth с именем Authorization и значением Bearer mrfrt_usr_YOUR_KEY

Подробности: examples/n8n.md.

Yandex AI Studio (MCP Hub)

AI Studio → MCP Hub → «Внешний MCP-сервер»:

Имя: mnogoreels
URL: https://mcp.mnogo-reels.ru/mcp
Транспорт: Streamable HTTP
Заголовок: Authorization: Bearer mrfrt_usr_YOUR_KEY

Подробности: examples/yandex-ai-studio.md.

Cloud.ru Evolution AI Agents

AI Agents → MCP servers → добавьте сервер по URL: https://mcp.mnogo-reels.ru/mcp и укажите заголовок Authorization: Bearer mrfrt_usr_YOUR_KEY.

GigaChain / LangChain (Python)

Используйте langchain-mcp-adapters:

import os

from langchain_mcp_adapters.client import MultiServerMCPClient

client = MultiServerMCPClient(
    {
        "mnogoreels": {
            "transport": "streamable_http",
            "url": "https://mcp.mnogo-reels.ru/mcp",
            "headers": {"Authorization": "Bearer " + os.environ["MNOGOREELS_API_KEY"]},
        }
    }
)
tools = await client.get_tools()

Передайте tools агенту GigaChat. Готовый к запуску скрипт находится в examples/gigachain.py.

Docker

По умолчанию образ запускает локальный сервер с транспортом stdio:

docker run -i --rm -e MNOGOREELS_API_KEY ghcr.io/realsatanyan/mnogoreels-mcp:latest

Пример записи для MCP-клиента:

{
  "mcpServers": {
    "mnogoreels": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "MNOGOREELS_API_KEY", "ghcr.io/realsatanyan/mnogoreels-mcp:latest"],
      "env": { "MNOGOREELS_API_KEY": "mrfrt_usr_YOUR_KEY" }
    }
  }
}

Что можно делать

Обращайтесь к ассистенту обычным языком. Например:

«Сделай короткие ролики из https://www.youtube.com/watch?v=… с русскими субтитрами в стиле Hormozi. Сначала скажи, сколько это будет стоить».
«Сколько кредитов потребуется, чтобы нарезать первые 30 минут этого подкаста? Его продолжительность — 2 часа».
«Расшифруй это видео с RuTube и подготовь субтитры SRT».
«Напиши статью для блога с главами по результатам моей последней задачи по созданию клипов».
«Покажи мои последние задачи по созданию клипов и три лучших клипа для каждой задачи, с оценками и ссылками».

Инструменты

Инструмент	Название	Только чтение	Расходует кредиты	Назначение
`get_account`	Проверить API key и настройки	да	нет	Проверяет, работает ли настроенный API key MnogoReels, и показывает настройки этого сервера.
`get_options_guide`	Справочник по параметрам клипов	да	нет	Объясняет допустимые значения параметров для create_clip_job и recut_clip_job: режимы видео, длительность клипов, стили субтитров, хуков, сюжетных арок и финальных заставок, кадрирование и языки, а также правила расчёта стоимости и ограничение в 30 минут на одну задачу.
`check_video_source`	Проверить источник видео	да	нет	Проверяет, может ли MnogoReels скачать видео по ссылке, и возвращает его название, продолжительность и платформу.
`quote_clip_job`	Рассчитать стоимость задачи по созданию клипов	да	нет	Рассчитывает стоимость в кредитах для create_clip_job или recut_clip_job без списания средств и проверяет, может ли MnogoReels скачать видео.
`create_clip_job`	Создать задачу по созданию клипов (расходует кредиты)	нет	да	Запускает создание вертикальных коротких клипов 9:16 из длинного видео с помощью AI. На видео добавляются субтитры и заголовок-хук; также можно добавить вступительные хуки, музыку и B-roll.
`get_clip_job`	Получить статус задачи и клипы	да	нет	Возвращает статус, ход выполнения и результаты задачи по созданию клипов, созданной с помощью create_clip_job, recut_clip_job или на сайте MnogoReels.
`list_clip_jobs`	Список задач по созданию клипов	да	нет	Показывает задачи пользователя по созданию клипов, начиная с самых новых, в том числе задачи, запущенные на сайте MnogoReels.
`recut_clip_job`	Создать новую версию клипов (расходует кредиты)	нет	да	Создаёт новую задачу по созданию клипов на основе исходного видео существующей задачи, используя другие настройки, например стиль субтитров или хуков, длительность клипов, язык, кадрирование, музыку, B-roll или запрос.
`retry_clip_job`	Повторить неудачную задачу (бесплатно)	нет	нет	Повторно запускает неудачную задачу с теми же настройками бесплатно, сохраняя прежний job_id.
`create_transcription`	Расшифровать видео или аудио	нет	нет	Запускает транскрибирование речи из видео или аудио по ссылке с временными метками.
`get_transcription`	Получить расшифровку	да	нет	Возвращает статус и текст расшифровки, запущенной с помощью create_transcription.
`create_article`	Создать статью по задаче с клипами	нет	нет	Преобразует исходное видео завершённой задачи по созданию клипов в развернутую статью: заголовок, SEO-заголовок и описание, краткое содержание, разделы, основные выводы, главы с временными метками, до 4 кадров из видео в качестве иллюстраций и полная расшифровка с временными метками.
`get_article`	Получить статью	да	нет	Возвращает статью, созданную с помощью create_article, в формате Markdown вместе с её статусом.
`search_broll`	Найти материалы B-roll	да	нет	Ищет видео и изображения для B-roll.
`get_broll_asset`	Получить материал B-roll	да	нет	Возвращает материал B-roll по asset_id со свежими ссылками.
`list_packs`	Список публикационных пакетов	да	нет	Показывает публикационные пакеты пользователя, начиная с самых новых.
`get_pack`	Получить публикационный пакет	да	нет	Возвращает публикационный пакет: варианты заголовков и описаний, тексты для обложек и хештеги, изображения миниатюр, тизерные видео, идентификатор статьи и идентификатор задачи по созданию клипов.
`create_youtube_thumbnails`	Создать миниатюры для YouTube	нет	нет	Создаёт от 1 до 4 миниатюр для YouTube с помощью AI в формате JPEG размером 1280×720. Для этого используются кадры из видео, а также необязательные заголовок и описание художественного оформления.
`get_youtube_thumbnails`	Получить миниатюры для YouTube	да	нет	Возвращает статус и изображения миниатюр, созданных в задаче, запущенной с помощью create_youtube_thumbnails.

Каждый инструмент содержит название, все четыре аннотации MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) и схему выходных данных. Для двух инструментов, расходующих кредиты, указано destructiveHint: true, поэтому клиенты, которые запрашивают подтверждение перед потенциально рискованными действиями (например, Claude и Codex), будут спрашивать разрешение при каждом вызове.

Как выбрать инструмент

Что нужно сделать	Инструмент
Проверить, работает ли ссылка, и узнать продолжительность видео	`check_video_source`
Узнать стоимость до создания клипов	`quote_clip_job`
Создать клипы	`create_clip_job` (после расчёта стоимости и вашего подтверждения)
Следить за ходом выполнения и получить клипы	`get_clip_job`
Найти предыдущие задачи, в том числе созданные на сайте	`list_clip_jobs`
Изменить оформление или выбрать другие фрагменты в завершённой задаче	`recut_clip_job` (платно, создаётся новая задача)
Повторно запустить неудачную задачу	`retry_clip_job` (бесплатно)
Получить расшифровку или субтитры SRT	`create_transcription` → `get_transcription`
Подготовить статью для блога, заметки к выпуску или главы	`create_article` → `get_article` (требуется завершённая задача по созданию клипов)
Найти видео для B-roll	`search_broll` → `get_broll_asset`
Просмотреть публикационный пакет, созданный на сайте	`list_packs` → `get_pack`
Создать миниатюры для YouTube	`create_youtube_thumbnails` → `get_youtube_thumbnails`
Проверить ключ и настройки сервера	`get_account`
Разобраться в стилях субтитров, режимах и других параметрах	`get_options_guide`

Задачи выполняются в фоновом режиме

Каждый инструмент create_* сразу возвращает идентификатор. Соответствующий инструмент get_* ожидает завершения операции в рамках вызова до wait_sec секунд (по умолчанию — 30, максимум — 50) и тем временем отправляет уведомления о ходе выполнения. Поэтому ассистенту достаточно вызывать его повторно, пока статус не станет completed или failed. Обработка коротких видео занимает несколько минут, а диапазона длительностью 30 минут — до нескольких десятков минут. Пока задача по созданию клипов выполняется, get_clip_job возвращает только количество готовых клипов. Чтобы увидеть их до завершения задачи, задайте include_partial_clips=true.

Правила расходования кредитов

Стоимость: 1 кредит за каждую начатую минуту обрабатываемого диапазона (end_sec − start_sec), минимум — 1 кредит. Кредиты списываются при создании задачи. Примеры: 45 с → 1 кредит, 10 мин → 10, 29 мин 30 с → 30. Субтитры, хуки, B-roll, музыка и агентный режим не влияют на стоимость при работе через API.
Бесплатно: проверки, расчёты стоимости, расшифровки, статьи, миниатюры для YouTube, повторный запуск неудачных задач и просмотр результатов.
Сначала рассчитайте стоимость: инструмент quote_clip_job бесплатный и использует ту же формулу, что и серверная часть. Ассистент должен сообщить вам стоимость и дождаться подтверждения.
Для create_clip_job и recut_clip_job обязательно указывать max_credits. Если стоимость выше указанного значения, вызов отклоняется без списания кредитов. Оператор также может задать жёсткий лимит с помощью MNOGOREELS_MAX_CREDITS_PER_CALL или заголовка X-MnogoReels-Max-Credits-Per-Call, который модель не может увеличить.
Не более 30 минут на задачу. MnogoReels обрабатывает максимум 30 минут за одну задачу, поэтому запросы на более длинные диапазоны отклоняются до списания кредитов. Разделяйте длинные видео с помощью start_sec/end_sec (0–1800, 1800–3600, …).
Защита от дублирования: если в течение 10 минут поступает идентичный запрос с тем же ключом, сервер возвращает уже созданную задачу и не списывает кредиты повторно (allow_duplicate: true отключает эту защиту). Механизм работает только в пределах одного процесса сервера; разные процессы не используют общие данные.
Отмена и автоматический возврат средств не предусмотрены. Кредиты списываются при создании задачи, а отменить её нельзя. Если обработка завершится с ошибкой, кредиты автоматически не возвращаются. Инструмент retry_clip_job бесплатно перезапускает неудачную задачу. Также можно обратиться в службу поддержки, указав job_id.
Диалог подтверждения. Если клиент поддерживает MCP form elicitation, сервер также попросит подтвердить точную сумму до списания кредитов:

Где запущен сервер	Диалог подтверждения перед списанием
Локальный сервер (stdio, `npx`, `.mcpb`, Docker), любой клиент с поддержкой form elicitation	да
Размещённый сервер, клиент на MCP 2026-07-28 с поддержкой form elicitation	да
Размещённый сервер, клиенты эпохи 2025 года (большинство современных клиентов)	нет: ограничения обеспечивают `max_credits`, лимит оператора, ограничение в 30 минут, защита от дублирования и собственный запрос клиента на подтверждение
Любой клиент без поддержки elicitation	нет: действуют те же ограничения, что и выше

Промпты и ресурсы

Промпты (команды со слешем в клиентах, которые их отображают):

Промпт	Назначение
`clip_video`	Рассчитать стоимость, подтвердить создание клипов по одной ссылке и дождаться их готовности (`url`, необязательные параметры `language`, `caption_style`, `clip_length`)
`podcast_to_shorts`	Разделить длинный подкаст на части по 30 минут, рассчитать стоимость каждой части, создать серию Shorts и предложить порядок публикации (`url`, необязательный параметр `language`)
`video_to_blog_post`	Преобразовать готовую задачу по созданию клипов в статью и список глав (`clip_job_id`)
`transcribe_video`	Расшифровать видео по ссылке в виде текста или SRT (`url`, необязательные параметры `language`, `format`)
`review_recent_clips`	Просмотреть последние задачи и предложить настройки для повторной нарезки без расходов (`count` — необязательный параметр)

Ресурсы:

URI	Содержимое
`mnogoreels://guide/options`	Все допустимые значения параметров с описаниями
`mnogoreels://guide/pricing`	Цены, ограничение в 30 минут и список бесплатных операций
`mnogoreels://guide/workflow`	Инструкции по использованию инструментов (совпадают с инструкциями сервера)
`mnogoreels://clip-jobs/{job_id}`	Статус и клипы одной задачи (JSON; содержит список из 20 последних задач)
`mnogoreels://transcriptions/{transcription_id}`	Первая страница расшифровки
`mnogoreels://articles/{article_id}`	Первая страница статьи в Markdown

Промпты и ресурсы задач доступны только при включённых инструментах, которые они используют (например, /mcp/readonly предлагает только review_recent_clips). Все возможности также доступны через инструменты, поскольку многие клиенты не отображают ресурсы.

Конфигурация

Переменные среды (локальный сервер и самостоятельный хостинг)

Переменная	По умолчанию	Описание
`MNOGOREELS_API_KEY`	отсутствует	Ваш ключ (`mrfrt_usr_…`). Для запуска сервера и просмотра списка инструментов не требуется. В режиме HTTP не используется: каждый клиент передаёт собственный ключ.
`MNOGOREELS_API_URL`	`https://api.mnogo-reels.ru`	Базовый URL API; оставьте значение по умолчанию.
`MNOGOREELS_PROFILE`	`default`	`default`, `readonly` или `directory` (см. раздел Профили).
`MNOGOREELS_TOOLSETS`	все	Список через запятую: `clips`, `transcripts`, `articles`, `library`, `thumbnails` или `all`. `account` включён всегда.
`MNOGOREELS_READ_ONLY`	`false`	При значении `true` скрывает все инструменты, которые создают задачи или расходуют кредиты.
`MNOGOREELS_MAX_CREDITS_PER_CALL`	не задано	Жёсткий лимит кредитов на один платный вызов; модель не может его изменить.
`MNOGOREELS_MAX_WINDOW_SEC`	`1800`	Максимальная длительность диапазона для одной платной задачи в секундах. Оставьте значение по умолчанию: оно соответствует возможностям MnogoReels.
`MNOGOREELS_MEDIA_URLS`	`direct`	Значение `both` также возвращает ссылки `stream_url` через прокси сайта MnogoReels. Оставьте `direct`, пока MnogoReels не объявит о поддержке прокси для API.
`MNOGOREELS_DEBUG`	`false`	Только для локального сервера: выводит полные сообщения об ошибках в stderr.
`MNOGOREELS_TRANSPORT`	`stdio`	Значение `http` запускает сервер Streamable HTTP (то же, что и `--http`).
`MNOGOREELS_HOST` / `MNOGOREELS_PORT`	`127.0.0.1` / `8080`	Адрес HTTP-привязки.
`MNOGOREELS_PUBLIC_URL`	`https://mcp.mnogo-reels.ru/mcp`	Публичный URL, указанный в карточке сервера.
`MNOGOREELS_ALLOWED_HOSTS`	`localhost,127.0.0.1,[::1]`	Допустимые заголовки `Host` (защита от DNS-rebinding).
`MNOGOREELS_ALLOWED_ORIGINS`	`localhost,127.0.0.1,[::1]`	Допустимые имена хостов браузера в заголовке `Origin` или `*` для публичного развёртывания с bearer-токеном.
`MNOGOREELS_TRUSTED_PROXIES`	пусто	CIDR-диапазоны обратных прокси, которым доверяется заголовок `X-Forwarded-For`.

Для логических значений принимаются 1/true/yes/on и 0/false/no/off. Недопустимое значение останавливает сервер и выводит сообщение с именем переменной (код выхода 2). Команда запуска: mnogoreels-mcp [--http] [--help] [--version].

Развёрнутый сервер: пути и заголовки

Путь	Профиль
`/mcp`	`default`
`/mcp/readonly`	`readonly`
`/mcp/directory`	`directory`

Заголовок	Действие
`Authorization: Bearer`	Ваш API-ключ (предпочтительный вариант).
`X-API-Key:`	Ваш API-ключ, если заголовок `Authorization` недоступен.
`X-MnogoReels-Toolsets: clips,transcripts`	Отображает только эти наборы инструментов (`account` остаётся включённым).
`X-MnogoReels-Read-Only: true`	Скрывает инструменты, которые создают задачи или расходуют кредиты. Значение `false` не расширяет возможности пути, работающего только для чтения.
`X-MnogoReels-Max-Credits-Per-Call: 30`	Жёсткий лимит кредитов на один платный вызов.

Заголовки могут только ограничивать возможности, разрешённые для пути. Обнаружение сервера и просмотр списка инструментов доступны без ключа; вызов инструмента, которому нужен ключ, без него вернёт HTTP 401.

Профили

Профиль	Инструменты	Отличия
`default`	19	Все возможности.
`readonly`	13	Нет инструментов, создающих задачи или расходующих кредиты; чтение, проверки и расчёт стоимости доступны.
`directory`	17	Нет инструментов для миниатюр YouTube, вариантов B-roll с AI-изображениями или motion graphics и ссылки для покупки кредитов. Используется в публичных каталогах.

Самостоятельный запуск HTTP-сервера

Команда npx -y mnogoreels-mcp@latest --http или docker run -p 8080:8080 -e MNOGOREELS_TRANSPORT=http ghcr.io/realsatanyan/mnogoreels-mcp:latest запускает тот же сервер, который работает по адресу mcp.mnogo-reels.ru (проверка работоспособности: GET /healthz, карточка сервера: GET /.well-known/mcp/server-card.json). Укажите свой домен в MNOGOREELS_ALLOWED_HOSTS. Описание производственной конфигурации приведено в docs/deploy-coolify.md.

Безопасность

Недоверенное содержимое. Заголовки, расшифровки, статьи и другой текст из видео обрамляются тегами ``. В инструкциях сервера указано, что модель должна воспринимать такое содержимое как данные, а не как инструкции.
Защита ключей. Ключ передаётся только в заголовке Authorization или X-API-Key (развёрнутый сервер отклоняет ключи в URL), никогда не попадает в журналы, а get_account показывает только последние 4 символа. Используйте отдельный ключ для каждого клиента и отзывайте больше не используемые ключи. Сервисные ключи (mrfrt_svc_…) отклоняются.
Режим только для чтения. MNOGOREELS_READ_ONLY=true, путь /mcp/readonly или переключатель режима только для чтения в пакете для Claude Desktop убирает все инструменты, способные создавать задачи или расходовать кредиты.
Только официальные источники. Сервер распространяется только как npm-пакет mnogoreels-mcp, образ ghcr.io/realsatanyan/mnogoreels-mcp, размещённый сервис https://mcp.mnogo-reels.ru и этот репозиторий. Не передавайте свой ключ поддельным копиям.
Фиксация версии. mnogoreels-mcp@latest обновляется автоматически. Чтобы отключить автоматические обновления, зафиксируйте версию, например npx -y mnogoreels-mcp@1.0.0.

О сообщениях об уязвимостях сообщайте конфиденциально: см. SECURITY.md.

Конфиденциальность

Локальный сервер отправляет аргументы инструментов и ключ только на api.mnogo-reels.ru. Развёрнутый сервер получает их на mcp.mnogo-reels.ru и пересылает в тот же API; ключи хранятся только в памяти на время обработки запроса. Сервер никогда не записывает в журналы ключи, аргументы инструментов или результаты — только короткий префикс хеша ключа, чтобы различать пользователей. Телеметрия не собирается. Подробнее: PRIVACY.md, политика конфиденциальности и условия использования MnogoReels.

Устранение неполадок

Ошибки инструментов начинаются с Error []: и содержат рекомендации. Чаще всего встречаются следующие ошибки:

Код	Что делать
`missing_api_key`, `invalid_api_key_format`, `invalid_api_key` (HTTP 401 на размещённом сервере)	Создайте ключ на странице Разработчикам → API-ключи и обновите конфигурацию клиента. Ключи начинаются с `mrfrt_usr_`. Выполните `get_account`, чтобы проверить ключ.
`insufficient_credits` (402)	Пополните баланс или приобретите тариф на сайте mnogo-reels.ru.
`duration_unknown`	Платформа не сообщает длительность видео (обычно так бывает с прямыми ссылками на файлы). Укажите `end_sec` — длительность в секундах или время окончания обрабатываемого фрагмента.
`invalid_arguments` с упоминанием 30 минут	За одну задачу можно обработать не более 30 минут видео. Разделите видео с помощью `start_sec` и `end_sec`, а затем запустите несколько задач.
`source_not_downloadable`	Видео закрыто, удалено, недоступно в вашем регионе, содержит только аудио или имеет размер более 17 GB. Списание средств не произошло. Попробуйте другую ссылку.
`rate_limited`, `rate_limited_local`	Превышено допустимое число запросов. Подождите указанное в сообщении количество секунд.
`upstream_timeout`	MnogoReels не ответил вовремя. Попробуйте ещё раз. При проверке источника можно самостоятельно указать `start_sec` и `end_sec`.
`outcome_unknown`, `billing_uncertain`	Сервер не смог подтвердить, была ли создана платная задача. Прежде чем повторять запрос, проверьте результат с помощью `list_clip_jobs`. Если средства списаны, но задача не создана, напишите в службу поддержки: support@mnogo-reels.ru. Повтор идентичного запроса в течение 10 минут вернёт тот же ответ, не отправляя новый запрос.
Codex: время ожидания инструментов истекает или сервер не запускается	Укажите `startup_timeout_sec = 60` и `tool_timeout_sec = 120` в `config.toml`.
Медленная или неудачная загрузка в России	Некоторые домашние интернет-подключения в России ограничивают скорость доступа к API и медиасерверам. При работе через домашнее подключение предпочтительно использовать размещённый сервер. Переменная `MNOGOREELS_MEDIA_URLS=both` добавляет проксированные ссылки `stream_url`, когда MnogoReels включит этот прокси для работы с API.

Не удалось решить проблему? Создайте issue (сначала удалите ключ из журналов и конфигурационных файлов) или напишите в службу поддержки: support@mnogo-reels.ru.

Ограничения (v1)

Работа с локальными файлами не поддерживается: видео должно быть доступно по публичной ссылке (сначала загрузите его в общедоступное место).
Просмотр баланса кредитов недоступен: API не предоставляет эту информацию. Проверить баланс можно на mnogo-reels.ru.
Публикация в социальных сетях и планирование публикаций не поддерживаются.
Отмена задач не поддерживается.
Пакеты публикаций можно просматривать, но нельзя создавать; повторно запустить создание изображений для неудачной статьи нельзя.

Разработка

Требования: Node.js 22+. Код написан на TypeScript со строгой проверкой типов, собирается с помощью tsc и тестируется с использованием Vitest и Stryker. Разработка ведётся с предварительным написанием тестов.

npm ci --ignore-scripts
npm run typecheck && npm run lint && npm test
npm run build
npm run test:integration
npm run smoke              # MCP Inspector CLI smoke test
npm run version:check      # manifests in sync with package.json
npm run metadata:check     # README tool tables, MCPB tools, Docker tools.json up to date

Описание рабочего процесса см. в CONTRIBUTING.md, а сведения о выпуске релизов — в docs/release.md. Список изменений приведён в CHANGELOG.md. Все участники проекта должны соблюдать Кодекс поведения.