MnogoReels

English | Русский

MCP-сервер MnogoReels

MCP-сервер MnogoReels: превращайте длинные видео в вертикальные Shorts/Reels с субтитрами, транскрипты и статьи из любого MCP-клиента. Дайте вашему ИИ-ассистенту ссылку на 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 запрашивают ключ.

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

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

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

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-ключ

1. Войдите или зарегистрируйтесь на mnogo-reels.ru.
2. Откройте Developers → API keys и создайте ключ. Он начинается с mrfrt_usr_.
3. Вставьте его в конфигурацию вашего клиента, как показано ниже (MNOGOREELS_API_KEY для локального сервера, заголовок Authorization: Bearer для хостируемого).

Ключ может тратить ваши кредиты. Используйте отдельный ключ для каждого клиента или машины, никогда не вставляйте его в чаты, issues или 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 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

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

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

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

{
  "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_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

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

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

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

{
  "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" }
    }
  }
}

{
  "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": []
    }
  }
}

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

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

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

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 }}'

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()

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

{
  "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" }
    }
  }
}

Что вы можете делать

Задавайте вашему ассистенту вопросы на простом языке, например:

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

Инструменты

Cada herramienta declara un título, las cuatro anotaciones MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) y un esquema de salida. Las dos herramientas que gastan créditos están marcadas como destructiveHint: true, de modo que los clientes que preguntan antes de acciones riesgosas (por ejemplo, Claude y Codex) te solicitan confirmación en cada llamada.

Cómo elegir una herramienta

Los trabajos se ejecutan en segundo plano

Cada herramienta create_* devuelve un id de inmediato. La herramienta get_* correspondiente espera dentro de la llamada hasta wait_sec segundos (predeterminado 30, máximo 50) y envía notificaciones de progreso mientras tanto, de modo que el asistente simplemente la vuelve a llamar hasta que el estado sea completed o failed. Los videos cortos tardan unos minutos; un rango completo de 30 minutos puede tardar decenas de minutos. Mientras un trabajo de clips está en proceso, get_clip_job devuelve solo el número de clips listos (establece include_partial_clips=true para verlos antes).

Reglas de gasto

• Precio: 1 crédito por minuto iniciado del rango procesado (end_sec − start_sec), mínimo 1, cobrado cuando se crea el trabajo. Ejemplos: 45 s → 1 crédito, 10 min → 10, 29 min 30 s → 30. Los subtítulos, ganchos, metraje de apoyo, música y el modo agéntico no cambian el precio a través de la API.
• Gratis: comprobaciones, cotizaciones, transcripciones, artículos, miniaturas de YouTube, reintentos de trabajos fallidos y lectura de resultados.
• Cotizar primero: quote_clip_job es gratis y usa la misma fórmula que el backend. El asistente debe mostrarte el precio y esperar tu acuerdo.
• max_credits es obligatorio en create_clip_job y recut_clip_job. La llamada se rechaza sin cobrar si el precio es mayor. Un operador también puede establecer un límite máximo con MNOGOREELS_MAX_CREDITS_PER_CALL o el encabezado X-MnogoReels-Max-Credits-Per-Call que el modelo no puede superar.
• 30 minutos por trabajo. MnogoReels procesa como máximo 30 minutos por trabajo, por lo que los rangos más largos se rechazan antes de cualquier cargo. Divide videos largos con start_sec/end_sec (0–1800, 1800–3600, …).
• Protección contra duplicados: una solicitud idéntica con la misma clave dentro de 10 minutos devuelve el trabajo ya creado en lugar de cobrar de nuevo (allow_duplicate: true desactiva esto). La protección vive en un proceso del servidor; dos procesos separados no la comparten.
• Sin cancelación ni reembolso automático. Los créditos se cobran cuando se crea el trabajo y los trabajos no se pueden cancelar. Si el procesamiento falla, los créditos no se devuelven automáticamente; retry_clip_job re-ejecuta un trabajo fallido gratis, o contacta a support@mnogo-reels.ru con el job_id.
• Diálogo de confirmación. Donde el cliente admite la elicitación de formularios MCP, el servidor también te pide confirmar el monto exacto antes de cobrar:

Indicaciones y recursos

Indicaciones (comandos de barra en clientes que los muestran):

Recursos:

Las indicaciones y los recursos de trabajos aparecen solo cuando las herramientas que usan están habilitadas (por ejemplo, /mcp/readonly ofrece solo review_recent_clips). Cada capacidad también es accesible a través de herramientas, porque muchos clientes nunca muestran recursos.

Configuración

Variables de entorno (servidor local y autoalojamiento)

Los booleanos aceptan 1/true/yes/on y 0/false/no/off. Un valor inválido detiene el servidor con un mensaje que nombra la variable (código de salida 2). Línea de comandos: mnogoreels-mcp [--http] [--help] [--version].

Servidor alojado: rutas y encabezados

Las cabeceras solo pueden limitar lo que la ruta permite. El descubrimiento y el listado funcionan sin clave; una llamada de herramienta que necesita la clave y no la tiene recibe HTTP 401.

Perfiles

Autoalojamiento del servidor HTTP

npx -y mnogoreels-mcp@latest --http o docker run -p 8080:8080 -e MNOGOREELS_TRANSPORT=http ghcr.io/realsatanyan/mnogoreels-mcp:latest inicia el mismo servidor que se ejecuta en mcp.mnogo-reels.ru (comprobación de salud: GET /healthz, tarjeta del servidor: GET /.well-known/mcp/server-card.json). Establece MNOGOREELS_ALLOWED_HOSTS a tu dominio. La configuración de producción se describe en docs/deploy-coolify.md.

Seguridad

• Contenido no confiable. Los títulos, transcripciones, artículos y otros textos que provienen de videos están envueltos en etiquetas <untrusted_source_text>, y las instrucciones del servidor indican al modelo que los trate como datos, nunca como instrucciones.
• Higiene de la clave. La clave viaja solo en la cabecera Authorization o X-API-Key (el servidor alojado rechaza claves en URLs), nunca se registra, y get_account muestra solo sus últimos 4 caracteres. Usa una clave dedicada por cliente y revoca las claves que ya no uses. Las claves de servicio (mrfrt_svc_…) se rechazan.
• Modo de solo lectura. MNOGOREELS_READ_ONLY=true, la ruta /mcp/readonly o el interruptor de solo lectura en el paquete de Claude Desktop eliminan toda herramienta que pueda crear trabajos o gastar créditos.
• Solo fuentes oficiales. El servidor se publica solo como el paquete npm mnogoreels-mcp, la imagen ghcr.io/realsatanyan/mnogoreels-mcp, el endpoint alojado https://mcp.mnogo-reels.ru y este repositorio. No entregues tu clave a imitaciones.
• Fijación. mnogoreels-mcp@latest se actualiza automáticamente. Para evitar actualizaciones automáticas, fija una versión, p. ej. npx -y mnogoreels-mcp@1.0.0.

Reporta vulnerabilidades de forma privada: consulta SECURITY.md.

Privacidad

El servidor local envía tus argumentos de herramienta y tu clave solo a api.mnogo-reels.ru. El servidor alojado los recibe en mcp.mnogo-reels.ru y los reenvía a la misma API; mantiene las claves solo en memoria durante la duración de una solicitud y nunca registra claves, argumentos de herramienta ni resultados (solo un prefijo hash corto de la clave, para distinguir a los usuarios). No se recopila telemetría. Detalles: PRIVACY.md, la política de privacidad de MnogoReels y los términos.

Solución de problemas

Los errores de herramientas comienzan con Error [<code>]: seguido de consejos. Los más comunes:

¿Sigue atascado? Abre un issue (quita tu clave de los registros y configuraciones primero) o escribe a support@mnogo-reels.ru.

Limitaciones (v1)

• Sin archivos locales: el video debe ser accesible mediante un enlace público (súbelo a algún lugar público primero).
• Sin saldo de créditos: la API no lo expone; consúltalo en mnogo-reels.ru.
• Sin publicación ni programación en redes sociales.
• Sin cancelación de trabajos.
• Los paquetes de publicación se pueden leer pero no crear; las imágenes de artículos fallidas no se pueden reintentar.

Desarrollo

Requisitos: Node.js 22+. El código es TypeScript (estricto), compilado con tsc, probado con Vitest y Stryker, y escrito con desarrollo guiado por pruebas.

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

Consulta CONTRIBUTING.md para el flujo de trabajo y docs/release.md para los lanzamientos. Los cambios se enumeran en CHANGELOG.md. Se espera que todos los participantes sigan el Código de Conducta.

Licencia

MIT © 2026 MnogoReels