Collega il tuo assistente IA (MCP)

L'MCP (Model Context Protocol) è lo standard utilizzato dagli assistenti IA per richiamare strumenti esterni. Transept mette a disposizione un unico endpoint, https://app.transept.ai/api/public/v1/mcp, e un assistente collegato ottiene le stesse funzionalità che uno script ricava dalle API, sotto forma di strumenti che può richiamare autonomamente: creare un documento, calcolare il costo di un'esecuzione, avviarla, verificarne lo stato e leggere le traduzioni.

La differenza pratica rispetto al copia-incolla in una chatbot è che l'assistente lavora sui tuoi documenti reali, applicando i tuoi glossari, le tue guide di stile e le tue memorie di traduzione. I risultati vengono salvati in Transept, dove puoi revisionarli ed esportarli come qualsiasi altro lavoro.

La connessione avviene tramite lo standard OAuth: aggiungi l'URL al tuo client e, al primo tentativo di collegamento, si aprirà una finestra del browser per richiedere l'autorizzazione all'accesso. Una volta approvata, il client sarà collegato; non c'è alcuna chiave da incollare. Trovi gli snippet pronti all'uso per ogni client nella pagina Integrazioni dell'app.

Non per i client interattivi: per quelli si usa l'OAuth. Le chiavi servono per le macchine che non possono aprire un browser. In ogni caso, la connessione compare sotto Impostazioni → Sviluppatore come voce revocabile, quindi basta un clic per disconnettersi, indipendentemente da come sia stata creata.

Gli strumenti coprono l'intero processo dall'inizio alla fine: in un'unica conversazione è possibile gestire un documento dall'importazione fino alle traduzioni revisionate:

• Importare contenuti: documenti tramite copia-incolla o un catalogo di stringhe con chiavi, contesti e segnaposto.
• Calcolare gratuitamente il costo di un'esecuzione, avviare un workflow in tutte le lingue di destinazione contemporaneamente e monitorare l'avanzamento per ogni lingua.
• Creare e ampliare glossari, consultare le guide di stile e interrogare la memoria di traduzione prima di tradurre.
• Leggere i risultati: a blocchi per la prosa oppure tramite ID stringa per i cataloghi.
• Registrare webhook affinché i tuoi sistemi ricevano un evento firmato al termine di un'esecuzione.
• Cosa resta escluso, per scelta progettuale: il caricamento di file e le esportazioni binarie (DOCX, XLIFF, TMX) avvengono tramite l'API REST, e la gestione delle chiavi rimane un'operazione manuale nell'app; un assistente non può mai generare autonomamente una chiave per se stesso.

Tre misure di sicurezza, tutte applicate lato Transept anziché affidate all'assistente:

• Permessi. Ogni chiamata a uno strumento viene verificata in base alle autorizzazioni concesse: gli scope della chiave o del consenso OAuth. Una chiamata al di fuori di essi viene rifiutata specificando il permesso mancante.
• Stima e conferma. Qualsiasi operazione che comporti un consumo di parole restituisce prima la stima delle parole e si interrompe. L'esecuzione si avvia solo quando l'assistente conferma esplicitamente; in questo modo vedrai il costo nella conversazione prima che l'operazione venga effettuata. I Review gate nei tuoi workflow mettono comunque in pausa l'esecuzione; per proseguire è necessaria un'approvazione esplicita, da parte tua o dell'assistente su tua istruzione.
• Revoca. La connessione può essere interrotta da parte tua in qualsiasi momento: la chiamata successiva di un assistente revocato viene rifiutata, anche a conversazione in corso.

Sì: associa la connessione a un trigger webhook e il cerchio si chiude. La tua piattaforma email, il CMS o uno script inviano i contenuti tramite POST all'URL del trigger (il corpo della richiesta diventa il documento), il workflow li traduce e un webhook o l'assistente recuperano le traduzioni completate: dieci lingue in uscita per un unico template in entrata, senza che nessuno debba aprire l'editor.

Questo è il meccanismo alla base della localizzazione dei template email e del lavoro continuo sui cataloghi di stringhe: la piattaforma invia le modifiche, Transept traduce solo quelle e la tua pipeline recupera i risultati. A te spetta la revisione: tutto ciò che è meccanico viene delegato.