Integrácia MCP
OpenFactory podporuje Model Context Protocol , aby vám AI asistenti pomohli vytvárať buildy, prehliadať recepty, spravovať VM a kontrolovať výsledky testov.
MCP použite, keď chcete pracovať s OpenFactory z Claude, Cursor, Claude Code, OpenAI Codex alebo iného klienta kompatibilného s MCP, bez prepínania medzi nástrojmi.
Požiadavky
- MCP klient s podporou vzdialených MCP serverov
- Pre prístup viazaný na účet sa v tomto prehliadači prihláste do OpenFactory
- Pre hosťovský prístup použite vygenerovaný guest token zobrazený nižšie
API kľúče účtu sa zobrazia raz pri vytvorení a dajú sa zrušiť v konzole. Guest tokeny sú identifikátory prehliadača pre meraný prístup; nie sú to tajomstvá účtu.
Endpointy
| Transport | URL | Použitie |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP endpoint |
Streamable HTTP je jediný podporovaný transport. Staršie endpointy HTTP+SSE (/mcp/sse, /mcp/messages) boli ukončené a teraz vracajú 410 Gone; u klientov, ktoré ich stále používajú, nastavte URL Streamable HTTP vyššie s rovnakou hlavičkou Authorization. Claude Code, Claude Desktop, Cursor, Codex a OpenCode podporujú Streamable HTTP.
Konfigurácia na skopírovanie
Po zmene nastavení MCP reštartujte Claude Desktop, Cursor, OpenAI Codex alebo iného dlho bežiaceho MCP klienta. OpenAI Codex načítava MCP servery z ~/.codex/config.toml a pripája sa priamo na Streamable HTTP: nie je potrebný most mcp-remote. Vlastné konektory Claude.ai môžu chcieť URL servera a hlavičku ako samostatné polia.
Dostupné možnosti
OpenFactory vystavuje nástroje pre zákazníkov v týchto oblastiach:
| Kategória | Príklady |
|---|---|
| Builds | Zoznam buildov, vytváranie buildov z receptov, kontrola stavu buildu, opakovanie neúspešných buildov |
| Recipes | Prechádzanie šablón, validácia receptov, úprava šablón |
| Images | Odkazy na stiahnutie dokončených artefaktov |
| VMs | Zoznam VM, vytváranie testovacích VM, spustenie alebo zastavenie VM, otvorenie odkazov na konzolu |
| Tests | Spustenie overenia, zoznam testovacích behov, prehliadanie výsledkov testov, správa znovu použiteľných test suites |
| App UI testing | Riadenie tester VM na test ľubovoľnej URL aplikácie: znovu použiteľné, self-hardening GUI scenáre. Deploy netreba |
| App deployment | Nasadenie Git repozitára ako živej webovej aplikácie s verejnou preview URL (https://<slug>.apps.openfactory.tech) |
Dostupnosť nástrojov sa môže líšiť podľa plánu a oprávnení organizácie.
Znovu použiteľné test suites
Test suites sa dajú vytvoriť skôr, než je postavená varianta alebo ISO. Definujte jeden
alebo viac test cases, custom assertions, preddefinované testy a pomenované ISO target
sloty ako primary, client alebo server. Keď budú buildy hotové, priraďte každý
slot k dokončenému buildu a spustite suite.
| Tool | Použitie |
|---|---|
create_test_suite | Vytvorenie znovu použiteľnej suite bez hotovej varianty |
list_test_suites | Zoznam suites dostupných aktuálnemu MCP používateľovi |
get_test_suite | Zobrazenie definície suite a nedávnej histórie behov |
update_test_suite_targets | Priradenie pomenovaných ISO target slotov k dokončeným buildom |
run_test_suite | Spustenie suite proti priradeným ISO target slotom |
list_test_suite_runs | Zoznam behov vytvorených zo suite |
get_test_suite_status | Stav pripravenosti na autorovanie a najnovšieho behu |
App UI testing: ľubovoľná URL, bez deployu
Otestujte používateľské rozhranie ľubovoľnej webovej aplikácie tým, že spravovanú tester VM nasmerujete na URL. Aplikáciu nemusíte nasadiť cez OpenFactory, aby ste ju testovali. Tester VM otvorí lokálny dev server, preview alebo produkčné nasadenie na Vercel, AWS, Netlify alebo ľubovoľnom hostiteľovi, alebo ľubovoľnú verejnú URL dosiahnuteľnú z VM. Aplikácia zostane tam, kde už beží.
Scenáre sa píšu bežným jazykom a sú self-hardening: prvý beh zistí, kde je každý prvok UI,
a ďalšie behy prehrávajú z tejto pamäte (bez pomalého vizuálneho prechodu). Replay je tak rýchly a odolný voči
malým zmenám UI. Scenáre podporujú premenné prostredia (${VAR}) a 2FA (${totp:VAR}, RFC 6238) pre
prihlásenie; tajomstvá sa odovzdávajú za behu a neukladajú sa.
| Tool | Použitie |
|---|---|
ensure_tester_vm | Získanie alebo vytvorenie trvalej desktop tester VM |
create_app_scenario | Uloženie znovu použiteľného GUI scenára pre URL aplikácie |
run_app_scenario | Spustenie (tajomstvá za behu tu) a záznam screenshotov a verdiktu |
list_app_scenarios / get_app_scenario | Prechádzanie scenárov a ich hardened cache |
start_app_test / record_app_test_step / finish_app_test | Vlastné riadenie a záznam ad-hoc behu |
annotate_screenshot | Vyznačenie oblastí na screenshot-e |
Celý postup, schéma krokov a príklady 2FA nájdete v App UI Testing.
App deployment: Git repozitár na verejnú URL
Nasadte webovú aplikáciu priamo z Git repozitára a získajte verejnú preview URL
(https://<slug>.apps.openfactory.tech), ktorú môžete otvoriť, zdieľať alebo na ňu nasmerovať testovací
scenár. OpenFactory naklonuje repozitár, nainštaluje závislosti, spustí aplikáciu
a vykoná health check. Nič netreba zapájať: žiadne presmerovanie portov,
tunely ani DNS.
To ladí s App UI testing: nasaďte aplikáciu a spustite scenár proti jej preview URL, alebo deploy preskočte a testujte aplikáciu, ktorú už hostujete (Vercel, AWS, …).
| Tool | Použitie |
|---|---|
create_app | Registrácia Git repozitára ako aplikácie (názov, zdroj, slug) |
deploy_app | Nasadenie aplikácie a vrátenie verejnej preview URL |
list_apps / get_app | Prechádzanie aplikácií, ich URL a histórie deployov |
iterate_app | Odoslanie zmeny v prirodzenom jazyku; agent ju aplikuje a znova nasadí |
get_app_build_status | Dotaz na stav deployu aplikácie a prebiehajúcich change ticketov |
Celý postup je v App Deployment. Ak chcete, aby vaši používatelia hovorili zmeny do aplikácie z tlačidla mikrofónu, pozrite Voice Iterate Widget.
Príkladové prompty
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.Bezpečnosť
- API kľúče používajte len u klientov, ktorým dôverujete.
- Staré kľúče v konzole zrušte pri rotácii strojov alebo odchode z projektu.
- Pri akciách, ktoré vytvárajú buildy, spúšťajú VM alebo menia infraštruktúru, uprednostnite oprávnenia nástrojov s povinným schválením.
- API kľúče OpenFactory nevkladajte do promptov, ticketov, verejných repozitárov ani zdieľaných dokumentov.
Riešenie problémov
Nástroje sa nezobrazia
Reštartujte MCP klienta a overte, že URL servera je presne:
https://console.openfactory.tech/mcp-stream/mcpAk je klient nastavený na ukončenú URL /mcp/sse, dostane
410 Gone: zmeňte URL na uvedenú vyššie; inak nič nemeňte.
Zlyhanie autentifikácie
Obnovte túto stránku a znova skopírujte vygenerovanú konfiguráciu. Prihlásení používatelia majú použiť vygenerovanú hlavičku Authorization. Hostia majú použiť vygenerovanú hlavičku X-Guest-Id z konfigurácie na skopírovanie vyššie.
Zlyhanie akcií buildu alebo VM
Skontrolujte plán OpenFactory, oprávnenia organizácie a stav buildu. Niektoré akcie vyžadujú dokončený build, trvalé oprávnenie k VM alebo Enterprise oprávnenia.
Chyby transportu
Aktualizujte MCP klienta, ak nepodporuje Streamable HTTP. Ak ho aktualizovať nemôžete, prepnite na kompatibilný endpoint HTTP+SSE.