Passa al contenuto principale

Server MCP

I server MCP (Model Context Protocol) estendono le capacita' degli agenti con strumenti esterni: database, API, file system, servizi SaaS, ecc. Un agente con MCP collegato puo' invocare gli strumenti esposti durante la conversazione, sotto controllo dell'utente.

Cosa e' MCP​

MCP e' un protocollo standard che permette di esporre tool consultabili dall'AI tramite una descrizione formale (schema input/output). Askme AI supporta tre modi di trasporto:

  • Stdio — il server e' un processo locale lanciato dal backend; comunicazione su stdin/stdout
  • SSE — Server-Sent Events su HTTP
  • HTTP / Streamable HTTP — supporta JSON-RPC 2.0 streaming per server remoti

Lista server​

La pagina mostra tutti i server con badge di stato di salute. Per ogni server:

  • Card cliccabile con scroll dei tool disponibili
  • Campo di ricerca per filtrare i tool per nome o descrizione
  • Click sulla card → dialog di dettaglio per-tool con schema input/output completo

Health check​

  • Badge colorato per ciascun server: verde = sano, rosso = errore, grigio = mai testato
  • Aggiorna stato (pulsante globale) — probe parallelo di tutti i server, persiste il risultato in DB
  • Probe singolo — pulsante per server specifico per ricontrollare solo quello

L'health check riusa la stessa logica di connessione del Test connessione: per i server remoti la chiamata e' protetta da validazione anti-SSRF; per gli stdio si verifica che il comando sia eseguibile.

Creare un nuovo server MCP​

  1. Clicca Nuovo server MCP
  2. Configura:
    • Nome server
    • Tipo di trasporto (Stdio / SSE / HTTP / Streamable HTTP)
    • Per Stdio: Comando e Argomenti
    • Per SSE / HTTP: URL del server
    • Variabili d'ambiente (es. API key, segreti) — passate al processo o come header all'endpoint remoto
  3. Test connessione per verificare e popolare la lista tool disponibili
  4. Salva
Server stdio

La configurazione di server stdio richiede l'esecuzione di processi sul backend e in ambienti SaaS gestiti potrebbe non essere disponibile dall'interfaccia tenant. Se non vedi l'opzione contatta il team IT di Askme.

Assegnazione agli agenti​

Gli MCP server vengono assegnati agli agenti dal Step 5 del form agente, in modalita' bulk multi-select.

L'elenco dei tool effettivamente disponibili a un agente e' l'unione dei tool dei server selezionati e di quelli ereditati dai parent (se l'agente ha un agente padre, vedi Catena di parent prompt).

Approvazione runtime​

In chat, quando l'agente decide di invocare un tool, all'utente viene presentata una richiesta di approvazione esplicita:

"L'agente vuole utilizzare i seguenti strumenti:"

L'utente puo' approvare ed eseguire o rifiutare la chiamata. Vedi Chat — Approvazione strumenti MCP.

Best practice​

  • Naming chiaro — usa nomi descrittivi per i server (es. crm-zoho, sql-warehouse-readonly)
  • Privilegio minimo — limita gli scope/credenziali del server al minimo indispensabile
  • Health check periodico — esegui un refresh dello stato prima di spedire un agente in produzione
  • Documenta i tool sensibili — usa la descrizione del tool per chiarire effetti collaterali (es. write su DB, invio email)