> 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. # Servidor MCP da ElevenLabs ## Visão geral O servidor MCP da ElevenLabs é um servidor remoto do [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) que dá aos assistentes de IA acesso ao seu workspace da ElevenLabs. Depois de conectado, um assistente como Claude, ChatGPT ou Cursor pode gerar fala, imagens, vídeo e som, criar vozes, desenvolver [Flows](/docs/pt/eleven-creative/products/flows) e gerenciar seus agentes usando linguagem natural, sem precisar instalar ou executar nada localmente. O servidor está disponível em: ``` https://api.elevenlabs.io/v1/mcp ``` A autenticação usa OAuth. Ao se conectar, você entra com sua conta da ElevenLabs, escolhe um workspace e aprova as permissões solicitadas pelo assistente. Nenhuma chave de API é copiada para o cliente, e as gerações usam os créditos do workspace com o qual você entrar. > **Note** > > Quer dar ao seu agente da ElevenLabs acesso a servidores MCP externos? Consulte o [guia de integração com MCP](/docs/pt/eleven-agents/customization/tools/mcp). ## Para que serve Use o servidor MCP quando quiser trabalhar com a ElevenLabs pelo assistente que você já usa, em vez de alternar para o app da ElevenLabs ou escrever código para a API. Ele é adequado para dois tipos de trabalho: * **Trabalho criativo**: gerar locuções, imagens, vídeos, efeitos sonoros e música em uma conversa, refinando-os ao longo de várias interações. * **Trabalho com agentes**: criar, configurar, testar e revisar agentes do [ElevenAgents](/docs/pt/eleven-agents/overview). Para integrar a ElevenLabs ao seu próprio aplicativo, use a [API](/docs/pt/api-reference/introduction) e os [SDKs](/docs/pt/eleven-api/resources/libraries). ## Conecte-se pelo Claude Adicione o servidor como um conector personalizado. Isso dá ao Claude acesso a todas as ferramentas oferecidas pelo servidor. #### Abra o menu de conectores No Claude, vá para **Settings** > **Connectors** e selecione **Add custom connector**. Você também pode selecionar o botão **+** em um novo chat e, depois, **Add connector** > **Add custom connector**. #### Insira a URL do servidor Dê ao conector o nome "ElevenLabs" e insira `https://api.elevenlabs.io/v1/mcp`. Selecione **Add**. #### Entre e autorize Conclua o fluxo OAuth com sua conta da ElevenLabs. Escolha o workspace, revise as permissões solicitadas e selecione **Authorize**. > **Warning** > > O conector da ElevenLabs listado no diretório de conectores do Claude é uma versão restrita. Ele > abrange fala, vozes, transcrição e agentes, mas não pode gerar imagens, vídeo ou música. Adicione > o conector personalizado acima para ter acesso ao conjunto completo de ferramentas. Outros clientes MCP funcionam da mesma forma: aponte o cliente para a URL do servidor e conclua o fluxo OAuth. Não é necessário registrar clientes que oferecem suporte a metadados de cliente hospedados (CIMD). Se o seu workspace estiver em um ambiente isolado de residência de dados, use a URL da sua região, listada em [Regiões de residência de dados](/docs/pt/eleven-agents/operate/hosted-mcp#data-residency-regions). ## Ferramentas criativas Toda geração criativa é criada em um [Flow](/docs/pt/eleven-creative/products/flows): uma tela editável que reúne os prompts, as referências e os resultados. O assistente retorna um link para o flow, para que você possa abri-lo no app da ElevenLabs, revisar os resultados, ajustar um nó ou executá-lo novamente. Clientes compatíveis com MCP Apps, como o Claude, também mostram o flow e seus resultados diretamente no chat. Com as ferramentas criativas, um assistente pode: * Gerar imagens e vídeos, além de editar imagens existentes * Gerar fala a partir de texto com qualquer voz do seu workspace e transcrever áudio * Gerar efeitos sonoros, música e outros áudios por meio de nós do Flow * Criar uma nova voz a partir de uma descrição e salvar a que você escolher * Encadear gerações em um único flow, como um vídeo com locução ou uma sincronização labial a partir de fala gerada * Usar seus próprios arquivos como referências, enviados do seu computador ou obtidos por uma URL * Gerenciar kits de marca para que as gerações sigam as cores, fontes e logotipos da sua marca * Consultar os modelos disponíveis, seus parâmetros e guias de prompting Por padrão, as gerações de imagem e vídeo retornam várias variações, e a fala retorna duas tomadas. Diga ao assistente qual variação usar, e ele a levará para a próxima etapa. > **Note** > > Gerar conteúdo consome créditos da mesma forma que gerar no app da ElevenLabs. Evite pedir ao > assistente para tentar novamente uma geração que ainda está em andamento, pois cada nova tentativa inicia e cobra uma nova > geração. ### Exemplos de prompts * "Gere uma foto de produto de uma caneca de café de cerâmica sobre uma bancada de mármore, com luz da manhã, 16:9." * "Transforme a segunda imagem em um vídeo de cinco segundos com uma aproximação lenta." * "Escreva uma locução de 20 segundos para este vídeo com uma voz britânica acolhedora e adicione-a ao mesmo flow." * "Crie uma voz para um velho capitão do mar de voz áspera e me deixe ouvir três prévias." * "Transcreva a entrevista anexada e liste os participantes." ## Ferramentas para agentes As ferramentas para agentes criam, configuram e gerenciam os agentes no seu workspace. Elas abrangem configurações de agentes, conversas e transcrições, procedimentos, ferramentas, documentos da base de conhecimento, testes, ramificações, implantações e problemas. Consulte [MCP hospedado para ElevenAgents](/docs/pt/eleven-agents/operate/hosted-mcp) para ver a lista completa, exemplos de prompts e o comportamento das atualizações de agentes. ## Arquivos gerados O servidor retorna arquivos gerados como links em `elevenlabsusercontent.com`, o domínio da ElevenLabs para conteúdo de usuários. A ElevenLabs disponibiliza conteúdo de usuários em um domínio separado para que os arquivos no seu workspace não possam ler ou definir cookies de `elevenlabs.io`. Esses links são assinados e expiram cerca de duas horas após o assistente recebê-los. Para obter um novo link, peça ao assistente para buscar a geração novamente ou abra o flow no app da ElevenLabs. Se sua rede ou seu cliente MCP restringir os domínios que podem carregar mídia, permita `elevenlabsusercontent.com`. ## Permissões A tela de consentimento OAuth lista as permissões solicitadas pelo assistente, como ElevenAgents, Text to Speech, Flows e Geração de imagens e vídeo. O assistente só pode realizar ações abrangidas pelas permissões que você aprovar e pela sua função no workspace. Você pode revogar a conexão a qualquer momento pelo seu cliente MCP ou nas configurações da sua conta da ElevenLabs. Clientes MCP como o Claude também permitem escolher quais ferramentas do conector o assistente pode usar e quais exigem sua aprovação antes de cada chamada. Administradores do workspace podem configurar esses controles para toda a organização. ## Recursos relacionados #### [MCP hospedado para ElevenAgents](/docs/pt/eleven-agents/operate/hosted-mcp) Ferramentas para agentes, URLs de residência de dados e permissões de agentes. #### [Flows](/docs/pt/eleven-creative/products/flows) A tela em que toda geração criativa é criada. #### [Ferramentas para agentes](/docs/pt/eleven-api/resources/agent-tooling) Habilidades de agentes e outras ferramentas para assistentes de programação. #### [Referência da API](/docs/pt/api-reference/introduction) API REST completa para controle programático da plataforma.