Passa al contenuto principale
DocumentationAPI ReferenceVideo Tutorials

Server MCP

MCP — il Model Context Protocol — è uno standard aperto che consente agli assistenti IA di scoprire e chiamare strumenti esterni. Se gestisci un server compatibile MCP (il tuo o uno dei tanti server della community), puoi collegarlo a Hanc.AI e i tuoi agenti otterranno gli strumenti del server nel momento in cui inizia una chiamata.

Una volta connesso, l'agente può chiamare quegli strumenti durante la conversazione — recuperando dati live, eseguendo calcoli, avviando flussi di lavoro backend — esattamente come le integrazioni Calendar, HubSpot o API Tool integrate.

Disponibile su tutti i piani

I server MCP sono disponibili su tutti i piani incluso Free. Non c'è una commissione per server — paghi solo i minuti di chiamata che il tuo agente usa quando invoca gli strumenti.

Quando usare MCP​

ScenarioPerché MCP è adatto
Gestisci già un server di strumenti internoUna connessione, tutti i tuoi strumenti disponibili per ogni agente
Vuoi condividere strumenti tra agentiConnetti una volta, collega a quanti agenti vuoi
Usi server MCP della communityCollega popolari server MCP open-source senza scrivere codice personalizzato
La tua superficie di strumenti cambia frequentementeL'agente riscopre gli strumenti ad ogni chiamata — aggiungi/rimuovi strumenti lato server senza toccare la dashboard

Se hai un singolo endpoint una tantum, l'API Tool è più semplice. Se hai un insieme di strumenti correlati, o mantieni già un server MCP, questa è l'integrazione giusta.

Connessione di un server MCP​

1. Apri la pagina Integrazioni​

Nella barra laterale della dashboard, vai su Integrazione. Scorri fino alla sezione Server MCP.

2. Clicca su "Connetti server MCP"​

Si apre una finestra modale. Compila:

CampoDescrizione
EtichettaUn nome breve per questa connessione (es. "Sales Tools", "Internal CRM"). L'etichetta è mostrata nel selettore di strumenti dell'agente e prefissa i nomi degli strumenti presentati all'IA, quindi mantienilo breve e significativo.
URLL'URL HTTPS del tuo server MCP. Deve essere un indirizzo raggiungibile pubblicamente — http:// e indirizzi privati/interni vengono rifiutati.
AutenticazioneNessuna se il tuo server è aperto, o Token Bearer se si aspetta un header Authorization: Bearer ….
Token(Solo Bearer) Il tuo token di autenticazione. Memorizzato crittografato — solo il tuo account piattaforma può decifrarlo per l'uso.

Clicca su Salva. Hanc.AI verifica il formato URL e memorizza la connessione. La connessione è ora disponibile per ogni agente nel tuo workspace.

Le etichette contano

I nomi degli strumenti da ciascun server MCP sono prefissati con l'etichetta della connessione, quindi un server MCP con uno strumento lookup_order connesso come "Shop API" apparirà all'agente come Shop_API_lookup_order. Questo previene collisioni quando connetti più server MCP che hanno strumenti con nomi simili.

3. Modifica, disabilita o elimina​

L'elenco dei server MCP mostra etichetta, URL, tipo di auth e stato di ogni connessione aggiunta. Usa le azioni di riga per:

  • Modifica — cambia etichetta, URL, tipo di auth o token
  • Elimina — rimuovi la connessione interamente

La rimozione di una connessione la disattiva per ogni agente che l'aveva collegata — quegli agenti perdono semplicemente l'accesso ai suoi strumenti alla prossima chiamata.

Collegare strumenti MCP a un agente​

Una connessione nel tuo workspace è disponibile per i tuoi agenti — ma ogni agente decide individualmente quali delle tue connessioni esporre. Questo significa che puoi avere agenti separati Sales e Support che attingono da diversi server MCP.

1. Apri la scheda Azioni dell'agente​

Scegli l'agente. Apri la scheda Azioni. Clicca su Aggiungi azione.

2. Scegli "Server MCP" dal gruppo Live-call​

Il menu a discesa mostra tre gruppi: Pre fetch, Live call, Post call. Cerca nel gruppo Live-call — è dove appartengono i server MCP, perché l'agente invoca gli strumenti MCP durante la conversazione, non prima o dopo.

3. Attiva le connessioni da abilitare​

La finestra modale elenca ogni connessione MCP nel tuo workspace, ognuna con un toggle on/off. Attiva quelle che questo agente dovrebbe usare. Puoi anche scrivere una breve istruzione nel campo "Quando usarlo" — questo è ciò che l'agente legge per decidere quando utilizzare questi strumenti durante una conversazione.

Clicca su Salva. L'agente ora ha accesso agli strumenti da ogni connessione MCP abilitata.

Mix and match

Puoi avere una connessione MCP abilitata su cinque agenti e un'altra abilitata su uno solo — ogni agente ha il suo strumento Server MCP con il suo insieme di toggle.

Come funziona al momento della chiamata​

Quando inizia una chiamata, l'agente si connette a ciascuno dei suoi server MCP abilitati e chiede "quali strumenti offri?" Tutto ciò che il server restituisce viene esposto all'IA come strumento che può chiamare durante la conversazione.

Alcune cose da sapere:

  • Gli strumenti vengono scoperti all'inizio della chiamata. Se aggiungi o rimuovi strumenti sul tuo server MCP, la modifica appare alla prima chiamata successiva — non serve aggiornare nulla in Hanc.AI.
  • I nomi degli strumenti sono prefissati con l'etichetta della connessione (quindi "Shop API" + strumento search_products → Shop_API_search_products). Gli strumenti integrati dell'agente e altri strumenti MCP non entreranno in conflitto.
  • Descrizioni degli strumenti e schemi dei parametri provengono dal tuo server MCP. Scrivi buone descrizioni lì — è quello che l'IA usa per decidere quando e come chiamare lo strumento.
  • Gli errori vengono riportati all'agente. Se una chiamata a uno strumento fallisce, l'agente vede il messaggio di errore e può decidere di riprovare, scusarsi o provare uno strumento diverso.

Requisiti per il tuo server MCP​

Per funzionare con Hanc.AI, il tuo server deve:

RequisitoDettaglio
HTTPSIl semplice http:// non è accettato. Usa un vero certificato TLS.
URL pubblicoL'URL deve risolversi in un indirizzo pubblico — Hanc.AI non può raggiungere server su una rete privata o localhost.
Trasporto MCP Streamable HTTPL'attuale trasporto HTTP MCP su un singolo endpoint. I trasporti solo SSE e stdio non sono supportati in questa integrazione.
Auth Bearer (opzionale)Se il tuo server richiede autenticazione, deve accettare un header standard Authorization: Bearer <token>.

Se stai ospitando il tuo server dietro un firewall, esponilo tramite un tunnel o reverse proxy con un endpoint HTTPS pubblico.

Sicurezza e privacy​

I tuoi token bearer sono memorizzati crittografati a riposo. Solo l'infrastruttura di chiamata di Hanc.AI può decifrarli, e solo nel momento in cui inizia una chiamata e l'agente ha bisogno di connettersi al tuo server.

Le chiamate agli strumenti scorrono agente → Hanc.AI → tuo server MCP → indietro. Non registriamo i payload delle chiamate agli strumenti. Il tuo server registra qualsiasi cosa tu scelga di registrare dalla tua parte.

Se cambi o ruoti il tuo token, modifica la connessione nella dashboard — il nuovo valore ha effetto alla prossima chiamata.

Disponibilità per piano​

PianoServer MCP
FreeDisponibile
Starter / Pro / Business / EnterpriseDisponibile

Non c'è alcun costo per connessione — paghi solo i minuti di chiamata durante i quali l'agente invoca gli strumenti.

Risoluzione dei problemi​

"La connessione non si salva"​

  • Assicurati che l'URL inizi con https:// e non http://.
  • Assicurati che l'host sia raggiungibile pubblicamente — localhost, 127.0.0.1 e indirizzi interni sono bloccati per progettazione.
  • Ricontrolla il token bearer se ne hai impostato uno — spazi bianchi extra o virgolette interromperanno il salvataggio.

"L'agente non vede gli strumenti"​

  • Verifica che la voce del server MCP nella scheda Azioni dell'agente abbia almeno una connessione attivata on e che la voce sia salvata.
  • Assicurati che il tuo server MCP risponda a una richiesta tools/list e non richieda un flusso di auth interattivo.
  • Guarda nel registro chiamate dell'agente per messaggi dalla connessione MCP proprio all'inizio della chiamata.

"Lo strumento fallisce a metà chiamata"​

  • L'agente vedrà qualsiasi errore restituito dal tuo server. Controlla i log del tuo server.
  • Strumenti a lunga esecuzione potrebbero scadere — mantieni l'esecuzione dello strumento MCP sotto pochi secondi per chiamata in modo che il visitatore non rimanga in silenzio.

"Ho cambiato strumenti sul mio server ma l'agente usa ancora quelli vecchi"​

  • Gli strumenti vengono riscoperti all'inizio di ogni chiamata, non memorizzati in cache tra le chiamate. La prima nuova chiamata vede l'insieme di strumenti aggiornato. Le chiamate in corso mantengono gli strumenti che gli sono stati dati all'inizio.

Correlati​