MCP integrācija

OpenFactory atbalsta Model Context Protocol , lai mākslīgā intelekta asistenti varētu palīdzēt veidot build’us, pārbaudīt receptes, pārvaldīt VM un pārskatīt testu rezultātus.

Izmantojiet MCP, ja vēlaties strādāt ar OpenFactory no Claude, Cursor, Claude Code, OpenAI Codex vai cita ar MCP saderīga klienta, nepārslēdzoties pastāvīgi starp rīkiem.

Prasības

MCP klients, kas atbalsta attālos MCP serverus
Piekļuvei, kas saistīta ar kontu: pierakstieties OpenFactory šajā pārlūkā
Viesu piekļuvei: izmantojiet zemāk redzamo ģenerēto viesu tokenu

Konta API atslēgas tiek parādītas vienreiz izveides brīdī un tās var atsaukt konsolē. Viesu tokeni ir pārlūka identifikatori maksas piekļuvei; tie nav konta noslēpumi.

Endpoint’i

Transport	URL	Lietojums
Streamable HTTP	`https://console.openfactory.tech/mcp-stream/mcp`	OpenFactory MCP endpoint

Streamable HTTP ir vienīgais atbalstītais transports. Vecie HTTP+SSE endpoint’i (/mcp/sse, /mcp/messages) vairs netiek lietoti un tagad atgriež 410 Gone; novirziet visus klientus, kas tos vēl izmanto, uz augstāk norādīto Streamable HTTP URL ar to pašu Authorization galveni. Claude Code, Claude Desktop, Cursor, Codex un OpenCode atbalsta Streamable HTTP.

Kopēt un ielīmēt konfigurāciju

Preparing your MCP config...

Pēc MCP iestatījumu maiņas restartējiet Claude Desktop, Cursor, OpenAI Codex vai citu ilgi darbojošos MCP klientu. OpenAI Codex nolasa MCP serverus no ~/.codex/config.toml un savienojas tieši ar Streamable HTTP: mcp-remote tilta nav vajadzīgs. Claude.ai pielāgotie savienotāji var lūgt servera URL un galveni atsevišķos laukos.

Pieejamās iespējas

OpenFactory nodrošina klientiem paredzētus rīkus:

Kategorija	Piemēri
Builds	Build’u saraksts, build’u veidošana no receptēm, build statusa pārbaude, neizdevušos build’u atkārtošana
Recipes	Veidņu pārlūkošana, recepšu validācija, veidņu pielāgošana
Images	Lejupielādes saites pabeigtiem artefaktiem
VMs	VM saraksts, testu VM veidošana, VM startēšana vai apturēšana, konsoles saišu atvēršana
Tests	Verifikācijas palaišana, testu skrējienu saraksts, testu rezultātu pārbaude, atkārtoti lietojamu testu komplektu pārvaldība
App UI testing	Tester VM vadība, lai testētu jebkuru app URL: atkārtoti lietojami, self-hardening GUI scenāriji. Deploy nav vajadzīgs
App deployment	Git repo izvietošana kā live web app ar publisku priekšskatījuma URL (`https://<slug>.apps.openfactory.tech`)

Rīku pieejamība var atšķirties pēc plāna un organizācijas atļaujām.

Atkārtoti lietojami testu komplekti

Testu komplektus var izveidot pirms variantam vai ISO ir uzbūvēts. Definējiet vienu vai vairākus testu gadījumus, custom assertions, iepriekš definētus testus un nosauktus ISO mērķa slot’us, piem., primary, client vai server. Kad build’i ir gatavi, saistiet katru slot’u ar pabeigtu build’u un palaidiet komplektu.

Tool	Lietojums
`create_test_suite`	Izveidot atkārtoti lietojamu komplektu bez prasības pēc uzbūvēta varianta
`list_test_suites`	Sarakstīt pašreizējam MCP lietotājam pieejamos komplektus
`get_test_suite`	Skatīt komplekta definīciju un neseno palaišanu vēsturi
`update_test_suite_targets`	Saistīt nosauktos ISO mērķa slot’us ar pabeigtiem build’iem
`run_test_suite`	Palaist komplektu pret saistītajiem ISO mērķa slot’iem
`list_test_suite_runs`	Sarakstīt palaišanas, kas radītas no komplekta
`get_test_suite_status`	Skatīt sagatavošanas gatavību un jaunākās palaišanas statusu

App UI Testing: jebkurš URL, bez deploy

Testējiet jebkuras web app lietotāja saskarni, norādot pārvaldītu tester VM uz URL. Lai testētu, nav jāizvieto app ar OpenFactory. Tester VM atver vietējo dev serveri, priekšskatījuma vai produkcijas izvietojumu Vercel, AWS, Netlify vai jebkurā host’ā, vai jebkuru publisku URL, kas sasniedzams no VM. Jūsu app paliek tur, kur jau darbojas.

Scenāriji ir rakstīti vienkāršā valodā un ir self-hardening: pirmajā palaišanā tiek iemācīts, kur atrodas katrs UI elements, vēlākās palaišanas atkārto no šīs atmiņas (izlaižot lēno vizuālo caurlaidi). Tādējādi atkārtojumi ir ātri un noturīgi pret nelielām UI izmaiņām. Scenāriji atbalsta environment variables (${VAR}) un 2FA (${totp:VAR}, RFC 6238) pierakstīšanās reizēm; noslēpumi tiek nodoti palaišanas laikā un nekad netiek glabāti.

Tool	Lietojums
`ensure_tester_vm`	Iegūt vai izveidot pastāvīgu desktop tester VM
`create_app_scenario`	Saglabāt atkārtoti lietojamu GUI scenāriju app URL
`run_app_scenario`	Palaist (šeit nodot run-time secrets) un ierakstīt ekrānuzņēmumus un verdict
`list_app_scenarios` / `get_app_scenario`	Pārlūkot scenārijus un to hardened cache
`start_app_test` / `record_app_test_step` / `finish_app_test`	Pašiem vadīt un ierakstīt ad-hoc palaišanu
`annotate_screenshot`	Uz ekrānuzņēmuma zīmēt apzīmētas izcelšanas kastes

Pilnai darba plūsmai, step shēmai un 2FA piemēriem skatiet App UI Testing.

App Deployment: Git repo uz publisku URL

Izvietojiet web app tieši no Git repository un saņemiet publisku priekšskatījuma URL (https://<slug>.apps.openfactory.tech), ko varat atvērt, kopīgot vai norādīt testa scenārijam. OpenFactory klonē repo, instalē atkarības, startē app un veic health check. Nav neko jāsavieno: nav port forwarding, tuneļu vai DNS.

Tas labi sader ar App UI testing: izvietojiet app, tad palaidiet scenāriju pret tās priekšskatījuma URL, vai izlaidiet deploy un testējiet jau host’ētu app (Vercel, AWS, …).

Tool	Lietojums
`create_app`	Reģistrēt Git repo kā app (name, source, slug)
`deploy_app`	Izvietot app un atgriezt publisku priekšskatījuma URL
`list_apps` / `get_app`	Pārlūkot app, to URL un deploy vēsturi
`iterate_app`	Nosūtīt dabiskās valodas izmaiņu app; aģents piemēro un pārizvieto
`get_app_build_status`	Pārbaudīt app deploy statusu un notiekošos change ticket’us

Pilnai darba plūsmai skatiet App Deployment. Lai jūsu lietotāji varētu runāt izmaiņas app caur mikrofona pogu, skatiet Voice Iterate Widget.

Piemēru prompt’i


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.

Drošības piezīmes

API atslēgas izmantojiet tikai ar klientiem, kuriem uzticaties.
Atceļiet vecās atslēgas konsolē, mainot mašīnas vai atstājot projektu.
Dodiet priekšroku apstiprinājumu prasošām tool atļaujām darbībām, kas veido build’us, startē VM vai maina infrastruktūru.
Neielīmējiet OpenFactory API atslēgas prompt’os, ticket’os, publiskos repository vai koplietotos dokumentos.

Problēmu novēršana

Rīki neparādās

Restartējiet MCP klientu un pārliecinieties, ka servera URL ir tieši:


https://console.openfactory.tech/mcp-stream/mcp

Ja klients ir konfigurēts ar neaktīvo /mcp/sse URL, saņemsiet 410 Gone: nomainiet URL uz augstāk norādīto; vairāk nekas nav jāmaina.

Autentifikācija neizdodas

Atjaunojiet šo lapu un vēlreiz nokopējiet ģenerēto konfigurāciju. Pierakstījušiem lietotājiem jāizmanto ģenerētā Authorization galvene. Viesiem jāizmanto ģenerētā X-Guest-Id galvene no augstāk esošās kopēt un ielīmēt konfigurācijas.

Build vai VM darbības neizdodas

Pārbaudiet OpenFactory plānu, organizācijas atļaujas un build statusu. Dažām darbībām vajag pabeigtu build’u, pastāvīgu VM tiesību vai Enterprise atļaujas.

Transporta kļūdas

Atjauniniet MCP klientu, ja tas neatbalsta Streamable HTTP. Ja atjaunināt nevarat, pārslēdzieties uz HTTP+SSE saderības endpoint’u.