Servidor MCP para aumentar vídeos
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)
Somente contas pagas
Assim como a API, o servidor MCP está disponível para contas que compraram créditos ou fizeram uma assinatura. Você precisa de uma chave de API.
Conecte um cliente
Crie uma chave de API 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.
claude mcp add --transport http videoupscaler https://videoupscaler.co/api/mcp \
--header "Authorization: Bearer $VIDEOUPSCALER_API_KEY" \
--scope user--scope user deixa o servidor disponível em todos os seus projetos e mantém a chave fora do .mcp.json do projeto. Execute /mcp no Claude Code para verificar a conexão.
Adicione ao ~/.cursor/mcp.json (todos os projetos) ou ao .cursor/mcp.json (um projeto):
{
"mcpServers": {
"videoupscaler": {
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${env:VIDEOUPSCALER_API_KEY}"
}
}
}
}Adicione ao .vscode/mcp.json. O VS Code pede a chave na primeira vez e a armazena com segurança:
{
"inputs": [
{
"type": "promptString",
"id": "videoupscaler-key",
"description": "VideoUpscaler API key",
"password": true
}
],
"servers": {
"videoupscaler": {
"type": "http",
"url": "https://videoupscaler.co/api/mcp",
"headers": {
"Authorization": "Bearer ${input:videoupscaler-key}"
}
}
}
}Qualquer cliente que suporte servidores MCP remotos via Streamable HTTP funciona. Configure:
- URL:
https://videoupscaler.co/api/mcp - Cabeçalho:
Authorization: Bearer <sua chave de API>
O login com OAuth (para o Claude desktop e os conectores do claude.ai) chega em breve.
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.mp4para 2K." (clientes que conseguem executar comandos enviam o arquivo comcreate_uploadprimeiro)
Solução de problemas
| Problema | Solução |
|---|---|
O cliente mostra 401 ou pede para você fazer login | A chave de API está ausente ou incorreta. Verifique o cabeçalho Authorization e se a chave ainda existe em Configurações. |
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. |