Integracija MCP
OpenFactory podpira Model Context Protocol , da vam AI asistenti pomagajo ustvarjati build-e, pregledovati recepte, upravljati VM in pregledovati rezultate testov.
MCP uporabite, ko želite delati z OpenFactory iz Claude, Cursor, Claude Code, OpenAI Codex ali drugega odjemalca, združljivega z MCP, brez preklapljanja med orodji.
Zahteve
- MCP odjemalec s podporo za oddaljene MCP strežnike
- Za dostop, vezan na račun, se v tem brskalniku prijavite v OpenFactory
- Za gostujoči dostop uporabite ustvarjen guest token, prikazan spodaj
API ključi računa se prikažejo enkrat ob ustvarjanju in jih lahko prekličete v konzoli. Guest tokeni so identifikatorji brskalnika za merjen dostop; niso skrivnosti računa.
Končne točke
| Transport | URL | Uporaba |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP končna točka |
Streamable HTTP je edini podprt transport. Starejše končne točke HTTP+SSE (/mcp/sse, /mcp/messages) so ukinjene in zdaj vrnejo 410 Gone; odjemalce, ki jih še uporabljajo, usmerite na URL Streamable HTTP zgoraj z enako glavo Authorization. Claude Code, Claude Desktop, Cursor, Codex in OpenCode podpirajo Streamable HTTP.
Konfiguracija za kopiranje
Po spremembi nastavitev MCP znova zaženite Claude Desktop, Cursor, OpenAI Codex ali drugega dolgo tekočega MCP odjemalca. OpenAI Codex bere MCP strežnike iz ~/.codex/config.toml in se poveže neposredno na Streamable HTTP: most mcp-remote ni potreben. Prilagojeni konektorji Claude.ai lahko zahtevajo URL strežnika in glavo v ločenih poljih.
Razpoložljive zmogljivosti
OpenFactory izpostavi orodja za stranke na področjih:
| Kategorija | Primeri |
|---|---|
| Builds | Seznam build-ov, ustvarjanje build-ov iz receptov, preverjanje stanja build-a, ponovitev neuspešnih build-ov |
| Recipes | Brskanje po predlogah, validacija receptov, prilagajanje predlog |
| Images | Povezave za prenos dokončanih artefaktov |
| VMs | Seznam VM, ustvarjanje testnih VM, zagon ali ustavitev VM, odpiranje povezav do konzole |
| Tests | Zagon preverjanja, seznam testnih zagonov, pregled rezultatov testov, upravljanje večkrat uporabnih test suites |
| App UI testing | Vožnja tester VM za test poljubnega URL-ja aplikacije: večkrat uporabni, self-hardening GUI scenariji. Deploy ni potreben |
| App deployment | Namestitev Git repozitorija kot žive spletne aplikacije z javnim preview URL (https://<slug>.apps.openfactory.tech) |
Razpoložljivost orodij se lahko razlikuje glede na paket in dovoljenja organizacije.
Večkrat uporabne test suites
Test suites lahko ustvarite, preden je zgrajena varianta ali ISO. Določite en
ali več test cases, custom assertions, vnaprej določene teste in poimenovane ISO target
reže, na primer primary, client ali server. Ko so build-i pripravljeni, vsako
režo povežite z dokončanim build-om in zaženite suite.
| Tool | Uporaba |
|---|---|
create_test_suite | Ustvarjanje večkrat uporabne suite brez zgrajene variant |
list_test_suites | Seznam suites, dostopnih trenutnemu MCP uporabniku |
get_test_suite | Prikaz definicije suite in nedavne zgodovine zagonov |
update_test_suite_targets | Povezava poimenovanih ISO target rež z dokončanimi build-i |
run_test_suite | Zagon suite proti povezanim ISO target režam |
list_test_suite_runs | Seznam zagonov, ustvarjenih iz suite |
get_test_suite_status | Pripravljenost za avtorstvo in stanje zadnjega zagona |
App UI testing: poljuben URL, brez deploya
Preizkusite uporabniški vmesnik poljubne spletne aplikacije tako, da upravljani tester VM usmerite na URL. Aplikacije ni treba namestiti prek OpenFactory, da jo testirate. Tester VM odpre lokalni dev strežnik, preview ali produkcijsko namestitev na Vercel, AWS, Netlify ali katerem koli gostitelju, ali poljuben javni URL, dosegljiv z VM. Aplikacija ostane tam, kjer že teče.
Scenariji so napisani v navadnem jeziku in so self-hardening: prvi zagon ugotovi, kje je vsak element UI,
kasnejši zagoni predvajajo iz tega spomina (brez počasnega vizualnega prehoda). Ponovitve so hitre in odporne na
majhne spremembe UI. Scenariji podpirajo spremenljivke okolja (${VAR}) in 2FA (${totp:VAR}, RFC 6238) za
prijave; skrivnosti se posredujejo ob zagonu in se ne shranjujejo.
| Tool | Uporaba |
|---|---|
ensure_tester_vm | Pridobitev ali ustvarjanje trajne desktop tester VM |
create_app_scenario | Shranjevanje večkrat uporabnega GUI scenarija za URL aplikacije |
run_app_scenario | Zagon (skrivnosti ob zagonu tukaj) in zapis posnetkov zaslona ter sodbe |
list_app_scenarios / get_app_scenario | Brskanje po scenarijih in njihovi hardened cache |
start_app_test / record_app_test_step / finish_app_test | Samostojna vožnja in zapis ad-hoc zagona |
annotate_screenshot | Označevanje območij na posnetku zaslona |
Celoten potek, shema korakov in primeri 2FA so v App UI Testing.
App deployment: Git repozitorij na javni URL
Namestite spletno aplikacijo neposredno iz Git repozitorija in pridobite javni preview URL
(https://<slug>.apps.openfactory.tech), ki ga lahko odprete, delite ali nanj usmerite testni
scenarij. OpenFactory klonira repozitorij, namesti odvisnosti, zažene aplikacijo
in izvede health check. Ničesar ni treba povezovati: brez posredovanja vrat,
tunelov ali DNS.
To se ujema z App UI testing: namestite aplikacijo in zaženite scenarij proti njenemu preview URL, ali preskočite deploy in testirajte aplikacijo, ki jo že gostite (Vercel, AWS, …).
| Tool | Uporaba |
|---|---|
create_app | Registracija Git repozitorija kot aplikacije (ime, vir, slug) |
deploy_app | Namestitev aplikacije in vrnitev javnega preview URL |
list_apps / get_app | Brskanje po aplikacijah, njihovih URL-jih in zgodovini deployov |
iterate_app | Pošiljanje spremembe v naravnem jeziku; agent jo uveljavi in znova namesti |
get_app_build_status | Poizvedba o stanju deploya aplikacije in v teku change ticketov |
Celoten potek je v App Deployment. Če želite, da vaši uporabniki spreminjajo aplikacijo prek gumba za mikrofon, glejte Voice Iterate Widget.
Primeri promptov
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.Varnost
- API ključe uporabljajte le pri odjemalcih, ki jim zaupate.
- Stare ključe v konzoli prekličite ob rotaciji strojev ali odhodu iz projekta.
- Za dejanja, ki ustvarjajo build-e, zaganjajo VM ali spreminjajo infrastrukturo, dajte prednost dovoljenjem orodij s potrditvijo.
- API ključev OpenFactory ne prilepite v prompte, tickete, javne repozitorije ali skupne dokumente.
Odpravljanje težav
Orodja se ne prikažejo
Znova zaženite MCP odjemalca in preverite, da je URL strežnika točno:
https://console.openfactory.tech/mcp-stream/mcpČe je odjemalec nastavljen na ukinjeni URL /mcp/sse, dobi
410 Gone: spremenite URL na zgoraj navedenega; drugega ni treba spreminjati.
Avtentikacija ne uspe
Osvežite to stran in znova kopirajte ustvarjeno konfiguracijo. Prijavljeni uporabniki naj uporabijo ustvarjeno glavo Authorization. Gostje naj uporabijo ustvarjeno glavo X-Guest-Id iz konfiguracije za kopiranje zgoraj.
Dejanja build-a ali VM ne uspejo
Preverite paket OpenFactory, dovoljenja organizacije in stanje build-a. Nekatera dejanja zahtevajo dokončan build, trajno pravico do VM ali Enterprise dovoljenja.
Napake transporta
Posodobite MCP odjemalca, če ne podpira Streamable HTTP. Če ga ne morete posodobiti, preklopite na združljivo končno točko HTTP+SSE.