Blogs
/
Cómo crear un agente de voz con Claude Code y Claude Fable 5.2

Cómo crear un agente de voz con Claude Code y Claude Fable 5.2

Retell
AI Voice Agent Platform
Published 
November 17, 2026
9
 min read
Cómo crear un agente de voz con Claude Code y Claude Fable 5.2
About this article
Conecta Claude Code al servidor MCP de Retell AI con un solo comando y deja que Claude Fable 5.2 cree, pruebe y revise un agente telefónico desde tu terminal.
VOLVER A LOS BLOGS
See Retell AI in action
Start free
Volver arriba

Claude Code puede crear un agente telefónico funcional desde tu terminal. Lo conectas al servidor MCP de Retell AI con un solo comando, describes el agente en lenguaje natural y Claude Code lo crea, escribe casos de prueba para él y revisa sus llamadas a través de la API de Retell. Esta guía recorre ese ciclo con Claude Fable 5.2, el modelo que Anthropic lanzó el 9 de noviembre de 2026, y explica qué debes aprobar manualmente por el camino.

Retell AI publica esta guía, y el servidor MCP que utiliza es propiedad de Retell.

Cómo es la configuración

Intervienen tres piezas. Claude Code se ejecuta en tu terminal y planifica el trabajo. El servidor MCP de Retell, en mcp.retellai.com, le da acceso a la API de Retell. Tu espacio de trabajo de Retell contiene los agentes, números de teléfono, pruebas e historial de llamadas sobre los que actúa la API.

El servidor MCP expone tres herramientas en lugar de una por cada endpoint de la API, lo que mantiene la lista de herramientas lo bastante reducida para la ventana de contexto del modelo. Claude Code las usa en orden: enumera los endpoints disponibles, lee el esquema de entrada del que necesita y, después, lo invoca. Si una llamada incluye un argumento que no está en el esquema, el servidor devuelve un error que indica el argumento y no llama a la API.

Diagrama de cómo Claude Code llega a un espacio de trabajo de Retell. A la izquierda, Claude Code en tu terminal, con el modelo Claude Fable 5.2, lee tu petición en lenguaje natural, planifica qué endpoints de Retell necesita y te pide que apruebes cada llamada. Se conecta mediante MCP sobre HTTP, con la clave de API en la cabecera Authorization, al servidor MCP de Retell en mcp.retellai.com, que tiene tres herramientas que se usan en orden: list_api_endpoints encuentra el endpoint adecuado, get_api_endpoint_schema lee el esquema de entrada de ese endpoint e invoke_api_endpoint comprueba los argumentos con el esquema y luego llama a la API de Retell. La API de Retell actúa sobre tu espacio de trabajo de Retell: agentes, números de teléfono, bases de conocimiento, voces, pruebas y llamadas. El agente atiende las llamadas con un modelo de la lista de Retell, no con Fable 5.2.
Claude Code planifica el trabajo y el servidor MCP de Retell realiza cada llamada a la API después de que la apruebes. Diagrama de Retell AI, noviembre de 2026, basado en la documentación del servidor MCP de Retell.

Una cosa que conviene aclarar antes de empezar: Claude Fable 5.2 es el modelo que construye, no el modelo que habla por teléfono. El agente que crees atiende las llamadas con un modelo de la propia lista de Retell, y Fable 5.2 no figura en esa lista a 10 de noviembre de 2026. (La lista sí incluye el modelo propio de Retell, Tell-1.) Tratamos esa división en Claude Fable 5.2 para agentes de voz: dónde encaja y dónde no.

Tres formas de crear un agente de Retell con Claude

Claude Code con el servidor MCP es una de las tres vías. Cada una se adapta a perfiles distintos.

Claude Code + servidor MCP de RetellConector de Retell AI en ClaudePanel de Retell
Dónde trabajasTu terminal o IDEUn chat en Claude en la web o en Claude DesktopUn navegador
Inicio de sesiónUna clave de API de Retell en una cabecera de la peticiónTu cuenta de Retell, mediante OAuthTu cuenta de Retell
A qué accedeLos endpoints de la API de Retell que permite tu clave, salvo los obsoletos52 herramientas específicas con widgets en el chat (a octubre de 2026)Todos los ajustes
Tipos de agenteLos que admita la APISolo agentes de prompt únicoTodos
Ideal paraDesarrolladores, cambios masivos y todo lo que quieras automatizar con scripts o repetirCrear y editar un agente describiéndoloFlujos de conversación, integraciones, revisión visual

Fuentes: documentación del servidor MCP y documentación del conector de Claude de Retell, consultadas el 10 de noviembre de 2026.

Conecta Claude Code al servidor MCP de Retell

Necesitas una cuenta de Retell, una clave de API de Retell y Claude Code instalado. Crea la clave en el panel de Retell y concédele solo los permisos que requiere este trabajo.

Ejecuta esto en tu terminal, sustituyendo el marcador por tu clave:

claude mcp add --transport http retell https://mcp.retellai.com \
  --header "Authorization: Bearer <RETELL_API_KEY>"

Inicia Claude Code y ejecuta /mcp para confirmar que el servidor retell está conectado. Después ejecuta /model y elige Claude Fable 5.2 si tu plan lo incluye. La documentación de Claude Code indica que Fable 5.2 requiere Claude Code v2.1.321 o posterior, y la publicación de lanzamiento de Anthropic señala que los desarrolladores pueden llamar al modelo en Claude Platform como claude-fable-5-2.

Mantén la clave fuera de la conversación. Debe ir en el comando anterior o en los ajustes de tu cliente, nunca pegada en un prompt.

Describe el agente y deja que Claude Code lo cree

Empieza con una lectura, para comprobar que la conexión funciona antes de cambiar nada:

Enumera mis agentes de Retell y resume qué hace cada uno.

Después describe el agente que quieres. Sé concreto sobre su función, el tono, lo que nunca debe hacer y cuándo pasa la llamada a una persona:

Crea un agente de voz de prompt único para una clínica dental llamada
Northside Dental. Responde preguntas sobre horarios y seguros,
concierta citas de limpieza y transfiere las consultas de facturación
a recepción en el +14155550123. Debe decir que es un asistente de IA
al inicio de cada llamada. Usa Claude 5.5 Sonnet como modelo del agente.
Muéstrame el prompt antes de crear nada.

Claude Code redacta el prompt, consulta el esquema de los endpoints que necesita y te pide que apruebes cada llamada a la API. Lee el prompt que ha escrito antes de aprobar. Aquí es donde un modelo más potente demuestra su valor: el prompt es el agente, y uno vago produce una llamada vaga.

Escribe los casos de prueba antes de hacer una llamada

Las pruebas de simulación de Retell ejecutan tu agente en una conversación de texto frente a un interlocutor simulado por IA y califican cada ejecución como superada o fallida según los criterios de éxito que definas. Funcionan con agentes de prompt único, multiprompt y de flujo de conversación, y no realizan ninguna llamada. Pide a Claude Code que escriba la batería de pruebas:

Escribe ocho casos de prueba de simulación para el agente de Northside Dental.
Incluye un paciente nuevo que reserva una limpieza, un interlocutor que interrumpe
y cambia el día dos veces, una consulta de facturación que debe transferirse,
alguien que pregunta si está hablando con una persona real y alguien que pide
un consejo médico que el agente debe negarse a dar. Asigna a cada uno
criterios de éxito claros. Después ejecútalos y muéstrame los fallos.

Los casos guardados se convierten en una batería de regresión. Cada vez que cambie el prompt, vuelve a ejecutarlos antes de que el cambio llegue a quien llama.

Asigna el agente a un número y llama a tu propio teléfono

La simulación cubre la lógica. Una llamada real cubre la voz, el ritmo y las interrupciones. Pide a Claude Code que enumere tus números de teléfono, asigne el agente a uno y te llame:

Muéstrame mis números de teléfono de Retell y qué agente tiene cada uno.
Asigna el agente de Northside Dental al que no tenga agente y luego
haz que me llame al +14155550199.

Tres precauciones. Una llamada llega a un teléfono real y se factura como cualquier otra llamada, así que comprueba el número de destino en la solicitud de aprobación. Las llamadas salientes también requieren KYC en tu cuenta de Retell. Y si un número ya tiene un agente asignado, sustituirlo cambia quién atiende ese número, así que comprueba primero qué hay.

Revisa las llamadas y ajusta el prompt

Tras unas cuantas llamadas, haz que Claude Code las revise:

Recupera las últimas 20 llamadas del agente de Northside Dental. Agrupa
las que terminaron mal por causa, cita el turno en el que cada una se torció
y propón cambios en el prompt. No cambies nada todavía.

Aprueba los cambios de prompt con los que estés de acuerdo, vuelve a ejecutar la batería de simulación y publica. Ese ciclo de crear, probar, llamar, revisar y ajustar es todo el trabajo, y es la parte que Claude Code más acorta.

Diagrama del ciclo de cuatro etapas que Claude Code ejecuta sobre un agente de Retell, cada una con una petición de ejemplo, lo que hace Claude Code y lo que hay que comprobar. Uno, crear el agente: Claude Code escribe el prompt y crea el agente; lee el prompt antes de aprobar. Dos, probar sin llamada: crea casos de prueba de simulación calificados y los ejecuta como conversaciones de texto; comprueba que los criterios de éxito reflejan lo que te importa. Tres, llamar a tu propio teléfono: asigna el agente a un número y realiza una llamada; comprueba el número de destino y qué agente se sustituye. Cuatro, revisar las llamadas: lee las llamadas y el análisis posterior a la llamada y redacta cambios; aprueba solo los cambios con los que estés de acuerdo. Una flecha punteada vuelve de la etapa cuatro a la uno, con la etiqueta ajusta el prompt, vuelve a ejecutar los casos de prueba, publica.
El ciclo de crear, probar, llamar y revisar, con la comprobación que debes hacer en cada etapa. Diagrama de Retell AI, noviembre de 2026, basado en la documentación del servidor MCP y de las pruebas de simulación de Retell.
Lo que pidesLo que hace Claude Code a través del servidor MCPRequiere tu aprobación
«Enumera mis agentes»Lee los agentes y sus versionesRiesgo bajo, solo lectura
«Crea un agente que...»Escribe un prompt y crea el agenteSí. Lee antes el prompt
«Escribe y ejecuta casos de prueba»Crea casos de prueba de simulación, los ejecuta e informa de los fallosSí
«Asígnalo a mi número»Enumera los números y asigna el agenteSí. Comprueba qué agente sustituye
«Llama a mi teléfono»Crea una llamada telefónicaSí. Comprueba el número de destino
«Revisa las llamadas recientes»Enumera las llamadas y lee la transcripción, la latencia y el análisis posterior a la llamada de cada unaRiesgo bajo, pero las transcripciones pueden contener datos personales
«Elimina el agente antiguo»Llama a un endpoint de eliminaciónSí. Considera la eliminación como permanente

Qué aprobaciones mantener activadas

Todas las llamadas a la API desde Claude Code pasan por una sola herramienta, invoke_api_endpoint. Si eliges permitir siempre esa herramienta, permites todos los endpoints a los que llega tu clave, incluidos los de eliminación y publicación. La documentación de Retell recomienda aprobar cada llamada por separado y revisar su endpoint y sus argumentos, y nosotros no nos saltaríamos ese paso.

  • Usa una clave con los mínimos permisos necesarios. Una clave de solo lectura basta para revisar llamadas.
  • Lee antes de escribir. Haz que Claude Code obtenga el agente actual antes de actualizarlo o eliminarlo.
  • Trata las transcripciones como texto no fiable. Quien llama puede decir cualquier cosa, incluidas instrucciones dirigidas al modelo. No permitas que una sesión de revisión de llamadas tenga también aprobación para cambiar agentes sin que lo revises.
  • Evita los datos personales siempre que puedas. Pide resúmenes de los fallos, no transcripciones completas, salvo que las necesites.

¿Tiene que ser Claude Fable 5.2?

No. El servidor MCP funciona con cualquier modelo que pueda ejecutar Claude Code, y el propio consejo de Anthropic en la publicación de lanzamiento es directo: «Para la mayoría de las tareas de programación y de conocimiento, recomendamos que los usuarios empiecen con Claude Opus 5.5, nuestro modelo más potente para el día a día». Describe Fable y Mythos como modelos creados para el trabajo técnico más ambicioso y abierto.

Para un solo agente con un prompt corto, Opus 5.5 cumple. Merece la pena elegir Fable 5.2 cuando el trabajo es grande y abierto: reescribir los prompts de decenas de agentes conforme a un nuevo estándar, convertir un mes de llamadas fallidas en una batería de regresión o migrar agentes entre espacios de trabajo manteniendo el mismo comportamiento. Son valoraciones nuestras, no resultados de benchmarks. Anthropic fija el precio de Fable 5.2 en $8 por millón de tokens de entrada y $40 por millón de tokens de salida en su plataforma.

Preguntas frecuentes

¿Puede Claude Code conectarse a Retell AI?

Sí. Retell ofrece un servidor MCP alojado en mcp.retellai.com, y Claude Code se conecta a él con el comando claude mcp add y una clave de API de Retell en la cabecera Authorization. Cursor, Claude Desktop, Codex y otros clientes MCP pueden conectarse al mismo servidor.

¿Necesito Claude Fable 5.2 para usar el servidor MCP de Retell?

No. El servidor funciona con el modelo que ejecute tu cliente MCP. Anthropic recomienda empezar con Claude Opus 5.5 para la mayoría de las tareas de programación y de conocimiento, y posiciona Fable 5.2 para el trabajo técnico más ambicioso y abierto.

¿Puede el propio agente de voz funcionar con Claude Fable 5.2?

No desde la lista de modelos de Retell a 10 de noviembre de 2026. El agente atiende las llamadas con un modelo que eliges de esa lista, que incluye Claude 5.5 Opus, Claude 5.5 Sonnet y Claude 5.5 Haiku. Fable 5.2 se encarga de crear, probar y revisar desde Claude Code.

¿Qué diferencia hay entre el servidor MCP de Retell y el conector de Retell AI para Claude?

El servidor MCP inicia sesión con una clave de API de Retell y accede a la API de Retell desde clientes como Claude Code y Cursor. El conector figura en el directorio de conectores de Claude, inicia sesión con tu cuenta de Retell mediante OAuth y muestra los pasos de creación, despliegue y prueba como widgets dentro del chat. El conector solo crea agentes de prompt único.

¿Es seguro dejar que Claude Code gestione mi cuenta de Retell?

Es tan seguro como la clave y las aprobaciones que le des. Usa una clave con los permisos mínimos, mantén activada la aprobación por llamada para invoke_api_endpoint y revisa cualquier llamada a un endpoint de eliminación o publicación antes de aprobarla.

¿Las pruebas a través de Claude Code cuestan dinero?

El uso a través del servidor MCP es uso de la API de Retell, así que las llamadas que realiza se facturan como cualquier otra llamada. La página de precios de las pruebas de Retell detalla lo que cuestan las pruebas, y el uso de Claude Code lo factura Anthropic, según tu plan de Claude, tus créditos de uso o las tarifas de la API, en función de cómo inicies sesión.

Crea un agente y ponlo a prueba con tus propias llamadas

Según los datos de la plataforma de Retell, el 80 % de los minutos en producción pasan por agentes que los clientes crean y gestionan por sí mismos. Claude Code acorta ese ciclo. Sigue la configuración del servidor MCP, crea un agente en Retell y evalúalo con tus propias llamadas antes de decidir nada más.

Calculadora de ROI
Estima tu ROI al automatizar las llamadas

Descubre cuánto podría ahorrar tu empresa al pasar a agentes de voz impulsados por IA.

¡Listo! 
Tu envío se ha mandado a tu correo electrónico
¡Vaya! Algo salió mal al enviar el formulario.
   1
   8
20
¡Vaya! Algo salió mal al enviar el formulario.

Resultado del 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

Revoluciona tu operación de llamadas con Retell