Menu da documentação

Servidor MCP

O servidor MCP deixa um assistente de IA trabalhar na sua conta Evocal: enviar um vídeo, iniciar a dublagem, conferir e corrigir segmentos e baixar os arquivos. Ele usa a sua chave de API, com os mesmos créditos e regras do app.

Atualizado em 20 de nov. de 2026

Antes de começar

  • O servidor MCP faz parte dos planos Pro, Studio e Enterprise, como a API.
  • Crie uma chave no app, em Conta, API. Dê ao assistente uma chave só dele, para poder revogá-la sem parar mais nada.
  • O seu assistente precisa permitir adicionar um servidor MCP remoto com um cabeçalho. Agentes que trabalham num terminal e editores de código permitem; apps de chat que só se conectam fazendo login ainda não podem usá-lo.

Como conectar

O endereço do servidor é https://www.evocal.app/api/mcp (Streamable HTTP). Ele recebe a chave no cabeçalho Authorization. Por exemplo, no Claude Code:

claude mcp add --transport http evocal https://www.evocal.app/api/mcp \
  --header "Authorization: Bearer evk_..."

Editores que guardam os servidores num arquivo JSON aceitam uma entrada como esta. Veja no guia do seu editor o nome do arquivo e o formato exato.

{
  "mcpServers": {
    "evocal": {
      "url": "https://www.evocal.app/api/mcp",
      "headers": { "Authorization": "Bearer evk_..." }
    }
  }
}

Depois peça, por exemplo: “Duble lesson-4.mp4 do português para o inglês e me diga quanto custa antes de começar.”

O que o assistente pode fazer

FerramentaO que faz
get_accountO plano e os créditos agora.
list_languagesOs pares de idiomas abertos agora.
list_projectsSeus projetos, do mais novo ao mais antigo.
get_projectUm projeto, com o estado do arquivo e as dublagens.
create_projectCria um projeto com uma dublagem para cada idioma de destino.
start_uploadAbre o envio do arquivo e dá os endereços das primeiras partes.
get_upload_part_urlsEndereços para mais partes, ou novos para as partes que falharam.
complete_uploadTermina o envio; o arquivo é então conferido.
start_dubInicia uma dublagem. Gasta créditos.
get_jobO estado e o andamento de um job.
get_dubUma dublagem, com o último job que rodou nela.
get_segmentsOs segmentos da dublagem: tempos, textos e avisos. Pode mostrar só os que têm avisos ou edições.
edit_segmentSalva um texto novo para um segmento.
quote_regenerationQuanto custa regenerar alguns segmentos.
regenerate_segmentsRegenera segmentos com os textos salvos. Gasta créditos.
finish_dubConclui a edição e libera os downloads.
get_download_linksLinks para os arquivos da dublagem, válidos por 5 minutos.
get_subtitlesAs legendas como texto, em SRT ou WebVTT.
delete_projectApaga um projeto com os arquivos e as dublagens.

Como enviar o arquivo

O assistente lê o arquivo no seu computador e o envia em partes, então precisa rodar onde o arquivo está, com um terminal ou acesso aos seus arquivos. Ele corta o arquivo em partes de part_size bytes e envia cada uma com um PUT para o endereço dela.

Um assistente que não alcança os seus arquivos ainda pode trabalhar nos projetos que você envia pelo app: ler os segmentos, corrigi-los, regenerar e baixar.

Créditos e segurança

  • O assistente gasta os seus créditos: uma dublagem custa um crédito por segundo de vídeo (no mínimo 30), uma regeneração os segundos dos seus segmentos (no mínimo 15). O servidor manda ele dizer o custo e esperar o seu sim antes de qualquer uma delas, mas você responde por toda chamada feita com a sua chave.
  • Concluir uma dublagem e apagar um projeto não têm volta. O assistente é orientado a perguntar a você antes.
  • Todo arquivo segue as mesmas regras do app: envie só vozes que são suas ou de pessoas que deram permissão por escrito. A confirmação de voz da chave vale para cada arquivo.
  • As chamadas dele contam nos limites da API: 120 por minuto e 3.600 por hora para a conta inteira.
  • O assistente vê o que a API mostra: seus projetos, dublagens, segmentos e créditos. Se a chave vazar, revogue-a em Conta, API.

Leia a seguir