MCP integráció
Az OpenFactory támogatja a Model Context Protocol protokollt, hogy az AI asszisztensek segítsenek build-ek létrehozásában, receptek átnézésében, VM-ek kezelésében és teszteredmények ellenőrzésében.
Az MCP-t akkor érdemes használni, ha Claude-ból, Cursorból, Claude Code-ból, OpenAI Codexből vagy más MCP-kompatibilis kliensből szeretne az OpenFactory-vel dolgozni anélkül, hogy eszközök között váltogatna.
Követelmények
- Távoli MCP szervereket támogató MCP kliens
- Fiókhoz kötött hozzásához jelentkezzen be az OpenFactory-be ebben a böngészőben
- Vendég hozzásához használja az alább megjelenő generált guest tokent
A fiók API kulcsai létrehozáskor egyszer jelennek meg, és a konzolból visszavonhatók. A guest tokenek böngésző azonosítók mért hozzáféréshez; nem fiók titkok.
Végpontok
| Transport | URL | Használat |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | Az OpenFactory MCP végpont |
A Streamable HTTP az egyetlen támogatott transport. A régebbi HTTP+SSE végpontok (/mcp/sse, /mcp/messages) megszűntek, és most 410 Gone választ adnak; a még ezeket használó klienseket állítsa a fenti Streamable HTTP URL-re ugyanazzal az Authorization fejléccel. A Claude Code, Claude Desktop, Cursor, Codex és OpenCode támogatja a Streamable HTTP-t.
Másolható konfiguráció
Az MCP beállítások módosítása után indítsa újra a Claude Desktopot, a Cursort, az OpenAI Codexet vagy más hosszan futó MCP klienst. Az OpenAI Codex a ~/.codex/config.toml fájlból olvassa az MCP szervereket, és közvetlenül csatlakozik a Streamable HTTP-hez: nincs szükség mcp-remote hídra. A Claude.ai egyedi csatlakozói külön mezőkben kérhetik a szerver URL-jét és a fejlécet.
Elérhető képességek
Az OpenFactory ügyfél felé szánt eszközöket ad:
| Kategória | Példák |
|---|---|
| Builds | Build-ek listázása, build-ek létrehozása receptekből, build státusz ellenőrzése, sikertelen build-ek újrapróbálása |
| Recipes | Sablonok böngészése, receptek validálása, sablonok testreszabása |
| Images | Letöltési linkek kész artefaktumokhoz |
| VMs | VM-ek listázása, teszt VM-ek létrehozása, VM indítása vagy leállítása, konzol linkek megnyitása |
| Tests | Ellenőrzés futtatása, teszt futások listázása, teszteredmények átnézése, újrahasználható test suites kezelése |
| App UI testing | Tester VM vezetése bármely app URL teszteléséhez: újrahasználható, self-hardening GUI forgatókönyvek. Deploy nem kell |
| App deployment | Git repo deploy élő web appként nyilvános preview URL-lel (https://<slug>.apps.openfactory.tech) |
Az eszközök elérhetősége csomag és szervezeti jogosultságok szerint változhat.
Újrahasználható test suites
Test suite-ok létrehozhatók variant vagy ISO build előtt is. Határozzon meg egy
vagy több test case-t, custom assertion-t, előre definiált teszteket és elnevezett ISO target
slotokat, például primary, client vagy server. Amikor a build-ek készen állnak, kösse minden
slotot egy kész build-hez, majd futtassa a suite-ot.
| Tool | Használat |
|---|---|
create_test_suite | Újrahasználható suite létrehozása kész variant nélkül |
list_test_suites | Az aktuális MCP felhasználó számára elérhető suite-ok listázása |
get_test_suite | Suite definíció és legutóbbi futástörténet megtekintése |
update_test_suite_targets | Elnevezett ISO target slotok kötése kész build-ekhez |
run_test_suite | Suite futtatása a kötött ISO target slotok ellen |
list_test_suite_runs | Suite-ból létrejött futások listázása |
get_test_suite_status | Szerzői készültség és legutóbbi futás státusza |
App UI testing: bármely URL, deploy nélkül
Tesztelje bármely web app felhasználói felületét úgy, hogy egy kezelt tester VM-et egy URL-re irányít. Az appot nem kell az OpenFactory-vel deployolni a teszteléshez. A tester VM megnyit egy helyi dev szervert, preview vagy production deploy-t Vercel, AWS, Netlify vagy bármely host felületén, vagy bármely nyilvános URL-t, amely elérhető a VM-ről. Az app ott marad, ahol már fut.
A forgatókönyvek köznyelven íródnak, és self-hardening: az első futás megtanulja, hol van minden UI elem,
a későbbi futások ebből a memóriából játszanak le (a lassú vizuális átjárás kihagyásával). A replay gyors és ellenáll
a kisebb UI változásoknak. A forgatókönyvek támogatják a környezeti változókat (${VAR}) és a 2FA-t (${totp:VAR}, RFC 6238) a
bejelentkezéshez; a titkok futásidőben kerülnek átadásra, és nem tárolódnak.
| Tool | Használat |
|---|---|
ensure_tester_vm | Állandó desktop tester VM lekérése vagy létrehozása |
create_app_scenario | Újrahasználható GUI forgatókönyv mentése app URL-hez |
run_app_scenario | Futtatás (futásidőbeli titkok itt) és screenshotok plusz ítélet rögzítése |
list_app_scenarios / get_app_scenario | Forgatókönyvek és hardened cache böngészése |
start_app_test / record_app_test_step / finish_app_test | Ad-hoc futás saját vezetése és rögzítése |
annotate_screenshot | Kiemelt dobozok rajzolása screenshoton |
A teljes munkafolyamat, lépésséma és 2FA példák: App UI Testing.
App deployment: Git repo nyilvános URL-re
Deployoljon web appot közvetlenül Git repóból, és kapjon nyilvános preview URL-t
(https://<slug>.apps.openfactory.tech), amelyet megnyithat, megoszthat, vagy teszt forgatókönyvet irányíthat rá.
Az OpenFactory klónozza a repót, telepíti a függőségeket, elindítja az appot,
és health check-et futtat. Nincs mit bekötni: port továbbítás,
alagutak vagy DNS nélkül.
Ez párosul az App UI testinggel: deployolja az appot, majd futtasson forgatókönyvet a preview URL ellen, vagy hagyja ki a deployt, és tesztelje a már hostolt appot (Vercel, AWS, …).
| Tool | Használat |
|---|---|
create_app | Git repo regisztrálása appként (név, forrás, slug) |
deploy_app | App deploy és nyilvános preview URL visszaadása |
list_apps / get_app | Appok, URL-jeik és deploy történet böngészése |
iterate_app | Természetes nyelvű változás küldése; egy agent alkalmazza és újra deployol |
get_app_build_status | App deploy státusz és folyamatban lévő change ticketek lekérdezése |
A teljes munkafolyamat: App Deployment. Ha saját felhasználói mikrofon gombból beszéljenek változtatásokat az apphoz, lásd a Voice Iterate Widget oldalt.
Példa promptok
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.Biztonság
- API kulcsokat csak megbízható kliensekkel használjon.
- Régi kulcsokat vonjon vissza a konzolból gépcsere vagy projekt elhagyásakor.
- Build-eket, VM-eket vagy infrastruktúrát módosító műveleteknél részesítse előnyben a jóváhagyást igénylő eszköz jogosultságokat.
- Ne illesszen OpenFactory API kulcsokat promptokba, ticketekbe, nyilvános repókba vagy megosztott dokumentumokba.
Hibaelhárítás
Az eszközök nem jelennek meg
Indítsa újra az MCP klienst, és ellenőrizze, hogy a szerver URL pontosan ez:
https://console.openfactory.tech/mcp-stream/mcpHa a kliens a megszűnt /mcp/sse URL-re van állítva,
410 Gone választ kap: cserélje az URL-t a fenti értékre; mást nem kell módosítani.
Sikertelen hitelesítés
Frissítse ezt az oldalt, és másolja újra a generált konfigurációt. Bejelentkezett felhasználók a generált Authorization fejlécet használják. Vendégek a fenti másolható konfigurációból a generált X-Guest-Id fejlécet.
Build vagy VM műveletek sikertelenek
Ellenőrizze az OpenFactory csomagot, szervezeti jogosultságokat és a build státuszát. Egyes műveletek kész build-et, állandó VM jogosultságot vagy Enterprise jogosultságokat igényelnek.
Transport hibák
Frissítse az MCP klienst, ha nem támogatja a Streamable HTTP-t. Ha nem frissíthet, váltson HTTP+SSE kompatibilitási végpontra.