Pular para o conteúdo
Tutoriais completos

Como conectar o Claude Code e o Cursor à sua hospedagem de vídeos (MCP, passo a passo)

Publicado em 18 de novembro de 2026

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.

  1. Copie o token em Hub → "API e MCP" → "Token do plano".
  2. Guarde o token numa variável de ambiente, fora do Git.
  3. Rode claude mcp add (ou edite o mcp.json do Cursor).
  4. Confira com claude mcp get jmvstream.
Neste tutorial (13 seções)
  1. Resposta rápida
  2. Conectar o Claude à hospedagem de vídeos: os 4 passos
  3. Onde a configuração fica: os três escopos do Claude Code
  4. Token fora do Git: o .mcp.json com variável
  5. Conferir a conexão
  6. Uma sessão real: pedido, ferramenta e resultado
  7. Erros que apareceram e como corrigir
  8. Pedir permissão e confirmação antes de apagar
  9. Dois fluxos de operação
  10. Quanto custa
  11. MCP ou REST API: qual usar
  12. Perguntas frequentes
  13. Fontes
Diagrama de como conectar o Claude à hospedagem de vídeos via MCP

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"
Diagrama dos passos 1 e 2: o token do plano sai do Hub, em API e MCP, e fica numa variável de ambiente chamada JMV_MCP_TOKEN, fora do GitDe cima para baixo. Passo 1, no Hub: abra API e MCP e copie o Token do plano; sem token no plano, vá em Configurações do plano, bloco API, Gerar token. Passo 2: guarde o token numa variável de ambiente com nome próprio, JMV_MCP_TOKEN, fora do Git. Aviso: gerar um token novo invalida o anterior.Passos 1 e 2: do Hub à variável1No Hubabra "API e MCP" e copieo "Token do plano"Sem token: Configurações do plano→ bloco API → Gerar token2Variável de ambienteJMV_MCP_TOKENnome próprio, que não colidecom outra variávelO token fica fora do GitAtençãoGerar um token novo invalidao anterior.
Passos 1 e 2: o token sai do Hub e fica numa variável de ambiente, fora do Git.

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.

Bloco de terminal com o comando claude mcp add que registra o servidor MCP da JMVStream, com o token só como a variável JMV_MCP_TOKENTerminal estilizado, não é captura de tela. Comando: claude mcp add --transport http jmvstream https://mcp.jmvstream.com/mcp --header "Authorization: Bearer $JMV_MCP_TOKEN". Três notas: o transporte é Streamable HTTP, por isso --transport http; o endereço termina em /mcp, sem isso a resposta é 404; o token vem da variável JMV_MCP_TOKEN, criada no passo 2, e fica fora do Git.Passo 3: registre o servidorterminal$ claude mcp add \--transport http \jmvstream \https://mcp.jmvstream.com/mcp \--header \"Authorization: Bearer $JMV_MCP_TOKEN"--transport httpStreamable HTTP: por issoo transporte é http./mcpO endereço termina em /mcp.Sem isso, a resposta é 404.$JMV_MCP_TOKENVariável criada no passo 2.O token fica fora do Git.
Passo 3: o comando claude mcp add, com o token só como variável.

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.

Diagrama do passo 4: no Cursor o arquivo é .cursor/mcp.json, o endereço é o mesmo mcp.jmvstream.com/mcp e o header lê o token da variável JMV_MCP_TOKENNo Cursor, o arquivo muda e o servidor é o mesmo. Arquivo: .cursor/mcp.json no projeto, ou ~/.cursor/mcp.json para valer em todos. Campo url: https://mcp.jmvstream.com/mcp. Campo headers, Authorization: Bearer ${env:JMV_MCP_TOKEN}. O Cursor lê a variável pela sintaxe ${env:NOME}, e o token não fica escrito no arquivo.Passo 4: no Cursor, outro arquivoArquivo, no projeto.cursor/mcp.jsonOu, para valer em todos~/.cursor/mcp.jsonCampo "url"https://mcp.jmvstream.com/mcpCampo "headers" › "Authorization"Bearer ${env:JMV_MCP_TOKEN}O Cursor lê a variável pelasintaxe ${env:NOME}. O token nãofica escrito no arquivo.
Passo 4: no Cursor, o arquivo é .cursor/mcp.json e o token vem da variável.

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:

EscopoOnde gravaQuem vêQuando usar
local (padrão)~/.claude.json, só para o projeto atualsó você, só alitestar com o seu token
project.mcp.json na raiztodo o time, via Gitservidor compartilhado, com ${VAR} no lugar do token
user~/.claude.json, todos os projetossó você, em tudoum 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êsFerramentaResultado
"Quanto de disco estou usando?"get_disk_usage5,05 GB
"Liste minhas galerias e vídeos."list_galleries, list_videos5 galerias; 32 vídeos em 4 páginas
"Crie uma galeria de teste."create_gallerygaleria criada
"Suba este MP4 de 3 segundos."create_upload, complete_uploadupload concluído
"Está pronto?"get_video1ª chamada "não encontrado"; ~75 s depois, ready: true
"Renomeie e mova para outra galeria."update_videonome 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_galleryremovidos; 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.

Diagrama do envio de vídeo pelo MCP: create_upload, URL pré-assinada, curl -T no seu computador, complete_upload e get_video; o arquivo não passa pelo modeloDiagrama em cinco passos, de cima para baixo, não é captura de tela. 1: create_upload, ferramenta do MCP, pede o endereço de envio. 2: URL pré-assinada, devolvida pelo MCP. 3: curl -T, executado no seu computador, envia o arquivo direto para a hospedagem. 4: complete_upload, ferramenta do MCP, avisa que o envio terminou. 5: get_video confere se o vídeo está pronto; logo após o envio pode responder não encontrado, e cerca de 1 minuto depois vem ready true. O arquivo não passa pelo modelo.Como o vídeo sobe pelo MCPFerramenta do MCPNo seu computador1create_uploadpede ao MCP oendereço de envio2URL pré-assinadao endereço de envio,devolvido pelo MCP3curl -Troda no seu computador: o arquivovai direto para a hospedagem4complete_uploadavisa que o envio terminou5get_videoconfere se está pronto (ready: true).Logo após o envio, pode dizer"não encontrado": espere cercade 1 minuto.O arquivo não passapelo modeloDiagrama do fluxo, não é capturade tela do Claude Code nem do Cursor.
O envio de vídeo pelo MCP: o arquivo vai direto para a hospedagem, sem passar pelo modelo.

Erros que apareceram e como corrigir

O que aconteceuCausaCorreção
401 ao conectarsem header, token errado ou plano inativoconferir o token no Hub e o plano ativo
404endereço sem /mcp no finalusar https://mcp.jmvstream.com/mcp
get_video responde "não encontrado" logo após o uploado vídeo ainda não foi processadoesperar cerca de 1 minuto e consultar de novo
a ferramenta recusa a chamadaparâmetro com outro nome: get_video pede hash, delete_gallery pede uuiddeixar o assistente reler o schema e repetir
envio recusadoarmazenamento do plano cheioliberar 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.

Amostra de planilha CSV com as colunas galeria, nome, hash, endereço m3u8 e iframe, com duas linhas de exemplo e valores fictíciosAmostra com valores fictícios. Colunas: galeria, nome, hash, endereço .m3u8 e iframe. Linha 1: galeria Aulas, nome Aula 01 - Abertura, hash <hash>, endereço <endereço-do-vídeo>.m3u8, iframe <iframe src="<URL-DO-PLAYER>">. Linha 2: galeria Eventos, nome Evento 01 - Palestra, com os mesmos formatos. Uma linha por vídeo.Fluxo 2: a planilha de embed e HLSgalerianomehash.m3u8iframeUma linha por vídeo. Duas de exemplo:Linha 1galeriaAulasnomeAula 01 - Aberturahash<hash>.m3u8<endereço-do-vídeo>.m3u8iframe<iframe src="<URL-DO-PLAYER>">Linha 2galeriaEventosnomeEvento 01 - Palestrahash<hash>.m3u8<endereço-do-vídeo>.m3u8iframe<iframe src="<URL-DO-PLAYER>">Valores fictícios. O assistente montao CSV na sua máquina, a partir do list_videosde cada galeria.
Amostra da planilha do Fluxo 2, com valores fictícios.

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