Resumen
Conecta Preflight con un asistente de IA o agente de programación compatible para ver cómo se muestra tu email en clientes de correo reales. Pide capturas de distintas aplicaciones en modo claro u oscuro y revísalas mientras ajustas el borrador.
Conectar con Preflight
Necesitas una cuenta de Preflight con permisos de administrador en tu organización y un asistente compatible con MCP, como ChatGPT.
URL del servidor
https://mcp.preflight.qa
- Añade un servidor MCP remoto en los ajustes de tu asistente con la URL de arriba.
- Introduce el identificador de cliente OAuth que te proporciona Preflight al concederte acceso.
- Inicia sesión en Preflight, elige tu organización y autoriza la conexión. Tu asistente ya puede pedir capturas usando los créditos de esa organización.
¿Cuánto cuesta?
MCP usa el mismo saldo de créditos de captura que la API de Preflight y consume la misma cantidad de créditos por captura. Usar MCP no tiene coste adicional.
| Tarea | Coste |
|---|---|
| Generar capturas | 1 crédito por aplicación de correo y modo |
| Consultar los límites de la cuenta, listar aplicaciones o ver resultados | Gratis |
Apple Mail en modo claro y oscuro cuesta 2 créditos. Preflight descuenta los créditos al aceptar la solicitud de capturas.
Consulta los precios de Preflight para ver los créditos incluidos al mes y los paquetes adicionales.
Probar un email
Dale a tu asistente el HTML del email, pegado en el chat o adjunto como archivo. No basta con un enlace a una web.
Muéstrame cómo se ve este email en Apple Mail en modo claro y oscuro.
Tu asistente solicita las capturas y consulta su progreso. Abre la galería de capturas cuando esté disponible para comparar los resultados.
Después de hacer cambios, pide nuevas capturas para comparar el borrador actualizado. Cada nueva ejecución consume más créditos.
Herramientas de tu asistente
Tu asistente elige estas herramientas por ti. No tienes que llamarlas tú.
| Herramienta | Qué hace |
|---|---|
get_account_limits | Muestra los créditos disponibles y los límites de uso de la organización. |
list_email_clients | Lista las aplicaciones de correo y los modos que puedes probar. |
start_email_rendering | Inicia una prueba de capturas. |
get_email_test_results | Consulta el progreso y los enlaces disponibles a las capturas y a la galería. |
Datos de las herramientas para desarrolladores
list_email_clients no acepta argumentos. Usa los identificadores de cliente y modos que devuelve en start_email_rendering:
{
"subject": "Lanzamiento de primavera",
"html": "<html lang=\"es\"><body><h1>Lanzamiento de primavera</h1></body></html>",
"clients": [
{ "id": "apple_mail_mac", "modes": ["light", "dark"] }
],
"idempotency_key": "primavera-capturas-1"
}
Pasa el test_id devuelto a get_email_test_results. Respeta poll_after_seconds al consultar el progreso.
La idempotency_key es una clave de reintento. Reutilízala con los mismos datos en un plazo de 24 horas para obtener la ejecución original sin otro cargo. Usa una clave nueva si cambian los datos. Una clave caducada puede iniciar otra ejecución de pago.
Entender los resultados
Las capturas pueden terminar en momentos distintos. Tu asistente puede mostrar cuáles están disponibles y cuáles han fallado, e indicar los créditos consumidos.
Si una prueba no termina, pide a tu asistente que consulte su estado antes de iniciar otra de pago. Una prueba de capturas también puede devolver algunas imágenes mientras otras fallan.
Límites técnicos y estados
- Las ejecuciones pasan de
queuedarunningy después acompleted,partial_failureofailed. stalledsignifica que no ha habido actividad durante diez minutos. Las consultas muestran el estado de la ejecución en curso.- El HTML está limitado a 1 MiB de texto UTF-8. La solicitud JSON completa está limitada a 8 MiB.
- Los límites predeterminados son 12 solicitudes por minuto y una nueva prueba de capturas cada 45 segundos. Los de tu organización pueden ser distintos. Se pueden atender hasta dos solicitudes MCP a la vez por organización.
- Si alcanzas un límite de uso, espera el intervalo indicado antes de reintentar. Los resultados se recogen mediante consultas periódicas; no se admiten webhooks personalizados.
- El servidor usa Streamable HTTP y OAuth con un cliente registrado. No se admite el registro automático de clientes. El asistente renueva los tokens de acceso sin que tengas que volver a conectar.
- El historial de uso incluye las ejecuciones aceptadas, aunque sigan en curso o fallen. Los reintentos gratuitos no añaden consumo. No incluye la actividad de claves de API ni de otras conexiones.
Tu conexión y tus datos
Cada conexión funciona con una organización y permanece activa hasta que la desconectes. Debes seguir siendo administrador para usarla. Para usar otra organización, crea otra conexión.
En Gestionar organización → Conexiones de aplicaciones puedes ver las capturas y los créditos usados por cada conexión en los últimos 30 días, o desconectarla. También se cierra cuando termina tu suscripción.
Los enlaces de capturas duran hasta 7 días desde que se genera la imagen. Descarga las imágenes que quieras conservar. Desconectar bloquea nuevas aperturas de esos enlaces.
El HTML y las capturas se conservan durante 30 días, o se eliminan en un plazo de cinco días naturales desde el fin de tu suscripción si es antes.
¿Necesitas ayuda? Escribe a hello@preflight.qa.