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 no seu workspace por linguagem natural, sem precisar instalar ou executar nada localmente.
O servidor está disponível em:
A autenticação usa OAuth. Ao conectar, você entra com sua conta da ElevenLabs e concede ao assistente acesso limitado ao seu workspace. Nenhuma chave de API é copiada para o cliente.
Quer dar ao seu agente da ElevenLabs acesso a servidores MCP externos? Consulte o guia de integração com MCP.
Conectar pelo Claude Desktop
O servidor MCP hospedado está publicado no diretório do Claude Desktop.
Regiões de residência de dados
O conector no diretório do Claude e a URL padrão do servidor se conectam ao ambiente global. Se o seu workspace 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 workspaces separados, com contas separadas. Quando o fluxo OAuth começar, entre com a conta desse ambiente, não com sua conta elevenlabs.io.
Adicionar um conector personalizado no Claude
Abra o menu de conectores
Em um novo chat, 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 insira 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 OAuth. Não é necessário registrar o cliente para clientes compatíveis com metadados de cliente hospedado (CIMD).
O que você pode fazer
Depois de conectado, seu assistente pode:
- Criar novos agentes descrevendo o que você quer
- Atualizar qualquer configuração de agente, incluindo o prompt de sistema, voz, idioma e primeira mensagem
- Listar seus agentes e inspecionar ou comparar suas configurações
- Revisar as conversas recentes de um agente e ler transcrições completas
- Explorar os tópicos abordados nas conversas dos seus agentes
- Duplicar e excluir agentes
- Estimar o uso e o custo esperados de LLM de um agente antes de fazer mudanças
- Recuperar a configuração do widget de um agente e o link compartilhável
- Verificar o tamanho da base de conhecimento de um agente
- Gerar áudio de fala a partir de texto, retornado como um link de download de curta duração
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 meu agente de checkout custaria por conversa com o Gemini 2.5 Flash em vez do 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 conectar e os controles de ferramentas no seu cliente MCP.
Permissões da ElevenLabs
Ao conectar, a tela de consentimento OAuth lista as permissões que o assistente está solicitando, como leitura e gravação de agentes. O assistente só pode executar ações cobertas pelas permissões que você aprovar, e o acesso fica limitado ao workspace com o qual você fizer login. 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 workspace podem configurar o conector e suas ferramentas para todas as pessoas da 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 workspace que precisam dele.