MCP-integrasjon

OpenFactory støtter Model Context Protocol , slik at AI-assistenter kan hjelpe deg med å opprette builds, inspisere oppskrifter, administrere VM-er og gå gjennom testresultater.

Bruk MCP når du vil jobbe med OpenFactory fra Claude, Cursor, Claude Code, OpenAI Codex eller en annen MCP-kompatibel klient uten å bytte frem og tilbake mellom verktøy.

Krav

En MCP-klient som støtter eksterne MCP-servere
For kontobasert tilgang: logg inn på OpenFactory i denne nettleseren
For gjestetilgang: bruk det genererte gjestetokenet som vises nedenfor

Konto-API-nøkler vises én gang ved opprettelse og kan tilbakekalles fra konsollen. Gjestetokens er nettleseridentifikatorer for målt tilgang; de er ikke konthemmeligheter.

Endpoints

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

Streamable HTTP er den eneste støttede transporten. De eldre HTTP+SSE-endpoints (/mcp/sse, /mcp/messages) er avviklet og returnerer nå 410 Gone; pek klienter som fortsatt bruker dem mot Streamable HTTP-URL-en over, med samme Authorization-header. Claude Code, Claude Desktop, Cursor, Codex og OpenCode støtter Streamable HTTP.

Kopier-og-lim-inn-konfigurasjon

Preparing your MCP config...

Start Claude Desktop, Cursor, OpenAI Codex eller annen langvarig MCP-klient på nytt etter endring av MCP-innstillingene. OpenAI Codex leser MCP-servere fra ~/.codex/config.toml og kobler direkte til Streamable HTTP: ingen mcp-remote-bro nødvendig. Tilpassede connectors i Claude.ai kan be om server-URL og header som separate felt.

Tilgjengelige muligheter

OpenFactory eksponerer kundevendte verktøy for:

Kategori	Eksempler
Builds	List builds, opprett builds fra oppskrifter, sjekk buildstatus, prøv mislykkede builds på nytt
Recipes	Bla gjennom maler, valider oppskrifter, tilpass maler
Images	Hent nedlastingslenker for ferdige artefakter
VMs	List VM-er, opprett test-VM-er, start eller stopp VM-er, åpne konsollenker
Tests	Kjør verifisering, list testkjøringer, inspiser testresultater, administrer gjenbrukbare testsuiter
App UI testing	Styr en tester-VM for å teste enhver app-URL: gjenbrukbare, self-hardening GUI-scenarier. Ingen deploy nødvendig
App deployment	Deploy et Git-repo til en live webapp med offentlig forhåndsvisnings-URL (`https://<slug>.apps.openfactory.tech`)

Verktøytilgjengelighet kan variere etter plan og organisasjonstillatelser.

Gjenbrukbare testsuiter

Testsuiter kan opprettes før en variant eller ISO er bygget. Definer ett eller flere testcases, custom assertions, forhåndsdefinerte tester og navngitte ISO-målplasser som primary, client eller server. Når builds er klare, binder du hver plass til et fullført build og kjører suiten.

Tool	Bruk
`create_test_suite`	Opprett en gjenbrukbar suite uten å kreve en bygget variant
`list_test_suites`	List suiter tilgjengelige for gjeldende MCP-bruker
`get_test_suite`	Vis suite-definisjon og nylig kjøringshistorikk
`update_test_suite_targets`	Bind navngitte ISO-målplasser til fullførte builds
`run_test_suite`	Kjør en suite mot bundne ISO-målplasser
`list_test_suite_runs`	List kjøringer opprettet fra en suite
`get_test_suite_status`	Vis authoring readiness og status for siste kjøring

App UI Testing: enhver URL, ingen deploy

Test brukergrensesnittet til enhver webapp ved å peke en administrert tester-VM mot en URL. Du trenger ikke deploye appen med OpenFactory for å teste den. Tester-VM-en åpner en lokal dev-server, preview/produksjon på Vercel, AWS, Netlify eller enhver host, eller enhver offentlig URL VM-en når. Appen blir der den allerede kjører.

Scenarier skrives på vanlig språk og er self-hardening: første kjøring lærer hvor hvert UI-element er, senere kjøringer spiller av fra det minnet (uten treg visual pass). Det gjør replay raskt og tolerant for små UI-endringer. Scenarier støtter miljøvariabler (${VAR}) og 2FA (${totp:VAR}, RFC 6238) ved innlogging; hemmeligheter sendes ved run time og lagres aldri.

Tool	Bruk
`ensure_tester_vm`	Hent eller opprett din persistente desktop tester-VM
`create_app_scenario`	Lagre et gjenbrukbart GUI-scenario for en app-URL
`run_app_scenario`	Kjør det (send run-time-hemmeligheter her) og ta opp skjermbilder + verdict
`list_app_scenarios` / `get_app_scenario`	Bla gjennom scenarier og deres hardened cache
`start_app_test` / `record_app_test_step` / `finish_app_test`	Styr og ta opp en ad-hoc-kjøring selv
`annotate_screenshot`	Tegn merkede highlight-bokser på et skjermbilde

Se App UI Testing for hele arbeidsflyten, step-skjemaet og 2FA-eksempler.

App Deployment: Git-repo til offentlig URL

Deploy en webapp rett fra et Git-repository og få en offentlig forhåndsvisnings-URL (https://<slug>.apps.openfactory.tech) du kan åpne, dele eller peke et testscenario mot. OpenFactory kloner repoet, installerer avhengigheter, starter appen og kjører health checks for deg. Ingenting å koble: ingen port forwarding, tunneler eller DNS.

Dette henger sammen med App UI testing: deploy appen og kjør et scenario mot forhåndsvisnings-URL-en, eller hopp over deploy og test en app du allerede hoster (Vercel, AWS, …).

Tool	Bruk
`create_app`	Registrer et Git-repo som app (name, source, slug)
`deploy_app`	Deploy appen og returner dens offentlige forhåndsvisnings-URL
`list_apps` / `get_app`	Bla gjennom appene dine, URL-ene og deployhistorikk
`iterate_app`	Send en endring i naturlig språk til en app; en agent tar den i bruk og redeployer
`get_app_build_status`	Poll en apps deploystatus og in-flight change tickets

Se App Deployment for hele arbeidsflyten. For å la brukerne dine snakke inn endringer i appen via en mikrofonknapp, se Voice Iterate Widget.

Eksempelprompter


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.

Sikkerhetsmerknader

Bruk API-nøkler bare med klienter du stoler på.
Tilbakekall gamle nøkler i konsollen når du bytter maskiner eller forlater et prosjekt.
Foretrekk verktøytillatelser som krever godkjenning for handlinger som oppretter builds, starter VM-er eller endrer infrastruktur.
Ikke lim inn OpenFactory API-nøkler i prompter, saker, offentlige repositories eller delte dokumenter.

Feilsøking

Verktøy vises ikke

Start MCP-klienten på nytt og bekreft at server-URL-en er nøyaktig:


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

Hvis klienten er konfigurert med den avviklede /mcp/sse-URL-en, får du 410 Gone: bytt til URL-en over; ingenting annet trenger å endres.

Autentisering mislykkes

Oppdater siden og kopier den genererte konfigurasjonen på nytt. Innloggede brukere bør bruke den genererte Authorization-headeren. Gjester bør bruke den genererte X-Guest-Id-headeren fra kopier-og-lim-inn-konfigurasjonen over.

Build- eller VM-handlinger mislykkes

Sjekk OpenFactory-planen, organisasjonstillatelser og buildstatus. Noen handlinger krever et fullført build, persistent VM entitlement eller Enterprise-tillatelser.

Transportfeil

Oppdater MCP-klienten hvis den ikke støtter Streamable HTTP. Hvis du ikke kan oppdatere, bytt til HTTP+SSE compatibility endpoint.