AI Glot websiteOpen AI Glot
Gestione di AI GlotStrumenti MCP standard
Gestione di AI Glot

Strumenti MCP standard

Scopri i 18 strumenti MCP di AI Glot organizzati per attività, gli scope richiesti, gli effetti collaterali e la risorsa delle lingue supportate.

Il server standard mette a disposizione strumenti organizzati per attività, anziché replicare uno per uno tutti gli endpoint REST.

Strumenti per account e utilizzo

StrumentoScopeFunzione
get_accountaccount:readLegge l’area di lavoro, il piano, i crediti, i limiti e le funzionalità disponibili
get_credit_balanceaccount:readLegge il saldo e tutti i crediti assegnati
get_usageusage:readLegge l’andamento di crediti, parole e traduzioni completate nel tempo

Strumento per inviare feedback

StrumentoScopeFunzione
send_feedbackNessuno oltre all’autenticazioneRegistra un feedback in testo libero su un risultato imprevisto, un comportamento poco chiaro o una funzionalità che vorresti funzionasse diversamente

Usa send_feedback quando il problema è chiaro. Descrivi la situazione, cosa è successo e cosa sarebbe dovuto succedere. Se li conosci, aggiungi l’azione correlata, il modello AI e l’harness dell’agente. Non includere chiavi API, token, URL firmati o il contenuto integrale dei file. Non costa crediti e non modifica una traduzione.

Gli strumenti per account e utilizzo sono di sola lettura e non consumano crediti.

Strumenti per le traduzioni

StrumentoScopeFunzione
list_batchesbatches:readElenca le traduzioni esistenti con paginazione tramite cursore
get_batchbatches:readLegge una traduzione, l’avanzamento e il relativo piano di revisione corrente
show_translationbatches:readMostra la revisione interattiva negli host MCP Apps compatibili
get_batch_result_linkbatches:readRestituisce un link di download valido 30 minuti per un risultato completato
update_batchbatches:writeRinomina, archivia o ripristina una traduzione

Per impostazione predefinita, lo strumento per il link al risultato restituisce un URL di download temporaneo. Per i formati di testo inferiori a 2 MB, passa format: 'content' per ricevere il testo tradotto nella risposta dello strumento. update_batch modifica solo i metadati di gestione e l’archiviazione è reversibile.

Strumenti di traduzione

StrumentoScopeFunzione
create_upload_urlbatches:createRestituisce un URL temporaneo e le intestazioni per un file locale. Richiede un client HTTP esterno. Non costa nulla.
create_translationbatches:createCrea una traduzione a partire da un file. Non costa nulla.
plan_translationbatches:createPianifica o perfeziona cosa tradurre, in linguaggio semplice. Non costa nulla.
approve_translationbatches:createConsuma crediti e avvia la traduzione
cancel_translationbatches:writeInterrompe una traduzione in corso; il lavoro già svolto viene addebitato

Questi strumenti distinguono un agente che può leggere la tua area di lavoro da uno che può anche svolgere il lavoro. La sequenza è fissa (crea, pianifica, approva) e solo il terzo passaggio ha un costo.

Revisione interattiva con MCP Apps

La revisione di una traduzione AI Glot aperta in una chat: il file, il piano e i contenuti che resteranno invariati, mostrati da un host MCP Apps

La scheda di revisione che un host MCP Apps apre nella conversazione

Dopo aver creato o selezionato un batch, chiama show_translation con il relativo batch_id. Gli host compatibili possono mostrare il file, il piano, i contenuti inclusi ed esclusi, i prezzi calcolati per Standard/Lite, il saldo dell’area di lavoro, l’avanzamento e il risultato. Gli altri client ricevono normali dati strutturati del batch e possono continuare a usare gli strumenti esistenti.

La vista legge e approva tramite la stessa connessione MCP autenticata. Visualizzare e aggiornare non costa crediti. Per approvare servono batches:create, un piano verificato aggiornato, un livello di qualità incluso nel piano e crediti sufficienti. Le linee guida personalizzate non vuote richiedono entitlements.custom_guidelines; il limite massimo è 2.000 caratteri. Prima di avviare la traduzione dalla vista, l’utente deve accettare tutte le esclusioni elencate.

create_translation (con un’istruzione), plan_translation e get_batch restituiscono plan_revision quando è disponibile un piano da revisionare. Passa quel valore come expected_plan_revision a approve_translation: il campo è obbligatorio e collega l’approvazione al piano esaminato dall’utente. Se il piano è cambiato nel frattempo, plan_changed impedisce l’avvio; leggi il nuovo ambito e prezzo e mostrali di nuovo all’utente. L’approvazione REST accetta lo stesso campo e funziona anche senza, ma in quel caso il controllo viene saltato.

La vista aggiorna le attività in corso con un’attesa limitata e rende disponibile il download solo al completamento. Un campione è indicato come tale. Se il file conservato non è disponibile o è scaduto, viene mostrato un errore esplicito; aggiornarlo non può ricreare dati eliminati. Non si presume che un host offra funzionalità dell’interfaccia se non implementa MCP Apps. L’app web di AI Glot resta disponibile come alternativa.

Invio di un documento locale

Il client MCP deve poter leggere i byte originali del file ed effettuare una richiesta HTTP PUT al di fuori di MCP. Collegare un assistente ad AI Glot non gli dà automaticamente accesso agli allegati né a un client HTTP. AI Glot Code Mode non può eseguire direttamente questo trasferimento.

  1. Chiama create_upload_url passando il solo filename e l’esatto size_bytes.
  2. Invia i byte originali a upload_url usando il method e le headers restituiti. L’intestazione Authorization è un segreto temporaneo, valido solo per il caricamento. Non sostituirlo mai con una chiave API dell’area di lavoro o un token OAuth; non seguire reindirizzamenti, registrarlo nei log o mostrarlo all’utente.
  3. Dopo aver caricato correttamente il file, chiama create_translation sulla stessa connessione AI Glot, passando upload_id e, facoltativamente, instruction. È accettato esattamente uno tra upload_id, content e file_url. Se usi upload_id, ometti filename.
  4. Esamina il piano verificato e plan.not_included, quindi accertati che l’utente abbia autorizzato il piano e il costo in crediti prima di chiamare approve_translation.

Il segreto di caricamento consente un solo tentativo di PUT entro 10 minuti. Crea la traduzione entro un’ora. Se la risposta del PUT va persa, prova prima a chiamare create_translation con lo stesso upload_id. Se non esiste un caricamento completo, crea una nuova sessione. Ripetere la creazione recupera la stessa traduzione e non applica mai implicitamente un’istruzione modificata; per perfezionarla, usa plan_translation. Il recupero tramite upload_id è disponibile fino alla pulizia della sessione, almeno 24 ore dopo l’emissione. Conserva l’ID del batch per recuperare in seguito la traduzione dalla cronologia.

Se l’ambiente di esecuzione non può leggere l’allegato locale o inviare richieste HTTP PUT, spiega subito il limite. Per esempio: “Questo assistente può connettersi ad AI Glot, ma non può inviare questo allegato locale. Carica il documento nell’app web di AI Glot, usa la CLI di AI Glot oppure fornisci un link di download HTTPS da cui AI Glot possa scaricarlo.” Non dichiarare che il documento è stato caricato, non chiedere all’utente la chiave API e non approvare una traduzione senza aver verificato il file e il piano.

Un documento già ospitato a un URL di download HTTPS accessibile può essere inviato anche come file_url. I file di testo di piccole dimensioni possono essere inviati integralmente come content. Consulta caricamenti temporanei per la richiesta HTTP e le regole di recupero.

Strumenti per i glossari

StrumentoScopeFunzione
list_glossariesglossaries:readElenca le coppie di lingue, il numero di termini e i limiti del piano
get_glossaryglossaries:readLegge tutti i termini di un glossario
edit_glossary_termsglossaries:writeCrea un glossario se non esiste, quindi aggiunge, modifica, rimuove o sostituisce tutti i termini
delete_glossaryglossaries:writeElimina definitivamente un glossario e tutti i relativi termini

Per impostazione predefinita, edit_glossary_terms aggiunge i termini senza rimuovere quelli esistenti. replace_all: true elimina tutti i termini assenti dalla mappa fornita. Entrambi gli strumenti di modifica del glossario sono contrassegnati come distruttivi perché possono rimuovere termini; i client compatibili possono quindi richiedere una conferma.

Risorsa delle lingue

Le lingue supportate sono esposte come risorsa MCP memorizzabile nella cache:

aiglot://languages

È esposta come risorsa perché contiene dati di riferimento statici. Consultala prima di creare un glossario per una coppia di lingue.

Risultati e errori degli strumenti

Ogni strumento dichiara uno schema di input e restituisce contenuti strutturati insieme a una rappresentazione testuale leggibile. Il server standard non dichiara schemi di output separati. Gli errori vengono restituiti come risultati leggibili dello strumento, con un code stabile e un URL alla documentazione. In questo modo il modello può correggere la richiesta, invece di scambiare un errore applicativo per un problema di connessione MCP.

Verifica l'utilizzo recente delle mie traduzioni

Copia questo testo in un assistente compatibile con MCP dopo averlo connesso ad AI Glot.

Esamina il mio account AI Glot, il saldo crediti e l’utilizzo degli ultimi 30 giorni. Poi elenca le traduzioni recenti non riuscite o ancora in corso, segnala eventuali anomalie e non modificare né archiviare alcun dato.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.