Vai alla navigazione
ConfigurazioneStrumenti

Model Context Protocol

Collega i tuoi agenti conversazionali ElevenLabs a strumenti e fonti di dati esterni usando il Model Context Protocol.
Responsabilità dell'utente

Sei responsabile della sicurezza, della conformità normativa e del comportamento di qualsiasi server MCP di terze parti che integri con i tuoi agenti conversazionali ElevenLabs. ElevenLabs fornisce la piattaforma per l’integrazione, ma non gestisce, approva né protegge i server MCP esterni.

Panoramica

Questa guida spiega come consentire ai tuoi agenti ElevenLabs di accedere a server MCP esterni. Se invece vuoi gestire i tuoi agenti ElevenLabs da Claude o da un altro client MCP, usa il server MCP fornito.

Il Model Context Protocol (MCP) è uno standard aperto che definisce il modo in cui le applicazioni forniscono contesto ai modelli linguistici di grandi dimensioni (LLM). Considera MCP come un connettore universale che consente ai modelli IA di interagire senza problemi con diverse fonti di dati e strumenti. Integrando server che implementano MCP, puoi estendere notevolmente le capacità dei tuoi agenti conversazionali ElevenLabs.

Il supporto MCP non è attualmente disponibile per gli utenti in modalità Zero Retention o per chi richiede la conformità HIPAA.

ElevenLabs ti consente di collegare i tuoi agenti conversazionali a server MCP esterni. Ciò consente ai tuoi agenti di:

  • Accedere ed elaborare informazioni da varie fonti di dati tramite il server MCP
  • Utilizzare strumenti e funzionalità specializzate esposti dal server MCP
  • Creare esperienze conversazionali più dinamiche, informate e interattive

Abilita MCP per il tuo workspace

MCP è disabilitato per impostazione predefinita in ogni workspace. Prima che chiunque possa aggiungere o usare server MCP, un membro del workspace deve aderire per conto del workspace.

L’adesione avviene automaticamente la prima volta che qualcuno prova ad aggiungere un server MCP dalla dashboard delle integrazioni dei server MCP. Una finestra di dialogo chiede di esaminare e accettare i Termini del server Model Context Protocol: accettandoli, MCP viene abilitato per l’intero workspace, quindi ogni membro con accesso a ElevenAgents può aggiungere server MCP e associarli agli agenti.

L’abilitazione di MCP è un’impostazione a livello di workspace, non di singolo agente. Qualsiasi membro, o qualsiasi chiave API con l’autorizzazione convai_write, può attivarla o disattivarla: non è limitata agli amministratori del workspace.

Una volta abilitato MCP per il workspace, ciascun server MCP aggiunto è una risorsa distinta: il membro che lo crea può condividerlo singolarmente con altri membri del workspace, analogamente alla condivisione di un agente o di un documento della knowledge base.

L’abilitazione di questa impostazione non sostituisce la restrizione relativa alla modalità Zero Retention e HIPAA indicata sopra. I workspace con modalità Zero Retention o conformità HIPAA abilitate non possono usare server MCP, indipendentemente dall’impostazione can_use_mcp_servers.

Per iniziare

ElevenLabs supporta server MCP sia con trasporto SSE (Server-Sent Events) sia con flusso HTTP.

In questo esempio useremo Zapier MCP, che ti consente di collegare ElevenAgents a centinaia di strumenti e servizi.

I server MCP non sono ancora gestibili tramite la CLI di ElevenLabs: usa la dashboard o l’SDK.
1

Apri le integrazioni MCP

Vai alla dashboard delle integrazioni dei server MCP e fai clic su Add Custom MCP Server.

Creazione del tuo primo server MCP

2

Configura il server MCP

Inserisci i seguenti dettagli:

  • Nome: Il nome del server MCP (ad es. “Zapier MCP Server”)
  • Descrizione: Una descrizione delle funzionalità del server MCP
  • URL del server: L’URL del server MCP. Se contiene una chiave segreta, trattala come una password e memorizzala come secret del workspace.
  • Token segreto (facoltativo): Valore dell’header di autorizzazione
  • Header HTTP (facoltativo): Eventuali header aggiuntivi richiesti dal server
3

Salva e testa la connessione

Fai clic su Add Integration per salvare l’integrazione e testare la connessione, così da elencare gli strumenti disponibili.

Strumenti di esempio di Zapier

4

Associa il server a un agente

Il server MCP è ora disponibile per essere aggiunto ai tuoi agenti. Il supporto MCP è disponibile sia per gli agenti pubblici sia per quelli privati.

Aggiunta del server MCP a un agente

Modalità di approvazione degli strumenti

ElevenLabs offre controlli di approvazione flessibili per gestire il modo in cui gli agenti richiedono l’autorizzazione a utilizzare strumenti dai server MCP. Puoi configurare le impostazioni di approvazione sia a livello di server MCP sia a livello di singolo strumento, per il massimo controllo della sicurezza.

Impostazioni della modalità di approvazione degli strumenti

Modalità di approvazione disponibili

  • Chiedi sempre (consigliato): Massima sicurezza. L’agente richiederà l’autorizzazione prima di ogni utilizzo dello strumento.
  • Approvazione granulare degli strumenti: Disabilita e preseleziona gli strumenti che possono essere eseguiti automaticamente e quelli che richiedono approvazione.
  • Nessuna approvazione: L’assistente può utilizzare qualsiasi strumento senza approvazione.

Controllo granulare degli strumenti

La modalità Approvazione granulare degli strumenti ti consente di configurare i singoli strumenti con requisiti di approvazione diversi, offrendoti un controllo preciso su quali strumenti possono essere eseguiti automaticamente e quali richiedono un’autorizzazione esplicita.

Impostazioni di approvazione granulare degli strumenti

Per ogni strumento, puoi impostare:

  • Approvato automaticamente: Lo strumento viene eseguito automaticamente senza richiedere autorizzazione
  • Richiede approvazione: Lo strumento richiede un’autorizzazione esplicita prima dell’esecuzione
  • Disabilitato: Lo strumento è completamente disabilitato e non può essere utilizzato

Usa l’Approvazione granulare degli strumenti per consentire l’esecuzione automatica degli strumenti di sola lettura a basso rischio, richiedendo al contempo l’approvazione per gli strumenti che modificano dati o eseguono operazioni sensibili.

Considerazioni principali per l’integrazione con ElevenLabs

  • Server esterni: Sei responsabile della selezione dei server MCP esterni che desideri integrare. ElevenLabs ti fornisce i mezzi per collegarti a essi.
  • Funzionalità supportate: ElevenLabs supporta server MCP che comunicano tramite trasporti SSE (Server-Sent Events) e flusso HTTP per interazioni in tempo reale.
  • Strumenti dinamici: Gli strumenti e le funzionalità disponibili da un server MCP integrato sono definiti da quel server esterno e possono cambiare se la configurazione del server viene aggiornata.

Sicurezza ed esclusione di responsabilità

L’integrazione di server MCP esterni può esporre agenti e dati a servizi di terze parti. È fondamentale comprenderne le implicazioni per la sicurezza.

Esclusione di responsabilità importante

Abilitando le integrazioni dei server MCP, riconosci che ciò potrebbe comportare la condivisione di dati con servizi di terze parti non controllati da ElevenLabs. Ciò potrebbe comportare rischi aggiuntivi per la sicurezza. Assicurati di comprendere pienamente le implicazioni, di valutare la sicurezza di qualsiasi server MCP che integri e di consultare le nostre Linee guida sulla sicurezza delle integrazioni MCP prima di procedere.

Consulta le nostre Linee guida sulla sicurezza delle integrazioni MCP per le best practice dettagliate.

Trovare o creare server MCP

  • Utilizza server MCP disponibili pubblicamente da provider affidabili
  • Sviluppa il tuo server MCP per esporre dati o strumenti proprietari
  • Esplora la community e le risorse del Model Context Protocol per esempi e implementazioni di server

Risorse