Strumenti MCP Standard
Scopri i 15 strumenti MCP di AI Glot orientati ai task, i relativi scope richiesti, gli effetti collaterali e la risorsa per le lingue supportate.
Il server standard espone strumenti orientati ai task invece di replicare ogni singolo endpoint REST.
Strumenti per account e utilizzo
| Strumento | Scope | Cosa fa |
|---|---|---|
get_account | account:read | Legge workspace, piano, crediti, limiti e funzionalità |
get_credit_balance | account:read | Legge il saldo e ogni assegnazione di crediti |
get_usage | usage:read | Legge crediti, parole e traduzioni completate nel tempo |
Questi strumenti sono in sola lettura e non consumano crediti.
Strumenti di traduzione
| Strumento | Scope | Cosa fa |
|---|---|---|
list_batches | batches:read | Elenca le traduzioni esistenti con paginazione tramite cursore |
get_batch | batches:read | Legge una singola traduzione e il suo stato di avanzamento |
get_batch_result_link | batches:read | Restituisce un link di scaricamento valido 30 minuti per un risultato completato |
update_batch | batches:write | Rinomina, archivia o ripristina una traduzione |
Lo strumento per il link dei risultati restituisce un URL, mai il contenuto raw del file. update_batch modifica solo i metadati di gestione ed è reversibile in caso di archiviazione.
Strumenti che traducono
| Strumento | Scope | Cosa fa |
|---|---|---|
create_translation | batches:create | Crea una traduzione da un file. Gratuito. |
plan_translation | batches:create | Pianifica o affina cosa tradurre, in linguaggio naturale. Gratuito. |
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 quattro strumenti rappresentano la differenza tra un agente che legge il tuo workspace e uno che può eseguire il lavoro. La sequenza è fissa (creazione, pianificazione, approvazione) e solo il terzo passaggio ha un costo.
Strumenti del glossario
| Strumento | Scope | Cosa fa |
|---|---|---|
list_glossaries | glossaries:read | Elenca coppie linguistiche, conteggio termini e limiti del piano |
get_glossary | glossaries:read | Legge ogni termine in un glossario |
edit_glossary_terms | glossaries:write | Crea il glossario se mancante, quindi aggiunge, modifica, rimuove o sostituisce completamente i termini |
delete_glossary | glossaries:write | Elimina permanentemente un glossario e tutti i suoi termini |
edit_glossary_terms è cumulativo per impostazione predefinita. replace_all: true elimina ogni termine assente dalla mappa fornita. delete_glossary è esplicitamente contrassegnato come distruttivo affinché i client compatibili possano richiedere una conferma.
Risorsa linguistica
Le lingue supportate sono esposte come risorsa MCP memorizzabile nella cache:
aiglot://languagesÈ una risorsa e non un sedicesimo strumento perché si tratta di dati di riferimento statici. Leggetela prima di creare un glossario per una coppia linguistica.
Risultati degli strumenti ed errori
Ogni strumento ha uno schema di input e output e restituisce contenuti strutturati. Gli errori vengono restituiti come risultati dello strumento leggibili con un code stabile e l’URL della documentazione, permettendo al modello di correggere la richiesta invece di trattare un errore di business come una connessione MCP interrotta.
Copia questo testo in un assistente abilitato MCP dopo aver connesso AI Glot.
Analizza il mio account AI Glot, il saldo dei crediti e l’utilizzo degli ultimi 30 giorni. Quindi elenca le traduzioni recenti fallite o ancora in corso, spiega eventuali anomalie e non modificare né archiviare alcun dato.