Ir para a navegação

Servidor MCP da ElevenLabs

Gere fala, imagens e vídeo e crie agentes com o Claude e outros clientes MCP.

Visão geral

O servidor MCP da ElevenLabs é um servidor remoto do Model Context Protocol (MCP) 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 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.

Quer dar ao seu agente da ElevenLabs acesso a servidores MCP externos? Consulte o guia de integração com 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.

Para integrar a ElevenLabs ao seu próprio aplicativo, use a API e os SDKs.

Conecte-se pelo Claude

Adicione o servidor como um conector personalizado. Isso dá ao Claude acesso a todas as ferramentas oferecidas pelo servidor.

1

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.

2

Insira a URL do servidor

Dê ao conector o nome “ElevenLabs” e insira https://api.elevenlabs.io/v1/mcp. Selecione Add.

3

Entre e autorize

Conclua o fluxo OAuth com sua conta da ElevenLabs. Escolha o workspace, revise as permissões solicitadas e selecione Authorize.

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.

Ferramentas criativas

Toda geração criativa é criada em um Flow: 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.

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 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