Conecte o servidor MCP do VideoUpscaler ao Claude Code, Cursor ou VS Code e aumente vídeos para 1080p, 2K ou 4K pedindo ao seu assistente de IA.

O VideoUpscaler oferece um servidor MCP remoto para aumentar a resolução de vídeos, baseado no Model Context Protocol. Conecte-o ao seu assistente de IA e peça coisas como "aumente este vídeo para 4K": o assistente chama a mesma API descrita nesta documentação e usa os seus créditos.

URL do servidor: https://videoupscaler.co/api/mcp (Streamable HTTP)

Para contas pagas (saldo para todas)

Assim como a API, o servidor MCP está disponível para contas que compraram créditos ou fizeram uma assinatura. Os clientes se conectam fazendo login na sua conta do VideoUpscaler ou com uma chave de API. Qualquer conta pode fazer login e consultar o saldo com get_account; as demais ferramentas exigem uma conta paga.

Conecte um cliente

A maioria dos clientes se conecta com login: você adiciona a URL do servidor, uma janela do navegador se abre, você faz login no VideoUpscaler e clica em Permitir. Clientes que não conseguem fazer login usam uma chave de API: crie uma em Configurações → Chaves de API e guarde-a em uma variável de ambiente, como VIDEOUPSCALER_API_KEY. Não cole a chave em um arquivo de configuração que você vai commitar.

No claude.ai ou no app de desktop do Claude, abra Settings → Connectors, clique em Add custom connector e informe https://videoupscaler.co/api/mcp. Clique em Connect, faça login e permita o acesso.

claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp --scope user

Execute /mcp no Claude Code, selecione videoupscaler e escolha Authenticate para fazer login no navegador. --scope user deixa o servidor disponível em todos os seus projetos.

Para usar uma chave de API, adicione --header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" ao comando.

O Cursor se conecta com uma chave de API. Adicione a ~/.cursor/mcp.json (todos os projetos) ou .cursor/mcp.json (um projeto):

{
  "mcpServers": {
    "videoupscaler": {
      "url": "https://videoupscaler.co/api/mcp",
      "headers": {
        "Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
      }
    }
  }
}

Adicione a .vscode/mcp.json. O VS Code pede que você faça login na primeira vez que o servidor inicia:

{
  "servers": {
    "videoupscaler": {
      "type": "http",
      "url": "https://videoupscaler.co/api/mcp"
    }
  }
}

Qualquer cliente compatível com servidores MCP remotos via Streamable HTTP funciona. Informe a URL https://videoupscaler.co/api/mcp: clientes compatíveis com a autorização do MCP pedem o login automaticamente. Os demais enviam o cabeçalho Authorization: Bearer <sua chave de API>.

Ferramentas

Ferramenta	O que faz
`upscale_video`	Inicia o upscale de uma `video_url` pública para `1080p`, `2k` ou `4k` e cobra os créditos. Exige uma `idempotency_key`.
`get_task`	Retorna uma tarefa. Com `wait_seconds` (até 45), espera a tarefa terminar antes de responder.
`list_tasks`	Lista suas tarefas recentes, incluindo as iniciadas no site.
`get_account`	Seu saldo de créditos e o preço por segundo de cada resolução.
`create_upload`	Retorna uma URL assinada para enviar um arquivo local (até 100MB) que não tem URL pública.

As ferramentas se comportam exatamente como os endpoints correspondentes da API: veja Criar um upscale, Tarefas, Créditos e preços e Enviar um arquivo. Tarefas iniciadas via MCP custam os mesmos créditos.

Toda chamada de upscale_video precisa de uma idempotency_key. Se uma chamada expirar, o assistente deve verificar list_tasks e tentar de novo com a mesma chave, para que o vídeo nunca seja cobrado duas vezes.

Exemplos de prompts

"Quantos créditos do VideoUpscaler eu ainda tenho?"
"Aumente https://example.com/clip.mp4 para 4K e me mande o link quando terminar."
"Aumente ./intro.mp4 para 2K." (clientes que conseguem executar comandos enviam o arquivo com create_upload primeiro)

Solução de problemas

Problema	Solução
O cliente mostra `401` ou pede para você fazer login	Faça login novamente pelo cliente. Com uma chave de API, verifique o cabeçalho `Authorization` e se a chave ainda existe em Configurações.
A página de login diz que o link de autorização é inválido	O link expira em 10 minutos. Inicie a conexão novamente pelo cliente.
As ferramentas retornam `paid_plan_required`	A conta nunca comprou créditos. Compre qualquer pacote de créditos.
As ferramentas retornam `insufficient_credits`	Recarregue seu saldo na página de preços.
`upscale_video` expira	Vídeos remotos grandes demoram para ser baixados. Peça ao assistente para verificar `list_tasks`; normalmente a tarefa já existe.

Servidor MCP para aumentar vídeos

Conecte um cliente

Ferramentas

Exemplos de prompts

Solução de problemas

On this page