Gerencie sua hospedagem de vídeo por IA com o servidor MCP da JMVStream
Hoje, reorganizar uma biblioteca de vídeos é abrir o painel e mexer vídeo por vídeo, ou escrever e manter um script na REST API. Com o MCP, você descreve a tarefa em português ao seu assistente de IA e ele chama as ferramentas da sua hospedagem.
O servidor MCP da JMVStream conecta um assistente de IA à sua hospedagem de vídeo e dá a ele 13 ferramentas para gerenciar vídeos já hospedados: subir, listar, renomear, mover entre galerias, trocar a capa, gerar o MP4 para download, consultar o disco e apagar. Ele não gera nem edita vídeo e não cobre live, playlists nem eventos. O arquivo sobe direto do seu computador para o storage, até 100 GiB por vídeo, e a hospedagem por trás tem banda ilimitada e preço fixo em reais. O MCP está disponível em todos os planos de hospedagem de vídeo, sem custo à parte.
O que você pode pedir à IA: as 13 ferramentas
O servidor expõe 13 ferramentas, todas sobre vídeos que já estão no seu plano. Você não precisa saber o nome delas: o assistente escolhe a ferramenta pelo que você pede. A tabela mostra o que cada uma faz e o que ela devolve.
| Ferramenta | O que faz | O que devolve |
|---|---|---|
| create_upload | Inicia o envio de um vídeo do seu computador. Você informa nome do arquivo, tamanho exato em bytes (até 100 GiB) e, se quiser, a galeria de destino; sem galeria, o vídeo vai para a padrão. | Um upload_id e os comandos curl de cada parte (até 100 MiB, um único envio; acima disso, até 20 partes) |
| complete_upload | Fecha o envio. O vídeo entra na fila de conversão e aparece no plano em cerca de 1 minuto ("não encontrado" nesse intervalo é normal). | Confirmação |
| get_video | Consulta um vídeo pelo identificador (hash): status, andamento da conversão e links prontos. | Link HLS (.m3u8), capa, 3 imagens de capa, código de embed do player, tamanho, duração, datas |
| list_videos | Lista a biblioteca, com até 50 vídeos por página. Filtra por galeria e por parte do nome, ou mostra só os que ainda estão convertendo. | Os mesmos dados do get_video por vídeo, mais total de itens e de páginas |
| update_video | Renomeia um vídeo e/ou move para outra galeria. Só isso: descrição, tags, privacidade e capa não passam por aqui. | Atualização do vídeo |
| delete_video | Exclui o vídeo do plano. É definitivo. | Confirmação |
| get_download | Gera o MP4 para download. A primeira chamada cria o arquivo (processing); repetida, devolve o link quando fica pronto. O link vale cerca de 1 dia. Se falhar, mostra o erro e aceita nova tentativa. A fila é compartilhada e a geração pode demorar. | processing, ready (com a URL) ou failed |
| set_thumbnail | Troca a capa do vídeo por uma imagem de URL pública (JPEG, PNG ou WebP, até 1 MB, sem redirecionamento). | Confirmação |
| get_disk_usage | Mostra o espaço ocupado pelos vídeos do plano inteiro ou de uma galeria. | Total em GB, já formatado |
| list_galleries | Lista as galerias do plano em árvore (com subgalerias). É onde o assistente descobre o identificador de cada galeria. | Nome, descrição e identificador de cada galeria, e o total |
| create_gallery | Cria uma galeria, na raiz ou dentro de outra. | Confirmação |
| update_gallery | Renomeia uma galeria e/ou altera a descrição. O que você não informar é mantido. | Confirmação |
| delete_gallery | Exclui uma galeria, só se estiver vazia (sem vídeos e sem subgalerias). | Confirmação |
Exemplos de pedidos
Pedidos reais, em linguagem natural, e o que o assistente faz por baixo. A ordem das chamadas pode variar de um assistente para outro.
“Quanto de disco eu estou usando?”
Ferramenta: get_disk_usage
Volta: O total em GB do plano. Para uma galeria só: "…na galeria Cursos".
Testado com chamada real em 23/10/2026.
“Liste os vídeos que ainda estão convertendo.”
Ferramenta: list_videos com converting=true (esse filtro ignora os outros)
Volta: Os vídeos em conversão, com status e andamento, até 50 por página.
“Me dá o código de embed e o link HLS do vídeo 'Aula 01'.”
Ferramenta: list_videos filtrando pelo nome e, se preciso, get_video
Volta: O código do player (iframe), o link HLS, a capa principal e as 3 imagens de capa, tudo na mesma resposta. Sem segunda chamada para montar o embed.
Testado com chamada real em 23/10/2026.
Antes de publicar o embed, dê o play: veja "Vídeo curto sem HLS" em Limites, à vista.
“Suba o arquivo aula-02.mp4 e coloque na galeria Cursos.”
Ferramenta: Em sequência: list_galleries (acha o identificador de "Cursos") → create_upload → envio do arquivo → complete_upload → get_video depois de cerca de 1 minuto
Volta: O vídeo no plano, na galeria certa, com link HLS, capas e embed.
O MCP não recebe o arquivo: ele devolve comandos curl e o envio vai do computador onde o arquivo está direto para o storage, por URL pré-assinada. Os comandos precisam rodar nessa máquina: se o seu assistente tem acesso a terminal, ele pode rodá-los; se não, você copia e cola.
“Troque a capa do vídeo X por esta imagem: [URL].”
Ferramenta: set_thumbnail
Condição: a imagem precisa estar numa URL pública, em JPEG, PNG ou WebP, com até 1 MB e sem redirecionamento. O MCP não recebe imagem anexada ao chat.
“Gere o MP4 do vídeo X para eu baixar.”
Ferramenta: get_download
Volta: Primeiro processing; o assistente repete a chamada até ready e entrega a URL do MP4, que vale cerca de 1 dia. Não prometemos prazo: a fila de geração é compartilhada e o arquivo pode ficar em processing por bastante tempo.
“Mova os vídeos 'Aula 01' e 'Aula 02' para a galeria Módulo 1 e renomeie a segunda para 'Aula 02 — revisada'.”
Ferramenta: list_galleries, list_videos (filtro por nome) e update_video (nome e galeria)
Como conectar
Você precisa de um plano ativo na JMVStream e de um assistente de IA que fale MCP com servidor remoto (Streamable HTTP) e deixe configurar um header Authorization. A conexão usa o token do plano e enxerga só aquele plano: tudo o que as ferramentas listam ou alteram é daquele plano. Trate o token como senha: ele dá acesso às 13 ferramentas, inclusive às que apagam.
Passo 1 — Pegue o token do plano
- No Hub (hub.jmvtechnology.com), abra o menu "API e MCP" e, no card "Token do plano", copie o token. Se o plano ainda não tiver token: Configurações do plano → bloco API → Gerar token.
- O dono da conta já vê o menu; usuários adicionais só veem se o dono liberar administração para eles.
- Atenção: gerar um token novo invalida o anterior.
Passo 2 — Use o endereço do servidor
Endereço: https://mcp.jmvstream.com/mcp. Transporte: Streamable HTTP. Autenticação: header Authorization: Bearer <token do plano>. O MCP troca o token por um acesso à API da JMVStream por você; você não lida com JWT.
O endereço termina em /mcp: sem isso, o servidor responde 404. Sem o header, responde 401 (www-authenticate: Bearer).
Passo 3 — Configure no seu cliente
A sintaxe abaixo vem da documentação oficial de cada cliente; troque <TOKEN-DO-PLANO> pelo token do passo 1.
Claude Code (terminal)
claude mcp add --transport http jmvstream https://mcp.jmvstream.com/mcp --header "Authorization: Bearer <TOKEN-DO-PLANO>"Cursor (arquivo .cursor/mcp.json do projeto, ou ~/.cursor/mcp.json para todos os projetos)
{
"mcpServers": {
"jmvstream": {
"url": "https://mcp.jmvstream.com/mcp",
"headers": {
"Authorization": "Bearer <TOKEN-DO-PLANO>"
}
}
}
}Outros clientes: qualquer cliente que fale MCP remoto por Streamable HTTP e aceite um header personalizado conecta com os mesmos três dados: endereço, transporte e Authorization: Bearer <token do plano>.
Passo 4 — Teste a conexão sem risco
Peça: "Quanto de disco estou usando?". É uma consulta de leitura (get_disk_usage): não altera nada no plano. Se voltar o total em GB, está conectado.
Se der erro
| Resposta | O que significa |
|---|---|
| 404 | O endereço está sem o /mcp no final. |
| 401 | Token ausente, inválido, regenerado depois de copiado, ou plano inativo. |
Limites, à vista
| Limite | Valor |
|---|---|
| Tamanho de cada vídeo enviado pelo MCP | Até 100 GiB (cerca de 107 GB). Até 100 MiB, o envio é um único PUT; acima disso, é dividido em partes de até 5 GiB, no máximo 20. |
| Como o arquivo sobe | Direto do seu computador para o storage, por URL pré-assinada. O MCP não recebe nem guarda o arquivo. |
| Comandos do envio | curl (e dd para recortar as partes), executados na máquina onde está o arquivo. |
| Vídeos por consulta | list_videos: até 50 por página (padrão 10). Pedir 51 ou mais devolve erro de validação. A resposta traz total e última página. |
| Capa por URL | JPEG, PNG ou WebP, até 1 MB, URL pública, sem redirecionamento |
| update_video | Altera só nome e galeria. Não altera descrição, tags, privacidade nem capa (capa é o set_thumbnail). |
| delete_video | Definitivo. Não há desfazer documentado. A remoção é assíncrona: o vídeo fica indisponível na hora e o arquivo é apagado em instantes. |
| delete_gallery | Só galeria vazia (sem vídeos e sem subgalerias) |
| Armazenamento cheio | O envio de vídeo novo é recusado (erro "sem espaço") até o upgrade do plano |
| Download MP4 (get_download) | Link válido por cerca de 1 dia. A fila de geração é compartilhada: o arquivo pode ficar muito tempo em processing, e não prometemos prazo. |
| Vídeo curto sem HLS | Em alguns vídeos curtos, o status chega a COMPLETED sem o HLS gerado. Esses vídeos não tocam e não geram download. Dê o play antes de publicar o embed e, se acontecer, fale com o suporte. |
O que o MCP não faz (e o que usar)
O MCP cobre vídeo sob demanda, galerias, envio, download, capa e uso de disco. Ele não faz:
- Gerar ou editar vídeo. Não corta, não legenda, não cria vídeo por IA. Ele gerencia o que já está hospedado.
- Transmissão ao vivo, eventos e streams. Para live, veja a transmissão ao vivo e a documentação da REST API.
- Playlists. Não há ferramenta de playlist no MCP.
- Descrição, tags e privacidade do vídeo. O update_video só mexe em nome e galeria.
- Prometer prazo de download nem garantir vídeo curto tocável. Veja os limites na seção anterior.
- Cobrança de acesso (pay-per-view, ingresso). Isso é do app PPV/OTT com a sua marca, não do MCP nem do plano de hospedagem.
Quando não escolher o MCP
- Você quer que a IA edite ou crie vídeo. Esse é outro tipo de ferramenta. O nosso só gerencia a biblioteca.
- Você precisa de automação fixa, sem pessoa pedindo. Rotina agendada, integração com seu sistema de cursos ou CRM: use a API REST, que é feita para isso.
- Você vai subir poucos vídeos por mês. Para um upload por semana, o painel é mais rápido que montar a conexão. O MCP compensa em biblioteca grande, em lote (renomear, mover, conferir conversão) e no dia a dia de quem já trabalha dentro do assistente.
- Você não quer que um assistente possa apagar. O token é o do plano e libera as 13 ferramentas, inclusive delete_video e delete_gallery. Se isso é um risco para a sua equipe, não entregue o token a um assistente: use o painel.
A hospedagem por trás: preço fixo e limite à vista
O MCP gerencia a sua hospedagem de vídeo. A hospedagem tem banda ilimitada, sem taxa de excedente, e preço fixo em reais. O que muda de um plano para outro é o armazenamento.
| Plano | No anual (por mês) | No mensal | Armazenamento |
|---|---|---|---|
| Starter | R$ 49,90 | R$ 69,90 | 250 GB |
| Professional | R$ 119 | R$ 149 | 1 TB |
| Full | R$ 299 | R$ 349 | 2 TB |
| Enterprise | Sob consulta | — | Sob medida |
O plano anual é cobrado pelo valor total: parcele no cartão ou pague no Pix com 10% de desconto. Quando o armazenamento enche, o envio de vídeo novo é recusado até o upgrade. Datacenter próprio no Brasil, suporte humano em português todos os dias e assistente 24 h. Ver planos completos da hospedagem de vídeo
O MCP está disponível em todos os planos de hospedagem de vídeo, sem custo à parte.
Perguntas frequentes
O que é MCP e o que ele faz na JMVStream?
MCP (Model Context Protocol) é um padrão aberto para um assistente de IA usar ferramentas de outros sistemas. O servidor MCP da JMVStream dá ao assistente 13 ferramentas para gerenciar os vídeos da sua hospedagem: subir, listar, renomear, mover entre galerias, trocar a capa, gerar o MP4 para download, consultar o disco e apagar.
O MCP gera ou edita vídeo?
Não. Ele gerencia vídeos já hospedados. Não corta, não legenda e não cria vídeo por IA.
Qual é o endereço do servidor e como autentico?
https://mcp.jmvstream.com/mcp, por Streamable HTTP, com o header Authorization: Bearer <token do plano>. Sem o /mcp no final o servidor responde 404; sem o header, 401.
Quais assistentes de IA funcionam?
Qualquer cliente que fale MCP remoto por Streamable HTTP e aceite um header Authorization personalizado. Na página, mostramos a sintaxe do Claude Code e do Cursor, conforme a documentação oficial de cada um.
Preciso de um plano específico? Tem custo?
O MCP está disponível em todos os planos de hospedagem de vídeo, sem custo à parte. Planos só de live ou IPTV não têm API nem MCP. Você precisa de um plano ativo: com plano inativo, o servidor responde 401.
Onde pego o token?
No Hub, menu "API e MCP", card "Token do plano". Se o plano ainda não tiver token: Configurações do plano → bloco API → Gerar token. Gerar um novo token invalida o anterior. O dono da conta já vê o menu; usuários adicionais só veem se o dono liberar administração para eles.
É seguro pedir à IA para apagar vídeo?
delete_video é definitivo e não há desfazer documentado. A descrição da ferramenta orienta o assistente a confirmar com você antes, mas quem garante é você: peça "liste o que vai ser apagado e espere meu OK" e confira os nomes. A remoção é assíncrona (o vídeo sai do ar na hora; o arquivo é apagado em instantes). delete_gallery só apaga galeria vazia, então não leva vídeo junto.
Qual o limite de upload pelo MCP?
Até 100 GiB (cerca de 107 GB) por vídeo, limitado também pelo armazenamento livre do plano. O arquivo não passa pelo MCP: ele sobe direto do seu computador para o storage por URL pré-assinada. Até 100 MiB vai em um único envio; acima disso, em até 20 partes de até 5 GiB. Com o armazenamento cheio, o envio é recusado até o upgrade.
O download em MP4 sempre sai?
Não prometemos prazo. O get_download cria o arquivo numa fila compartilhada e pode ficar muito tempo em processing; quando fica pronto, o link vale cerca de 1 dia. Em alguns vídeos curtos, o status chega a COMPLETED sem o HLS gerado, e eles não tocam nem baixam: dê o play antes de publicar o embed.
Qual a diferença para a REST API?
É a mesma API da JMVStream, em duas camadas. O MCP é a camada para agentes de IA: você pede em linguagem natural a um assistente e ele chama 13 ferramentas de gerenciamento de vídeos sob demanda. A REST API é para código: o seu sistema chama a API de forma automática e fixa, e a API cobre também eventos ao vivo e playlists, que o MCP não expõe. As duas usam a mesma hospedagem.
Veja a REST API para automatizar por código e a documentação.