Integrace MCP
OpenFactory podporuje Model Context Protocol , aby vám AI asistenti pomohli vytvářet buildy, prohlížet recepty, spravovat VM a kontrolovat výsledky testů.
MCP použijte, když chcete pracovat s OpenFactory z Claude, Cursor, Claude Code, OpenAI Codex nebo jiného klienta kompatibilního s MCP, aniž byste přepínali mezi nástroji.
Požadavky
- MCP klient s podporou vzdálených MCP serverů
- Pro přístup vázaný na účet se v tomto prohlížeči přihlaste do OpenFactory
- Pro hostovský přístup použijte vygenerovaný guest token zobrazený níže
API klíče účtu se zobrazí jednou při vytvoření a lze je zrušit v konzoli. Guest tokeny jsou identifikátory prohlížeče pro měřený přístup; nejsou to tajemství účtu.
Endpointy
| Transport | URL | Použití |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP endpoint |
Streamable HTTP je jediný podporovaný transport. Starší endpointy HTTP+SSE (/mcp/sse, /mcp/messages) byly ukončeny a nyní vracejí 410 Gone; u klientů, které je stále používají, nastavte URL Streamable HTTP výše se stejným hlavičkou Authorization. Claude Code, Claude Desktop, Cursor, Codex a OpenCode podporují Streamable HTTP.
Konfigurace ke zkopírování
Po změně nastavení MCP restartujte Claude Desktop, Cursor, OpenAI Codex nebo jiného dlouho běžícího MCP klienta. OpenAI Codex načítá MCP servery z ~/.codex/config.toml a připojuje se přímo ke Streamable HTTP: není potřeba most mcp-remote. Vlastní konektory Claude.ai mohou chtít URL serveru a hlavičku jako samostatná pole.
Dostupné možnosti
OpenFactory vystavuje nástroje pro zákazníky v těchto oblastech:
| Kategorie | Příklady |
|---|---|
| Builds | Seznam buildů, vytváření buildů z receptů, kontrola stavu buildu, opakování neúspěšných buildů |
| Recipes | Procházení šablon, validace receptů, úprava šablon |
| Images | Odkazy ke stažení dokončených artefaktů |
| VMs | Seznam VM, vytváření testovacích VM, spuštění nebo zastavení VM, otevření odkazů na konzoli |
| Tests | Spuštění ověření, seznam testovacích běhů, prohlížení výsledků testů, správa znovu použitelných test suites |
| App UI testing | Řízení tester VM pro test libovolné URL aplikace: znovu použitelné, self-hardening GUI scénáře. Deploy není potřeba |
| App deployment | Nasazení Git repozitáře jako živé webové aplikace s veřejnou preview URL (https://<slug>.apps.openfactory.tech) |
Dostupnost nástrojů se může lišit podle plánu a oprávnění organizace.
Znovu použitelné test suites
Test suites lze vytvořit dříve, než je postavena varianta nebo ISO. Definujte jeden
nebo více test cases, custom assertions, předdefinované testy a pojmenované ISO target
sloty jako primary, client nebo server. Až budou buildy hotové, přiřaďte každý
slot k dokončenému buildu a spusťte suite.
| Tool | Použití |
|---|---|
create_test_suite | Vytvoření znovu použitelné suite bez hotové varianty |
list_test_suites | Seznam suites dostupných aktuálnímu MCP uživateli |
get_test_suite | Zobrazení definice suite a nedávné historie běhů |
update_test_suite_targets | Přiřazení pojmenovaných ISO target slotů k dokončeným buildům |
run_test_suite | Spuštění suite proti přiřazeným ISO target slotům |
list_test_suite_runs | Seznam běhů vytvořených ze suite |
get_test_suite_status | Stav připravenosti k autorování a nejnovějšího běhu |
App UI testing: libovolná URL, bez deploye
Otestujte uživatelské rozhraní libovolné webové aplikace tím, že spravovanou tester VM nasměrujete na URL. Aplikaci nemusíte nasazovat přes OpenFactory, abyste ji testovali. Tester VM otevře lokální dev server, preview nebo produkční nasazení na Vercel, AWS, Netlify nebo libovolném hostiteli, nebo libovolnou veřejnou URL dosažitelnou z VM. Aplikace zůstane tam, kde už běží.
Scénáře se píší běžným jazykem a jsou self-hardening: první běh zjistí, kde je každý prvek UI,
a další běhy přehrávají z této paměti (bez pomalého vizuálního průchodu). Replay je tak rychlý a odolný vůči
malým změnám UI. Scénáře podporují proměnné prostředí (${VAR}) a 2FA (${totp:VAR}, RFC 6238) pro
přihlášení; tajemství se předávají za běhu a neukládají se.
| Tool | Použití |
|---|---|
ensure_tester_vm | Získání nebo vytvoření trvalé desktop tester VM |
create_app_scenario | Uložení znovu použitelného GUI scénáře pro URL aplikace |
run_app_scenario | Spuštění (tajemství za běhu zde) a záznam screenshotů a verdiktu |
list_app_scenarios / get_app_scenario | Procházení scénářů a jejich hardened cache |
start_app_test / record_app_test_step / finish_app_test | Vlastní řízení a záznam ad-hoc běhu |
annotate_screenshot | Vyznačení oblastí na screenshotu |
Úplný postup, schéma kroků a příklady 2FA najdete v App UI Testing.
App deployment: Git repozitář na veřejnou URL
Nasazte webovou aplikaci přímo z Git repozitáře a získejte veřejnou preview URL
(https://<slug>.apps.openfactory.tech), kterou můžete otevřít, sdílet nebo na ni namířit testovací
scénář. OpenFactory naklonuje repozitář, nainstaluje závislosti, spustí aplikaci
a provede health check. Není co zapojovat: žádné přesměrování portů,
tunely ani DNS.
To ladí s App UI testing: nasaďte aplikaci a spusťte scénář proti její preview URL, nebo deploy přeskočte a testujte aplikaci, kterou už hostujete (Vercel, AWS, …).
| Tool | Použití |
|---|---|
create_app | Registrace Git repozitáře jako aplikace (název, zdroj, slug) |
deploy_app | Nasazení aplikace a vrácení veřejné preview URL |
list_apps / get_app | Procházení aplikací, jejich URL a historie deployů |
iterate_app | Odeslání změny v přirozeném jazyce; agent ji aplikuje a znovu nasadí |
get_app_build_status | Dotaz na stav deploye aplikace a probíhajících change ticketů |
Úplný postup je v App Deployment. Chcete-li, aby vaši uživatelé mluvili změny do aplikace z tlačítka mikrofonu, viz Voice Iterate Widget.
Pří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čnost
- API klíče používejte jen u klientů, kterým důvěřujete.
- Staré klíče v konzoli zrušte při rotaci strojů nebo odchodu z projektu.
- U akcí, které vytvářejí buildy, spouštějí VM nebo mění infrastrukturu, preferujte oprávnění nástrojů s povinným schválením.
- API klíče OpenFactory nevkládejte do promptů, ticketů, veřejných repozitářů ani sdílených dokumentů.
Řešení problémů
Nástroje se nezobrazují
Restartujte MCP klienta a ověřte, že URL serveru je přesně:
https://console.openfactory.tech/mcp-stream/mcpPokud je klient nastaven na ukončenou URL /mcp/sse, dostane
410 Gone: změňte URL na výše uvedenou; jinak nic neměňte.
Selhání autentizace
Obnovte tuto stránku a znovu zkopírujte vygenerovanou konfiguraci. Přihlášení uživatelé mají použít vygenerovanou hlavičku Authorization. Hosté mají použít vygenerovanou hlavičku X-Guest-Id z konfigurace ke zkopírování výše.
Selhání akcí buildu nebo VM
Zkontrolujte plán OpenFactory, oprávnění organizace a stav buildu. Některé akce vyžadují dokončený build, trvalé oprávnění k VM nebo Enterprise oprávnění.
Chyby transportu
Aktualizujte MCP klienta, pokud nepodporuje Streamable HTTP. Pokud ho aktualizovat nemůžete, přepněte na kompatibilní endpoint HTTP+SSE.