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



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.

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 Retell | Conector de Retell AI en Claude | Panel de Retell | |
|---|---|---|---|
| Dónde trabajas | Tu terminal o IDE | Un chat en Claude en la web o en Claude Desktop | Un navegador |
| Inicio de sesión | Una clave de API de Retell en una cabecera de la petición | Tu cuenta de Retell, mediante OAuth | Tu cuenta de Retell |
| A qué accede | Los endpoints de la API de Retell que permite tu clave, salvo los obsoletos | 52 herramientas específicas con widgets en el chat (a octubre de 2026) | Todos los ajustes |
| Tipos de agente | Los que admita la API | Solo agentes de prompt único | Todos |
| Ideal para | Desarrolladores, cambios masivos y todo lo que quieras automatizar con scripts o repetir | Crear y editar un agente describiéndolo | Flujos 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.

| Lo que pides | Lo que hace Claude Code a través del servidor MCP | Requiere tu aprobación |
|---|---|---|
| «Enumera mis agentes» | Lee los agentes y sus versiones | Riesgo bajo, solo lectura |
| «Crea un agente que...» | Escribe un prompt y crea el agente | Sí. Lee antes el prompt |
| «Escribe y ejecuta casos de prueba» | Crea casos de prueba de simulación, los ejecuta e informa de los fallos | Sí |
| «Asígnalo a mi número» | Enumera los números y asigna el agente | Sí. Comprueba qué agente sustituye |
| «Llama a mi teléfono» | Crea una llamada telefónica | Sí. 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 una | Riesgo bajo, pero las transcripciones pueden contener datos personales |
| «Elimina el agente antiguo» | Llama a un endpoint de eliminación | Sí. 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.
Descubre cuánto podría ahorrar tu empresa al pasar a agentes de voz impulsados por IA.
Tu envío se ha mandado a tu correo electrónico
Resultado del ROI
Total Human Agent Cost
AI Agent Cost
Estimated Savings
Estimate your monthly voice AI cost
Read Other Blogs
Revoluciona tu operación de llamadas con Retell

Empieza hoy a crear conversaciones más inteligentes.




