Ferramentas MCP padrão
Conheça as 18 ferramentas MCP do AI Glot organizadas por tarefa, os escopos necessários, os efeitos colaterais e o recurso de idiomas compatíveis.
O servidor padrão oferece ferramentas organizadas por tarefa, em vez de reproduzir cada endpoint REST individualmente.
Ferramentas de conta e uso
| Ferramenta | Escopo | O que faz |
|---|---|---|
get_account | account:read | Consulta o espaço de trabalho, o plano, os créditos, os limites e os recursos disponíveis |
get_credit_balance | account:read | Consulta o saldo e cada concessão de créditos |
get_usage | usage:read | Consulta os créditos, as palavras e as traduções concluídas ao longo do tempo |
Ferramenta de feedback
| Ferramenta | Escopo | O que faz |
|---|---|---|
send_feedback | Nenhum além da autenticação | Registra comentários em texto livre sobre um resultado inesperado, um comportamento confuso ou algo que você gostaria que funcionasse de outra forma |
Use send_feedback quando o problema estiver claro. Descreva a situação, o que aconteceu e o que deveria ter acontecido. Se souber, informe a ação relacionada, o modelo de IA e o harness do agente. Não inclua chaves de API, tokens, URLs assinadas nem o conteúdo integral de arquivos. O uso não custa créditos nem altera uma tradução.
As ferramentas de conta e uso são somente para leitura e não consomem créditos.
Ferramentas de tradução
| Ferramenta | Escopo | O que faz |
|---|---|---|
list_batches | batches:read | Lista traduções existentes com paginação por cursor |
get_batch | batches:read | Consulta uma tradução, seu andamento e o plano de revisão atual |
show_translation | batches:read | Exibe a revisão interativa em hosts compatíveis com MCP Apps |
get_batch_result_link | batches:read | Retorna um link de download válido por 30 minutos para um resultado concluído |
update_batch | batches:write | Renomeia, arquiva ou restaura uma tradução |
Por padrão, a ferramenta de link do resultado retorna uma URL temporária de download. Para formatos de texto com menos de 2 MB, informe format: 'content' para receber o texto traduzido na resposta da ferramenta. update_batch altera apenas os metadados administrativos e, ao arquivar, a ação pode ser revertida.
Ferramentas que traduzem
| Ferramenta | Escopo | O que faz |
|---|---|---|
create_upload_url | batches:create | Retorna uma URL temporária e os cabeçalhos para um arquivo local. Requer um cliente HTTP externo. Não custa nada. |
create_translation | batches:create | Cria uma tradução a partir de um arquivo. Não custa nada. |
plan_translation | batches:create | Planeja ou ajusta o que será traduzido, em linguagem simples. Não custa nada. |
approve_translation | batches:create | Consome créditos e inicia a tradução |
cancel_translation | batches:write | Interrompe uma tradução em andamento; o trabalho já realizado é cobrado |
Essas ferramentas fazem a diferença entre um agente que consulta seu espaço de trabalho e outro que consegue executar tarefas. A sequência é fixa (criar, planejar, aprovar), e somente a terceira etapa tem custo.
Revisão interativa com MCP Apps

Depois de criar ou selecionar um lote, chame show_translation com o
batch_id. Hosts compatíveis podem exibir o arquivo, o plano, o conteúdo incluído e excluído, os preços calculados de Standard/Lite, o saldo do espaço de trabalho, o andamento e o resultado.
Os outros clientes recebem dados estruturados comuns do lote e podem continuar usando as ferramentas existentes.
A visualização consulta e aprova pela mesma conexão MCP autenticada.
Visualizar e atualizar não custa créditos. Para aprovar, é necessário ter batches:create, um plano atual verificado, um nível de qualidade autorizado e créditos suficientes.
Diretrizes personalizadas não vazias exigem entitlements.custom_guidelines; o limite máximo é de 2.000 caracteres. Antes de iniciar pela visualização, o usuário precisa aceitar todas as exclusões listadas.
create_translation (com uma instrução), plan_translation e get_batch
retornam plan_revision quando há um plano disponível para revisão. Passe esse valor em
expected_plan_revision para approve_translation: o campo é obrigatório e
vincula a aprovação ao plano que o usuário revisou. Se o plano tiver mudado desde então,
plan_changed impede o início; consulte o novo escopo e preço e mostre-os novamente ao
usuário. A aprovação REST aceita o mesmo campo e continua funcionando sem
ele, mas, nesse caso, essa verificação é ignorada.
A visualização atualiza o trabalho ativo enquanto aguarda por um período limitado e só oferece o download quando a tarefa é concluída. Uma amostra é identificada como amostra. Se o arquivo mantido tiver sido removido ou expirado, isso será indicado como erro explícito; atualizar não recria bytes excluídos. Não se presume que o host tenha recursos de interface se ele não implementar MCP Apps. O app web do AI Glot continua disponível como alternativa.
Enviar um documento local
O cliente MCP precisa conseguir ler os bytes do arquivo original e fazer uma solicitação HTTP PUT fora do MCP. Conectar um assistente ao AI Glot não dá acesso automático aos anexos nem a um cliente HTTP. O AI Glot Code Mode não consegue realizar essa transferência.
- Chame
create_upload_urlcom ofilenamesem modificações e osize_bytesexato. - Envie os bytes originais para
upload_url, usando omethode osheadersretornados. O cabeçalhoAuthorizationé um segredo temporário exclusivo para o envio. Nunca o substitua por uma chave de API do espaço de trabalho ou um token OAuth, siga redirecionamentos, registre-o em logs ou mostre-o ao usuário. - Após o envio ser concluído com sucesso, chame
create_translationna mesma conexão do AI Glot, passandoupload_ide, opcionalmente,instruction. Só é aceito um dos valores entreupload_id,contentefile_url. Se usarupload_id, omitafilename. - Revise o plano verificado e
plan.not_includede, antes de chamarapprove_translation, confirme que o usuário autorizou esse plano e o custo em créditos.
O segredo de envio permite uma única tentativa de PUT em até 10 minutos. Crie a tradução em até uma hora. Se a resposta do PUT for perdida, tente primeiro create_translation com o mesmo upload_id. Se não houver um envio completo, obtenha uma nova sessão. Repetir a criação recupera a mesma tradução e nunca aplica implicitamente uma instrução alterada; use plan_translation para ajustá-la. A recuperação por upload_id fica disponível até a limpeza da sessão, no mínimo 24 horas após a emissão. Guarde o ID do lote para recuperar a tradução do histórico mais tarde.
Se o ambiente de execução não conseguir ler o anexo local ou enviar solicitações HTTP PUT, explique a limitação imediatamente. Por exemplo: “Este assistente pode se conectar ao AI Glot, mas não consegue enviar este anexo local. Envie o documento pelo app web do AI Glot, use a CLI do AI Glot ou forneça um link de download HTTPS que o AI Glot possa acessar.” Não afirme que o documento foi enviado, não peça a chave de API do usuário e não aprove uma tradução sem um arquivo e um plano verificados.
Um documento que já esteja hospedado em uma URL de download HTTPS acessível ainda pode ser enviado como file_url. Arquivos de texto pequenos podem ser enviados integralmente como content. Consulte envios temporários para ver as regras de solicitação HTTP e recuperação.
Ferramentas de glossário
| Ferramenta | Escopo | O que faz |
|---|---|---|
list_glossaries | glossaries:read | Lista pares de idiomas, contagem de termos e limites do plano |
get_glossary | glossaries:read | Consulta todos os termos de um glossário |
edit_glossary_terms | glossaries:write | Cria o glossário se ele não existir e, em seguida, adiciona, altera, remove ou substitui todos os termos |
delete_glossary | glossaries:write | Exclui permanentemente um glossário e todos os seus termos |
Por padrão, edit_glossary_terms adiciona termos. replace_all: true exclui todos os termos que não constarem no mapa fornecido. As duas ferramentas de edição do glossário são marcadas como destrutivas porque podem remover termos; por isso, clientes compatíveis podem exigir confirmação.
Recurso de idiomas
Os idiomas compatíveis são disponibilizados como o recurso MCP armazenável em cache:
aiglot://languagesEsse recurso é disponibilizado porque contém dados estáticos de referência. Consulte-o antes de criar um glossário para um par de idiomas.
Resultados e erros das ferramentas
Cada ferramenta declara um esquema de entrada e retorna conteúdo estruturado, além de uma representação em texto legível. O servidor padrão não declara esquemas de saída separados. Erros são retornados como resultados legíveis da ferramenta, com um code estável e uma URL de documentação, permitindo que o modelo corrija a solicitação em vez de interpretar um erro de negócio como uma falha de conexão MCP.
Copie isto para um assistente compatível com MCP após conectar o AI Glot.
Revise minha conta do AI Glot, meu saldo de créditos e o uso nos últimos 30 dias. Em seguida, liste as traduções recentes que falharam ou ainda estão em andamento, explique qualquer atividade incomum e não modifique nem arquive nenhum dado.