Server MCP: strumenti esterni per gli agenti
I server MCP (Model Context Protocol) collegano agli agenti strumenti esterni — azioni, ricerche, integrazioni con altri sistemi — senza dover scrivere il relativo codice dentro Askme AI.
Che cos'è il protocollo MCP
MCP è un protocollo standard che permette a un server esterno di esporre un catalogo di strumenti (tool), ciascuno descritto da uno schema formale di input e output. Un agente collegato a uno o più server MCP può invocare questi strumenti durante la conversazione, sotto il controllo dell'utente se è richiesta approvazione (vedere La console Chat).
Quando un agente ha accesso a un numero elevato di strumenti (oltre 200), la piattaforma seleziona automaticamente solo quelli più pertinenti alla richiesta corrente, per non sovraccaricare il modello, mantenendo comunque disponibili alcuni strumenti di base ("meta-tool").
Prerequisiti
- Permesso di gestione integrazioni sul tenant (
integrations.*). - Feature flag "Server MCP" attivo per il tenant.
- Per collegare un server già disponibile, le relative credenziali o variabili d'ambiente fornite dal sistema esterno da integrare.
Collegare un server (trasporti e variabili d'ambiente)
L'elenco dei server MCP configurati è raggiungibile da Servizi → Server MCP, con lo stato di salute di ciascun server.
Per creare un nuovo server:
- Cliccare Nuovo server MCP.
- Assegnare un nome descrittivo (es.
crm-zoho,sql-warehouse-readonly). - Scegliere il tipo di trasporto:
- Stdio — il server è un processo locale lanciato dal backend, con comando e argomenti da specificare; comunicazione su stdin/stdout;
- SSE — Server-Sent Events su HTTP, con URL del server remoto;
- HTTP / Streamable HTTP — JSON-RPC 2.0 in streaming su HTTP, con URL del server remoto.
- Impostare le variabili d'ambiente necessarie (API key, segreti): sono mascherate nell'interfaccia e passate al processo locale oppure come header alle chiamate remote.
- Salvare.
La configurazione di un server con trasporto Stdio richiede l'esecuzione di un processo direttamente sul backend: in ambienti SaaS gestiti potrebbe non essere disponibile dall'interfaccia del tenant. Se l'opzione non compare, contattare il team IT di Askme.
Gli strumenti rilevati (discovery e refresh)
Dopo il salvataggio, la piattaforma interroga il server per rilevare automaticamente gli strumenti che espone. L'elenco risultante viene mantenuto in una cache, per evitare di interrogare il server MCP a ogni singola conversazione: un pulsante Aggiorna strumenti ripulisce e ripopola la cache quando il catalogo del server è cambiato.
Il dettaglio di un singolo strumento mostra lo JSON Schema di input e output, consultabile e copiabile.
Verificare lo stato (health check e test)
- Badge di stato su ciascun server: sano, in errore, o mai testato.
- Aggiorna stato — verifica in parallelo la raggiungibilità di tutti i server configurati.
- Test connessione — verifica manuale su un singolo server, utile subito dopo la creazione.
Per i server remoti, ogni chiamata è protetta da una validazione anti-SSRF che impedisce richieste verso indirizzi interni non autorizzati.
Assegnare i server a un agente
I server MCP si assegnano a un agente nella relativa sezione di configurazione, con selezione multipla (vedere Gli agenti conversazionali).
Gli strumenti effettivamente disponibili a un agente sono l'unione di quelli dei server selezionati direttamente e di quelli ereditati dagli agenti padre nella catena di ereditarietà (vedere Gli agenti conversazionali — Agenti padre e figli).
Approvazione delle chiamate in chat
Quando un agente invoca uno strumento la cui esecuzione richiede approvazione, la conversazione mostra una richiesta esplicita che l'utente può approvare o rifiutare prima che lo strumento venga eseguito. Il dettaglio del comportamento in conversazione è descritto in La console Chat.
Problemi comuni
| Problema | Causa probabile | Soluzione |
|---|---|---|
| Il server risulta sempre "in errore" | URL o comando non raggiungibile, credenziali errate | Verificare URL/comando e variabili d'ambiente, ripetere il Test connessione |
| Uno strumento atteso non viene mai proposto dall'agente | Cache degli strumenti non aggiornata dopo una modifica lato server esterno | Cliccare Aggiorna strumenti sul server interessato |
| L'agente non ha accesso a uno strumento di un server collegato al padre | La catena di ereditarietà non è configurata correttamente | Verificare l'agente padre in Creare un agente |
| Un server remoto viene rifiutato in fase di test | L'URL punta a un indirizzo interno bloccato dalla protezione anti-SSRF | Utilizzare un endpoint pubblico raggiungibile, non un indirizzo di rete interno |