Integracija MCP-a
OpenFactory podržava Model Context Protocol kako bi vam AI asistenti pomogli stvarati buildove, pregledavati recepte, upravljati VM-ovima i pregledavati rezultate testova.
Koristite MCP kad želite raditi s OpenFactory iz Claude, Cursor, Claude Code, OpenAI Codex ili drugog MCP-kompatibilnog klijenta bez prebacivanja između alata.
Preduvjeti
- MCP klijent s podrškom za udaljene MCP poslužitelje
- Za pristup vezan uz račun prijavite se u OpenFactory u ovom pregledniku
- Za gostujući pristup koristite generirani guest token prikazan u nastavku
API ključevi računa prikazuju se jednom pri stvaranju i mogu se opozvati u konzoli. Guest tokeni su identifikatori preglednika za mjereni pristup; nisu tajne računa.
Krajnje točke
| Transport | URL | Upotreba |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP krajnja točka |
Streamable HTTP je jedini podržani transport. Starije HTTP+SSE krajnje točke (/mcp/sse, /mcp/messages) su ukinute i sada vraćaju 410 Gone; klijente koji ih još koriste usmjerite na URL Streamable HTTP gore s istim zaglavljem Authorization. Claude Code, Claude Desktop, Cursor, Codex i OpenCode podržavaju Streamable HTTP.
Konfiguracija za kopiranje
Nakon promjene MCP postavki ponovno pokrenite Claude Desktop, Cursor, OpenAI Codex ili drugi dugotrajno pokrenuti MCP klijent. OpenAI Codex učitava MCP poslužitelje iz ~/.codex/config.toml i povezuje se izravno na Streamable HTTP: most mcp-remote nije potreban. Prilagođeni konektori Claude.ai mogu tražiti URL poslužitelja i zaglavlje u odvojenim poljima.
Dostupne mogućnosti
OpenFactory izlaže alate za korisnike u područjima:
| Kategorija | Primjeri |
|---|---|
| Builds | Popis buildova, stvaranje buildova iz recepta, provjera statusa builda, ponovni pokušaj neuspjelih buildova |
| Recipes | Pregled predložaka, validacija recepta, prilagodba predložaka |
| Images | Poveznice za preuzimanje dovršenih artefakata |
| VMs | Popis VM-ova, stvaranje testnih VM-ova, pokretanje ili zaustavljanje VM-ova, otvaranje poveznica konzole |
| Tests | Pokretanje verifikacije, popis test runova, pregled rezultata testova, upravljanje višekratno upotrebljivim test suites |
| App UI testing | Vođenje tester VM-a za test bilo kojeg URL-a aplikacije: višekratno upotrebljivi, self-hardening GUI scenariji. Deploy nije potreban |
| App deployment | Deploy Git repozitorija kao live web aplikacije s javnim preview URL-om (https://<slug>.apps.openfactory.tech) |
Dostupnost alata može varirati ovisno o planu i dopuštenjima organizacije.
Višekratno upotrebljive test suites
Test suites mogu se stvoriti prije nego što je izgrađena varijanta ili ISO. Definirajte jedan
ili više test cases, custom assertions, unaprijed definirane testove i imenovane ISO target
slotove poput primary, client ili server. Kad su buildovi spremni, povežite svaki
slot s dovršenim buildom i pokrenite suite.
| Tool | Upotreba |
|---|---|
create_test_suite | Stvaranje višekratno upotrebljive suite bez izgrađene variant |
list_test_suites | Popis suites dostupnih trenutačnom MCP korisniku |
get_test_suite | Pregled definicije suite i nedavne povijesti runova |
update_test_suite_targets | Povezivanje imenovanih ISO target slotova s dovršenim buildovima |
run_test_suite | Pokretanje suite protiv povezanih ISO target slotova |
list_test_suite_runs | Popis runova stvorenih iz suite |
get_test_suite_status | Spremnost za autorstvo i status zadnjeg runa |
App UI testing: bilo koji URL, bez deploya
Testirajte korisničko sučelje bilo koje web aplikacije usmjeravanjem upravljanog tester VM-a na URL. Ne morate deployati aplikaciju putem OpenFactory da biste je testirali. Tester VM otvara lokalni dev server, preview ili produkcijski deploy na Vercel, AWS, Netlify ili bilo kojem hostu, ili bilo koji javni URL dostupan s VM-a. Aplikacija ostaje gdje već radi.
Scenariji su napisani običnim jezikom i self-hardening: prvi run uči gdje je svaki UI element,
a kasniji runovi reproduciraju iz te memorije (bez sporog vizualnog prolaza). To čini replay brzim i otpornim na
male promjene UI-a. Scenariji podržavaju varijable okruženja (${VAR}) i 2FA (${totp:VAR}, RFC 6238) za
prijave; tajne se predaju u vrijeme runa i ne pohranjuju se.
| Tool | Upotreba |
|---|---|
ensure_tester_vm | Dohvat ili stvaranje trajnog desktop tester VM-a |
create_app_scenario | Spremanje višekratno upotrebljivog GUI scenarija za URL aplikacije |
run_app_scenario | Pokretanje (tajne u vrijeme runa ovdje) i zapis screenshotova i presude |
list_app_scenarios / get_app_scenario | Pregled scenarija i njihove hardened cache |
start_app_test / record_app_test_step / finish_app_test | Samostalno vođenje i snimanje ad-hoc runa |
annotate_screenshot | Označavanje područja na screenshotu |
Cijeli tijek rada, shema koraka i primjeri 2FA u App UI Testing.
App deployment: Git repozitorij na javni URL
Deployajte web aplikaciju izravno iz Git repozitorija i dobijte javni preview URL
(https://<slug>.apps.openfactory.tech) koji možete otvoriti, podijeliti ili usmjeriti testni
scenarij na njega. OpenFactory klonira repozitorij, instalira ovisnosti, pokreće aplikaciju
i provodi health check. Nema što spajati: bez prosljeđivanja portova,
tunela ili DNS-a.
To se slaže s App UI testingom: deployajte aplikaciju, zatim pokrenite scenarij protiv njenog preview URL-a, ili preskočite deploy i testirajte aplikaciju koju već hostate (Vercel, AWS, …).
| Tool | Upotreba |
|---|---|
create_app | Registracija Git repozitorija kao aplikacije (ime, izvor, slug) |
deploy_app | Deploy aplikacije i vraćanje javnog preview URL-a |
list_apps / get_app | Pregled aplikacija, njihovih URL-ova i povijesti deploya |
iterate_app | Slanje promjene prirodnim jezikom; agent je primjenjuje i ponovno deploya |
get_app_build_status | Upit statusa deploya aplikacije i change ticketa u tijeku |
Cijeli tijek rada u App Deployment. Da vaši korisnici izgovaraju promjene aplikaciji s gumba mikrofona, pogledajte Voice Iterate Widget.
Primjeri promptova
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.Sigurnost
- API ključeve koristite samo s klijentima kojima vjerujete.
- Stare ključeve opozovite u konzoli kad rotirate strojeve ili napuštate projekt.
- Za radnje koje stvaraju buildove, pokreću VM-ove ili mijenjaju infrastrukturu preferirajte dopuštenja alata s obveznim odobrenjem.
- API ključeve OpenFactory ne lijepite u promptove, tickete, javne repozitorije ili dijeljene dokumente.
Rješavanje problema
Alati se ne prikazuju
Ponovno pokrenite MCP klijent i potvrdite da je URL poslužitelja točno:
https://console.openfactory.tech/mcp-stream/mcpAko je klijent postavljen na ukinuti URL /mcp/sse, dobit će
410 Gone: promijenite URL na gore navedeni; ništa drugo ne treba mijenjati.
Autentikacija ne uspijeva
Osvježite ovu stranicu i ponovno kopirajte generiranu konfiguraciju. Prijavljeni korisnici trebaju koristiti generirano zaglavlje Authorization. Gosti trebaju koristiti generirano zaglavlje X-Guest-Id iz konfiguracije za kopiranje gore.
Radnje builda ili VM-a ne uspijevaju
Provjerite plan OpenFactory, dopuštenja organizacije i status builda. Neke radnje zahtijevaju dovršen build, trajno pravo na VM ili Enterprise dopuštenja.
Greške transporta
Ažurirajte MCP klijent ako ne podržava Streamable HTTP. Ako ga ne možete ažurirati, prebacite se na kompatibilnu HTTP+SSE krajnju točku.