Vai al contenuto
Kaiross

Server MCP esterni: dare agli agenti nuovi strumenti

Oltre ai connettori del catalogo, un agente può usare gli strumenti di qualsiasi server MCP raggiungibile in https, o nella tua rete attraverso un tunnel.

Ultimo aggiornamento:

Cos’è MCP

Il Model Context Protocol (MCP) è uno standard aperto con cui un servizio espone «strumenti» a un assistente AI: ogni strumento ha un nome, una descrizione e i parametri. Molti fornitori di software pubblicano un proprio server MCP: l’indirizzo e il modo di autenticarsi sono nella loro documentazione.

Aggiungere un server

  1. Apri Agenti, scegli l’agente, scheda MCP e database → Aggiungi → Server MCP esterno.
  2. Compila Nome e URL (l’indirizzo del server, es. https://…/mcp).
  3. In Trasporto lascia Streamable HTTP: se il server risponde solo con il vecchio protocollo, Kaiross ripiega da solo su SSE. Scegli SSE (legacy) solo se il fornitore lo indica.
  4. In Autenticazione scegli Nessuna, Bearer token oppure Intestazione personalizzata (con Nome dell’intestazione, es. X-API-Key) e incolla il Token: viene cifrato nel Vault.
  5. In Raggiungibile tramite scegli Internet (solo https pubblico) oppure un tunnel VPN.
  6. Premi Collega e scopri strumenti: Kaiross si collega e legge l’elenco degli strumenti.
Scheda MCP e database di un agente
Scheda MCP e database di un agente
La scheda MCP e database: strumenti dell’agente e ciò che può generare dai dati.

Rete e sicurezza

  • Senza tunnel sono ammessi solo indirizzi https pubblici: reti private, loopback e indirizzi dei metadata cloud sono bloccati, anche se ci si arriva tramite DNS.
  • Per un server MCP nella rete aziendale crea un tunnel in Impostazioni → Rete / VPN (vedi tunnel WireGuard) e sceglilo in Raggiungibile tramite.
  • Kaiross non segue redirect e parla solo con l’origine del server indicato.
  • L’autenticazione avviene con un token nell’header (Bearer o intestazione personalizzata). I server che accettano solo l’accesso OAuth non si possono collegare come server esterni.

Strumenti e aggiornamento

L’elenco degli strumenti resta in memoria: la chat non lo richiede a ogni domanda. Se il fornitore aggiunge strumenti, premi Test sulla riga del server: Kaiross ricarica l’elenco e mostra quanti strumenti sono disponibili. In Strumenti abilitati scegli quali può usare l’agente.

Conferma delle chiamate

Kaiross non può sapere quali strumenti di un server esterno modificano dati. Con Chiedi conferma in chat prima di ogni chiamata ogni uso mostra la scheda con Conferma ed esegui e Annulla. Lasciala attiva per i server che possono scrivere, inviare o cancellare.