> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt. # Server MCP di ElevenLabs ## Panoramica Il server MCP di ElevenLabs è un server remoto [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) che offre agli assistenti IA l'accesso al tuo workspace ElevenLabs. Una volta connesso, un assistente come Claude, ChatGPT o Cursor può generare parlato, immagini, video e suoni, progettare voci, creare [Flows](/docs/it/eleven-creative/products/flows) e gestire i tuoi agenti tramite linguaggio naturale, senza dover installare o eseguire nulla in locale. Il server è disponibile all'indirizzo: ``` https://api.elevenlabs.io/v1/mcp ``` L'autenticazione utilizza OAuth. Quando ti connetti, accedi con il tuo account ElevenLabs, scegli un workspace e approvi le autorizzazioni richieste dall'assistente. Nessuna chiave API viene copiata nel client e le generazioni utilizzano i crediti del workspace con cui accedi. > **Note** > > Vuoi invece dare al tuo agente ElevenLabs accesso a server MCP esterni? Consulta la [guida all'integrazione MCP](/docs/it/eleven-agents/customization/tools/mcp). ## A cosa serve Usa il server MCP quando vuoi lavorare con ElevenLabs dall'assistente che usi già, anziché passare all'app ElevenLabs o scrivere codice per l'API. È adatto a due tipi di attività: * **Lavoro creativo**: generare voci fuori campo, immagini, video, effetti sonori e musica da una conversazione, e perfezionarli in più passaggi. * **Lavoro sugli agenti**: creare, configurare, testare e revisionare gli agenti [ElevenAgents](/docs/it/eleven-agents/overview). Per integrare ElevenLabs nella tua applicazione, usa invece l'[API](/docs/it/api-reference/introduction) e gli [SDK](/docs/it/eleven-api/resources/libraries). ## Connettiti da Claude Aggiungi il server come connettore personalizzato. In questo modo Claude avrà accesso a tutti gli strumenti offerti dal server. #### Apri il menu dei connettori In Claude, vai a **Settings** > **Connectors** e seleziona **Add custom connector**. Puoi anche selezionare il pulsante **+** in una nuova chat, quindi **Add connector** > **Add custom connector**. #### Inserisci l'URL del server Assegna al connettore il nome "ElevenLabs" e inserisci `https://api.elevenlabs.io/v1/mcp`. Seleziona **Add**. #### Accedi e autorizza Completa il flusso OAuth con il tuo account ElevenLabs. Scegli il workspace, verifica le autorizzazioni richieste e seleziona **Authorize**. > **Warning** > > Il connettore ElevenLabs elencato nella directory dei connettori di Claude è una versione con funzionalità limitate. > Include parlato, voci, trascrizione e agenti, ma non può generare immagini, video o musica. Aggiungi > il connettore personalizzato qui sopra per accedere alla serie completa di strumenti. Gli altri client MCP funzionano allo stesso modo: indirizza il client all'URL del server e completa il flusso OAuth. Non è necessaria la registrazione del client per i client che supportano i metadati del client ospitato (CIMD). Se il tuo workspace si trova in un ambiente isolato per la residenza dei dati, usa l'URL della tua regione, indicato in [Regioni di residenza dei dati](/docs/it/eleven-agents/operate/hosted-mcp#data-residency-regions). ## Strumenti creativi Ogni generazione creativa viene inserita in un [Flow](/docs/it/eleven-creative/products/flows): un canvas modificabile che contiene prompt, riferimenti e risultati. L'assistente restituisce un link al flow, così puoi aprirlo nell'app ElevenLabs per rivedere i risultati, modificare un nodo o eseguirlo di nuovo. I client che supportano le app MCP, come Claude, mostrano anche il flow e i relativi risultati direttamente nella chat. Con gli strumenti creativi, un assistente può: * Generare immagini e video e modificare immagini esistenti * Generare parlato dal testo con qualsiasi voce nel tuo workspace e trascrivere l'audio * Generare effetti sonori, musica e altri contenuti audio tramite nodi Flow * Progettare una nuova voce da una descrizione e salvare quella che scegli * Concatenare le generazioni in un unico flow, ad esempio un video con una voce fuori campo o un lipsync dal parlato generato * Usare i tuoi file come riferimenti, caricandoli dal computer o recuperandoli da un URL * Gestire i kit del brand affinché le generazioni seguano i colori, i font e i loghi del tuo brand * Consultare i modelli disponibili, i relativi parametri e le guide per i prompt Per impostazione predefinita, le generazioni di immagini e video restituiscono diverse varianti, mentre il parlato restituisce due versioni. Indica all'assistente quale variante usare e la utilizzerà nel passaggio successivo. > **Note** > > La generazione consuma crediti come nell'app ElevenLabs. Evita di chiedere all'assistente di > riprovare una generazione ancora in corso, perché ogni tentativo avvia e addebita una nuova > generazione. ### Esempi di prompt * "Genera uno scatto di prodotto di una tazza da caffè in ceramica su un piano in marmo, luce del mattino, 16:9." * "Trasforma la seconda immagine in un video di cinque secondi con una lenta carrellata in avanti." * "Scrivi una voce fuori campo di 20 secondi per questo video con una calda voce britannica e aggiungila allo stesso flow." * "Progetta una voce per un vecchio capitano di mare burbero e fammi ascoltare tre anteprime." * "Trascrivi l'intervista allegata ed elenca i parlanti." ## Strumenti per gli agenti Gli strumenti per gli agenti consentono di creare, configurare e gestire gli agenti nel tuo workspace. Coprono impostazioni degli agenti, conversazioni e trascrizioni, procedure, strumenti, documenti della knowledge base, test, rami, deployment e problemi. Consulta [MCP ospitato per ElevenAgents](/docs/it/eleven-agents/operate/hosted-mcp) per l'elenco completo, esempi di prompt e il comportamento degli aggiornamenti degli agenti. ## File generati Il server restituisce i file generati come link su `elevenlabsusercontent.com`, il dominio ElevenLabs per i contenuti degli utenti. ElevenLabs serve i contenuti degli utenti da un dominio separato affinché i file nel tuo workspace non possano leggere o impostare cookie per `elevenlabs.io`. Questi link sono firmati e scadono circa due ore dopo che l'assistente li riceve. Per ottenere un nuovo link, chiedi all'assistente di recuperare nuovamente la generazione oppure apri il flow nell'app ElevenLabs. Se la tua rete o il tuo client MCP limita i domini dai quali è possibile caricare contenuti multimediali, autorizza `elevenlabsusercontent.com`. ## Autorizzazioni La schermata di consenso OAuth elenca le autorizzazioni richieste dall'assistente, come ElevenAgents, Text to Speech, Flows e Generazione di immagini e video. L'assistente può eseguire soltanto le azioni coperte dalle autorizzazioni che approvi e dal tuo ruolo nel workspace. Puoi revocare la connessione in qualsiasi momento dal tuo client MCP o dalle impostazioni del tuo account ElevenLabs. I client MCP come Claude ti consentono inoltre di scegliere quali strumenti del connettore può usare l'assistente e per quali è richiesta la tua approvazione prima di ogni chiamata. Gli amministratori del workspace possono configurare questi controlli per l'intera organizzazione. ## Risorse correlate #### [MCP ospitato per ElevenAgents](/docs/it/eleven-agents/operate/hosted-mcp) Strumenti per gli agenti, URL per la residenza dei dati e autorizzazioni degli agenti. #### [Flows](/docs/it/eleven-creative/products/flows) Il canvas in cui viene inserita ogni generazione creativa. #### [Strumenti per agenti](/docs/it/eleven-api/resources/agent-tooling) Competenze degli agenti e altri strumenti per gli assistenti di coding. #### [Riferimento API](/docs/it/api-reference/introduction) API REST completa per il controllo programmatico della piattaforma.