MCP-integration

OpenFactory understøtter Model Context Protocol , så AI-assistenter kan hjælpe med at oprette builds, gennemgå opskrifter, administrere VM’er og gennemgå testresultater.

Brug MCP, når du vil arbejde med OpenFactory fra Claude, Cursor, Claude Code, OpenAI Codex eller en anden MCP-kompatibel klient uden at skifte frem og tilbage mellem værktøjer.

Krav

En MCP-klient, der understøtter remote MCP-servere
For kontobaseret adgang: log ind på OpenFactory i denne browser
For gæsteadgang: brug det genererede gæsttoken, der vises nedenfor

Konto-API-nøgler vises én gang ved oprettelse og kan tilbagekaldes fra konsollen. Gæsttokens er browseridentifikatorer til målt adgang; de er ikke konthemmeligheder.

Endpoints

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

Streamable HTTP er den eneste understøttede transport. De ældre HTTP+SSE-endpoints (/mcp/sse, /mcp/messages) er udfaset og returnerer nu 410 Gone; peg klienter, der stadig bruger dem, mod Streamable HTTP-URL’en ovenfor med samme Authorization-header. Claude Code, Claude Desktop, Cursor, Codex og OpenCode understøtter Streamable HTTP.

Kopier-indsæt-konfiguration

Preparing your MCP config...

Genstart Claude Desktop, Cursor, OpenAI Codex eller en anden langkørende MCP-klient efter ændring af MCP-indstillingerne. OpenAI Codex læser MCP-servere fra ~/.codex/config.toml og forbinder direkte til Streamable HTTP: ingen mcp-remote-bro nødvendig. Tilpassede connectors i Claude.ai kan bede om server-URL og header som separate felter.

Tilgængelige muligheder

OpenFactory eksponerer kundevendte værktøjer til:

Kategori	Eksempler
Builds	List builds, opret builds fra opskrifter, tjek buildstatus, prøv mislykkede builds igen
Recipes	Gennemse skabeloner, valider opskrifter, tilpas skabeloner
Images	Hent downloadlinks til færdige artefakter
VMs	List VM’er, opret test-VM’er, start eller stop VM’er, åbn konsollinks
Tests	Kør verifikation, list testkørsler, gennemgå testresultater, administrer genanvendelige testsuiter
App UI testing	Styr en tester-VM til at teste enhver app-URL: genanvendelige, self-hardening GUI-scenarier. Ingen deploy påkrævet
App deployment	Deploy et Git-repo til en live webapp med en offentlig preview-URL (`https://<slug>.apps.openfactory.tech`)

Værktøjstilgængelighed kan variere efter plan og organisationsrettigheder.

Genanvendelige testsuiter

Testsuiter kan oprettes, før en variant eller ISO er bygget. Definer et eller flere testcases, custom assertions, foruddefinerede tests og navngivne ISO-målpladser som primary, client eller server. Når builds er klar, binder du hver plads til et færdigt build og kører suiten.

Tool	Brug
`create_test_suite`	Opret en genanvendelig suite uden at kræve en bygget variant
`list_test_suites`	List suiter tilgængelige for den aktuelle MCP-bruger
`get_test_suite`	Se suite-definition og seneste kørselshistorik
`update_test_suite_targets`	Bind navngivne ISO-målpladser til færdige builds
`run_test_suite`	Kør en suite mod bundne ISO-målpladser
`list_test_suite_runs`	List kørsler oprettet fra en suite
`get_test_suite_status`	Se authoring readiness og status for seneste kørsel

App UI Testing: enhver URL, ingen deploy

Test brugergrænsefladen for enhver webapp ved at pege en administreret tester-VM mod en URL. Du behøver ikke deploye din app med OpenFactory for at teste den. Tester-VM’en åbner en lokal dev-server, preview/produktion på Vercel, AWS, Netlify eller enhver host, eller enhver offentlig URL, VM’en kan nå. Din app bliver, hvor den allerede kører.

Scenarier skrives på almindeligt sprog og er self-hardening: første kørsel lærer, hvor hvert UI-element er, senere kørsler afspiller fra det minde (uden langsom visual pass). Det gør replay hurtigt og modstandsdygtigt over for små UI-ændringer. Scenarier understøtter miljøvariabler (${VAR}) og 2FA (${totp:VAR}, RFC 6238) ved login; hemmeligheder sendes ved run time og gemmes aldrig.

Tool	Brug
`ensure_tester_vm`	Hent eller opret din persistente desktop tester-VM
`create_app_scenario`	Gem et genanvendeligt GUI-scenario for en app-URL
`run_app_scenario`	Kør det (send run-time-hemmeligheder her) og optag screenshots + verdict
`list_app_scenarios` / `get_app_scenario`	Gennemse scenarier og deres hardened cache
`start_app_test` / `record_app_test_step` / `finish_app_test`	Styr og optag en ad-hoc-kørsel selv
`annotate_screenshot`	Tegn mærkede highlight-bokse på et screenshot

Se App UI Testing for hele workflowet, step-skemaet og 2FA-eksempler.

App Deployment: Git-repo til offentlig URL

Deploy en webapp direkte fra et Git-repository og få en offentlig preview-URL (https://<slug>.apps.openfactory.tech), du kan åbne, dele eller pege et testscenario mod. OpenFactory kloner repoet, installerer afhængigheder, starter appen og kører health checks for dig. Intet at tilslutte: ingen port forwarding, tunneler eller DNS.

Det hænger sammen med App UI testing: deploy din app og kør et scenario mod preview-URL’en, eller spring deploy over og test en app, du allerede hoster (Vercel, AWS, …).

Tool	Brug
`create_app`	Registrer et Git-repo som app (name, source, slug)
`deploy_app`	Deploy appen og returner dens offentlige preview-URL
`list_apps` / `get_app`	Gennemse dine apps, deres URL’er og deployhistorik
`iterate_app`	Send en ændring i naturligt sprog til en app; en agent anvender den og redeployer
`get_app_build_status`	Poll en apps deploystatus og in-flight change tickets

Se App Deployment for hele workflowet. For at lade dine brugere tale ændringer ind i appen via en mikrofonknap, 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.

Sikkerhedsnoter

Brug API-nøgler kun med klienter, du stoler på.
Tilbagekald gamle nøgler i konsollen, når du skifter maskiner eller forlader et projekt.
Foretræk værktøjstilladelser med påkrævet godkendelse for handlinger, der opretter builds, starter VM’er eller ændrer infrastruktur.
Indsæt ikke OpenFactory API-nøgler i prompter, tickets, offentlige repositories eller delte dokumenter.

Fejlfinding

Værktøjer vises ikke

Genstart din MCP-klient og bekræft, at server-URL’en er præcis:


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

Hvis klienten er konfigureret med den udfasede /mcp/sse-URL, får du 410 Gone: skift URL til den ovenfor; intet andet skal ændres.

Godkendelse mislykkes

Opdater siden og kopier den genererede konfiguration igen. Loggede brugere bør bruge den genererede Authorization-header. Gæster bør bruge den genererede X-Guest-Id-header fra kopier-indsæt-konfigurationen ovenfor.

Build- eller VM-handlinger mislykkes

Tjek din OpenFactory-plan, organisationsrettigheder og buildstatus. Nogle handlinger kræver et færdigt build, persistent VM entitlement eller Enterprise-rettigheder.

Transportfejl

Opdater din MCP-klient, hvis den ikke understøtter Streamable HTTP. Hvis du ikke kan opdatere, skift til HTTP+SSE compatibility endpoint.