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
| Strumento | Scope | Funzione |
|---|---|---|
get_account | account:read | Legge l’area di lavoro, il piano, i crediti, i limiti e le funzionalità disponibili |
get_credit_balance | account:read | Legge il saldo e tutti i crediti assegnati |
get_usage | usage:read | Legge l’andamento di crediti, parole e traduzioni completate nel tempo |
Strumento per inviare feedback
| Strumento | Scope | Funzione |
|---|---|---|
send_feedback | Nessuno oltre all’autenticazione | Registra 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
| Strumento | Scope | Funzione |
|---|---|---|
list_batches | batches:read | Elenca le traduzioni esistenti con paginazione tramite cursore |
get_batch | batches:read | Legge una traduzione, l’avanzamento e il relativo piano di revisione corrente |
show_translation | batches:read | Mostra la revisione interattiva negli host MCP Apps compatibili |
get_batch_result_link | batches:read | Restituisce un link di download valido 30 minuti per un risultato completato |
update_batch | batches:write | Rinomina, 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
| Strumento | Scope | Funzione |
|---|---|---|
create_upload_url | batches:create | Restituisce un URL temporaneo e le intestazioni per un file locale. Richiede un client HTTP esterno. Non costa nulla. |
create_translation | batches:create | Crea una traduzione a partire da un file. Non costa nulla. |
plan_translation | batches:create | Pianifica o perfeziona cosa tradurre, in linguaggio semplice. Non costa nulla. |
approve_translation | batches:create | Consuma crediti e avvia la traduzione |
cancel_translation | batches:write | Interrompe 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

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.
- Chiama
create_upload_urlpassando il solofilenamee l’esattosize_bytes. - Invia i byte originali a
upload_urlusando ilmethode leheadersrestituiti. L’intestazioneAuthorizationè 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. - Dopo aver caricato correttamente il file, chiama
create_translationsulla stessa connessione AI Glot, passandoupload_ide, facoltativamente,instruction. È accettato esattamente uno traupload_id,contentefile_url. Se usiupload_id, omettifilename. - Esamina il piano verificato e
plan.not_included, quindi accertati che l’utente abbia autorizzato il piano e il costo in crediti prima di chiamareapprove_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
| Strumento | Scope | Funzione |
|---|---|---|
list_glossaries | glossaries:read | Elenca le coppie di lingue, il numero di termini e i limiti del piano |
get_glossary | glossaries:read | Legge tutti i termini di un glossario |
edit_glossary_terms | glossaries:write | Crea un glossario se non esiste, quindi aggiunge, modifica, rimuove o sostituisce tutti i termini |
delete_glossary | glossaries:write | Elimina 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.
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.