Vai alla navigazione

Server MCP fornito

Crea e gestisci i tuoi agenti da Claude e altri client MCP.

Panoramica

Il server MCP ospitato da ElevenLabs è un server remoto Model Context Protocol (MCP) che mette a disposizione strumenti di gestione degli agenti per gli assistenti IA. Una volta connesso, un assistente come Claude può creare, configurare e gestire gli agenti nel tuo workspace attraverso il linguaggio naturale, senza dover installare o eseguire nulla in locale.

Il server è disponibile all’indirizzo:

https://api.elevenlabs.io/v1/mcp

L’autenticazione usa OAuth. Quando ti connetti, accedi con il tuo account ElevenLabs e concedi all’assistente un accesso limitato al tuo workspace. Nessuna chiave API viene copiata nel client.

Lo stesso server offre anche strumenti creativi per generare parlato, immagini e video. Questa pagina tratta gli strumenti per gli agenti. Consulta Server MCP di ElevenLabs per una panoramica di tutte le funzionalità del server.

Vuoi invece consentire al tuo agente ElevenLabs di accedere a server MCP esterni? Consulta la guida all’integrazione MCP.

Connettiti da Claude

Aggiungi il server MCP ospitato a Claude come connettore personalizzato, seguendo i passaggi seguenti con l’URL https://api.elevenlabs.io/v1/mcp.

Il connettore ElevenLabs nella directory dei connettori di Claude è una versione limitata, senza generazione di immagini, video e musica. Include gli stessi strumenti per gli agenti.

Regioni di residenza dei dati

L’URL del server predefinito si connette all’ambiente globale. Se il tuo workspace si trova in un ambiente isolato di residenza dei dati, aggiungi invece un connettore personalizzato che punti all’URL della tua regione:

RegioneURL del server MCP
UEhttps://api.eu.residency.elevenlabs.io/v1/mcp
Indiahttps://api.in.residency.elevenlabs.io/v1/mcp
Singaporehttps://api.sg.residency.elevenlabs.io/v1/mcp

Gli ambienti isolati sono workspace separati con account distinti. Quando inizia il flusso OAuth, accedi con il tuo account per quell’ambiente, non con il tuo account elevenlabs.io.

Aggiungi un connettore personalizzato in Claude

1

Apri il menu dei connettori

In una nuova chat, seleziona il pulsante +, quindi Add connector > Add custom connector. Puoi anche aggiungere connettori da Settings > Connectors.

Il menu di input della chat di Claude con Add connector e Add custom connector evidenziati

2

Inserisci un nome e l'URL della tua regione

Assegna al connettore un nome che renda chiara la regione, ad esempio “ElevenLabs EU”, e inserisci l’URL del server MCP della tua regione. Seleziona Continue.

La finestra di dialogo Add custom connector con il nome ElevenLabs EU e l'URL del server UE compilati

3

Mantieni le impostazioni rilevate

Claude rileva automaticamente le impostazioni del server: l’autenticazione è impostata su Always required e il client OAuth usa **Anthropic’s hosted client metadata **. Lascia entrambe le impostazioni come rilevate e seleziona Add.

Le impostazioni di autenticazione del connettore con Always required e hosted client metadata rilevati

4

Accedi e autorizza

Completa il flusso OAuth con il tuo account per quell’ambiente. Scegli il workspace, verifica le autorizzazioni richieste e seleziona Authorize.

La schermata di consenso di ElevenLabs che mostra il selettore del workspace e le autorizzazioni richieste

Gli altri client MCP funzionano allo stesso modo: indirizza il client all’URL del server della tua regione e completa il flusso OAuth. Non è necessaria la registrazione del client per i client che supportano hosted client metadata (CIMD).

Cosa puoi fare

Una volta connesso, il tuo assistente può:

  • Creare nuovi agenti descrivendo ciò che desideri
  • Aggiornare qualsiasi impostazione dell’agente, inclusi system prompt, voce, lingua e primo messaggio
  • Elencare i tuoi agenti e ispezionarne o confrontarne le configurazioni
  • Esaminare le conversazioni recenti di un agente, leggere le trascrizioni complete e cercare al loro interno
  • Esplorare gli argomenti trattati nelle conversazioni dei tuoi agenti
  • Gestire procedure, strumenti, server MCP e documenti della knowledge base
  • Creare, eseguire ed esaminare test
  • Lavorare con branch, bozze, distribuzioni di traffico e proposte di merge
  • Leggere e aggiornare le issue
  • Duplicare ed eliminare agenti
  • Stimare l’utilizzo e il costo previsti del LLM di un agente prima di apportare modifiche
  • Recuperare la configurazione del widget di un agente e il relativo link condivisibile
  • Generare audio parlato dal testo, restituito come link per il download a validità limitata

L’aggiornamento di un agente tramite il server MCP pubblica direttamente la modifica, nel branch a cui si rivolge l’assistente o in main per impostazione predefinita. Non viene preparata in una bozza come avviene per le modifiche da ElevenAgents Architect nell’app.

Esempi di prompt

Una volta connesso, prova prompt come:

  • “Crea un agente di supporto per il mio sito di documentazione. Deve essere cordiale, conciso e inoltrare le domande sulla fatturazione.”
  • “Quanto costerebbe per conversazione il mio agente di checkout con Gemini 3.5 Flash anziché GPT-4o?”
  • “Duplica il mio agente di produzione, poi cambia la voce e imposta il primo messaggio in spagnolo.”
  • “Elenca i miei agenti e dimmi quali usano ancora il primo messaggio predefinito.”
  • “Genera un esempio della voce del mio agente che pronuncia il nostro nuovo saluto.”

Autorizzazioni

Due livelli controllano ciò che può fare un assistente connesso: le autorizzazioni che concedi a ElevenLabs quando ti connetti e i controlli degli strumenti nel tuo client MCP.

Autorizzazioni ElevenLabs

Quando ti connetti, la schermata di consenso OAuth elenca le autorizzazioni richieste dall’assistente, come la lettura e la scrittura degli agenti. L’assistente può eseguire solo le azioni coperte dalle autorizzazioni che approvi e l’accesso è limitato al workspace con cui accedi. Puoi revocare la connessione in qualsiasi momento dal tuo client MCP o dalle impostazioni del tuo account ElevenLabs.

Controlli degli strumenti nel tuo client MCP

I client MCP come Claude ti consentono di scegliere quali strumenti del connettore può usare l’assistente e quali richiedono la tua approvazione prima di ogni chiamata. In Claude, apri le impostazioni del connettore ElevenLabs per abilitare o disabilitare singoli strumenti e impostare se uno strumento viene eseguito automaticamente o richiede prima una conferma.

Questi controlli funzionano a due livelli. Gli amministratori del workspace possono configurare il connettore e i relativi strumenti per tutti i membri dell’organizzazione, mentre i singoli utenti possono applicare impostazioni più restrittive per sé stessi. Uno strumento disabilitato da un amministratore non può essere riabilitato da un singolo utente.

Sicurezza

  • L’accesso è limitato dalle autorizzazioni OAuth che coprono le operazioni di lettura e scrittura di ElevenAgents e Text to Speech.
  • L’eliminazione di un agente è distruttiva. Esamina le chiamate degli strumenti nel tuo client MCP prima di approvarle e limita l’accesso in scrittura ai membri del workspace che ne hanno bisogno.

Risorse correlate