> 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 hospedado ## Visão geral O servidor MCP hospedado da ElevenLabs é um servidor remoto do [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) 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 espaço de trabalho por 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 e concede ao assistente acesso limitado ao seu espaço de trabalho. Nenhuma chave de API é copiada para o cliente. > **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). ## Conectar pelo Claude Desktop O servidor MCP hospedado está disponível no diretório do Claude Desktop. #### Abra o diretório No Claude Desktop, acesse **Settings** > **Connectors** e navegue pelo diretório. #### Adicione o conector da ElevenLabs Pesquise por **ElevenLabs** e selecione **Connect**. #### Entre na sua conta Conclua o fluxo OAuth com sua conta da ElevenLabs. O Claude poderá listar, criar e atualizar agentes no seu espaço de trabalho em seu nome. ## 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 seu espaço de trabalho estiver em um ambiente isolado de [residência de dados](/docs/pt/overview/administration/data-residency), adicione um conector personalizado que aponte para a URL da sua região: | Região | URL do servidor MCP | | --------- | ----------------------------------------------- | | UE | `https://api.eu.residency.elevenlabs.io/v1/mcp` | | Índia | `https://api.in.residency.elevenlabs.io/v1/mcp` | | Singapura | `https://api.sg.residency.elevenlabs.io/v1/mcp` | > **Warning** > > Ambientes isolados são espaços de trabalho separados, com contas separadas. Quando o fluxo OAuth começar, > entre com sua conta desse ambiente, e não com sua conta elevenlabs.io. ### Adicione 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**. ![Menu de entrada do chat do Claude com Add connector e Add custom connector destacados](/docs/_fern-img/1c3f441dcc1e77404715e95da3f290f61f913b65b8e3636e404b71b1f4da3797.webp) #### 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**. ![Caixa de diálogo Add custom connector com o nome ElevenLabs UE e a URL do servidor da UE preenchidos](/docs/_fern-img/a1f5f6c459eafc68ce220f1e4d6dd1402e5e78f0d7abb87a41d1800ba6e4c355.webp) #### Mantenha as configurações detectadas O Claude detecta automaticamente as configurações do servidor: a autenticação é definida como **Always required** e o cliente OAuth usa os \*\*metadados de cliente hospedado da Anthropic \*\*. Mantenha ambos como detectados e selecione **Add**. ![Configurações de autenticação do conector com Always required e metadados de cliente hospedado detectados](/docs/_fern-img/5f5b5941ec2d311769570cb194bbd70dc347db5bde46c812f94bae7da1c25c47.webp) #### Entre e autorize Conclua o fluxo OAuth com sua conta desse ambiente. Escolha o espaço de trabalho, revise as permissões solicitadas e selecione **Authorize**. ![Tela de consentimento da ElevenLabs mostrando o seletor de espaço de trabalho e as permissões solicitadas](/docs/_fern-img/550401ee663f8b123ad61feffcc8cd6767f3f8f665419bf0a0b5cf999a6688ec.webp) > **Note** > > 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 que oferecem suporte a 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 do agente, incluindo o prompt de sistema, a voz, o idioma e a primeira mensagem * Listar seus agentes e inspecionar ou comparar suas configurações * Analisar as conversas recentes de um agente, ler transcrições completas e pesquisar nelas * Explorar os tópicos abordados nas conversas dos seus agentes * Gerenciar procedimentos, ferramentas, servidores MCP e documentos da base de conhecimento * Criar, executar e analisar testes * Trabalhar com ramificações, rascunhos, implantações de tráfego e propostas de merge * Ler e atualizar tickets de triagem * 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 de curta duração > **Warning** > > Atualizar um agente pelo servidor MCP publica a alteração diretamente, na ramificação que o > assistente escolher ou em `main` por padrão. A alteração não fica em um rascunho como acontece com as alterações do > [ElevenAgents Architect](/docs/pt/eleven-agents/operate/architect/external-assistants) 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 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 mude 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 que o assistente está solicitando, como ler e gravar agentes. O assistente só pode realizar ações cobertas pelas permissões que você aprovar, e o acesso é limitado ao espaço de trabalho com o qual você entrar. Você pode revogar a conexão a qualquer momento pelo seu cliente MCP ou pelas configurações da sua conta da 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 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 espaço de trabalho que precisarem dele. ## Recursos relacionados #### [CLI da ElevenLabs](/docs/pt/eleven-agents/operate/cli) Gerencie agentes como código com controle de versão e CI/CD. #### [Skill de agentes](https://github.com/elevenlabs/skills/tree/main/agents) Dê aos agentes de programação workflows mais aprofundados da ElevenLabs pelo repositório de skills. #### [Referência da API](/docs/pt/api-reference/introduction) API REST completa para controle programático da plataforma.