A Retell agora suporta o Model Context Protocol, ou MCP, para que você possa construir e gerenciar agentes de voz diretamente das ferramentas de IA que você já usa. Isso inclui clientes compatíveis com MCP como Cursor, Claude Desktop, Claude Code, ferramentas no estilo Codex e mais.
Com uma única conexão MCP, seu assistente pode trabalhar diretamente com a plataforma Retell para:
- criar e atualizar agentes
- iniciar chamadas
- gerenciar números de telefone
- anexar bases de conhecimento
- executar QA
Se você já usa a Retell pela nossa API ou SDKs, o MCP é a mesma plataforma por meio de uma interface mais simples e mais amigável para agentes.
O Que o Servidor MCP da Retell Pode Fazer
O Servidor MCP da Retell dá a você acesso direto à plataforma Retell. Em resumo, o Servidor MCP da Retell transforma o seu agente de IA em uma interface funcional para a sua pilha de voz, para que você possa de fato agir em todo o seu fluxo de trabalho de voz, como criar agentes, iniciar chamadas, atualizar números de telefone, gerenciar bases de conhecimento e executar QA, tudo a partir de uma conexão. E, mais especificamente, veja como ele pode ajudar:
Agentes
- Criar agentes
- Atualizar agentes
- Publicar versões
- Listar agentes
- Buscar versões
Chamadas
- Iniciar chamadas telefônicas e web
- Buscar detalhes da chamada
- Listar chamadas
- Atualizar metadados da chamada
- Excluir chamadas
- Executar QA e revisões
Números de Telefone
- Importar números
- Provisionar números
- Listar números
- Buscar detalhes do número
Base de Conhecimento
- Criar bases de conhecimento
- Anexar fontes
- Remover fontes
- Listar bases de conhecimento
Vozes
- Listar vozes
- Clonar vozes
- Pesquisar vozes da comunidade
Chats
- Criar chats
- Criar agentes de chat
- Encerrar chats
- Atualizar metadados do chat
Testes e QA
- Criar casos de teste
- Executar testes
- Listar execuções de QA
- Reexecutar QA
- Enviar pontuações
Alertas e Webhooks
- Criar regras de alerta
- Listar regras de alerta
- Listar incidentes
- Testar webhooks
Por Que Isso Importa
Construir IA de voz em produção ainda exige trocas de contexto demais. Em vez de ficar pulando entre o seu agente, o painel da Retell, a sua documentação, os scripts e as ferramentas de QA, o Servidor MCP da Retell traz esses fluxos de trabalho para uma única interface, para que você construa, teste e gerencie agentes de voz de forma mais rápida e fácil.
Como Funciona
A configuração é simples. Seu cliente MCP se conecta ao endpoint MCP hospedado da Retell por HTTP, autentica com a sua chave de API da Retell e chama as ferramentas. Ele também pode descobrir as ferramentas disponíveis automaticamente por meio de tools/list, incluindo:
- nome da ferramenta
- descrição
- esquema de entrada JSON
Então, em vez de programar cada ação de forma fixa, seu agente já sabe quais ferramentas da Retell existem e sabe como usá-las corretamente.
O Que Você Precisa para Começar
Certifique-se de ter:
- uma chave de API da Retell
- um cliente compatível com MCP como Cursor, Claude Desktop, Claude Code ou Codex
- a URL do servidor MCP da Retell: https://mcp.retellai.com
Formato de autenticação:
Authorization: Bearer <RETELL_API_KEY>
Configuração Simples
A maioria dos clientes MCP suporta servidores MCP remotos por HTTP.
Use:
- URL: https://mcp.retellai.com
- Header: Authorization: Bearer
Exemplo de Configuração
Cursor
Abra: Command Palette → Cursor Settings → MCP → Add new global MCP server
Adicione:
{
"mcpServers": {
"retell": {
"url": "https://mcp.retellai.com",
"headers": {
"Authorization": "Bearer <RETELL_API_KEY>"
}
}
}
}
Claude Desktop
Abra: Settings → Developer → Edit Config
Adicione:
{
"mcpServers": {
"retell": {
"command": "npx",
"args": [
"mcp-remote@latest",
"https://mcp.retellai.com",
"--header",
"Authorization:Bearer <RETELL_API_KEY>"
]
}
}
}
Claude Code
claude mcp add --transport http retell https://mcp.retellai.com --header "Authorization: Bearer <RETELL_API_KEY>"
Codex
Adicione isto a ~/.codex/config.toml:
[mcp_servers.retell]
url = "https://mcp.retellai.com"
bearer_token_env_var = "RETELL_API_KEY"
Então defina:
export RETELL_API_KEY="<RETELL_API_KEY>"
Outros Clientes MCP
Se o seu cliente suporta URLs e headers de MCP remoto, use:
- URL: https://mcp.retellai.com
- Header: Authorization: Bearer
Exemplos de Prompts
Uma vez conectado, seu assistente pode começar a trabalhar com a Retell na hora.
Experimente prompts como:
- "Liste meus agentes e resuma o que cada um faz."
- "Crie um novo agente para qualificação de vendas recebidas e o publique."
- "Mostre-me as últimas 20 chamadas e sinalize as que tiverem notas baixas de QA."
- "Crie uma base de conhecimento, anexe estas fontes e atualize meu agente para usá-la."
- "Importe este número de telefone e atribua-o ao meu agente."
- "Reexecute o QA nesta chamada e resuma os motivos da falha."
Agora, esta é a parte divertida em que o MCP pode realmente mostrar seu poder. Você não está mais apenas conversando com um assistente. Você está dando a ele acesso real à plataforma para que possa ajudá-lo a construir, testar, analisar e melhorar agentes de voz no próprio lugar.
Por Que as Equipes Vão Adorar
O Servidor MCP da Retell ajuda as equipes a:
- construir mais rápido sem sair do seu cliente de IA
- reduzir a sobrecarga de painel e API
- ir do protótipo à produção mais rápido
- executar QA e operações com menos trabalho manual
- manter a infraestrutura de voz mais perto das ferramentas que os desenvolvedores já usam
Para os desenvolvedores, reduz o trabalho manual de integração. Para as equipes de produto, acelera os testes e a iteração. Para as equipes de operações, facilita o gerenciamento de chamadas, QA e os fluxos de trabalho diários dos agentes.
Segurança e Uso Seguro
Conectar LLMs a ferramentas operacionais é enorme, mas também traz riscos. O maior risco é a injeção de prompt. Isso significa que conteúdo não confiável, como transcrições, mensagens de usuários ou documentos da base de conhecimento, pode incluir instruções ocultas que tentam fazer o modelo fazer algo que você não pediu. A maioria dos clientes MCP suporta "confirmar antes de executar ferramentas".
Mantenha isso ativado.
Melhores Práticas
Trate o MCP como dar ao seu assistente acesso real de operador.
Recomendamos:
- Use o menor privilégio — Crie chaves de API apenas com as permissões de que você precisa.
- Mantenha as chaves fora dos prompts — Armazene as chaves de API nas configurações do cliente ou em segredos. Nunca as cole no chat.
- Prefira fluxos de trabalho que leem primeiro — Busque o estado atual antes de atualizar ou excluir qualquer coisa.
- Revise ações destrutivas — Ações como excluir e publicar devem exigir uma intenção clara do usuário.
- Tenha cuidado com dados sensíveis — Registros de chamadas e transcrições podem conter PII. Exponha apenas o que você precisa.
- Use ambientes que não sejam de produção quando possível — Comece no desenvolvimento antes de conectar sistemas de produção.
Resolução de Problemas
Se algo não estiver funcionando, aqui estão as primeiras coisas a verificar.
As ferramentas não estão aparecendo
- Certifique-se de que a URL do servidor MCP está correta
- Confirme que o header Authorization está definido corretamente
- Verifique se o seu cliente consegue alcançar o endpoint MCP da Retell
401 Unauthorized
- Verifique se o seu header é
Authorization: Bearer <RETELL_API_KEY> - Certifique-se de que a sua chave de API está ativa e válida
Erros de chamada de ferramenta
- Tente novamente com uma entrada menor ou mais simples
- Verifique a mensagem de erro retornada para obter detalhes
- Muitos clientes MCP mostram erros de ferramenta estruturados diretamente, o que pode ajudar a identificar o problema
Comece a Construir com o MCP da Retell
O Servidor MCP da Retell facilita usar a Retell a partir das ferramentas de IA em que a sua equipe já trabalha. Isso significa menos troca entre ferramentas, iteração mais rápida e uma forma mais direta de construir e gerenciar agentes de voz em produção.
Se você já usa a Retell, o MCP dá a você um fluxo de trabalho mais rápido. Se você é novo na Retell, é uma das formas mais simples de começar. Conecte seu cliente. Adicione sua chave de API. Comece a construir. Vamos lá!
Precisa de Ajuda?
Se você tiver problemas ou quiser solicitar mais capacidades de MCP, entre em contato com support@retellai.com.
