Herramientas MCP Standard
Conoce las 17 herramientas de AI Glot MCP orientadas a tareas, los permisos necesarios, sus efectos secundarios y el recurso de idiomas disponibles.
El servidor Standard ofrece herramientas orientadas a tareas, en lugar de replicar uno por uno todos los endpoints REST.
Herramientas de cuenta y uso
| Herramienta | Permiso | Función |
|---|---|---|
get_account | account:read | Consulta el espacio de trabajo, el plan, los créditos, los límites y las funciones disponibles |
get_credit_balance | account:read | Consulta el saldo y cada uno de los lotes de créditos |
get_usage | usage:read | Consulta los créditos, las palabras y las traducciones completadas a lo largo del tiempo |
Herramienta de comentarios
| Herramienta | Permiso | Función |
|---|---|---|
send_feedback | Ninguno, aparte de la autenticación | Registra comentarios de texto libre sobre un resultado inesperado, un comportamiento confuso o algo que te gustaría que funcionase de otra manera |
Usa send_feedback cuando tengas claro el problema. Incluye la situación, lo que ha ocurrido y lo que debería haber ocurrido. Si lo sabes, añade la acción relacionada, el modelo de IA y el entorno del agente. No incluyas claves de API, tokens, URL firmadas ni el contenido completo de archivos. No consume créditos ni modifica ninguna traducción.
Las herramientas de cuenta y uso son de solo lectura y no consumen créditos.
Herramientas de traducción
| Herramienta | Permiso | Función |
|---|---|---|
list_batches | batches:read | Muestra las traducciones existentes con paginación mediante cursor |
get_batch | batches:read | Consulta una traducción y su progreso |
get_batch_result_link | batches:read | Devuelve un enlace de descarga válido durante 30 minutos para un resultado completado |
update_batch | batches:write | Cambia el nombre de una traducción, la archiva o la restaura |
De forma predeterminada, la herramienta de enlace del resultado devuelve una URL de descarga temporal. Para formatos de texto de menos de 2 MB, indica format: 'content' para recibir el texto traducido en la respuesta de la herramienta. update_batch solo modifica metadatos de gestión y la acción de archivar se puede revertir.
Herramientas de traducción
| Herramienta | Permiso | Función |
|---|---|---|
create_upload_url | batches:create | Devuelve una URL temporal y los encabezados necesarios para un archivo local. Requiere un cliente HTTP externo. No cuesta nada. |
create_translation | batches:create | Crea una traducción a partir de un archivo. No cuesta nada. |
plan_translation | batches:create | Planifica o ajusta qué se va a traducir, en lenguaje sencillo. No cuesta nada. |
approve_translation | batches:create | Consume créditos e inicia la traducción |
cancel_translation | batches:write | Detiene una traducción en curso; se cobra el trabajo ya realizado |
Estas herramientas permiten que un agente pase de consultar tu espacio de trabajo a realizar tareas en él. El orden es fijo (crear, planificar y aprobar), y solo el último paso tiene coste.
Enviar un documento local
El cliente MCP debe poder leer los bytes del archivo original y realizar una solicitud HTTP PUT fuera de MCP. Conectar un asistente a AI Glot no le da acceso automáticamente a los archivos adjuntos ni a un cliente HTTP. AI Glot Code Mode no puede realizar esta transferencia por sí mismo.
- Llama a
create_upload_urlcon elfilenamesin modificar y elsize_bytesexacto. - Envía los bytes originales a
upload_urlcon elmethody losheadersque devuelve. El encabezadoAuthorizationes un secreto temporal que solo sirve para la carga. Nunca lo sustituyas por una clave de API del espacio de trabajo o un token OAuth, sigas redirecciones, lo registres ni se lo muestres al usuario. - Cuando la carga se haya completado correctamente, llama a
create_translationconupload_idy, de forma opcional,instruction, en la misma conexión de AI Glot. Solo se acepta uno de estos valores:upload_id,contentofile_url. Si usasupload_id, omitefilename. - Revisa el plan verificado y
plan.not_included. Antes de llamar aapprove_translation, comprueba que el usuario ha autorizado ese plan y el coste en créditos.
El secreto de carga permite un intento de PUT en un plazo de 10 minutos. Crea la traducción antes de que pase una hora. Si se pierde la respuesta al PUT, prueba primero a llamar a create_translation con el mismo upload_id. Si no hay ninguna carga completa, obtén una sesión nueva. Repetir la creación recupera la misma traducción y nunca aplica una instrucción modificada de forma implícita; usa plan_translation para ajustarla. La recuperación mediante upload_id está disponible hasta que se limpia la sesión, como mínimo 24 horas después de su emisión. Guarda el ID de lote para recuperar la traducción más adelante desde tu historial.
Si el entorno de ejecución no puede leer el archivo adjunto local ni enviar solicitudes HTTP PUT, explica la limitación de inmediato. Por ejemplo: “Este asistente puede conectarse a AI Glot, pero no puede enviar este archivo adjunto local. Sube el documento en la aplicación web de AI Glot, usa la CLI de AI Glot o proporciona un enlace de descarga HTTPS al que AI Glot pueda acceder.” No afirmes que se ha subido el documento, no pidas al usuario su clave de API ni apruebes una traducción sin un archivo y un plan verificados.
También puedes enviar mediante file_url un documento alojado en una URL de descarga HTTPS accesible. Los archivos de texto pequeños se pueden enviar sin modificar como content. Consulta cargas temporales para ver las solicitudes HTTP y las reglas de recuperación.
Herramientas del glosario
| Herramienta | Permiso | Función |
|---|---|---|
list_glossaries | glossaries:read | Muestra las combinaciones de idiomas, el número de términos y los límites del plan |
get_glossary | glossaries:read | Consulta todos los términos de un glosario |
edit_glossary_terms | glossaries:write | Crea el glosario si no existe y, después, añade, cambia, elimina o reemplaza todos los términos |
delete_glossary | glossaries:write | Elimina permanentemente un glosario y todos sus términos |
De forma predeterminada, edit_glossary_terms añade términos. replace_all: true elimina todos los términos que no estén en el mapa proporcionado. Ambas herramientas de edición del glosario se marcan como destructivas porque pueden eliminar términos, por lo que los clientes compatibles pueden exigir una confirmación.
Recurso de idiomas
Los idiomas disponibles se ofrecen como el siguiente recurso MCP, que se puede guardar en caché:
aiglot://languagesSe ofrece como recurso porque contiene datos de referencia estáticos. Léelo antes de crear un glosario para una combinación de idiomas.
Resultados y errores de las herramientas
Todas las herramientas declaran un esquema de entrada y devuelven contenido estructurado, además de una representación de texto legible. El servidor Standard no declara esquemas de salida independientes. Los errores se devuelven como resultados legibles de la herramienta, con un code estable y una URL de documentación. Así, el modelo puede corregir la solicitud en lugar de tratar un error de negocio como si se hubiera interrumpido la conexión MCP.
Copia este texto en un asistente compatible con MCP después de conectar AI Glot.
Revisa mi cuenta de AI Glot, el saldo de créditos y el uso de los últimos 30 días. Después, enumera las traducciones recientes que hayan fallado o sigan en curso, explica cualquier anomalía y no modifiques ni archives ningún dato.