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.
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
| Ferramenta | O que faz |
|---|---|
get_account | O plano e os créditos agora. |
list_languages | Os pares de idiomas abertos agora. |
list_projects | Seus projetos, do mais novo ao mais antigo. |
get_project | Um projeto, com o estado do arquivo e as dublagens. |
create_project | Cria um projeto com uma dublagem para cada idioma de destino. |
start_upload | Abre o envio do arquivo e dá os endereços das primeiras partes. |
get_upload_part_urls | Endereços para mais partes, ou novos para as partes que falharam. |
complete_upload | Termina o envio; o arquivo é então conferido. |
start_dub | Inicia uma dublagem. Gasta créditos. |
get_job | O estado e o andamento de um job. |
get_dub | Uma dublagem, com o último job que rodou nela. |
get_segments | Os segmentos da dublagem: tempos, textos e avisos. Pode mostrar só os que têm avisos ou edições. |
edit_segment | Salva um texto novo para um segmento. |
quote_regeneration | Quanto custa regenerar alguns segmentos. |
regenerate_segments | Regenera segmentos com os textos salvos. Gasta créditos. |
finish_dub | Conclui a edição e libera os downloads. |
get_download_links | Links para os arquivos da dublagem, válidos por 5 minutos. |
get_subtitles | As legendas como texto, em SRT ou WebVTT. |
delete_project | Apaga 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.