Servidor MCP da ElevenLabs: configuração com Claude Code, ChatGPT e Cursor

A maioria dos tutoriais sobre essa configuração ainda manda colar um segredo de API em um arquivo JSON e iniciar um pacote Python chamado elevenlabs-mcp. Esse caminho é um beco sem saída. O repositório oficial no GitHub está arquivado, o próprio aviso chama o servidor local de obsoleto, e a ElevenLabs agora mantém um servidor MCP hospedado em https://api.elevenlabs.io/v1/mcp que faz o login com OAuth. Não há pacote para instalar, nenhum segredo guardado em arquivo de configuração e nada para atualizar quando a próxima versão sair.

Este artigo conecta esse servidor hospedado ao Claude Code, ao ChatGPT e ao Cursor, com os comandos exatos, a entrada em JSON e as soluções para os erros que as pessoas de fato encontram. Depois das três configurações, você também verá como usar as mesmas vozes da ElevenLabs direto no navegador, na PicassoIA, quando precisar só de uma narração e não quiser nenhuma conexão.

O que muda com o servidor hospedado

Antes de digitar qualquer comando, convém entender por que a configuração parece tão diferente do que você pode ter lido no ano passado. O servidor antigo era um programa no seu próprio computador. O novo é um serviço que o seu assistente chama pela internet, do mesmo jeito que chama qualquer outro conector.

Hospedado comparado com o antigo pacote local

A diferença prática aparece na primeira vez em que algo quebra. Com o pacote local, era preciso resolver problemas de ferramentas do Python, de PATH e erros no arquivo de configuração. Com o servidor hospedado, as únicas partes móveis são uma URL e um login no navegador.

💡 Já usa o pacote antigo? Ele continua funcionando, então nada obriga você a migrar hoje. Mas uma configuração nova não tem motivo para começar por ele, e as configurações abaixo levam menos tempo do que instalar uv.

O que o seu assistente pode criar

Depois de conectado, o assistente ganha um conjunto de ferramentas que acessam o seu workspace da ElevenLabs. A ElevenLabs as agrupa em duas áreas: ElevenCreative, para gerar mídia, e ElevenAgents, para criar agentes de voz e de chat. Em termos simples, o seu assistente pode:

• Falar. Transformar texto em fala com qualquer voz da biblioteca, pronta dentro da conversa.
• Transcrever. O Scribe devolve uma transcrição limpa, com identificação de falantes e marcações de tempo, em 99 idiomas.
• Dublar. Produzir faixas traduzidas que mantêm a voz, o tom e a entrega do falante original.
• Compor. Gerar música em qualquer gênero ou estilo, com ou sem vocais, além de efeitos sonoros.
• Criar visuais. Gerar uma imagem, editá-la, animá-la em vídeo e adicionar sincronização labial.
• Gerenciar agentes. Inspecionar, criar e atualizar agentes de voz e de chat, revisar conversas e transcrições, e cuidar de testes e implantações.

Tudo o que você gerar vai para o seu workspace do ElevenCreative, onde você pode abrir no Studio para finalizar o trabalho. Esse detalhe importa mais do que parece: o áudio não fica preso em uma janela de chat, ele fica no mesmo lugar que o resto dos seus projetos.

Verifique estes pontos antes de conectar

Você precisa de três coisas: uma conta na ElevenLabs, um dos clientes compatíveis e a URL de servidor certa para a sua região de dados. A maioria das pessoas só precisa da primeira URL da tabela.

As URLs de residência são destinadas a workspaces criados com residência de dados isolada. Se você nunca viu esse termo na sua conta da ElevenLabs, a URL padrão é a que deve usar.

Há duas outras coisas que merecem um minuto. Primeiro, o login no navegador usa a conta da ElevenLabs que estiver ativa, então entre na conta que é dona do workspace que você quer que o assistente acesse. Segundo, a ElevenLabs não publica o custo em créditos de cada ferramenta nas páginas de MCP, então trate suas primeiras execuções como um teste e acompanhe o seu consumo no painel antes de enfileirar um lote longo.

Configuração do Claude Code em dois comandos

O Claude Code trabalha com MCP remoto nativamente, o que faz dele o caminho mais curto entre os três. Você pode adicionar só o servidor ou instalar o plugin que reúne o servidor com habilidades prontas.

Adicionar só o servidor

Execute isto no seu terminal, fora de qualquer sessão do Claude Code:

claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp

Copiar prompt

Depois, conclua o login de dentro do Claude Code:

1. Inicie uma sessão com claude.
2. Digite /mcp para abrir a lista de servidores.
3. Selecione elevenlabs e escolha autenticar.
4. Aprove o acesso na janela do navegador que abrir, usando a sua conta da ElevenLabs.

Quando o navegador disser que você está conectado, o status do servidor em /mcp muda de precisa de autenticação para conectado, e as ferramentas da ElevenLabs aparecem na lista.

Instalar o plugin completo

Se você quer mais do que ferramentas brutas, a ElevenLabs disponibiliza um plugin que funciona no Claude Code, no Cursor e no OpenAI Codex. No Claude Code, ele exige dois comandos:

/plugin marketplace add elevenlabs/plugin
/plugin install elevenlabs@elevenlabs

Copiar prompt

O plugin adiciona três grupos de habilidades sobre a conexão:

• Habilidades gerais para texto em fala em mais de 70 idiomas, fala em texto, troca de voz, efeitos sonoros, música e dublagem.
• Habilidades de MCP para gerenciar agentes e para o estúdio criativo, que inclui fala, imagens, vídeo e transcrição.
• Habilidades de arquiteto para criar agentes de voz, do teste até a implantação.

A autenticação continua a mesma: você faz login com OAuth quando o agente se conecta ao servidor pela primeira vez.

Verificar e definir o escopo

Confira se o servidor foi registrado e está saudável:

claude mcp list

Copiar prompt

Por padrão, claude mcp add guarda o servidor apenas para o projeto atual. Adicione --scope user para disponibilizá-lo em todos os projetos da sua máquina:

claude mcp add --scope user --transport http elevenlabs https://api.elevenlabs.io/v1/mcp

Copiar prompt

Use --scope project no lugar quando uma equipe inteira deve compartilhar a mesma configuração. Isso grava um arquivo .mcp.json na raiz do projeto e, como o login acontece por OAuth, a entrada guarda apenas a URL.

💡 Workspace regional? Troque a URL padrão pela URL de residência da tabela acima. O resto do comando continua idêntico.

Experimente um primeiro prompt já: "Leia o README deste repositório e gere uma narração de 20 segundos com os passos de instalação, em uma voz calma." O Claude Code lê o arquivo, escreve o roteiro e chama a ferramenta de fala, e o áudio pronto aparece no seu workspace do ElevenCreative.

Configuração do Cursor pelo marketplace ou pelo JSON

O Cursor oferece dois caminhos, e ambos terminam no mesmo pedido de OAuth. Escolha o marketplace se quiser as habilidades, ou o arquivo JSON se quiser controle total sobre o que é carregado.

Instalação com um clique pelo marketplace

Abra o marketplace do Cursor, procure o plugin ElevenLabs e instale-o. O plugin reúne o servidor hospedado e as suas habilidades, então o seu agente de programação consegue usar fala, efeitos sonoros, música e dublagem sem configuração extra. Na primeira conexão, o Cursor pede que você entre na ElevenLabs.

Entrada manual no mcp.json

Para uma configuração manual, adicione o servidor ao seu mcp.json. Use ~/.cursor/mcp.json para todos os projetos, ou .cursor/mcp.json dentro de um repositório específico:

{
  "mcpServers": {
    "elevenlabs": {
      "url": "https://api.elevenlabs.io/v1/mcp"
    }
  }
}

Copiar prompt

Salve o arquivo e recarregue a janela. O Cursor pede que você faça login com OAuth na primeira conexão, e as ferramentas da ElevenLabs aparecem na seção de MCP das suas configurações. Repare no que falta no JSON: nenhum command, nenhum args, nenhum bloco env. Um servidor remoto precisa de uma URL e de nada mais.

Um bom teste no Cursor é a narração de uma demo: "Gere uma narração para o fluxo de checkout deste projeto, duas frases, tom amigável." Se o agente pedir permissão antes de chamar a ferramenta, isso é a confirmação de ferramentas do Cursor fazendo o seu trabalho, não um erro.

Configuração do ChatGPT como conector personalizado

O ChatGPT é onde o antigo pacote local se encaixava pior. Ele se conecta a servidores MCP pela internet pública, então um programa rodando no seu notebook ficava fora de alcance sem um túnel. Um servidor hospedado elimina esse obstáculo por completo.

Adicionar o conector

Os nomes dos menus do ChatGPT mudam entre versões e planos, então siga a lógica em vez dos rótulos exatos:

1. Abra as configurações do ChatGPT e vá para a seção de conectores ou aplicativos.
2. Procure ElevenLabs no diretório. A ElevenLabs oferece uma instalação com um clique e OAuth para o ChatGPT.
3. Se ele não aparecer para a sua conta, escolha adicionar um conector personalizado.
4. Informe a URL do servidor https://api.elevenlabs.io/v1/mcp e selecione OAuth como método de autenticação.
5. Entre com a sua conta da ElevenLabs e aprove o pedido de acesso.
6. Em um novo chat, ative o conector da ElevenLabs no menu de ferramentas antes de enviar o prompt.

💡 Não encontra a opção? Em workspaces Business, Enterprise e Education, um administrador pode precisar liberar conectores personalizados antes, geralmente por um botão de modo desenvolvedor nas permissões do workspace. Em planos individuais, a disponibilidade varia, então verifique o seu plano antes de passar uma hora depurando.

Execute um primeiro prompt de teste

Comece pequeno para saber se o problema está na conexão ou no prompt. Estes cinco funcionam igualmente no ChatGPT, no Claude Code e no Cursor:

• "Gere uma mensagem de boas-vindas de 10 segundos com uma voz feminina calorosa."
• "Crie um efeito sonoro de chuva em um telhado de zinco, 8 segundos."
• "Transcreva esta gravação e identifique cada falante."
• "Escreva um teaser de produto de 30 segundos e leia com uma voz masculina confiante."
• "Duble este trecho para o espanhol e mantenha o tom do falante original."

Se o primeiro prompt funcionar, os demais também vão funcionar. Se falhar com uma mensagem sobre ferramentas ou permissões, vá para a próxima seção.

Como resolver os problemas mais comuns

Quase toda falha se encaixa em um de três grupos: o login não foi concluído, a conta ou a região não batem, ou uma configuração antiga está atrapalhando.

Nenhuma janela de login aparece

No Claude Code, um servidor OAuth recém-adicionado fica no estado de precisa de autenticação até que você abra /mcp, selecione-o e inicie o login por conta própria. Em geral, ele não abre uma aba do navegador sozinho. No Cursor e no ChatGPT, tente a ação de conectar novamente e confira se o navegador não bloqueou o pop-up. Se uma aba abriu com a conta errada da ElevenLabs, saia da conta no navegador e repita o fluxo.

Região errada ou ferramentas bloqueadas

Aqui se escondem dois sintomas diferentes, e eles têm soluções diferentes.

O acesso é controlado em duas camadas. As permissões de OAuth da ElevenLabs limitam, antes de tudo, o que a conexão pode fazer, e os controles de ferramentas do próprio cliente permitem desligar ferramentas individuais ou exigir confirmação antes de cada chamada. Manter a confirmação ativada para qualquer coisa que gaste créditos é um padrão sensato.

Tutoriais antigos e segredos de API

Se você seguiu um post mais antigo, uma entrada que inicia uvx elevenlabs-mcp pode ainda estar na sua configuração. Dois servidores expondo ferramentas parecidas fazem o assistente escolher de forma imprevisível, então remova o antigo:

claude mcp remove ElevenLabs

Copiar prompt

Use exatamente o nome que você deu a ele e apague o bloco correspondente de claude_desktop_config.json ou mcp.json, se ele estiver lá. Outros três resíduos valem a limpeza:

• Variáveis de ambiente, como ELEVENLABS_MCP_BASE_PATH e ELEVENLABS_MCP_OUTPUT_MODE, pertencem ao pacote local e não fazem nada no servidor hospedado.
• A etapa do Modo Desenvolvedor do Windows que os tutoriais antigos do Claude Desktop exigiam faz parte da rota local, não da hospedada.
• Segredos de API colados em arquivos de configuração devem ser rotacionados no painel da ElevenLabs, sobretudo se o arquivo algum dia chegou a um repositório Git.

Como usar o ElevenLabs v3 na PicassoIA

Nem todo trabalho precisa de um assistente envolvido no processo. Se tudo o que você quer é uma narração de um roteiro pronto, o ElevenLabs V3 na PicassoIA roda no navegador, sem conexão, sem OAuth e sem cliente para configurar. Ele oferece mais de 25 vozes, saída multilíngue e controles finos de velocidade, tom e estilo.

Passos no navegador

1. Abra a página do modelo ElevenLabs V3.
2. Cole o seu roteiro em Prompt, o único campo obrigatório.
3. Escolha uma voz. A padrão é Rachel, e a lista também inclui Drew, Aria, Roger, Sarah, James e Juniper.
4. Defina o código de idioma, por exemplo en, es ou fr.
5. Ajuste os controles da tabela abaixo.
6. Para roteiros longos, preencha Previous Text e Next Text para que a entonação fique natural nas fronteiras das frases.
7. Execute o modelo, ouça o resultado e baixe o áudio.

💡 Dica: Para um capítulo de audiolivro ou um módulo de curso, aumente Stability e deixe Style perto de zero, para que a frase 40 soe como a frase 1. Para um trailer ou uma voz de personagem, faça o contrário.

Escolha o modelo ElevenLabs certo

A ElevenLabs não é um único modelo, e a PicassoIA hospeda vários deles. Escolha pelo trabalho, não pelo nome mais novo.

O próprio roteiro pode vir de um modelo de linguagem da mesma plataforma. Escreva um rascunho com o Claude Sonnet 5 ou o GPT 5.6 Sol, cole o resultado em um modelo de voz e você terá uma peça narrada sem sair do navegador.

💡 Dois conectores, um assistente. A PicassoIA também oferece o seu próprio conector para gerar imagens e vídeos a partir de um chat. Use-o junto com o conector da ElevenLabs, e um único assistente pode narrar um roteiro e ilustrá-lo na mesma conversa.

Crie seus próprios visuais na Picasso IA

A voz é só metade de uma peça finalizada. Todo vídeo ainda precisa de uma miniatura, todo podcast precisa de uma arte de capa, e toda demo precisa de algumas cenas que pareçam fotografias reais, e não material genérico de banco de imagens. É essa parte que a Picasso IA resolve em segundos.

Comece com o modelo PicassoIA Image ou experimente o Seedream 4.5 para uma segunda versão. Descreva o assunto, a luz e a lente em uma frase, por exemplo "um podcaster em uma mesa de madeira, luz de janela vinda da esquerda, lente de 85mm, profundidade de campo rasa", e depois mude um detalhe por vez e compare os resultados. Quando uma imagem está quase certa, mas não exatamente, o PicassoIA Image Editor Pro permite editá-la em vez de começar de novo.

Escolha um roteiro que você narrou hoje, gere três imagens que combinem com ele e monte o conjunto. Você pode navegar por todos os modelos disponíveis em picassoia.com/en/all-models e começar a experimentar agora mesmo.