Server MCP
I server MCP ti permettono di collegare provider di strumenti esterni al tuo team. Una volta collegato un server, i suoi strumenti, prompt e skill diventano disponibili per gli agenti del team. I server MCP si configurano per team, dalla pagina Configurations del team.
Catalogo connettori
Alcuni connettori sono disponibili come catalogo. Da Configurations puoi:
- Attivare un connettore che usa l'account di ogni persona (per esempio Gmail). Le persone accedono la prima volta che un agente ne ha bisogno.
- Aggiungere un connettore che usa un token condiviso del team. Puoi aggiungere più istanze dello stesso connettore, ciascuna con nome e token propri.
- Aggiornare il token o rimuovere in seguito un'istanza con token di team.
Un token di team è usato da tutti gli agenti del team, anche dagli ospiti del widget. Non salvare qui una chiave personale se gli ospiti non devono agire con quell'account.
Connettori con accesso al servizio
Alcuni connettori, come HubSpot, chiedono a ogni persona di accedere con quel servizio invece di incollare una chiave.
- Un admin attiva il connettore una sola volta dal catalogo. Non serve alcuna chiave.
- La prima volta che un agente ha bisogno di uno dei suoi strumenti, la chat mostra Accedi con seguito dal nome del connettore. Puoi collegarti anche da Impostazioni.
- Dopo l'accesso, l'agente agisce con i tuoi permessi in quel servizio. Se il tuo account non vede un record o non può usare una funzione, quello strumento restituisce un errore.
- Puoi scollegarti in qualsiasi momento da Impostazioni.
Gli ospiti del widget non hanno effettuato l'accesso, quindi gli strumenti di questi connettori non vengono eseguiti per loro. Se il connettore viene aggiornato sulla piattaforma, potrebbe esserti chiesto di accedere di nuovo.
Cosa puoi fare
- Aggiungere un server MCP con nome e URL
- Abilitare o disabilitare un server senza rimuoverlo
- Caricarne il catalogo di strumenti, prompt e skill
- Scegliere come autenticare il server (token di servizio e/o credenziale per-utente)
- Abilitare strumenti specifici del server su ogni agente
Autenticazione
Un server puo' richiedere l'autenticazione in due modi indipendenti, con scopi diversi: conviene impostare quello giusto.
| Impostazione | Scopo | Chi la fornisce |
|---|---|---|
| Autenticazione di servizio (token) | Carica il catalogo degli strumenti del server e viene inviata come credenziale condivisa del team quando gli agenti chiamano il server | Un admin, una volta, nelle impostazioni del server |
| Credenziale per-utente (runtime) | Ogni utente agisce con la propria identita' a runtime | Ogni utente, quando richiesto in chat |
Autenticazione di servizio
E' il token di servizio a livello di team. E' cio' che permette di recuperare l'elenco degli strumenti disponibili dai server che richiedono autenticazione, e viene inviato come credenziale condivisa del team quando gli agenti chiamano il server. Non e' una credenziale personale.
Credenziale per-utente
Quando "Richiedi a ogni utente una credenziale personale (runtime)" e' attivo, ogni utente aggiunge la propria credenziale la prima volta che un agente ne ha bisogno. Viene richiesta direttamente in chat, conservata in modo sicuro e usata solo per le proprie richieste.
Se la credenziale per-utente non e' richiesta, le richieste di tutti gli utenti usano il token di servizio condiviso, quindi ogni utente agisce con la stessa identita'. Abilita la credenziale per-utente quando il server restituisce dati specifici per ogni utente (ad esempio un workspace o una casella di posta personale).
Stato del catalogo
Ogni server mostra uno stato per il suo catalogo:
| Stato | Significato |
|---|---|
| Non recuperato | Il catalogo non e' ancora stato caricato |
| OK | Strumenti, prompt e skill caricati correttamente |
| Fallito | L'ultimo tentativo di caricare il catalogo e' fallito |
Usa l'azione di aggiornamento per ricaricare il catalogo dopo aver modificato il server o il suo token. Se un server richiede autenticazione e non e' impostato alcun token di servizio, aggiungi prima un token per poter caricare il catalogo.
Usare gli strumenti di un server su un agente
Dopo aver caricato il catalogo di un server, apri l'area Tools di un agente per abilitare gli strumenti, i prompt e le skill che vuoi far usare a quell'agente. All'agente sono disponibili solo le capacita' che abiliti.
Collega un server una sola volta a livello di team, poi abilita solo gli strumenti che ti servono su ogni agente. Agenti diversi possono usare sottoinsiemi diversi dello stesso server.