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

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

Retell
AI Voice Agent Platform
Published 
November 17, 2026
9
 min read
Como criar um agente de voz com Claude Code e Claude Fable 5.2
About this article
Conecte o Claude Code ao servidor MCP da Retell AI com um comando e deixe o Claude Fable 5.2 criar, testar e revisar um agente de voz por telefone no seu terminal.
VOLTAR PARA BLOGS
See Retell AI in action
Start free
Voltar ao topo

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.

Diagrama de como o Claude Code chega a um workspace da Retell. À esquerda, o Claude Code no seu terminal, executando o modelo Claude Fable 5.2, lê o seu pedido em linguagem natural, planeja quais endpoints da Retell são necessários e pede que você aprove cada chamada. Ele se conecta via MCP sobre HTTP, com a chave de API no cabeçalho Authorization, ao servidor MCP da Retell em mcp.retellai.com, que tem três ferramentas usadas em sequência: list_api_endpoints encontra o endpoint para a tarefa, get_api_endpoint_schema lê o schema de entrada desse endpoint e invoke_api_endpoint verifica os argumentos em relação ao schema e então chama a API da Retell. A API da Retell atua sobre o seu workspace da Retell: agentes, números de telefone, bases de conhecimento, vozes, testes e chamadas. O agente atende as chamadas com um modelo da lista da Retell, não com o Fable 5.2.
O Claude Code planeja o trabalho e o servidor MCP da Retell faz cada chamada à API depois que você aprova. Diagrama da Retell AI, novembro de 2026, com base na documentação do servidor MCP da Retell.

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 RetellConector da Retell AI no ClaudePainel da Retell
Onde você trabalhaNo seu terminal ou IDEEm um chat no Claude na web ou no Claude DesktopEm um navegador
LoginUma chave de API da Retell em um cabeçalho da requisiçãoSeu login da Retell, via OAuthSeu login da Retell
O que alcançaOs endpoints da API da Retell que sua chave permite, exceto os descontinuados52 ferramentas específicas com widgets no chat (em outubro de 2026)Todas as configurações
Tipos de agenteTudo o que a API suportaApenas agentes de prompt únicoTodos
Ideal paraDesenvolvedores, alterações em massa, tudo o que você quer automatizar por script ou repetirCriar e editar um agente descrevendo-oFluxos 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.

Diagrama do ciclo de quatro etapas que o Claude Code executa em um agente da Retell, cada etapa com um exemplo de pedido, o que o Claude Code faz e o que verificar. Um, criar o agente: o Claude Code escreve o prompt e cria o agente; leia o prompt antes de aprovar. Dois, testar sem chamada: ele cria casos de teste de simulação avaliados e os executa como conversas por texto; verifique se os critérios de sucesso correspondem ao que importa para você. Três, ligar para o seu próprio telefone: ele atribui o agente a um número e faz uma chamada; confira o número de destino e qual agente é substituído. Quatro, revisar as chamadas: ele lê as chamadas e a análise pós-chamada e rascunha mudanças; aprove apenas as mudanças com as quais você concorda. Uma seta pontilhada volta da etapa quatro para a etapa um, com o rótulo ajuste o prompt, execute novamente os casos de teste, publique.
O ciclo de criar, testar, ligar e revisar, com a verificação a fazer em cada etapa. Diagrama da Retell AI, novembro de 2026, com base na documentação do servidor MCP e dos testes de simulação da Retell.
O que você pedeO que o Claude Code faz pelo servidor MCPPrecisa da sua aprovação
"Liste meus agentes"Lê os agentes e suas versõesBaixo risco, somente leitura
"Crie um agente que..."Escreve um prompt e cria o agenteSim. Leia o prompt primeiro
"Escreva e execute casos de teste"Cria casos de teste de simulação, executa-os e relata as falhasSim
"Coloque no meu número"Lista os números e atribui o agenteSim. Verifique qual agente será substituído
"Ligue para o meu telefone"Cria uma chamada telefônicaSim. 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 umaBaixo risco, mas as transcrições podem conter dados pessoais
"Exclua o agente antigo"Chama um endpoint de exclusãoSim. 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.

Calculadora de ROI
Estime Seu ROI ao Automatizar as Chamadas

Veja quanto seu negócio poderia economizar ao migrar para agentes de voz com IA.

All done! 
Your submission has been sent to your email
Ops! Algo deu errado ao enviar o formulário.
   1
   8
20
Ops! Algo deu errado ao enviar o formulário.

Resultado do ROI

2,000

Total Human Agent Cost

$5,000
/month

AI Agent Cost

$3,000
/month

Estimated Savings

$2,000
/month

Estimate your monthly voice AI cost

$  0.11
Thank you! Your submission has been received!
Oops! Something went wrong while submitting the form.
Estimated monthly cost
$1,408
12,800 conversation minutes

Revolucione sua operação de chamadas com a Retell