MCP integracija

OpenFactory palaiko Model Context Protocol , kad dirbtinio intelekto asistentai galėtų padėti kurti build’us, tikrinti receptus, valdyti VM ir peržiūrėti testų rezultatus.

Naudokite MCP, kai norite dirbti su OpenFactory per Claude, Cursor, Claude Code, OpenAI Codex ar kitą su MCP suderinamą klientą neperjunginėdami nuolat tarp įrankių.

Reikalavimai

MCP klientas, palaikantis nuotolinius MCP serverius
Prieigai susietai su paskyra: prisijunkite prie OpenFactory šioje naršyklėje
Svečio prieigai: naudokite žemiau rodomą sugeneruotą svečio tokeną

Paskyros API raktai rodomi vieną kartą sukūrus ir gali būti atšaukti konsolėje. Svečio tokenai yra naršyklės identifikatoriai mokamai prieigai; tai nėra paskyros slaptažodžiai.

Endpoint’ai

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

Streamable HTTP yra vienintelis palaikomas transportas. Senesni HTTP+SSE endpoint’ai (/mcp/sse, /mcp/messages) nebenaudojami ir dabar grąžina 410 Gone; nukreipkite visus klientus, kurie dar juos naudoja, į aukščiau nurodytą Streamable HTTP URL su tuo pačiu Authorization antrašte. Claude Code, Claude Desktop, Cursor, Codex ir OpenCode palaiko Streamable HTTP.

Kopijuoti ir įklijuoti konfigūraciją

Preparing your MCP config...

Paleiskite iš naujo Claude Desktop, Cursor, OpenAI Codex ar kitą ilgai veikiantį MCP klientą pakeitus MCP nustatymus. OpenAI Codex skaito MCP serverius iš ~/.codex/config.toml ir jungiasi tiesiogiai prie Streamable HTTP: mcp-remote tilto nereikia. Claude.ai pasirinktiniai jungtys gali prašyti serverio URL ir antraštės atskirais laukais.

Galimos galimybės

OpenFactory teikia klientams skirtus įrankius:

Kategorija	Pavyzdžiai
Builds	Build’ų sąrašas, build’ų kūrimas iš receptų, build būsenos tikrinimas, nepavykusių build’ų pakartojimas
Recipes	Šablonų naršymas, receptų validavimas, šablonų pritaikymas
Images	Atsisiuntimo nuorodos į baigtus artefaktus
VMs	VM sąrašas, testinių VM kūrimas, VM paleidimas ar sustabdymas, konsolės nuorodų atidarymas
Tests	Verifikacijos vykdymas, testų paleidimų sąrašas, testų rezultatų peržiūra, pakartotinai naudojamų testų rinkinių valdymas
App UI testing	Tester VM valdymas bet kurio app URL testavimui: pakartotinai naudojami, self-hardening GUI scenarijai. Deploy nereikia
App deployment	Git repo diegimas kaip live web app su vieša peržiūros URL (`https://<slug>.apps.openfactory.tech`)

Įrankių prieinamumas gali skirtis pagal planą ir organizacijos leidimus.

Pakartotinai naudojami testų rinkiniai

Testų rinkinius galima sukurti prieš sukuriant variantą ar ISO. Apibrėžkite vieną ar daugiau testų atvejų, custom assertions, iš anksto apibrėžtus testus ir pavadintus ISO tikslų slot’us, pvz. primary, client ar server. Kai build’ai paruošti, susiekite kiekvieną slot’ą su baigtu build’u ir paleiskite rinkinį.

Tool	Naudojimas
`create_test_suite`	Sukurti pakartotinai naudojamą rinkinį be reikalavimo turėti sukurtą variantą
`list_test_suites`	Rodyti dabartiniam MCP vartotojui prieinamus rinkinius
`get_test_suite`	Peržiūrėti rinkinio apibrėžimą ir naujausią paleidimų istoriją
`update_test_suite_targets`	Susieti pavadintus ISO tikslų slot’us su baigtais build’ais
`run_test_suite`	Paleisti rinkinį prie susietų ISO tikslų slot’ų
`list_test_suite_runs`	Rodyti iš rinkinio sukurtus paleidimus
`get_test_suite_status`	Peržiūrėti rengimo parengtį ir naujausio paleidimo būseną

App UI Testing: bet kuris URL, be deploy

Testuokite bet kurios web app naudotojo sąsają, nukreipdami valdomą tester VM į URL. Norėdami testuoti, nereikia diegti app su OpenFactory. Tester VM atidaro vietinį dev serverį, peržiūros ar gamybinį diegimą Vercel, AWS, Netlify ar bet kuriame host’e, ar bet kurį viešą URL, pasiekiamą iš VM. Jūsų app lieka ten, kur jau veikia.

Scenarijai rašomi paprasta kalba ir yra self-hardening: pirmas paleidimas išmoksta, kur yra kiekvienas UI elementas, vėlesni paleidimai pakartoja iš to atminties (praleidžiant lėtą vizualinį perėjimą). Dėl to pakartojimai greiti ir atsparūs nedideliems UI pakeitimams. Scenarijai palaiko environment variables (${VAR}) ir 2FA (${totp:VAR}, RFC 6238) prisijungimams; slaptažodžiai perduodami paleidimo metu ir niekada nesaugomi.

Tool	Naudojimas
`ensure_tester_vm`	Gauti ar sukurti nuolatinę desktop tester VM
`create_app_scenario`	Išsaugoti pakartotinai naudojamą GUI scenarijų app URL
`run_app_scenario`	Paleisti (čia perduoti run-time secrets) ir įrašyti ekrano nuotraukas bei verdict
`list_app_scenarios` / `get_app_scenario`	Naršyti scenarijus ir jų hardened cache
`start_app_test` / `record_app_test_step` / `finish_app_test`	Patys valdyti ir įrašyti ad-hoc paleidimą
`annotate_screenshot`	Piešti pažymėtas paryškinimo dėžutes ekrano nuotraukoje

Visam workflow, step schemai ir 2FA pavyzdžiams žr. App UI Testing.

App Deployment: Git repo į viešą URL

Diekite web app tiesiai iš Git repository ir gaukite viešą peržiūros URL (https://<slug>.apps.openfactory.tech), kurią galite atidaryti, dalintis ar nurodyti test scenarijui. OpenFactory klonuoja repo, įdiegia priklausomybes, paleidžia app ir atlieka health check. Nereikia nieko sujunginėti: jokio port forwarding, tunelių ar DNS.

Tai derinasi su App UI testing: įdiekite app, tada paleiskite scenarijų prie jos peržiūros URL, arba praleiskite deploy ir testuokite jau host’inamą app (Vercel, AWS, …).

Tool	Naudojimas
`create_app`	Registruoti Git repo kaip app (name, source, slug)
`deploy_app`	Įdiegti app ir grąžinti viešą peržiūros URL
`list_apps` / `get_app`	Naršyti app, jų URL ir deploy istoriją
`iterate_app`	Siųsti natūralios kalbos pakeitimą app; agentas pritaiko ir perdeploy’ina
`get_app_build_status`	Tikrinti app deploy būseną ir vykdomus change ticket’us

Visam workflow žr. App Deployment. Kad jūsų vartotojai galėtų kalbėti pakeitimus į app per mikrofono mygtuką, žr. Voice Iterate Widget.

Pavyzdiniai prompt’ai


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.

Saugumo pastabos

API raktus naudokite tik su klientais, kuriais pasitikite.
Atšaukite senus raktus konsolėje keisdami mašinas ar išeidami iš projekto.
Pageidautina reikalauti patvirtinimo tool leidimams veiksmams, kurie kuria build’us, paleidžia VM ar keičia infrastruktūrą.
Neįklijuokite OpenFactory API raktų į prompt’us, ticket’us, viešus repository ar bendrinamus dokumentus.

Trikčių šalinimas

Įrankiai nerodomi

Paleiskite MCP klientą iš naujo ir patikrinkite, ar serverio URL tiksliai:


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

Jei klientas sukonfigūruotas su nebenaudojamu /mcp/sse URL, gausite 410 Gone: pakeiskite URL į aukščiau nurodytą; daugiau nieko keisti nereikia.

Autentifikacija nepavyksta

Atnaujinkite šį puslapį ir vėl nukopijuokite sugeneruotą konfigūraciją. Prisijungę vartotojai turėtų naudoti sugeneruotą Authorization antraštę. Svečiai turėtų naudoti sugeneruotą X-Guest-Id antraštę iš aukščiau esančios kopijuoti ir įklijuoti konfigūracijos.

Build ar VM veiksmai nepavyksta

Patikrinkite OpenFactory planą, organizacijos leidimus ir build būseną. Kai kurie veiksmai reikalauja baigto build’o, nuolatinės VM teisės ar Enterprise leidimų.

Transporto klaidos

Atnaujinkite MCP klientą, jei jis nepalaiko Streamable HTTP. Jei atnaujinti negalite, perjunkite į HTTP+SSE suderinamumo endpoint’ą.