Servidor MCP hospedado
Visão geral
O servidor MCP hospedado da ElevenLabs é um servidor remoto do Model Context Protocol (MCP) que disponibiliza ferramentas de gerenciamento de agentes para assistentes de IA. Depois de conectado, um assistente como o Claude pode criar, configurar e gerenciar os agentes do seu espaço de trabalho usando linguagem natural, sem precisar instalar ou executar nada localmente.
O servidor está disponível em:
A autenticação usa OAuth. Ao se conectar, você entra com sua conta da ElevenLabs e concede ao assistente acesso limitado ao seu espaço de trabalho. Nenhuma chave de API é copiada para o cliente.
O mesmo servidor também tem ferramentas criativas para gerar fala, imagens e vídeo. Esta página aborda as ferramentas de agentes. Consulte o servidor MCP da ElevenLabs para ver tudo o que o servidor pode fazer.
Quer dar ao seu agente da ElevenLabs acesso a servidores MCP externos? Consulte o guia de integração com MCP.
Conectar pelo Claude
Adicione o servidor MCP hospedado ao Claude como um conector personalizado, seguindo as etapas
abaixo com a URL https://api.elevenlabs.io/v1/mcp.
O conector da ElevenLabs no diretório de conectores do Claude é uma versão restrita, sem geração de imagens, vídeo e música. Ele inclui as mesmas ferramentas de agentes.
Regiões de residência de dados
A URL padrão do servidor se conecta ao ambiente global. Se seu espaço de trabalho estiver em um ambiente isolado de residência de dados, adicione um conector personalizado que aponte para a URL da sua região:
Ambientes isolados são espaços de trabalho separados, com contas separadas. Quando o fluxo de OAuth começar, entre com sua conta desse ambiente, não com sua conta da elevenlabs.io.
Adicionar um conector personalizado no Claude
Abra o menu de conectores
Em uma nova conversa, selecione o botão + e depois Add connector > Add custom connector. Você também pode adicionar conectores em Settings > Connectors.
Insira um nome e a URL da sua região
Dê ao conector um nome que deixe a região clara, por exemplo, “ElevenLabs UE”, e informe a URL do servidor MCP da sua região. Selecione Continue.
Outros clientes MCP funcionam da mesma forma: direcione o cliente para a URL do servidor da sua região e conclua o fluxo de OAuth. Não é necessário registrar o cliente para aqueles que aceitam metadados de cliente hospedado (CIMD).
O que você pode fazer
Depois de conectado, seu assistente pode:
- Criar novos agentes descrevendo o que você deseja
- Atualizar qualquer configuração de agente, incluindo o prompt de sistema, a voz, o idioma e a primeira mensagem
- Listar seus agentes e inspecionar ou comparar suas configurações
- Revisar as conversas recentes de um agente, ler transcrições completas e pesquisar em todas elas
- Explorar os temas abordados nas conversas dos seus agentes
- Gerenciar procedimentos, ferramentas, servidores MCP e documentos da base de conhecimento
- Criar, executar e revisar testes
- Trabalhar com ramificações, rascunhos, implantações de tráfego e propostas de mesclagem
- Ler e atualizar problemas
- Duplicar e excluir agentes
- Estimar o uso e o custo esperados de LLM de um agente antes de fazer alterações
- Recuperar a configuração do widget de um agente e o link compartilhável
- Gerar áudio de fala a partir de texto, retornado como um link de download temporário
Atualizar um agente pelo servidor MCP publica a alteração diretamente, na ramificação que o
assistente selecionar ou em main por padrão. A alteração não fica em um rascunho, como acontece com as alterações feitas no
ElevenAgents Architect no app.
Exemplos de prompts
Depois de conectar, experimente prompts como:
- “Crie um agente de suporte para meu site de documentação. Ele deve ser amigável, conciso e encaminhar perguntas sobre cobrança.”
- “Quanto custaria meu agente de checkout por conversa com Gemini 2.5 Flash em vez de GPT-4o?”
- “Duplique meu agente de produção, depois altere a voz e defina a primeira mensagem em espanhol.”
- “Liste meus agentes e diga quais ainda usam a primeira mensagem padrão.”
- “Gere uma amostra da voz do meu agente dizendo nossa nova saudação.”
Permissões
Duas camadas controlam o que um assistente conectado pode fazer: as permissões que você concede à ElevenLabs ao se conectar e os controles de ferramentas no seu cliente MCP.
Permissões da ElevenLabs
Ao se conectar, a tela de consentimento OAuth lista as permissões solicitadas pelo assistente, como ler e gravar agentes. O assistente só pode executar ações abrangidas pelas permissões aprovadas por você, e o acesso é limitado ao espaço de trabalho com o qual você entrou. Você pode revogar a conexão a qualquer momento pelo seu cliente MCP ou pelas configurações da sua conta ElevenLabs.
Controles de ferramentas no seu cliente MCP
Clientes MCP como o Claude permitem escolher quais ferramentas do conector o assistente pode usar e quais exigem sua aprovação antes de cada chamada. No Claude, abra as configurações do conector da ElevenLabs para ativar ou desativar ferramentas individuais e definir se uma ferramenta é executada automaticamente ou pede confirmação primeiro.
Esses controles funcionam em dois níveis. Administradores do espaço de trabalho podem configurar o conector e suas ferramentas para toda a organização, e usuários individuais podem aplicar configurações mais restritas para si mesmos. Uma ferramenta desativada por um administrador não pode ser reativada por um usuário individual.
Segurança
- O acesso é limitado por permissões OAuth que abrangem operações de leitura e gravação do ElevenAgents e Text to Speech.
- Excluir um agente é uma ação destrutiva. Revise as chamadas de ferramentas no seu cliente MCP antes de aprová-las e restrinja o acesso de gravação aos membros do espaço de trabalho que precisarem dele.