Como criar um agente de voz com Claude Code e Claude Fable 5.2



O Claude Code consegue criar um agente de voz por telefone funcional direto do seu terminal. Você o conecta ao servidor MCP da Retell AI com um único comando e descreve o agente em linguagem natural. A partir daí, o Claude Code cria o agente, escreve casos de teste para ele e revisa as chamadas pela API da Retell. Este guia percorre esse ciclo com o Claude Fable 5.2, o modelo que a Anthropic lançou em 9 de novembro de 2026, e mostra o que você deve aprovar manualmente ao longo do caminho.
A Retell AI publica este guia, e o servidor MCP usado aqui é da própria Retell.
Como funciona a configuração
São três peças. O Claude Code roda no seu terminal e planeja o trabalho. O servidor MCP da Retell, em mcp.retellai.com, dá a ele acesso à API da Retell. O seu workspace da Retell guarda os agentes, números de telefone, testes e o histórico de chamadas sobre os quais a API atua.
O servidor MCP expõe três ferramentas, em vez de uma ferramenta por endpoint da API, o que mantém a lista de ferramentas pequena o bastante para a janela de contexto do modelo. O Claude Code as usa em sequência: lista os endpoints disponíveis, lê o schema de entrada do endpoint de que precisa e, então, o invoca. Se uma chamada incluir um argumento que não está no schema, o servidor retorna um erro indicando o argumento e não chama a API.

Um ponto a esclarecer antes de começar: o Claude Fable 5.2 é o modelo que faz a construção, não o modelo que fala ao telefone. O agente que você cria atende as chamadas com um modelo da lista da própria Retell, e o Fable 5.2 não está nessa lista em 10 de novembro de 2026. (A lista inclui o modelo próprio da Retell, o Tell-1.) Abordamos essa divisão em Claude Fable 5.2 para agentes de voz: onde ele se encaixa e onde não.
Três formas de criar um agente da Retell com o Claude
O Claude Code com o servidor MCP é um de três caminhos. Cada um atende a um perfil diferente.
| Claude Code + servidor MCP da Retell | Conector da Retell AI no Claude | Painel da Retell | |
|---|---|---|---|
| Onde você trabalha | No seu terminal ou IDE | Em um chat no Claude na web ou no Claude Desktop | Em um navegador |
| Login | Uma chave de API da Retell em um cabeçalho da requisição | Seu login da Retell, via OAuth | Seu login da Retell |
| O que alcança | Os endpoints da API da Retell que sua chave permite, exceto os descontinuados | 52 ferramentas específicas com widgets no chat (em outubro de 2026) | Todas as configurações |
| Tipos de agente | Tudo o que a API suporta | Apenas agentes de prompt único | Todos |
| Ideal para | Desenvolvedores, alterações em massa, tudo o que você quer automatizar por script ou repetir | Criar e editar um agente descrevendo-o | Fluxos de conversa, integrações, revisão visual |
Fontes: documentação do servidor MCP e documentação do conector para Claude da Retell, consultadas em 10 de novembro de 2026.
Conecte o Claude Code ao servidor MCP da Retell
Você precisa de uma conta na Retell, uma chave de API da Retell e o Claude Code instalado. Crie a chave no painel da Retell e conceda a ela apenas as permissões necessárias para este trabalho.
Execute isto no seu terminal, substituindo o placeholder pela sua chave:
claude mcp add --transport http retell https://mcp.retellai.com \
--header "Authorization: Bearer <RETELL_API_KEY>"Inicie o Claude Code e execute /mcp para confirmar que o servidor retell está conectado. Depois, execute /model e escolha o Claude Fable 5.2, se o seu plano incluir esse modelo. A documentação do Claude Code informa que o Fable 5.2 exige o Claude Code v2.1.321 ou posterior, e o post de lançamento da Anthropic diz que desenvolvedores podem chamar o modelo na Claude Platform como claude-fable-5-2.
Mantenha a chave fora da conversa. Ela deve ficar no comando acima ou nas configurações do seu cliente, nunca colada em um prompt.
Descreva o agente e deixe o Claude Code criá-lo
Comece com uma leitura, para ver a conexão funcionando antes de qualquer alteração:
Liste meus agentes da Retell e resuma o que cada um faz.Em seguida, descreva o agente que você quer. Seja específico sobre a função, o tom, o que ele nunca deve fazer e quando deve passar a chamada para uma pessoa:
Crie um agente de voz de prompt único para uma clínica odontológica chamada
Northside Dental. Ele responde dúvidas sobre horários e convênios,
agenda limpezas e transfere dúvidas de cobrança para a recepção
no +14155550123. Ele deve dizer que é um assistente de IA no início
de cada chamada. Use o Claude 5.5 Sonnet como modelo do agente. Mostre-me
o prompt antes de criar qualquer coisa.O Claude Code rascunha o prompt, consulta o schema dos endpoints de que precisa e pede que você aprove cada chamada à API. Leia o prompt que ele escreveu antes de aprovar. É aqui que um modelo mais forte faz diferença: o prompt é o agente, e um prompt vago gera uma chamada vaga.
Escreva os casos de teste antes de fazer uma chamada
Os testes de simulação da Retell executam seu agente em uma conversa por texto com um interlocutor simulado por IA e avaliam cada execução como aprovada ou reprovada com base nos critérios de sucesso que você define. Eles funcionam com agentes de prompt único, de múltiplos prompts e de fluxo de conversa, e não fazem nenhuma chamada. Peça ao Claude Code para escrever a suíte:
Escreva oito casos de teste de simulação para o agente da Northside Dental.
Cubra um novo paciente agendando uma limpeza, alguém que interrompe e
muda o dia duas vezes, uma dúvida de cobrança que precisa ser transferida,
alguém perguntando se está falando com uma pessoa de verdade e alguém
pedindo um conselho médico que o agente deve se recusar a dar. Dê a cada
um critérios de sucesso claros. Depois, execute-os e mostre as falhas.Os casos salvos se tornam uma suíte de regressão. Sempre que o prompt mudar, execute-os novamente antes que a alteração chegue a quem liga.
Coloque o agente em um número e ligue para o seu próprio telefone
A simulação cobre a lógica. Uma chamada real cobre a voz, o ritmo e as interrupções. Peça ao Claude Code para listar seus números de telefone, atribuir o agente a um deles e ligar para você:
Mostre meus números de telefone da Retell e qual agente está em cada um. Coloque o
agente da Northside Dental no número que não tem agente e depois faça-o
me ligar no +14155550199.Três cuidados. A chamada chega a um telefone real e é cobrada como qualquer outra, então confira o número de destino no pedido de aprovação. Chamadas de saída também exigem KYC na sua conta da Retell. E, se um número já tiver um agente, substituí-lo muda quem atende aquele número, então verifique o que está lá primeiro.
Revise as chamadas e ajuste o prompt
Depois de algumas chamadas, peça ao Claude Code para analisá-las:
Busque as últimas 20 chamadas do agente da Northside Dental. Agrupe as
que terminaram mal por causa, cite o turno em que cada uma deu
errado e proponha mudanças no prompt. Não altere nada ainda.Aprove as mudanças no prompt com as quais você concorda, execute novamente a suíte de simulação e publique. Esse ciclo de criar, testar, ligar, revisar e ajustar é todo o trabalho, e é a parte que o Claude Code mais encurta.

| O que você pede | O que o Claude Code faz pelo servidor MCP | Precisa da sua aprovação |
|---|---|---|
| "Liste meus agentes" | Lê os agentes e suas versões | Baixo risco, somente leitura |
| "Crie um agente que..." | Escreve um prompt e cria o agente | Sim. Leia o prompt primeiro |
| "Escreva e execute casos de teste" | Cria casos de teste de simulação, executa-os e relata as falhas | Sim |
| "Coloque no meu número" | Lista os números e atribui o agente | Sim. Verifique qual agente será substituído |
| "Ligue para o meu telefone" | Cria uma chamada telefônica | Sim. Confira o número de destino |
| "Revise as chamadas recentes" | Lista as chamadas e lê a transcrição, a latência e a análise pós-chamada de cada uma | Baixo risco, mas as transcrições podem conter dados pessoais |
| "Exclua o agente antigo" | Chama um endpoint de exclusão | Sim. Trate a exclusão como permanente |
Quais aprovações manter ativas
Toda chamada à API feita pelo Claude Code passa por uma única ferramenta, invoke_api_endpoint. Se você optar por sempre permitir essa ferramenta, estará permitindo todos os endpoints que sua chave alcança, incluindo exclusão e publicação. A documentação da Retell recomenda aprovar cada chamada separadamente, verificando o endpoint e os argumentos, e nós não pularíamos essa etapa.
- Use uma chave com o mínimo de permissões necessário para a tarefa. Uma chave somente leitura basta para revisar chamadas.
- Leia antes de escrever. Peça ao Claude Code para buscar o agente atual antes de atualizá-lo ou excluí-lo.
- Trate as transcrições como texto não confiável. Quem liga pode dizer qualquer coisa, inclusive instruções direcionadas ao modelo. Não deixe uma sessão de revisão de chamadas ter também aprovação para alterar agentes sem que você confira.
- Evite dados pessoais sempre que possível. Peça resumos das falhas, e não transcrições completas, a menos que você precise delas.
Precisa ser o Claude Fable 5.2?
Não. O servidor MCP funciona com qualquer modelo que o Claude Code consiga executar, e a própria Anthropic é direta no post de lançamento: "Para a maioria das tarefas de programação e de conhecimento, recomendamos que os usuários comecem com o Claude Opus 5.5, nosso modelo mais forte para o dia a dia." Ela descreve o Fable e o Mythos como modelos criados para o trabalho técnico mais ambicioso e aberto.
Para um agente com um prompt curto, o Opus 5.5 dá conta do recado. Vale escolher o Fable 5.2 quando a tarefa é grande e aberta: reescrever prompts de dezenas de agentes para um novo padrão, transformar um mês de chamadas com falha em uma suíte de regressão ou migrar agentes entre workspaces mantendo o mesmo comportamento. Essas são avaliações nossas, não resultados de benchmark. A Anthropic cobra US$ 8 por milhão de tokens de entrada e US$ 40 por milhão de tokens de saída pelo Fable 5.2 em sua plataforma.
Perguntas frequentes
O Claude Code pode se conectar à Retell AI?
Sim. A Retell mantém um servidor MCP hospedado em mcp.retellai.com, e o Claude Code se conecta a ele com o comando claude mcp add e uma chave de API da Retell no cabeçalho Authorization. Cursor, Claude Desktop, Codex e outros clientes MCP podem se conectar ao mesmo servidor.
Preciso do Claude Fable 5.2 para usar o servidor MCP da Retell?
Não. O servidor funciona com qualquer modelo que o seu cliente MCP execute. A Anthropic recomenda começar com o Claude Opus 5.5 para a maioria das tarefas de programação e de conhecimento e posiciona o Fable 5.2 para o trabalho técnico mais ambicioso e aberto.
O próprio agente de voz pode rodar no Claude Fable 5.2?
Não pela lista de modelos da Retell, em 10 de novembro de 2026. O agente atende as chamadas com um modelo que você escolhe nessa lista, que inclui o Claude 5.5 Opus, o Claude 5.5 Sonnet e o Claude 5.5 Haiku. O Fable 5.2 cuida da criação, dos testes e da revisão a partir do Claude Code.
Qual é a diferença entre o servidor MCP da Retell e o conector da Retell AI para o Claude?
O servidor MCP faz login com uma chave de API da Retell e acessa a API da Retell a partir de clientes como o Claude Code e o Cursor. O conector está listado no diretório de conectores do Claude, faz login com seu login da Retell via OAuth e mostra as etapas de criação, implantação e teste como widgets dentro do chat. O conector cria apenas agentes de prompt único.
É seguro deixar o Claude Code gerenciar minha conta da Retell?
É tão seguro quanto a chave e as aprovações que você concede. Use uma chave com o mínimo de permissões, mantenha a aprovação por chamada ativa para invoke_api_endpoint e revise qualquer chamada a um endpoint de exclusão ou publicação antes de aprová-la.
Testar pelo Claude Code custa dinheiro?
O uso pelo servidor MCP é uso da API da Retell, então as chamadas que ele faz são cobradas como qualquer outra chamada. A página de preços de testes da Retell explica quanto custam os testes, e o uso do Claude Code é cobrado pela Anthropic, de acordo com o seu plano do Claude, créditos de uso ou tarifas de API, dependendo de como você faz login.
Crie um agente e teste-o nas suas próprias chamadas
Segundo dados da plataforma da Retell, 80% dos minutos em produção passam por agentes que os próprios clientes criam e gerenciam. O Claude Code torna esse ciclo mais curto. Siga a configuração do servidor MCP, crie um agente na Retell e avalie-o nas suas próprias chamadas antes de decidir qualquer outra coisa.
Veja quanto seu negócio poderia economizar ao migrar para agentes de voz com IA.
Your submission has been sent to your email
Resultado do ROI
Total Human Agent Cost
AI Agent Cost
Estimated Savings
Estimate your monthly voice AI cost
Read Other Blogs
Revolucione sua operação de chamadas com a Retell

Comece hoje a criar conversas mais inteligentes.




