Ferramentas MCP Standard

O servidor Standard oferece ferramentas organizadas por tarefa, em vez de reproduzir cada endpoint REST individualmente.

Ferramentas de conta e uso

Ferramenta de feedback

Use send_feedback quando o problema estiver claro. Inclua a situação, o que aconteceu e o que deveria ter acontecido. Se souber, informe também a ação relacionada, o modelo de IA e o ambiente do agente. Não inclua chaves de API, tokens, URLs assinadas nem o conteúdo integral dos arquivos. A ferramenta não consome 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

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, passe format: 'content' para receber o texto traduzido na resposta da ferramenta. update_batch altera apenas os metadados administrativos e, no caso de arquivamento, a ação pode ser revertida.

Ferramentas de tradução de conteúdo

Essas ferramentas diferenciam um agente que apenas consulta seu workspace de um que consegue executar tarefas. A sequência é fixa (criar, planejar, aprovar), e só a terceira etapa tem custo.

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 arquivos anexados nem a um cliente HTTP. O AI Glot Code Mode não consegue fazer essa transferência.

1. Chame create_upload_url com o filename sem caminho e o valor exato de size_bytes.
2. Envie os bytes originais para upload_url usando o method e os headers retornados. O cabeçalho Authorization é um segredo temporário, válido apenas para o upload. Nunca o substitua por uma chave de API do workspace ou por um token OAuth, não siga redirecionamentos, não o registre em logs nem o mostre ao usuário.
3. Após o upload ser concluído com sucesso, chame create_translation com upload_id e, se quiser, instruction, usando a mesma conexão do AI Glot. É aceito exatamente um entre upload_id, content e file_url. Se usar upload_id, omita filename.
4. Revise o plano verificado e plan.not_included. Antes de chamar approve_translation, confirme que o usuário autorizou esse plano e o custo em créditos.

O segredo de upload 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 chamar create_translation com o mesmo upload_id. Se não houver um upload completo, obtenha uma nova sessão. Repetir a criação recupera a mesma tradução e nunca aplica implicitamente uma instrução alterada. Para ajustá-la, use plan_translation. É possível recuperar usando upload_id até a limpeza da sessão, que ocorre pelo menos 24 horas após a emissão. Guarde o ID do lote para recuperar a tradução do seu histórico depois.

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 diga que o documento foi enviado, não peça a chave de API do usuário nem aprove uma tradução sem um arquivo e um plano verificados.

Um documento já hospedado em uma URL de download HTTPS acessível ainda pode ser enviado como file_url. Arquivos de texto pequenos podem ser enviados diretamente em content. Consulte uploads temporários para ver as regras de solicitação HTTP e recuperação.

Ferramentas do glossário

Por padrão, edit_glossary_terms adiciona termos. replace_all: true exclui todos os termos que não estiverem no mapa fornecido. As duas ferramentas de edição do glossário são marcadas como destrutivas porque podem remover termos, então os 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://languages

Esse recurso é disponibilizado porque contém dados de referência estáticos. 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 Standard não declara esquemas de saída separados. Os erros são retornados como resultados legíveis da ferramenta, com um code estável e uma URL de documentação. Assim, o modelo pode corrigir a solicitação, em vez de interpretar um erro de negócio como uma falha na conexão MCP.