Integrazione MCP
OpenFactory supporta il Model Context Protocol così gli assistenti AI possono aiutarti a creare build, ispezionare ricette, gestire VM e rivedere risultati test.
Usa MCP quando vuoi lavorare con OpenFactory da Claude, Cursor, Claude Code, OpenAI Codex o un altro client compatibile MCP senza passare avanti e indietro tra strumenti.
Requisiti
- Un client MCP che supporti server MCP remoti
- Per accesso legato all’account, accedi a OpenFactory in questo browser
- Per accesso guest, usa il token guest generato mostrato sotto
Le chiavi API account sono mostrate una volta alla creazione e possono essere revocate dalla console. I token guest sono identificatori browser per accesso a consumo; non sono segreti account.
Endpoint
| Trasporto | URL | Uso |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | Endpoint MCP OpenFactory |
Streamable HTTP è l’unico trasporto supportato. Gli endpoint HTTP+SSE più vecchi (/mcp/sse, /mcp/messages) sono stati ritirati e ora restituiscono 410 Gone; punta qualsiasi client che li usa ancora all’URL Streamable HTTP sopra, con lo stesso header Authorization. Claude Code, Claude Desktop, Cursor, Codex e OpenCode supportano tutti Streamable HTTP.
Config copia-incolla
Riavvia Claude Desktop, Cursor, OpenAI Codex o qualsiasi altro client MCP long-running dopo aver cambiato impostazioni MCP. OpenAI Codex legge server MCP da ~/.codex/config.toml e si connette a Streamable HTTP direttamente: non serve bridge mcp-remote. I connettori custom Claude.ai possono chiedere URL server e header come campi separati.
Capacità disponibili
OpenFactory espone tool customer-facing per:
| Categoria | Esempi |
|---|---|
| Build | Elencare build, creare build da ricette, controllare stato build, riprovare build fallite |
| Ricette | Sfogliare template, validare ricette, personalizzare template |
| Immagini | Ottenere link download per artefatti completati |
| VM | Elencare VM, creare VM test, avviare o fermare VM, aprire link console |
| Test | Eseguire verifica, elencare run test, ispezionare risultati test, gestire suite test riutilizzabili |
| App UI testing | Guidare tester VM per testare qualsiasi URL app: scenari GUI riutilizzabili self-hardening. Nessun deploy richiesto |
| App deployment | Deployare repo Git in web app live con URL preview pubblico (https://<slug>.apps.openfactory.tech) |
Disponibilità tool può variare per piano e permessi organizzazione.
Suite test riutilizzabili
Le suite test possono essere create prima che variante o ISO sia buildata. Definisci
uno o più casi test, asserzioni personalizzate, test predefined e slot target ISO
nominati come primary, client o server. Quando le build sono pronte, associa
ogni slot a build completata ed esegui la suite.
| Tool | Uso |
|---|---|
create_test_suite | Crea suite riutilizzabile senza richiedere variante buildata |
list_test_suites | Elenca suite disponibili per utente MCP corrente |
get_test_suite | Visualizza definizione suite e cronologia run recente |
update_test_suite_targets | Associa slot target ISO nominati a build completate |
run_test_suite | Esegue suite su slot target ISO associati |
list_test_suite_runs | Elenca run create da suite |
get_test_suite_status | Visualizza readiness authoring e stato run più recente |
App UI Testing: qualsiasi URL, nessun deploy
Testa l’interfaccia utente di qualsiasi web app puntando tester VM gestita a un URL. Non deployi la tua app con OpenFactory per testarla. La tester VM apre dev server locale, deploy preview/produzione su Vercel, AWS, Netlify o qualsiasi host, o qualsiasi URL pubblico raggiungibile dalla VM. La tua app resta dove già gira.
Gli scenari sono scritti in linguaggio semplice e sono self-hardening: la prima
run impara dove sta ogni elemento UI, e run successive replay dalla memoria (saltando
passo visivo lento). Questo rende replay veloci e resilienti a piccoli cambi UI.
Gli scenari supportano variabili ambiente (${VAR}) e 2FA (${totp:VAR}, RFC 6238) per
sign-in; i segreti sono passati a runtime e non memorizzati.
| Tool | Uso |
|---|---|
ensure_tester_vm | Ottieni o crea tester VM desktop persistente |
create_app_scenario | Salva scenario GUI riutilizzabile per URL app |
run_app_scenario | Eseguilo (passa segreti runtime qui) e registra screenshot + verdetto |
list_app_scenarios / get_app_scenario | Sfoglia scenari e cache hardened |
start_app_test / record_app_test_step / finish_app_test | Guida e registra run ad hoc tu stesso |
annotate_screenshot | Disegna box highlight etichettati su screenshot |
Vedi App UI Testing per flusso completo, schema passi ed esempi 2FA.
App Deployment: repo Git a URL pubblico
Deploya web app direttamente da repository Git e ottieni URL preview pubblico
(https://<slug>.apps.openfactory.tech) da aprire, condividere o puntare con scenario
test. OpenFactory clona repo, installa dipendenze, avvia app e fa health-check per te.
Niente da collegare: niente port forwarding, tunnel o DNS.
Si abbina ad App UI testing: deploya app, poi esegui scenario sul suo URL preview, oppure salta deploy e testa app che già hosti (Vercel, AWS, …).
| Tool | Uso |
|---|---|
create_app | Registra repo Git come app (nome, sorgente, slug) |
deploy_app | Deploya app e restituisce URL preview pubblico |
list_apps / get_app | Sfoglia app, URL e cronologia deploy |
iterate_app | Dispatcha cambio in linguaggio naturale a app; agent applica e redeploya |
get_app_build_status | Poll stato deploy app e ticket cambio in corso |
Vedi App Deployment per flusso completo. Per far parlare utenti al tuo app da pulsante mic, vedi Voice Iterate Widget.
Esempi prompt
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.Note sicurezza
- Usa chiavi API solo con client di cui ti fidi.
- Revoca chiavi vecchie dalla console quando ruoti macchine o lasci un progetto.
- Preferisci permessi tool che richiedono approvazione per azioni che creano build, avviano VM o cambiano infrastruttura.
- Non incollare chiavi API OpenFactory in prompt, ticket, repository pubblici o documenti condivisi.
Risoluzione problemi
I tool non compaiono
Riavvia client MCP e conferma che URL server sia esattamente:
https://console.openfactory.tech/mcp-stream/mcpSe client è configurato con URL ritirato /mcp/sse otterrà
410 Gone: cambia URL in quello sopra; nient’altro deve cambiare.
Autenticazione fallisce
Ricarica pagina e copia di nuovo configurazione generata. Utenti autenticati
dovrebbero usare header Authorization generato. Utenti guest dovrebbero usare
header X-Guest-Id generato dalla config copia-incolla sopra.
Azioni build o VM falliscono
Controlla piano OpenFactory, permessi organizzazione e stato build. Alcune azioni richiedono build completata, entitlement VM persistente o permessi Enterprise.
Errori trasporto
Aggiorna client MCP se non supporta Streamable HTTP. Se non puoi aggiornarlo, passa all’endpoint compatibilità HTTP+SSE.