Te presentamos el Retell MCP Server

Retell ya es compatible con el Model Context Protocol, o MCP, para que puedas crear y gestionar agentes de voz directamente desde las herramientas de IA que ya usas. Eso incluye clientes compatibles con MCP como Cursor, Claude Desktop, Claude Code, herramientas tipo Codex y más.

Con una sola conexión MCP, tu asistente puede trabajar directamente con la plataforma de Retell para:

• crear y actualizar agentes
• lanzar llamadas
• gestionar números de teléfono
• adjuntar bases de conocimiento
• ejecutar QA

Si ya usas Retell a través de nuestra API o nuestros SDK, MCP es la misma plataforma a través de una interfaz más sencilla y más amigable para agentes.

Qué puede hacer el Retell MCP Server

El Retell MCP Server te da acceso directo a la plataforma de Retell. En resumen, el Retell MCP Server convierte tu agente de IA en una interfaz operativa para tu pila de voz, de modo que puedas pasar realmente a la acción en todo tu flujo de trabajo de voz: crear agentes, lanzar llamadas, actualizar números de teléfono, gestionar bases de conocimiento y ejecutar QA, todo desde una sola conexión. Y, más concretamente, así es como puede ayudarte:

Agentes

• Crear agentes
• Actualizar agentes
• Publicar versiones
• Listar agentes
• Obtener versiones

Llamadas

• Iniciar llamadas telefónicas y web
• Obtener detalles de las llamadas
• Listar llamadas
• Actualizar los metadatos de las llamadas
• Eliminar llamadas
• Ejecutar QA y revisiones

Números de teléfono

• Importar números
• Aprovisionar números
• Listar números
• Obtener detalles de los números

Base de conocimiento

• Crear bases de conocimiento
• Adjuntar fuentes
• Eliminar fuentes
• Listar bases de conocimiento

Voces

• Listar voces
• Clonar voces
• Buscar voces de la comunidad

Chats

• Crear chats
• Crear agentes de chat
• Finalizar chats
• Actualizar los metadatos de los chats

Pruebas y QA

• Crear casos de prueba
• Ejecutar pruebas
• Listar ejecuciones de QA
• Reejecutar QA
• Enviar puntuaciones

Alertas y webhooks

• Crear reglas de alerta
• Listar reglas de alerta
• Listar incidencias
• Probar webhooks

Por qué esto importa

Crear IA de voz en producción todavía exige demasiados cambios de contexto. En lugar de saltar entre tu agente, el panel de Retell, tu documentación, tus scripts y tus herramientas de QA, el Retell MCP Server reúne esos flujos de trabajo en una única interfaz para que puedas crear, probar y gestionar agentes de voz de forma más rápida y sencilla.

Cómo funciona

La configuración es sencilla. Tu cliente MCP se conecta al endpoint MCP alojado de Retell por HTTP, se autentica con tu clave de API de Retell y llama a las herramientas. También puede descubrir las herramientas disponibles automáticamente mediante tools/list, incluyendo:

• nombre de la herramienta
• descripción
• esquema de entrada JSON

Así, en lugar de codificar a mano cada acción, tu agente ya sabe qué herramientas de Retell existen y sabe cómo usarlas correctamente.

Qué necesitas para empezar

Asegúrate de tener:

• una clave de API de Retell
• un cliente compatible con MCP como Cursor, Claude Desktop, Claude Code o Codex
• la URL del servidor MCP de Retell: https://mcp.retellai.com

Formato de autenticación:

Authorization: Bearer <RETELL_API_KEY>

Configuración sencilla

La mayoría de los clientes MCP admiten servidores MCP remotos por HTTP.

Usa:

• URL: https://mcp.retellai.com
• Cabecera: Authorization: Bearer

Ejemplo de configuración

Cursor

Abre: Command Palette → Cursor Settings → MCP → Add new global MCP server

Añade:

{
  "mcpServers": {
    "retell": {
      "url": "https://mcp.retellai.com",
      "headers": {
        "Authorization": "Bearer <RETELL_API_KEY>"
      }
    }
  }
}

Claude Desktop

Abre: Settings → Developer → Edit Config

Añade:

{
  "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

Añade esto a ~/.codex/config.toml:

[mcp_servers.retell]
url = "https://mcp.retellai.com"
bearer_token_env_var = "RETELL_API_KEY"

Luego define:

export RETELL_API_KEY="<RETELL_API_KEY>"

Otros clientes MCP

Si tu cliente admite URL de MCP remotas y cabeceras, usa:

• URL: https://mcp.retellai.com
• Cabecera: Authorization: Bearer

Ejemplos de prompts

Una vez conectado, tu asistente puede empezar a trabajar con Retell de inmediato.

Prueba prompts como:

• "Lista mis agentes y resume qué hace cada uno."
• "Crea un nuevo agente para cualificación de ventas entrantes y publícalo."
• "Muéstrame las últimas 20 llamadas y marca las que tengan puntuaciones de QA bajas."
• "Crea una base de conocimiento, adjunta estas fuentes y actualiza mi agente para que la use."
• "Importa este número de teléfono y asígnalo a mi agente."
• "Reejecuta el QA en esta llamada y resume los motivos del fallo."

Y ahora viene la parte divertida, donde MCP puede sacar músculo de verdad. Ya no solo estás chateando con un asistente. Le estás dando acceso real a la plataforma para que pueda ayudarte a crear, probar, analizar y mejorar agentes de voz sobre la marcha.

Por qué a los equipos les va a encantar

El Retell MCP Server ayuda a los equipos a:

• crear más rápido sin salir de su cliente de IA
• reducir la carga del panel y de la API
• pasar del prototipo a la producción más rápido
• ejecutar QA y operaciones con menos trabajo manual
• mantener la infraestructura de voz más cerca de las herramientas que los desarrolladores ya usan

Para los desarrolladores, reduce el trabajo manual de integración. Para los equipos de producto, acelera las pruebas y la iteración. Para los equipos de operaciones, facilita gestionar las llamadas, el QA y los flujos de trabajo diarios de los agentes.

Seguridad y uso seguro

Conectar LLM a herramientas operativas es enorme, pero también conlleva riesgos. El mayor riesgo es la inyección de prompts. Eso significa que contenido no fiable como transcripciones, mensajes de usuarios o documentos de la base de conocimiento puede incluir instrucciones ocultas que intenten hacer que el modelo haga algo que no pediste. La mayoría de los clientes MCP admiten "confirmar antes de ejecutar herramientas".

Déjalo activado.

Buenas prácticas

Trata MCP como si dieras a tu asistente acceso real de operador.

Recomendamos:

• Usa el privilegio mínimo: crea claves de API solo con los permisos que necesites.
• Mantén las claves fuera de los prompts: guarda las claves de API en los ajustes del cliente o en secretos. Nunca las pegues en el chat.
• Prioriza los flujos de lectura primero: obtén el estado actual antes de actualizar o eliminar nada.
• Revisa las acciones destructivas: acciones como eliminar y publicar deberían requerir una intención clara del usuario.
• Ten cuidado con los datos sensibles: los registros y transcripciones de llamadas pueden contener PII. Expón solo lo que necesites.
• Usa entornos no productivos siempre que sea posible: empieza en desarrollo antes de conectar sistemas de producción.

Resolución de problemas

Si algo no funciona, esto es lo primero que conviene comprobar.

Las herramientas no aparecen

• Asegúrate de que la URL del servidor MCP es correcta
• Confirma que la cabecera Authorization está configurada correctamente
• Comprueba que tu cliente puede alcanzar el endpoint MCP de Retell

401 Unauthorized

• Verifica que tu cabecera es Authorization: Bearer <RETELL_API_KEY>
• Asegúrate de que tu clave de API está activa y es válida

Errores en la llamada a herramientas

• Inténtalo de nuevo con una entrada más pequeña o más sencilla
• Revisa el mensaje de error devuelto para ver los detalles
• Muchos clientes MCP muestran errores de herramienta estructurados directamente, lo que puede ayudar a localizar el problema

Empieza a crear con Retell MCP

El Retell MCP Server facilita usar Retell desde las herramientas de IA en las que tu equipo ya trabaja. Eso significa menos cambios entre herramientas, iteración más rápida y una forma más directa de crear y gestionar agentes de voz de producción.

Si ya usas Retell, MCP te ofrece un flujo de trabajo más rápido. Si eres nuevo en Retell, es una de las formas más sencillas de empezar. Conecta tu cliente. Añade tu clave de API. Empieza a crear. ¡Vamos allá!

¿Necesitas ayuda?

Si tienes problemas o quieres solicitar más capacidades de MCP, escribe a support@retellai.com.