MCP integratsioon
OpenFactory toetab Model Context Protocol , et tehisintellekti assistendid saaksid aidata build’e luua, retsepte kontrollida, VM-e hallata ja testitulemusi üle vaadata.
Kasutage MCP-d, kui soovite OpenFactoryga töötada Claude’i, Cursori, Claude Code’i, OpenAI Codexi või muu MCP-ühilduva kliendi kaudu ilma pideva tööriistade vahetamiseta.
Nõuded
- MCP klient, mis toetab kaug-MCP-servereid
- Kontoga seotud juurdepääsuks: logige selles brauseris OpenFactorysse sisse
- Külalise juurdepääsuks: kasutage all kuvatud genereeritud külalisemärki
Konto API võtmed kuvatakse loomisel üks kord ja neid saab konsoolist tühistada. Külalisemärgid on brauseri identifikaatorid mõõdetava juurdepääsu jaoks; need ei ole konto saladused.
Endpoint’id
| Transport | URL | Kasutus |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP endpoint |
Streamable HTTP on ainus toetatud transport. Vanemad HTTP+SSE endpoint’id (/mcp/sse, /mcp/messages) on kasutuselt kõrvaldatud ja tagastavad nüüd 410 Gone; suunake kõik kliendid, kes neid veel kasutavad, ülalolevale Streamable HTTP URL-ile sama Authorization päisega. Claude Code, Claude Desktop, Cursor, Codex ja OpenCode toetavad Streamable HTTP-d.
Kopeeri-kleebi konfiguratsioon
Taaskäivitage pärast MCP seadete muutmist Claude Desktop, Cursor, OpenAI Codex või muu pikalt töötav MCP klient. OpenAI Codex loeb MCP servereid failist ~/.codex/config.toml ja ühendub otse Streamable HTTP-ga: mcp-remote silda pole vaja. Claude.ai kohandatud ühendused võivad küsida serveri URL-i ja päist eraldi väljadena.
Saadaolevad võimalused
OpenFactory pakub kliendile suunatud tööriistu:
| Kategooria | Näited |
|---|---|
| Builds | Build’ide loetlemine, build’ide loomine retseptidest, build’i staatuse kontroll, ebaõnnestunud build’ide korduskatsed |
| Recipes | Mallide sirvimine, retseptide valideerimine, mallide kohandamine |
| Images | Allalaadimislingid valmis artefaktidele |
| VMs | VM-ide loetlemine, test-VM-ide loomine, VM-ide käivitamine või peatamine, konsoolilinkide avamine |
| Tests | Verifikatsiooni käivitamine, testikäivituste loetlemine, testitulemuste ülevaatus, korduvkasutatavate testsuite’ide haldamine |
| App UI testing | Tester VM-i juhtimine mis tahes app URL-i testimiseks: korduvkasutatavad, self-hardening GUI stsenaariumid. Deploy pole vajalik |
| App deployment | Git repo juurutamine live web app’ina avaliku eelvaate URL-iga (https://<slug>.apps.openfactory.tech) |
Tööriistade kättesaadavus võib plaanist ja organisatsiooni õigustest sõltuvalt erineda.
Korduvkasutatavad testsuite’id
Testsuite’e saab luua enne, kui variant või ISO on ehitatud. Määratlege üks või mitu testijuhtu, custom assertions, eelmääratletud testid ja nimetatud ISO sihtslot’id nagu primary, client või server. Kui build’id on valmis, seoge iga slot valmis build’iga ja käivitage suite.
| Tool | Kasutus |
|---|---|
create_test_suite | Luua korduvkasutatav suite ilma ehitatud varianti nõudmata |
list_test_suites | Loetleda praegusele MCP kasutajale saadaolevad suite’id |
get_test_suite | Vaadata suite’i definitsiooni ja hiljutist käivituste ajalugu |
update_test_suite_targets | Seostada nimetatud ISO sihtslot’id valmis build’idega |
run_test_suite | Käivitada suite seotud ISO sihtslot’ide vastu |
list_test_suite_runs | Loetleda suite’ist loodud käivitused |
get_test_suite_status | Vaadata koostamise valmisolekut ja viimase käivituse staatust |
App UI Testing: mis tahes URL, deploy’ta
Testige mis tahes veebirakenduse kasutajaliidest, suunates hallatava tester VM-i URL-ile. Testimiseks ei pea te rakendust OpenFactoryga deploy’ima. Tester VM avab kohaliku dev serveri, eelvaate või toodangu paigutuse Vercelil, AWS-is, Netlify’s või mis tahes host’il või mis tahes avaliku URL-i, mis VM-ist kättesaadav on. Teie app jääb sinna, kus see juba töötab.
Stsenaariumid on kirjutatud lihtsas keeles ja on self-hardening: esimene käivitus õpib, kus iga UI element asub, hilisemad käivitused taasesitavad seda mälu (jättes vahele aeglase visuaalse läbimise). See teeb kordused kiireks ja väikeste UI muudatuste suhtes vastupidavaks. Stsenaariumid toetavad environment variables (${VAR}) ja 2FA (${totp:VAR}, RFC 6238) sisselogimiste jaoks; saladused edastatakse käivituse ajal ja neid ei salvestata.
| Tool | Kasutus |
|---|---|
ensure_tester_vm | Hankida või luua püsiv desktop tester VM |
create_app_scenario | Salvestada korduvkasutatav GUI stsenaarium app URL-ile |
run_app_scenario | Käivitada (edastage run-time secrets siin) ja salvestada ekraanipildid + verdict |
list_app_scenarios / get_app_scenario | Sirvida stsenaariume ja nende hardened cache’i |
start_app_test / record_app_test_step / finish_app_test | Juhtida ja salvestada ad-hoc käivitus ise |
annotate_screenshot | Joonistada märgistatud esiletõstmiskastid ekraanipildile |
Täieliku workflow, step skeemi ja 2FA näidete jaoks vaadake App UI Testing.
App Deployment: Git repo avalikule URL-ile
Deploy’ige veebirakendus otse Git repository’st ja saage avalik eelvaate URL
(https://<slug>.apps.openfactory.tech), mida saate avada, jagada või testistsenaariumile suunata.
OpenFactory kloonib repo, installib sõltuvused, käivitab app’i ja teeb health check’i.
Pole midagi ühendada: port forwarding, tunnelid ega DNS puuduvad.
See sobib App UI testinguga: deploy’ige app, seejärel käivitage stsenaarium selle eelvaate URL-i vastu, või jätke deploy vahele ja testige juba host’itud app’i (Vercel, AWS, …).
| Tool | Kasutus |
|---|---|
create_app | Registreerida Git repo app’ina (name, source, slug) |
deploy_app | Deploy’ida app ja tagastada avalik eelvaate URL |
list_apps / get_app | Sirvida app’e, nende URL-e ja deploy ajalugu |
iterate_app | Saata looduskeelse muudatuse app’ile; agent rakendab ja deploy’ib uuesti |
get_app_build_status | Küsida app’i deploy staatust ja pooleli change ticket’e |
Täieliku workflow jaoks vaadake App Deployment. Et teie kasutajad saaksid muudatusi app’i rääkida mikrofoni nupu kaudu, vaadake Voice Iterate Widget.
Näidis-prompt’id
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.Turvalisuse märkused
- Kasutage API võtmeid ainult klientidega, mida usaldate.
- Tühistage vanad võtmed konsoolis, kui vahetate masinaid või lahkute projektist.
- Eelistage kinnitust nõudvaid tool õigusi toimingutele, mis loovad build’e, käivitavad VM-e või muudavad infrastruktuuri.
- Ärge kleepige OpenFactory API võtmeid prompt’idesse, ticket’itesse, avalikesse repository’desse ega jagatud dokumentidesse.
Tõrkeotsing
Tööriistad ei ilmu
Taaskäivitage MCP klient ja kinnitage, et serveri URL on täpselt:
https://console.openfactory.tech/mcp-stream/mcpKui klient on seadistatud kasutuselt kõrvaldatud /mcp/sse URL-iga, saate 410 Gone: muutke URL ülalolevaks; muud muudatused pole vajalikud.
Autentimine ebaõnnestub
Värskendage seda lehte ja kopeerige genereeritud konfiguratsioon uuesti. Sisse loginud kasutajad peaksid kasutama genereeritud Authorization päist. Külalised peaksid kasutama genereeritud X-Guest-Id päist ülalolevast kopeeri-kleebi konfiguratsioonist.
Build või VM toimingud ebaõnnestuvad
Kontrollige OpenFactory plaani, organisatsiooni õigusi ja build’i staatust. Mõned toimingud nõuavad valmis build’i, püsivat VM entitlement’i või Enterprise õigusi.
Transpordi vead
Uuendage MCP klienti, kui see ei toeta Streamable HTTP-d. Kui uuendada ei saa, lülitage HTTP+SSE ühilduvus endpoint’ile.