install zelto.ai Con el prompt de abajo, el agente te guía al acceso web y a la autorización OAuth, conecta tu código para enviar conversaciones y comprueba que llegó la primera. Desde ahí puede seguir por el servidor MCP: crear un monitor, esperar el primer hallazgo y configurar la entrega. Esta página es a la vez el recorrido para una persona y el guion que sigue el agente (lee los mismos pasos con la herramienta read_docs).
El prompt mínimo
Desde la raíz del proyecto del agente de voz, dile a tu agente de programación:ZELTO_API_KEY, los endpoints configurados o una conexión autenticada existente.
No debe registrar otra cuenta ni exigir MCP si ya tiene una clave de API válida.
Instala la integración donde termina cada conversación, envía una conversación
sintética identificada como tal y lee su transcripción para verificarla.
Un acuse de recepción no basta. Los hallazgos y monitores son pasos opcionales.
Con credenciales existentes, puede completar el recorrido sin pasos manuales.
Una cuenta nueva requiere verificar el email del titular y aceptar los Términos
y la Política de Privacidad. El agente no debe eludir esos pasos ni inventar una
identidad para crear la cuenta.
Llegá al primer resultado visible en Gratis
Una vez que llegue una conversación real, pedile a tu agente de código que lea la transcripción, proponga un problema con evidencia y sugiera una acción concreta. Si no encuentra un problema fundamentado, revisen otra conversación. Antes de publicar concreate_finding, debe pedirte permiso y buscar hallazgos existentes
para evitar duplicados. Después debe leerlo con get_finding y entregarte el
enlace al hallazgo en la app. No requiere un monitor de pago.
La guía /agent-setup.md del dashboard incluye este recorrido aunque la
configuración ya esté completa. La pantalla de inicio conserva el prompt para
copiar y el enlace a Hallazgos.
Registro mediante un enlace
El agente te entrega un enlace para iniciar sesión o registrarte. Elegís tus credenciales y verificás tu cuenta con el botón del correo. El agente nunca genera una contraseña ni te pide el código del email. El MCP públicohttps://api.zelto.ai/mcp/signup expone start_signup con {}:
solo devuelve los enlaces de acceso y la URL del MCP. Después conectás el cliente
a https://api.zelto.ai/mcp mediante OAuth y autorizás el acceso en el navegador.
Si abrís el enlace en otro navegador o para otra cuenta, Zelto muestra el correo
y te pide confirmar antes de iniciar sesión.
Instala Zelto con una frase
Pega esto en tu agente de programación (Claude Code, Cursor, Codex, …) desde la raíz del proyecto que quieres observar:Pega esto en tu agente de programación
Acceso e integración
Completá el acceso y la autorización OAuth en el navegador. Para la ingesta desde el servidor, creá una clave en Configuración > Integraciones > Integración API y configurala directamente en tu archivo local de entorno o gestor de secretos. Nunca pegues claves en el chat. Seguí la guía de carga de conversaciones y continuá con el primer hallazgo.Qué puede y qué no puede hacer el agente
- Cuentas existentes. Iniciá sesión en el navegador, también con acceso social o MFA, y autorizá el MCP mediante OAuth. Las credenciales quedan con vos.
- Sin atajos. El agente no omite la verificación ni aprueba el consentimiento por vos. Usá el botón del correo; no compartas códigos ni sesiones.
- Planes. Las conversaciones, transcripciones y trazas funcionan en el plan Free. Los monitores están disponibles en todos los planes, incluido Free; se mantienen los costos y límites de uso. Los hallazgos aportados por tu propio agente son gratis:
create_findingpublica un hallazgo abierto, legible y visible inmediatamente en la app. Una organización Free puede tener tres agentes conectados; la conversación de un cuarto agente se rechaza con403connected_agent_limit. Consulta Planes. - Qué significa «instalar». El paquete oficial de npm para proyectos TypeScript es
zelto-sdk. El envío de conversaciones requiere la versión 0.4.0 o posterior. Antes de instalar, consultanpm view zelto-sdk version: si 0.4.0 todavía no está publicada, usa la integración HTTP de esta guía. La versión 0.3.0 solo ofrece la API anterior de analítica web. Cuando esté disponible, ejecutanpm install zelto-sdk@^0.4.0y usaZelto.sendConversationen el servidor; consulta el ejemplo TypeScript de la guía de envío. Guarda la clave en variables de entorno exclusivas del servidor. MCP se conecta de forma remota sin paquete npm. «Install Zelto in this project» es una instrucción para el agente de programación, no un comando de terminal.
¿Ya tienes cuenta? Una línea desde Empezar
Si ya tienes una cuenta de Zelto, abre Empezar en el panel. Una organización nueva se abre en Configura Zelto con tu agente de código; si lo omites, la misma línea sigue en O deja que tu agente de código lo configure, debajo de los pasos. Cópiala en tu agente. Tiene este aspecto:/agent-setup.md hace que el agente agregue el servidor MCP
y se conecte con OAuth, así que la línea no
contiene ninguna clave de API: inicias sesión una vez en el navegador y eliges la
organización. Después el agente lee get_onboarding_status y recorre contigo
el flujo de abajo: conecta tu plataforma de voz o conecta tu propio
código a la API de ingesta, y te ofrece un
primer monitor. Nunca se registra ni crea otra organización.
Antes de empezar (si ya tienes una clave)
Si ya generaste una clave en el panel, ve directo a conectar el servidor MCP:- Ten una clave de API. En el panel está en Configuración → Integraciones → Integración por API y se muestra una sola vez al crearla.
- Conecta el servidor MCP de Zelto en tu editor con esa clave (consulta MCP para la configuración de cada cliente). Confirma con la herramienta
health(devuelve el id de tu organización).
El flujo
1
Comprueba dónde estás
El agente llama primero a
get_onboarding_status. Devuelve los pasos de configuración ordenados (connectCalls: llegan conversaciones, importAgent: existe un agente, createMonitor), cada uno con un indicador done, más nextIncomplete y monitorsAvailable. Repetir la incorporación es seguro: el agente retoma desde el primer paso incompleto. Si ya enviaste conversaciones con la integración, los dos primeros pasos ya están hechos.2
Conectar un proveedor
El agente consulta
list_integrations y llama a connect_provider con el
proveedor y una etiqueta opcional. Recibes un enlace válido durante 15 minutos:
ábrelo como propietario o administrador e introduce tu clave directamente
en Zelto. No la pegues en el chat. El agente confirma que se guardó con
check_provider_connection y continúa con la importación de agentes.Para claves de proveedores de IA o transcripción, usa connect_ai_provider
y la misma comprobación. Los endpoints personalizados también solicitan la
URL y los modelos en la web; su validación hace una pequeña llamada de pago
por modelo. Las instrucciones opcionales de webhook están en Configuración → Integraciones.3
Hacer que las conversaciones fluyan
Las conversaciones llegan una vez que se pega el webhook (o se ejecuta la sincronización horaria para los proveedores basados en pull).
list_conversations En una primera conversación, Zelto crea el primer contacto.
agente automáticamente. Si ya tienes historial en una
cuenta de Retell conectada, el agente puede importarlo con
retell_import_agent y retell_import_conversations en lugar de esperar.Si la integración va a ejecutar experimentos, consulta también
Versiones de agentes. LiveKit y cargas propias
deben indicar version en cada conversación. Verifica dos etiquetas de
despliegue bajo el mismo agente antes de configurar la comparación.4
Crear un monitor
A monitor es un juez de IA que se ejecuta contra cada conversación y marca las que coinciden con una rúbrica. Los monitores están disponibles en todos los planes; estima los costos de uso antes de crear uno. El agente ofrece el catálogo listo para usar de
list_starter_monitors (negaciones, fallos de tareas, frustración del usuario y más), luego conversaciones create_monitor con un
starterKeyO con un name y un sí/no en lenguaje sencillo instruction
de su propio. Se confirma con list_monitors.5
Espera el primer Hallazgo
A medida que las conversaciones fluyen a través del monitor, Zelto se
hallazgos problemas duraderos a nivel de organización agrupados a partir de las conversaciones que coinciden.
list_findings hasta que aparezca el primero. El agente también puede crear un hallazgo con create_finding (basta una description en texto plano); se publica abierto y visible inmediatamente, también en Gratis.6
Ruta hallazgos a tu equipo
Finalmente, el agente llama
set_findings_delivery con el channels Quieres email y/o slack. Slack también necesita la aplicación de Slack conectada a través de OAuth bajo Configuración → Integraciones, que el agente marcará para que usted haga.Utilice su agente de codificación
Pega la siguiente indicación en el agente de codificación de tu editor. Carga elzelto-onboarding habilidad si su cliente apoya las habilidades de los agentes antrópicos, o vuelve a leer esta página a través de read_docs de cualquier manera sigue el flujo anterior y hace una pausa para los pasos que solo usted puede hacer.
Paste into your coding agent
Instalar la habilidad
Tres formas de darle a tu agente la habilidad, primero la fricción más baja:- Zero-install (funciona con cualquier cliente MCP). Cada editor conectado ya tiene el
read_docsherramienta el mensaje de pegado anterior le dice al agente queread_docs('onboarding-with-an-agent')y síguelo. Esto siempre refleja la versión en vivo de esta página. Recomendado. - Copia la carpeta de habilidades (Claude Code y otros clientes con capacidad de habilidades).
Suelte el
zelto-onboardingcarpeta de habilidades en el directorio de habilidades de su agente (para Claude Code,.claude/skills/). La habilidadSKILL.mdmás sureferences/archivos conducen el mismo flujo con detalle progresivo. - referencia en línea. Apunta el agente a la URL de esta página en tu propio mensaje;
read_docsversión actual a pedido.
Relacionado
- MCP conectar el servidor y el completo herramientas de onboarding referencia.
- Inicio rápido la misma configuración hecha a mano en el tablero.
- Conectar un proveedor de voz detalles de conexión por proveedor.
- Hallazgos lo que Zelto sale a la superficie una vez que su monitor está en vivo.

