Vai al contenuto principale
Puoi connettere strumenti e fonti di dati esterni a Saga così l’IA può utilizzarli mentre chatti. Una volta connesso uno strumento, l’IA può richiamarlo durante una conversazione — ad esempio per cercare qualcosa in un sistema connesso — senza che tu lasci Saga. Un amministratore configura lo strumento per l’intera organizzazione. Alcuni strumenti richiedono anche che ogni persona connetta il proprio account o token prima che Saga possa usare lo strumento nelle sue chat.

​
A cosa serve

Connettere uno strumento dà all’IA di Saga una nuova capacità che utilizza per tuo conto durante le chat. Il fornitore dello strumento ti fornisce un indirizzo web (e talvolta una credenziale), e Saga si occupa del resto. Esempi includono database di ricerca, sistemi interni dello studio o qualsiasi servizio che supporti il Model Context Protocol.

​
Configurare uno strumento (amministratori)

Apri il Pannello di amministrazione e vai alla sezione MCP Servers.
  1. Aggiungi lo strumento. Clicca su Add Server, assegna un nome e incolla l’indirizzo web dello strumento (il suo URL endpoint). Il fornitore dello strumento ti fornisce questo indirizzo.
  2. Imposta come Saga accede. Scegli l’autenticazione richiesta dallo strumento:
    • None — lo strumento non richiede credenziali.
    • API Key o Bearer Token — incolla la chiave o il token condiviso forniti dal fornitore. Viene archiviato in modo sicuro e non viene più mostrato.
    • Basic Auth — una combinazione condivisa di nome utente e password, inserita nella forma codificata specificata dal fornitore.
    • OAuth 2.1 — inserisci i dettagli del client OAuth forniti dal fornitore, se richiesti. Il server viene configurato per l’organizzazione, ma l’accesso è personale. Ogni persona deve cliccare su Connect per quello strumento e connettere il proprio account.
    • Per-User API Token — ogni persona inserisce il proprio token personale anziché un’unica credenziale condivisa dello studio (vedi sotto).
  3. Testa e attivalo. Usa Test Connection per confermare che Saga può raggiungere lo strumento — un test riuscito elenca le capacità trovate. Attiva Available in Chat così le persone della tua organizzazione possono utilizzarlo.
Le credenziali che inserisci qui vengono archiviate in modo sicuro e non vengono più mostrate. Se devi modificarne una, inserisci un nuovo valore.

​
Connettere il tuo account o token

Alcuni strumenti sono configurati in modo che ogni persona connetta il proprio account o token anziché usare un’unica credenziale condivisa dello studio. Questo vale per gli strumenti che usano OAuth 2.1 e per quelli che usano Per-User API Token.
  1. Vai su Impostazioni > MCPs.
  2. Trova lo strumento nell’elenco.
  3. Clicca su Connect per accedere con OAuth, oppure incolla il tuo token personale se lo strumento lo richiede.
  4. Salva quando Saga ti chiede di salvare un token. Lo strumento è ora disponibile per te nella chat.
Finché non connetti il tuo account o token, quello strumento non sarà disponibile nelle tue conversazioni, anche se il tuo amministratore lo ha configurato. Se la chat ti chiede di riconnettere uno strumento, torna in Impostazioni > MCPs e connettilo di nuovo.

​
Usare gli strumenti MCP in una chat

Apri Aggiungi fonti nel campo di composizione. In MCPs, scegli i server collegati che Saga può usare per questo messaggio. Puoi includerne fino al limite indicato nell’elenco. Usa Manage MCP Connections per aprire le tue connessioni. I server che la tua organizzazione ha configurato, ma che non hai ancora collegato, sono elencati in Non collegato, ciascuno con un pulsante Collega. Per un server che usa l’accesso OAuth, Collega avvia l’accesso. Per gli altri server, apre Impostazioni > MCPs, dove aggiungi il tuo token. Se Saga ha bisogno di un server che non hai collegato, la scheda che ti chiede di collegarlo mostra Connetti e Salta. Scegli Salta per continuare senza quel server. Se un server richiede il tuo accesso, la chat mostra Connect to seguito dal nome del server, con un pulsante Connect. Se l’autorizzazione Usa gli MCP è impostata su Chiedi, la chat mostra Allow Saga to use seguito dal nome del server. Scegli Consenti, Consenti sempre oppure Salta. Mentre Saga lavora, la risposta mostra quale server o strumento sta usando. Se un server non risponde, la risposta indica che Saga non lo ha usato. Se Usa gli MCP è impostato su Disattivato in Autorizzazioni, sotto il campo del messaggio, l’elenco MCPs lo indica.
Vuoi invece che Saga sia lo strumento a cui si connettono altri assistenti? Questa è l’altra direzione — consulta Connettere il tuo assistente a Saga.