Integrare MCP
OpenFactory acceptă Model Context Protocol , astfel încât asistenții AI vă pot ajuta să creați build-uri, să inspectați rețete, să gestionați VM-uri și să revizuiți rezultatele testelor.
Folosiți MCP când lucrați cu OpenFactory din Claude, Cursor, Claude Code, OpenAI Codex sau alt client compatibil MCP, fără să alternați între instrumente.
Cerințe
- Client MCP care acceptă servere MCP la distanță
- Pentru acces legat de cont, autentificați-vă în OpenFactory în acest browser
- Pentru acces guest, folosiți tokenul guest generat afișat mai jos
Cheile API de cont se afișează o singură dată la creare și pot fi revocate din consolă. Tokenurile guest sunt identificatori de browser pentru acces măsurat; nu sunt secrete de cont.
Endpoint-uri
| Transport | URL | Utilizare |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | Endpointul MCP OpenFactory |
Streamable HTTP este singurul transport acceptat. Endpoint-urile HTTP+SSE mai vechi (/mcp/sse, /mcp/messages) au fost retrase și returnează acum 410 Gone; orientați orice client care le folosește încă către URL-ul Streamable HTTP de mai sus, cu același antet Authorization. Claude Code, Claude Desktop, Cursor, Codex și OpenCode acceptă Streamable HTTP.
Configurație de copiat
Reporniți Claude Desktop, Cursor, OpenAI Codex sau orice alt client MCP care rulează continuu după ce modificați setările MCP. OpenAI Codex citește serverele MCP din ~/.codex/config.toml și se conectează direct la Streamable HTTP: nu este nevoie de pod mcp-remote. Conectorii personalizați Claude.ai pot cere URL-ul serverului și antetul în câmpuri separate.
Capabilități disponibile
OpenFactory expune instrumente pentru clienți în domeniile:
| Categorie | Exemple |
|---|---|
| Builds | Listare build-uri, creare build-uri din rețete, verificare stare build, reluare build-uri eșuate |
| Recipes | Răsfoire șabloane, validare rețete, personalizare șabloane |
| Images | Linkuri de descărcare pentru artefacte finalizate |
| VMs | Listare VM-uri, creare VM-uri de test, pornire sau oprire VM-uri, deschidere linkuri consolă |
| Tests | Rulare verificare, listare rulări test, inspectare rezultate test, gestionare test suites reutilizabile |
| App UI testing | Conducere tester VM pentru testarea oricărui URL de app: scenarii GUI reutilizabile, self-hardening. Deploy nu este necesar |
| App deployment | Deploy repo Git ca aplicație web live cu URL preview public (https://<slug>.apps.openfactory.tech) |
Disponibilitatea instrumentelor poate varia după plan și permisiunile organizației.
Test suites reutilizabile
Test suites pot fi create înainte ca o variantă sau un ISO să fie construit. Definiți un
sau mai multe test cases, custom assertions, teste predefinite și sloturi ISO target
denumite, cum ar fi primary, client sau server. Când build-urile sunt gata, legați fiecare
slot de un build finalizat și rulați suite-ul.
| Tool | Utilizare |
|---|---|
create_test_suite | Creare suite reutilizabil fără variant construit |
list_test_suites | Listare suites disponibile utilizatorului MCP curent |
get_test_suite | Vizualizare definiție suite și istoric recent de rulări |
update_test_suite_targets | Legare sloturi ISO target denumite la build-uri finalizate |
run_test_suite | Rulare suite pe sloturile ISO target legate |
list_test_suite_runs | Listare rulări create dintr-un suite |
get_test_suite_status | Pregătire pentru autorare și starea ultimei rulări |
App UI testing: orice URL, fără deploy
Testați interfața oricărei aplicații web direcționând un tester VM gestionat către un URL. Nu trebuie să deployați aplicația cu OpenFactory ca să o testați. Tester VM deschide un server dev local, un deploy preview sau production pe Vercel, AWS, Netlify sau orice gazdă, sau orice URL public accesibil din VM. Aplicația rămâne unde rulează deja.
Scenariile sunt scrise în limbaj simplu și sunt self-hardening: prima rulare învață unde este fiecare element UI,
iar rulările ulterioare redau din această memorie (fără trecerea vizuală lentă). Replay-urile sunt rapide și rezistente la
schimbări mici de UI. Scenariile acceptă variabile de mediu (${VAR}) și 2FA (${totp:VAR}, RFC 6238) pentru
autentificări; secretele se transmit la rulare și nu se stochează.
| Tool | Utilizare |
|---|---|
ensure_tester_vm | Obținere sau creare tester VM desktop persistent |
create_app_scenario | Salvare scenariu GUI reutilizabil pentru URL aplicație |
run_app_scenario | Rulare (secrete la rulare aici) și înregistrare capturi ecran plus verdict |
list_app_scenarios / get_app_scenario | Răsfoire scenarii și hardened cache |
start_app_test / record_app_test_step / finish_app_test | Conducere și înregistrare manuală a unei rulări ad-hoc |
annotate_screenshot | Desenare casete evidențiate pe captură ecran |
Fluxul complet, schema pașilor și exemple 2FA: App UI Testing.
App deployment: repo Git către URL public
Deployați o aplicație web direct dintr-un repository Git și obțineți un URL preview public
(https://<slug>.apps.openfactory.tech) pe care îl puteți deschide, partaja sau indica un scenariu de test.
OpenFactory clonează repo-ul, instalează dependențele, pornește aplicația
și face health check. Nu aveți nimic de conectat: fără redirecționare porturi,
tuneluri sau DNS.
Se potrivește cu App UI testing: deployați aplicația, apoi rulați un scenariu pe URL-ul ei preview, sau omiteți deploy-ul și testați o aplicație pe care o găzduiți deja (Vercel, AWS, …).
| Tool | Utilizare |
|---|---|
create_app | Înregistrare repo Git ca aplicație (nume, sursă, slug) |
deploy_app | Deploy aplicație și returnare URL preview public |
list_apps / get_app | Răsfoire aplicații, URL-uri și istoric deploy |
iterate_app | Trimitere modificare în limbaj natural; un agent o aplică și redeployează |
get_app_build_status | Interogare stare deploy aplicație și change ticket-uri în curs |
Fluxul complet: App Deployment. Pentru ca utilizatorii dvs. să rostească modificări aplicației dintr-un buton de microfon, vedeți Voice Iterate Widget.
Exemple de prompturi
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.Note de securitate
- Folosiți cheile API doar cu clienți în care aveți încredere.
- Revocați cheile vechi din consolă când rotiți mașinile sau părăsiți proiectul.
- Pentru acțiuni care creează build-uri, pornesc VM-uri sau schimbă infrastructura, preferați permisiuni de instrument cu aprobare obligatorie.
- Nu lipiți chei API OpenFactory în prompturi, tickete, repository-uri publice sau documente partajate.
Depanare
Instrumentele nu apar
Reporniți clientul MCP și confirmați că URL-ul serverului este exact:
https://console.openfactory.tech/mcp-stream/mcpDacă clientul este configurat cu URL-ul retras /mcp/sse, va primi
410 Gone: schimbați URL-ul cu cel de mai sus; altceva nu trebuie modificat.
Autentificarea eșuează
Reîmprospătați această pagină și copiați din nou configurația generată. Utilizatorii autentificați ar trebui să folosească antetul Authorization generat. Utilizatorii guest ar trebui să folosească antetul X-Guest-Id generat din configurația de copiat de mai sus.
Acțiunile build sau VM eșuează
Verificați planul OpenFactory, permisiunile organizației și starea build-ului. Unele acțiuni necesită un build finalizat, drept persistent la VM sau permisiuni Enterprise.
Erori de transport
Actualizați clientul MCP dacă nu acceptă Streamable HTTP. Dacă nu îl puteți actualiza, comutați la endpoint-ul de compatibilitate HTTP+SSE.