Referência do conector MCP do VideoCallTranslator

O que o conector faz?

Ele permite que um assistente de IA prepare chamadas de vídeo traduzidas na conta de um anfitrião no VideoCallTranslator: criar uma sala de chamada e devolver os dois links dela, listar as salas do anfitrião, informar os minutos que restam e listar os idiomas das chamadas.

A chamada em si acontece no videocalltranslator.com, no navegador: o anfitrião abre o link de anfitrião e a outra pessoa abre o link de convidado. O conector não pode iniciar, entrar nem escutar uma chamada, não envia convites e não faz cobranças. Os minutos são comprados na página de preços.

Para ver como uma pessoa o conecta, leia como organizar uma chamada de vídeo traduzida pelo Claude.

Como um assistente se conecta?

• Servidor: https://videocalltranslator.com/mcp, Streamable HTTP, sem estado. Atende à revisão 2026-07-28 do MCP e às revisões de 2025.
• Diretório: listado no diretório de conectores do Claude como conector Community.
• Autorização: OAuth 2.1, código de autorização com PKCE (S256). Os documentos de descoberta ficam em /.well-known/oauth-protected-resource/mcp e /.well-known/oauth-authorization-server.
• Cadastro do cliente: um Client ID Metadata Document ou o cadastro dinâmico de clientes em /oauth/register. A pessoa que conecta não precisa digitar nenhum segredo de cliente.
• Login: a pessoa entra no videocalltranslator.com, com o Google ou com e-mail e senha, e depois responde à nossa página de autorização, que mostra o nome do assistente e, quando o assistente comprova, o domínio dele.
• Tokens: os tokens de acesso duram uma hora e são renovados com um token de atualização. Uma conexão sem uso por 30 dias expira.

Quais permissões a pessoa pode conceder?

As três são oferecidas, a menos que o assistente peça menos. Na página de autorização, a criação de salas é uma caixa marcada: ao desmarcá-la, o assistente se conecta somente leitura, com rooms.read e balance.read, e a página da conta marca essa conexão como Read-only. Um assistente também pode pedir acesso somente leitura por conta própria, com scope=rooms.read balance.read.

Quais são as ferramentas?

Nenhuma ferramenta faz uma escrita sensível. Nenhuma paga, compra, envia mensagem ou apaga nada. create_call_room adiciona uma sala, o que é grátis; os minutos de tradução só são usados enquanto duas pessoas estão conectadas em uma chamada.

Sem host_language, a sala usa o idioma definido na conta do anfitrião. Sem guest_language, o convidado escolhe o seu na tela antes de entrar. Todo resultado tem uma forma em texto e uma estruturada. Nenhum resultado contém endereço de e-mail, nome de convidado, registro de chamada, áudio, transcrição ou dados de pagamento.

Cada ferramenta tem um título e as anotações MCP readOnlyHint, destructiveHint (false nas quatro) e openWorldHint (false).

Quais erros uma ferramenta pode devolver?

• Sem token, ou com um expirado: HTTP 401, com o endereço do documento de descoberta em WWW-Authenticate.
• Uma ferramenta que a pessoa não permitiu: HTTP 403 insufficient_scope, com a permissão necessária, para que o assistente possa pedi-la.
• Entrada inválida: um erro de ferramenta que descreve o campo, para um código de idioma desconhecido, um nome de sala com mais de 60 caracteres ou um argumento desconhecido.
• Salas demais em uma hora: um erro de ferramenta dizendo que o limite foi atingido e que as salas existentes continuam funcionando (VCT-6020).
• Chamadas de ferramenta demais: um erro de ferramenta informando quantos segundos esperar.

Quais são os limites?

• 60 chamadas de ferramenta por minuto por conta, somando todos os assistentes conectados.
• O limite de salas por hora do site também vale para create_call_room.
• Nomes de sala com no máximo 60 caracteres pelo conector.
• Somente idiomas entre os 41 idiomas de chamada.
• list_my_rooms devolve no máximo 50 salas.

Como uma conexão termina, e o que fica guardado?

O anfitrião clica em Disconnect na seção Connected assistants das configurações da conta, o que encerra na hora o acesso do assistente (essa seção está em inglês). Uma conexão sem uso por 30 dias expira, e excluir a conta encerra todas as conexões.

De cada conexão guardamos qual assistente é e quando foi conectado, quando foi usado pela última vez (por hora) e um registro de cada sala que ele criou. Os tokens são guardados só em forma de hash. O que o próprio assistente recebe é guardado pela empresa dele, conforme a política dela. Os detalhes estão na nossa política de privacidade (em inglês).