MnogoReels

English | Русский

Servidor MCP MnogoReels

Servidor MCP MnogoReels: transforme vídeos longos em Shorts/Reels verticais legendados, transcrições e artigos a partir de qualquer cliente MCP. Dê ao seu assistente de IA um link de YouTube, VK Video, RuTube, Dzen, Twitch, Yandex Disk, Google Drive ou um link de vídeo direto, e ele escolhe os melhores momentos, reformata para 9:16, insere legendas e um título de chamariz, e devolve links para os clipes prontos, usando sua própria conta MnogoReels.

Instalação em um clique

Cliente	Servidor hospedado (nada para instalar)	Servidor local (Node.js 22+, npx)
Cursor
VS Code
VS Code Insiders
Kiro
Claude Desktop	não disponível com chave de API (veja abaixo)
Smithery

Os botões do Cursor e do Kiro esperam MNOGOREELS_API_KEY no seu ambiente; defina-a e reinicie o editor, ou substitua ${env:…} pela sua chave na configuração que o editor abrir. Os botões do VS Code pedem a chave.

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

O pacote do Claude Desktop (.mcpb) abre uma caixa de diálogo de instalação que pede a chave e um interruptor opcional de somente leitura. Links do Goose e todos os outros clientes estão listados em Início rápido.

Obtenha sua chave de API

1. Entre ou registre-se em mnogo-reels.ru.
2. Abra Developers → API keys e crie uma chave. Ela começa com mrfrt_usr_.
3. Coloque-a na configuração do seu cliente conforme mostrado abaixo (MNOGOREELS_API_KEY para o servidor local, um cabeçalho Authorization: Bearer para o hospedado).

A chave pode gastar seus créditos. Use uma chave separada para cada cliente ou máquina, nunca a cole em chats, issues ou URLs, e revogue-a na mesma página quando não precisar mais dela.

Listar ferramentas funciona sem chave, assim como get_account, get_options_guide, check_video_source e quote_clip_job para um novo link. Tudo o que lê seus jobs ou cria novos precisa da chave.

Início rápido

Servidor hospedado (recomendado)

URL: https://mcp.mnogo-reels.ru/mcp (Streamable HTTP). Envie a chave em um cabeçalho:

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

• Se seu cliente não puder definir Authorization, envie X-API-Key: mrfrt_usr_YOUR_KEY em vez disso.
• https://mcp.mnogo-reels.ru/mcp/readonly é o mesmo servidor sem qualquer ferramenta que crie jobs ou gaste créditos.
• Nunca coloque a chave na URL: o servidor recusa tais solicitações.

Servidor local (stdio)

Requer Node.js 22 ou mais recente. O servidor fala com https://api.mnogo-reels.ru diretamente da sua máquina.

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

"type": "http" é a grafia usada por Claude Code, VS Code e Cursor. Cline precisa de "streamableHttp", Windsurf de serverUrl, Gemini CLI de httpUrl; os blocos por cliente abaixo têm a forma exata. Arquivos prontos estão em examples/, e docs/clients.md tem notas mais longas por cliente.

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

O que você pode fazer

Peça ao seu assistente em linguagem simples, por exemplo:

• "Crie Shorts a partir de https://www.youtube.com/watch?v=… com legendas em russo no estilo hormozi. Me diga o preço primeiro."
• "Quantos créditos custaria para recortar os primeiros 30 minutos deste podcast? Ele tem 2 horas de duração."
• "Transcreva este vídeo do RuTube e me dê legendas SRT."
• "Escreva um post de blog com capítulos do meu último job de clipes."
• "Mostre meus jobs de clipes recentes e os três melhores clipes de cada um, com suas pontuações e links."

Ferramentas

Cada ferramenta declara um título, todas as quatro anotações MCP (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) e um esquema de saída. As duas ferramentas que gastam créditos são marcadas como destructiveHint: true, para que clientes que pedem confirmação antes de ações arriscadas (por exemplo, Claude e Codex) solicitem sua aprovação a cada chamada.

Como escolher uma ferramenta

Trabalhos são executados em segundo plano

Cada ferramenta create_* retorna um id imediatamente. A ferramenta get_* correspondente aguarda dentro da chamada por até wait_sec segundos (padrão 30, máximo 50) e envia notificações de progresso enquanto isso, para que o assistente simplesmente a chame novamente até que o status seja completed ou failed. Vídeos curtos levam alguns minutos; um intervalo completo de 30 minutos pode levar dezenas de minutos. Enquanto um trabalho de clipe está em processamento, get_clip_job retorna apenas o número de clipes prontos (defina include_partial_clips=true para vê-los antecipadamente).

Regras de gastos

• Preço: 1 crédito por minuto iniciado do intervalo processado (end_sec − start_sec), mínimo 1, cobrado quando o trabalho é criado. Exemplos: 45 s → 1 crédito, 10 min → 10, 29 min 30 s → 30. Legendas, ganchos, B-roll, música e modo agêntico não alteram o preço pela API.
• Grátis: verificações, cotações, transcrições, artigos, miniaturas do YouTube, repetições de trabalhos com falha e leitura de resultados.
• Cote primeiro: quote_clip_job é gratuito e usa a mesma fórmula do backend. O assistente deve mostrar o preço e aguardar seu acordo.
• max_credits é obrigatório em create_clip_job e recut_clip_job. A chamada é recusada sem cobrança se o preço for maior. Um operador também pode definir um limite rígido com MNOGOREELS_MAX_CREDITS_PER_CALL ou o cabeçalho X-MnogoReels-Max-Credits-Per-Call que o modelo não pode aumentar.
• 30 minutos por trabalho. O MnogoReels processa no máximo 30 minutos por trabalho, portanto intervalos mais longos são recusados antes de qualquer cobrança. Divida vídeos longos com start_sec/end_sec (0–1800, 1800–3600, …).
• Proteção contra duplicatas: uma solicitação idêntica com a mesma chave dentro de 10 minutos retorna o trabalho já criado em vez de cobrar novamente (allow_duplicate: true desativa isso). A proteção vive em um processo do servidor; dois processos separados não a compartilham.
• Sem cancelamento, sem reembolso automático. Os créditos são cobrados quando o trabalho é criado e os trabalhos não podem ser cancelados. Se o processamento falhar, os créditos não são devolvidos automaticamente; retry_clip_job reexecuta um trabalho com falha gratuitamente, ou entre em contato com support@mnogo-reels.ru com o job_id.
• Diálogo de confirmação. Onde o cliente suporta elicitação de formulário MCP, o servidor também pede que você confirme o valor exato antes de cobrar:

Prompts e recursos

Prompts (comandos de barra em clientes que os exibem):

Recursos:

Prompts e recursos de trabalho aparecem apenas quando as ferramentas que eles usam estão habilitadas (por exemplo, /mcp/readonly oferece apenas review_recent_clips). Toda capacidade também é acessível por meio de ferramentas, porque muitos clientes nunca exibem recursos.

Configuração

Variáveis de ambiente (servidor local e auto-hospedagem)

Booleanos aceitam 1/true/yes/on e 0/false/no/off. Um valor inválido interrompe o servidor com uma mensagem nomeando a variável (código de saída 2). Linha de comando: mnogoreels-mcp [--http] [--help] [--version].

Servidor hospedado: caminhos e cabeçalhos

Os cabeçalhos só podem restringir o que o caminho permite. Descoberta e listagem funcionam sem chave; uma chamada de ferramenta que precisa da chave e não a possui recebe HTTP 401.

Perfis

Auto-hospedagem do servidor HTTP

npx -y mnogoreels-mcp@latest --http ou docker run -p 8080:8080 -e MNOGOREELS_TRANSPORT=http ghcr.io/realsatanyan/mnogoreels-mcp:latest inicia o mesmo servidor que roda em mcp.mnogo-reels.ru (verificação de saúde: GET /healthz, cartão do servidor: GET /.well-known/mcp/server-card.json). Defina MNOGOREELS_ALLOWED_HOSTS para o seu domínio. A configuração de produção está descrita em docs/deploy-coolify.md.

Segurança

• Conteúdo não confiável. Títulos, transcrições, artigos e outros textos provenientes de vídeos são envolvidos em tags <untrusted_source_text>, e as instruções do servidor dizem ao modelo para tratá-los como dados, nunca como instruções.
• Higiene da chave. A chave viaja apenas no cabeçalho Authorization ou X-API-Key (o servidor hospedado rejeita chaves em URLs), nunca é registrada em logs, e get_account mostra apenas os últimos 4 caracteres. Use uma chave dedicada por cliente e revogue chaves que não usa mais. Chaves de serviço (mrfrt_svc_…) são rejeitadas.
• Modo somente leitura. MNOGOREELS_READ_ONLY=true, o caminho /mcp/readonly ou o interruptor de somente leitura no pacote do Claude Desktop remove toda ferramenta que pode criar jobs ou gastar créditos.
• Apenas fontes oficiais. O servidor é publicado apenas como o pacote npm mnogoreels-mcp, a imagem ghcr.io/realsatanyan/mnogoreels-mcp, o endpoint hospedado https://mcp.mnogo-reels.ru e este repositório. Não forneça sua chave a imitações.
• Fixação de versão. mnogoreels-mcp@latest atualiza automaticamente. Para evitar atualizações automáticas, fixe uma versão, ex.: npx -y mnogoreels-mcp@1.0.0.

Reporte vulnerabilidades de forma privada: veja SECURITY.md.

Privacidade

O servidor local envia seus argumentos de ferramenta e chave apenas para api.mnogo-reels.ru. O servidor hospedado os recebe em mcp.mnogo-reels.ru e os encaminha para a mesma API; ele mantém chaves apenas em memória durante a duração de uma requisição e nunca registra chaves, argumentos de ferramenta ou resultados (apenas um prefixo curto de hash da chave, para distinguir usuários). Nenhuma telemetria é coletada. Detalhes: PRIVACY.md, a política de privacidade e os termos do MnogoReels.

Solução de problemas

Erros de ferramenta começam com Error [<code>]: seguido de conselhos. Os mais comuns:

Ainda travado? Abra uma issue (remova sua chave de logs e configurações primeiro) ou escreva para support@mnogo-reels.ru.

Limitações (v1)

• Sem arquivos locais: o vídeo deve ser acessível por um link público (envie-o para algum lugar público primeiro).
• Sem saldo de créditos: a API não o expõe; veja-o em mnogo-reels.ru.
• Sem publicação ou agendamento em redes sociais.
• Sem cancelamento de jobs.
• Pacotes de publicação podem ser lidos, mas não criados; imagens de artigos com falha não podem ser repetidas.

Desenvolvimento

Requisitos: Node.js 22+. O código é TypeScript (estrito), construído com tsc, testado com Vitest e Stryker, e escrito com testes primeiro.

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

Veja CONTRIBUTING.md para o fluxo de trabalho e docs/release.md para lançamentos. Mudanças estão listadas em CHANGELOG.md. Todos os participantes devem seguir o Código de Conduta.

Licença

MIT © 2026 MnogoReels