Como conectar o Claude Code e o Cursor à sua hospedagem de vídeos (MCP, passo a passo)
Resposta rápida
Para conectar o Claude à hospedagem de vídeos, registre https://mcp.jmvstream.com/mcp no cliente.
Use o header Authorization: Bearer <token do plano>. Funciona no Claude Code e no Cursor.
- Copie o token em Hub → "API e MCP" → "Token do plano".
- Guarde o token numa variável de ambiente, fora do Git.
- Rode
claude mcp add(ou edite omcp.jsondo Cursor). - Confira com
claude mcp get jmvstream.
Neste tutorial (13 seções)
- Resposta rápida
- Conectar o Claude à hospedagem de vídeos: os 4 passos
- Onde a configuração fica: os três escopos do Claude Code
- Token fora do Git: o .mcp.json com variável
- Conferir a conexão
- Uma sessão real: pedido, ferramenta e resultado
- Erros que apareceram e como corrigir
- Pedir permissão e confirmação antes de apagar
- Dois fluxos de operação
- Quanto custa
- MCP ou REST API: qual usar
- Perguntas frequentes
- Fontes

Conectar o Claude à hospedagem de vídeos: os 4 passos
Passo 1: pegue o token. No Hub (hub.jmvtechnology.com), abra "API e MCP" e copie o "Token do plano".
Sem token no plano: Configurações do plano → bloco API → Gerar token.
Gerar um token novo invalida o anterior. Se um script já usa o token, anote antes de gerar outro.
Passo 2: exporte o token. Crie a variável com um nome próprio, que não colida com outra:
export JMV_MCP_TOKEN="cole-o-token-aqui"
Passo 3: registre o servidor no Claude Code.
claude mcp add --transport http jmvstream \
https://mcp.jmvstream.com/mcp \
--header "Authorization: Bearer $JMV_MCP_TOKEN"
O transporte é Streamable HTTP, por isso --transport http.
O endereço termina em /mcp. Sem isso, a resposta é 404.
Passo 4: no Cursor, o arquivo é outro. Crie .cursor/mcp.json no projeto (ou ~/.cursor/mcp.json para valer em todos):
{
"mcpServers": {
"jmvstream": {
"url": "https://mcp.jmvstream.com/mcp",
"headers": {
"Authorization": "Bearer ${env:JMV_MCP_TOKEN}"
}
}
}
}
O Cursor lê a variável pela sintaxe ${env:NOME}. O token não fica escrito no arquivo.
Os dois clientes usam o mesmo servidor. As 13 ferramentas estão na página do servidor MCP para vídeos.
Aqui entra o que vem depois do cadastro.
Onde a configuração fica: os três escopos do Claude Code
O claude mcp add aceita --scope, e a escolha decide quem enxerga o token:
| Escopo | Onde grava | Quem vê | Quando usar |
|---|---|---|---|
local (padrão) | ~/.claude.json, só para o projeto atual | só você, só ali | testar com o seu token |
project | .mcp.json na raiz | todo o time, via Git | servidor compartilhado, com ${VAR} no lugar do token |
user | ~/.claude.json, todos os projetos | só você, em tudo | um plano que você usa em vários repositórios |
Fonte: documentação oficial do Claude Code sobre MCP, consultada em 16/11/2026.
Para uma pessoa só, user costuma bastar.
Para um time, use project. O Claude Code pede a aprovação de cada membro antes de ligar um servidor vindo do .mcp.json.
No Cursor a escolha é mais simples: .cursor/mcp.json vale para o projeto e ~/.cursor/mcp.json vale para todos.
Token fora do Git: o .mcp.json com variável
O erro clássico é colar o token no .mcp.json e dar commit. Quem clonar o repositório passa a administrar os seus vídeos.
O arquivo certo guarda só a referência:
{
"mcpServers": {
"jmvstream": {
"type": "http",
"url": "https://mcp.jmvstream.com/mcp",
"headers": {
"Authorization": "Bearer ${JMV_MCP_TOKEN}"
}
}
}
}
O Claude Code aceita ${VAR} e ${VAR:-padrão} em url e headers. Cada pessoa define JMV_MCP_TOKEN na própria máquina.
Duas pegadinhas, as duas da documentação:
- Variável sem valor e sem padrão:
${JMV_MCP_TOKEN}vai literal no header, e o servidor responde 401. - Em servidor remoto, algumas variáveis de credencial do ambiente chegam vazias no header. Daí o nome próprio.
Se o token vazou, gere outro no Hub. O antigo deixa de valer.
Conferir a conexão
No terminal:
claude mcp get jmvstream
claude mcp list
Dentro do Claude Code, /mcp mostra o status e as ferramentas do servidor.
No Cursor, ligue e desligue servidores MCP em "Customize", na barra lateral.
O teste mais barato é um pedido de leitura: "Quanto de disco estou usando na JMVStream?". Ele chama get_disk_usage, que só consulta.
Uma sessão real: pedido, ferramenta e resultado
Pedidos executados no MCP real da JMV em 14/11 e 16/11/2026, num plano real usado para testes.
Os comandos de cada cliente vêm da documentação oficial. Os números abaixo vêm dos registros dessas sessões.
| Pedido em português | Ferramenta | Resultado |
|---|---|---|
| "Quanto de disco estou usando?" | get_disk_usage | 5,05 GB |
| "Liste minhas galerias e vídeos." | list_galleries, list_videos | 5 galerias; 32 vídeos em 4 páginas |
| "Crie uma galeria de teste." | create_gallery | galeria criada |
| "Suba este MP4 de 3 segundos." | create_upload, complete_upload | upload concluído |
| "Está pronto?" | get_video | 1ª chamada "não encontrado"; ~75 s depois, ready: true |
| "Renomeie e mova para outra galeria." | update_video | nome e galeria alterados |
| "Me dê o link e o player." | get_video | .m3u8, iframe do player e 3 capas |
| "Apague o vídeo e a galeria de teste." | delete_video, delete_gallery | removidos; disco de volta a 5,05 GB |
O upload merece atenção. O MCP não recebe o arquivo: create_upload devolve uma URL pré-assinada.
O assistente roda curl -T no seu computador e depois chama complete_upload.
O arquivo vai direto para a hospedagem, sem passar pelo modelo.
Erros que apareceram e como corrigir
| O que aconteceu | Causa | Correção |
|---|---|---|
| 401 ao conectar | sem header, token errado ou plano inativo | conferir o token no Hub e o plano ativo |
| 404 | endereço sem /mcp no final | usar https://mcp.jmvstream.com/mcp |
get_video responde "não encontrado" logo após o upload | o vídeo ainda não foi processado | esperar cerca de 1 minuto e consultar de novo |
| a ferramenta recusa a chamada | parâmetro com outro nome: get_video pede hash, delete_gallery pede uuid | deixar o assistente reler o schema e repetir |
| envio recusado | armazenamento do plano cheio | liberar espaço ou fazer upgrade |
Na sessão de 14/11, o "não encontrado" veio na primeira consulta e o ready: true cerca de 75 segundos depois.
Não é falha. Peça "confira de novo em 1 minuto".
Pedir permissão e confirmação antes de apagar
O delete_video é definitivo, e não há desfazer documentado. Peça a confirmação no próprio pedido:
"Liste os vídeos que vão ser apagados, com nome e galeria. Só apague depois do meu OK."
O cliente também ajuda. O Claude Code trata cada ferramenta MCP como mcp__jmvstream__<ferramenta>.
As regras valem na ordem deny, ask, allow. Para bloquear a exclusão:
{
"permissions": {
"deny": ["mcp__jmvstream__delete_video", "mcp__jmvstream__delete_gallery"]
}
}
Vai no .claude/settings.json do projeto (vale para o time, via Git) ou no ~/.claude/settings.json (vale para você em todos os projetos).
Fonte: documentação de permissões do Claude Code, consultada em 16/11/2026.
O Cursor pede aprovação antes de usar uma ferramenta MCP por padrão. Clique na seta ao lado do nome da ferramenta para ver os argumentos.
O delete_gallery só apaga galeria vazia. Com vídeo dentro, a chamada falha.
Dois fluxos de operação
Fluxo 1: organizar um lote de vídeos novos.
Pedido: "Crie as galerias Aulas e Eventos, suba estes 3 arquivos e mova cada um para a galeria certa, com o nome padronizado."
O assistente usa create_gallery, create_upload, complete_upload e update_video.
Na sessão de 16/11/2026, 2 galerias e 3 vídeos ficaram prontos em cerca de 90 segundos, quase tudo esperando o processamento.
Fluxo 2: planilha de embed e HLS.
Pedido: "Liste os vídeos de cada galeria e me dê uma planilha com nome, endereço HLS e link do player."
O assistente chama list_videos por galeria e monta o CSV na sua máquina.
Cada linha traz galeria, nome, hash, endereço .m3u8 e o iframe do player. Na sessão de 16/11, vieram também as capas.
Um cuidado antes de publicar o embed: vídeo curto pode ficar COMPLETED sem HLS e não tocar.
Dê o play uma vez antes de publicar. Se acontecer, fale com o suporte.
Quanto custa
O MCP está incluso em todos os planos de hospedagem de vídeos.
O plano anual começa em R$ 49,90 por mês (250 GB, preço da página em 16/11/2026), com banda ilimitada e preço fixo.
Teste grátis de 30 dias para empresas com CNPJ, liberado pelo WhatsApp.
MCP ou REST API: qual usar
Use o MCP quando uma pessoa conversa com um assistente e quer operar a hospedagem sem abrir o painel.
Use a API REST para vídeos quando um sistema seu chama a hospedagem sozinho.
Perguntas frequentes
Como conectar o Claude à hospedagem de vídeos?
Rode claude mcp add --transport http com o endereço https://mcp.jmvstream.com/mcp e o header Bearer. O token vem do Hub.
Onde pego o token do plano?
No Hub, menu "API e MCP", card "Token do plano". Sem token: Configurações do plano, bloco API, Gerar token. O novo invalida o anterior.
Posso colocar o token no .mcp.json do repositório?
Não coloque o valor. Use Bearer ${JMV_MCP_TOKEN} e defina a variável em cada máquina. Se já foi commitado, gere outro token.
O assistente consegue apagar meus vídeos?
Consegue: delete_video é definitivo. Peça que ele liste o que vai apagar e espere o seu OK, ou bloqueie a ferramenta em permissions.deny.
O assistente envia o arquivo de vídeo pelo MCP?
Não. O MCP devolve uma URL de envio e o assistente roda curl -T no seu computador. O arquivo segue direto para a hospedagem.
Por que recebo 401 ou 404?
401: falta o header, o token está errado ou o plano está inativo. 404: o endereço está sem /mcp no final.
Fontes
- Claude Code, MCP e permissões, consultadas em 16/11/2026.
- Cursor, Model Context Protocol, consultada em 16/11/2026.

