Integração MCP

O OpenFactory suporta o Model Context Protocol para que assistentes de IA ajudem a criar builds, inspecionar receitas, gerenciar VMs e revisar resultados de teste.

Use MCP quando quiser trabalhar com OpenFactory a partir do Claude, Cursor, Claude Code, OpenAI Codex ou outro cliente compatível com MCP sem alternar entre ferramentas.

Requisitos

Cliente MCP que suporte servidores MCP remotos
Para acesso ligado à conta, faça sign-in no OpenFactory neste navegador
Para acesso guest, use o token guest gerado exibido abaixo

Chaves de API de conta são exibidas uma vez na criação e podem ser revogadas no console. Tokens guest são identificadores de navegador para acesso medido; não são segredos de conta.

Endpoints

Transport	URL	Use
Streamable HTTP	`https://console.openfactory.tech/mcp-stream/mcp`	Endpoint MCP OpenFactory

Streamable HTTP é o único transport suportado. Endpoints HTTP+SSE antigos (/mcp/sse, /mcp/messages) foram aposentados e agora retornam 410 Gone; aponte qualquer cliente que ainda os use para a URL Streamable HTTP acima, com o mesmo header Authorization. Claude Code, Claude Desktop, Cursor, Codex e OpenCode suportam Streamable HTTP.

Config copy-paste

Preparing your MCP config...

Reinicie Claude Desktop, Cursor, OpenAI Codex ou outro cliente MCP de longa execução depois de alterar configurações MCP. OpenAI Codex lê servidores MCP de ~/.codex/config.toml e conecta a Streamable HTTP diretamente: não precisa de ponte mcp-remote. Conectores customizados Claude.ai podem pedir URL do servidor e header como campos separados.

Capacidades disponíveis

O OpenFactory expõe ferramentas voltadas ao 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`)

Disponibilidade de ferramentas pode variar por plano e permissões de organização.

Suítes de teste reutilizáveis

Suítes de teste podem ser criadas antes de variant ou ISO ser construído. Defina um ou mais casos de teste, asserções personalizadas, testes predefined e slots de alvo ISO nomeados como primary, client ou server. Quando builds estiverem prontos, vincule cada slot a um build concluído e execute a suíte.

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

App UI Testing: any URL, no deploy

Teste a interface de qualquer app web apontando VM tester gerenciada para uma URL. Você não precisa fazer deploy do app com OpenFactory para testá-lo. A VM tester abre servidor dev local, deployment preview/produção na Vercel, AWS, Netlify ou qualquer host, ou qualquer URL pública alcançável da VM. Seu app permanece onde já roda.

Cenários são escritos em linguagem natural e são self-hardening: a primeira execução aprende onde cada elemento de UI está, e execuções posteriores replay a partir dessa memória (pulando o passe visual lento). Isso torna replays rápidos e resilientes a pequenas mudanças de UI. Cenários suportam variáveis de ambiente (${VAR}) e 2FA (${totp:VAR}, RFC 6238) para sign-ins; segredos são passados em runtime e nunca armazenados.

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

Veja App UI Testing para fluxo completo, schema de steps e exemplos 2FA.

App Deployment: Git repo to a public URL

Faça deploy de app web direto de repositório Git e obtenha URL pública de preview (https://<slug>.apps.openfactory.tech) para abrir, compartilhar ou apontar cenário de teste. OpenFactory clona o repo, instala dependências, inicia o app e faz health-check. Nada para conectar: sem port forwarding, túneis ou DNS.

Combina com App UI testing: faça deploy do app, depois rode cenário contra URL de preview, ou pule deploy e teste app que você já hospeda (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

Veja App Deployment para fluxo completo. Para usuários falarem mudanças ao app por botão de microfone, veja Voice Iterate Widget.

Exemplos de prompts


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 segurança

Use chaves de API só com clientes em que confia.
Revogue chaves antigas no console ao rotacionar máquinas ou sair de projeto.
Prefira permissões de ferramenta com aprovação exigida para ações que criam builds, iniciam VMs ou alteram infraestrutura.
Não cole chaves de API OpenFactory em prompts, tickets, repositórios públicos ou documentos compartilhados.

Solução de problemas

Ferramentas não aparecem

Reinicie cliente MCP e confirme que URL do servidor é exatamente:


https://console.openfactory.tech/mcp-stream/mcp

Se cliente estiver configurado com URL aposentada /mcp/sse receberá 410 Gone: mude para a URL acima; nada mais precisa mudar.

Autenticação falha

Atualize esta página e copie configuração gerada de novo. Usuários autenticados devem usar header Authorization gerado. Usuários guest devem usar header X-Guest-Id gerado da config copy-paste acima.

Ações de build ou VM falham

Verifique plano OpenFactory, permissões de organização e status de build. Algumas ações exigem build concluído, entitlement de VM persistente ou permissões Enterprise.

Erros de transport

Atualize cliente MCP se não suportar Streamable HTTP. Se não puder atualizar, mude para endpoint de compatibilidade HTTP+SSE.