Integración MCP
OpenFactory admite el Model Context Protocol para que los asistentes de IA te ayuden a crear compilaciones, inspeccionar recetas, gestionar VM y revisar resultados de prueba.
Usa MCP cuando quieras trabajar con OpenFactory desde Claude, Cursor, Claude Code, OpenAI Codex u otro cliente compatible con MCP sin cambiar constantemente de herramienta.
Requisitos
- Un cliente MCP que admita servidores MCP remotos
- Para acceso respaldado por cuenta, inicia sesión en OpenFactory en este navegador
- Para acceso de invitado, usa el token de invitado generado que se muestra abajo
Las claves API de cuenta se muestran una vez al crearlas y pueden revocarse desde el console. Los tokens de invitado son identificadores de navegador para acceso medido; no son secretos de cuenta.
Endpoints
| Transport | URL | Use |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | El endpoint MCP de OpenFactory |
Streamable HTTP es el único transport admitido. Los endpoints HTTP+SSE antiguos (/mcp/sse, /mcp/messages) están retirados y ahora devuelven 410 Gone; apunta cualquier cliente que aún los use a la URL Streamable HTTP anterior, con el mismo header Authorization. Claude Code, Claude Desktop, Cursor, Codex y OpenCode admiten Streamable HTTP.
Configuración para copiar y pegar
Reinicia Claude Desktop, Cursor, OpenAI Codex u otro cliente MCP de larga duración tras cambiar su configuración MCP. OpenAI Codex lee servidores MCP desde ~/.codex/config.toml y se conecta a Streamable HTTP directamente: no hace falta puente mcp-remote. Los conectores personalizados de Claude.ai pueden pedir la URL del servidor y el header como campos separados.
Capacidades disponibles
OpenFactory expone herramientas orientadas al cliente para:
| Category | Examples |
|---|---|
| Builds | List builds, create builds from recipes, check build status, retry failed builds |
| Recipes | Browse templates, validate recipes, customize templates |
| Images | Get download links for completed artifacts |
| VMs | List VMs, create test VMs, start or stop VMs, open console links |
| Tests | Run verification, list test runs, inspect test results, manage reusable test suites |
| App UI testing | Drive a tester VM to test any app URL: reusable, self-hardening GUI scenarios. No deploy required |
| App deployment | Deploy a Git repo to a live web app with a public preview URL (https://<slug>.apps.openfactory.tech) |
La disponibilidad de herramientas puede variar según plan y permisos de organización.
Test suites reutilizables
Las test suites pueden crearse antes de que exista un variant o ISO compilado. Define uno o más casos de prueba, aserciones personalizadas, pruebas predefinidas y ranuras de destino ISO con nombre como primary, client o server. Cuando las compilaciones estén listas, vincula cada ranura a una compilación completada y ejecuta la suite.
| Tool | Use |
|---|---|
create_test_suite | Create a reusable suite without requiring a built variant |
list_test_suites | List suites available to the current MCP user |
get_test_suite | View suite definition and recent run history |
update_test_suite_targets | Bind named ISO target slots to completed builds |
run_test_suite | Run a suite against bound ISO target slots |
list_test_suite_runs | List runs created from a suite |
get_test_suite_status | View authoring readiness and latest run status |
Pruebas UI de app: cualquier URL, sin despliegue
Prueba la interfaz de usuario de cualquier app web apuntando una VM tester gestionada a una URL. No despliegas tu app con OpenFactory para probarla. La VM tester abre un servidor de desarrollo local, un despliegue preview/producción en Vercel, AWS, Netlify u otro host, o cualquier URL pública alcanzable desde la VM. Tu app sigue donde ya corre.
Los escenarios se escriben en lenguaje llano y son auto-endurecidos: la primera ejecución aprende dónde está cada elemento UI y las siguientes reproducen desde esa memoria (omitendo el paso visual lento). Eso hace replays rápidos y resistentes a cambios UI pequeños. Los escenarios admiten variables de entorno (${VAR}) y 2FA (${totp:VAR}, RFC 6238) para inicios de sesión; los secretos se pasan en runtime y nunca se almacenan.
| Tool | Use |
|---|---|
ensure_tester_vm | Get or create your persistent desktop tester VM |
create_app_scenario | Save a reusable GUI scenario for an app URL |
run_app_scenario | Run it (pass run-time secrets here) and record screenshots + verdict |
list_app_scenarios / get_app_scenario | Browse scenarios and their hardened cache |
start_app_test / record_app_test_step / finish_app_test | Drive and record an ad-hoc run yourself |
annotate_screenshot | Draw labeled highlight boxes on a screenshot |
Consulta Pruebas UI de app para el flujo completo, el esquema de pasos y ejemplos 2FA.
Despliegue de app: repositorio Git a URL pública
Despliega una app web directamente desde un repositorio Git y obtén una URL preview pública (https://<slug>.apps.openfactory.tech) que puedes abrir, compartir o apuntar con un escenario de prueba. OpenFactory clona el repo, instala dependencias, arranca la app y hace health-check por ti. No hay nada que cablear: sin reenvío de puertos, túneles ni DNS.
Esto encaja con pruebas UI de app: despliega tu app, luego ejecuta un escenario contra su URL preview, u omite el despliegue y prueba una app que ya hospedas (Vercel, AWS, …).
| Tool | Use |
|---|---|
create_app | Register a Git repo as an app (name, source, slug) |
deploy_app | Deploy the app and return its public preview URL |
list_apps / get_app | Browse your apps, their URLs, and deploy history |
iterate_app | Dispatch a natural-language change to an app; an agent applies it and redeploys |
get_app_build_status | Poll an app’s deploy status and in-flight change tickets |
Consulta Despliegue de app para el flujo completo. Para que tus usuarios hablen cambios a tu app desde un botón de micrófono, consulta el Widget Voice Iterate.
Prompts de ejemplo
Show my most recent OpenFactory builds and summarize any failures.Create a Debian server image with SSH, Docker, a deploy user, and default verification tests.Validate this recipe before I start a build.Start a VM from my latest completed build and give me the console link.Create a reusable smoke test suite for example-project with primary and client ISO slots. I will bind the builds later.Create a smoke-login scenario for my app at https://my-app.vercel.app, run it in a tester VM, and verify the dashboard loads. I'll give you the password and 2FA seed at run time.Notas de seguridad
- Usa claves API solo con clientes en los que confíes.
- Revoca claves antiguas desde el console al rotar máquinas o abandonar un proyecto.
- Prefiere permisos de herramienta que exijan aprobación para acciones que creen compilaciones, arranquen VM o cambien infraestructura.
- No pegues claves API OpenFactory en prompts, tickets, repositorios públicos ni documentos compartidos.
Solución de problemas
No aparecen herramientas
Reinicia tu cliente MCP y confirma que la URL del servidor sea exactamente:
https://console.openfactory.tech/mcp-stream/mcpSi tu cliente está configurado con la URL retirada /mcp/sse obtendrá 410 Gone: cambia la URL a la de arriba; nada más debe cambiar.
Falla la autenticación
Refresca esta página y copia de nuevo la configuración generada. Los usuarios con sesión deben usar el header Authorization generado. Los invitados deben usar el header X-Guest-Id generado de la config para copiar y pegar arriba.
Fallan acciones de compilación o VM
Comprueba tu plan OpenFactory, permisos de organización y el estado de compilación. Algunas acciones requieren una compilación completada, un derecho de VM persistente o permisos Enterprise.
Errores de transporte
Actualiza tu cliente MCP si no admite Streamable HTTP. Si no puedes actualizarlo, cambia al endpoint de compatibilidad HTTP+SSE.