Model Context Protocol
Você é responsável pela segurança, conformidade e comportamento de qualquer servidor MCP de terceiros que integrar aos seus agentes conversacionais da ElevenLabs. A ElevenLabs fornece a plataforma para integração, mas não gerencia, recomenda nem protege servidores MCP externos.
Visão geral
Este guia aborda como dar aos seus agentes da ElevenLabs acesso a servidores MCP externos. Se você quiser o contrário, gerenciar seus agentes da ElevenLabs pelo Claude ou outro cliente MCP, use o servidor MCP hospedado.
O Model Context Protocol (MCP) é um padrão aberto que define como aplicações fornecem contexto a modelos de linguagem grandes (LLMs). Pense no MCP como um conector universal que permite que modelos de IA interajam sem dificuldades com diversas fontes de dados e ferramentas. Ao integrar servidores que implementam o MCP, você pode ampliar significativamente os recursos dos seus agentes conversacionais da ElevenLabs.
No momento, o suporte a MCP não está disponível para usuários no modo de retenção zero ou que precisam de conformidade com a HIPAA.
A ElevenLabs permite conectar seus agentes conversacionais a servidores MCP externos. Isso permite que seus agentes:
- Acessem e processem informações de diversas fontes de dados pelo servidor MCP
- Usem ferramentas e funcionalidades especializadas disponibilizadas pelo servidor MCP
- Criem experiências conversacionais mais dinâmicas, informadas e interativas
Ative o MCP para seu espaço de trabalho
O MCP fica desativado por padrão em todos os espaços de trabalho. Antes que qualquer pessoa possa adicionar ou usar servidores MCP, um membro do espaço de trabalho precisa aderir em nome dele.
Painel
API
A adesão ocorre automaticamente na primeira vez que alguém tenta adicionar um servidor MCP pelo painel de integrações de servidores MCP. Uma caixa de diálogo pede que a pessoa revise e aceite os Termos do Servidor do Model Context Protocol — a aceitação ativa o MCP para todo o espaço de trabalho, e todos os membros com acesso ao ElevenAgents podem adicionar servidores MCP e vinculá-los a agentes.
Ativar o MCP é uma configuração de todo o espaço de trabalho, e não de cada agente. Qualquer membro, ou qualquer chave de API
com a permissão convai_write, pode ativá-lo ou desativá-lo — isso não é restrito a administradores
do espaço de trabalho.
Depois que o MCP estiver ativado para o espaço de trabalho, cada servidor MCP adicionado será um recurso próprio: o membro que o criar poderá compartilhá-lo individualmente com outros membros do espaço de trabalho, de forma semelhante ao compartilhamento de um agente ou documento da base de conhecimento.
Ativar essa configuração não substitui a restrição de modo de retenção zero e HIPAA mencionada acima.
Espaços de trabalho com o modo de retenção zero ou a conformidade com a HIPAA ativados não podem usar servidores MCP, independentemente
da configuração can_use_mcp_servers.
Primeiros passos
A ElevenLabs é compatível com servidores MCP que usam transporte SSE (Server-Sent Events) e HTTP streamable.
Neste exemplo, usaremos o Zapier MCP, que permite conectar o ElevenAgents a centenas de ferramentas e serviços.
Adicionar pelo painel
Adicionar pela API
Abra as integrações MCP
Acesse o painel de integrações de servidores MCP e clique em Adicionar servidor MCP personalizado.
Configure o servidor MCP
Insira os seguintes detalhes:
- Nome: O nome do servidor MCP (por exemplo, “Servidor MCP do Zapier”)
- Descrição: Uma descrição do que o servidor MCP pode fazer
- URL do servidor: A URL do servidor MCP. Se ela contiver uma chave secreta, trate-a como uma senha e armazene-a como um segredo do espaço de trabalho.
- Token secreto (opcional): Valor do cabeçalho de autorização
- Cabeçalhos HTTP (opcional): Quaisquer cabeçalhos adicionais exigidos pelo servidor
Modos de aprovação de ferramentas
A ElevenLabs oferece controles de aprovação flexíveis para gerenciar como os agentes solicitam permissão para usar ferramentas de servidores MCP. Você pode configurar as aprovações tanto no nível do servidor MCP quanto no nível de cada ferramenta para ter máximo controle de segurança.
Modos de aprovação disponíveis
- Sempre perguntar (recomendado): Máxima segurança. O agente solicitará sua permissão antes de cada uso de ferramenta.
- Aprovação detalhada de ferramentas: Desative e pré-selecione as ferramentas que podem ser executadas automaticamente e as que exigem aprovação.
- Sem aprovação: O assistente pode usar qualquer ferramenta sem aprovação.
Controle detalhado de ferramentas
O modo de aprovação detalhada de ferramentas permite configurar ferramentas individuais com requisitos de aprovação diferentes, dando a você controle preciso sobre quais ferramentas podem ser executadas automaticamente e quais exigem permissão explícita.
Para cada ferramenta, você pode definir:
- Aprovada automaticamente: A ferramenta é executada automaticamente sem exigir permissão
- Exige aprovação: A ferramenta exige permissão explícita antes da execução
- Desativada: A ferramenta fica completamente desativada e não pode ser usada
Use a aprovação detalhada de ferramentas para permitir que ferramentas de baixo risco e somente leitura sejam executadas automaticamente, enquanto exige aprovação para ferramentas que modificam dados ou realizam operações sensíveis.
Considerações importantes para a integração com a ElevenLabs
- Servidores externos: Você é responsável por selecionar os servidores MCP externos que deseja integrar. A ElevenLabs fornece os meios para se conectar a eles.
- Recursos compatíveis: A ElevenLabs é compatível com servidores MCP que se comunicam por transportes SSE (Server-Sent Events) e HTTP streamable para interações em tempo real.
- Ferramentas dinâmicas: As ferramentas e os recursos disponíveis em um servidor MCP integrado são definidos por esse servidor externo e podem mudar se a configuração do servidor for atualizada.
Segurança e aviso legal
Integrar servidores MCP externos pode expor seus agentes e dados a serviços de terceiros. É fundamental entender as implicações de segurança.
Ao ativar integrações de servidores MCP, você reconhece que isso pode envolver o compartilhamento de dados com serviços de terceiros não controlados pela ElevenLabs. Isso pode gerar riscos adicionais de segurança. Certifique-se de entender completamente as implicações, avaliar a segurança de qualquer servidor MCP que integrar e revisar nossas Diretrizes de segurança para integração MCP antes de continuar.
Consulte nossas Diretrizes de segurança para integração MCP para ver práticas recomendadas detalhadas.
Como encontrar ou criar servidores MCP
- Use servidores MCP disponíveis publicamente de provedores confiáveis
- Desenvolva seu próprio servidor MCP para disponibilizar seus dados ou ferramentas proprietários
- Explore a comunidade e os recursos do Model Context Protocol para ver exemplos e implementações de servidores
Recursos
- Exemplos de servidores MCP da Anthropic - Uma lista de servidores de exemplo da Anthropic
- Awesome Remote MCP Servers - Uma lista selecionada e de código aberto de servidores MCP remotos
- Diretório de servidores MCP remotos - Uma lista pesquisável de servidores MCP remotos