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.
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.