MCP-integraatio
OpenFactory tukee Model Context Protocol -protokollaa, jotta tekoälyavustajat voivat auttaa buildien luonnissa, reseptien tarkastelussa, VM:ien hallinnassa ja testitulosten läpikäynnissä.
Käytä MCP:ää, kun haluat työskennellä OpenFactoryn kanssa Clauden, Cursorin, Claude Coden, OpenAI Codexin tai muun MCP-yhteensopivan asiakkaan kautta ilman jatkuvaa työkalujen vaihtamista.
Vaatimukset
- MCP-asiakas, joka tukee etä-MCP-palvelimia
- Tiliin sidottuun käyttöön: kirjaudu OpenFactoryyn tässä selaimessa
- Vieraskäyttöön: käytä alla näkyvää luotua vierastokenia
Tilin API-avaimet näytetään kerran luonnin yhteydessä, ja ne voi perua konsolista. Vierastokenit ovat selaimen tunnisteita mitattua käyttöä varten; ne eivät ole tilin salaisuuksia.
Endpointit
| Transport | URL | Käyttö |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactoryn MCP-endpoint |
Streamable HTTP on ainoa tuettu kuljetus. Vanhemmat HTTP+SSE-endpointit (/mcp/sse, /mcp/messages) on poistettu käytöstä, ja ne palauttavat nyt 410 Gone; ohjaa ne asiakkaat, jotka vielä käyttävät niitä, yllä olevaan Streamable HTTP -URL-osoitteeseen samalla Authorization-otsikolla. Claude Code, Claude Desktop, Cursor, Codex ja OpenCode tukevat Streamable HTTP:ää.
Kopioi-liitä-konfiguraatio
Käynnistä Claude Desktop, Cursor, OpenAI Codex tai muu pitkään käynnissä oleva MCP-asiakas uudelleen MCP-asetusten muuttamisen jälkeen. OpenAI Codex lukee MCP-palvelimet tiedostosta ~/.codex/config.toml ja yhdistää suoraan Streamable HTTP:hen: mcp-remote-siltaa ei tarvita. Claude.ain mukautetut liittimet voivat pyytää palvelimen URL-osoitteen ja otsikon erillisinä kenttinä.
Käytettävissä olevat ominaisuudet
OpenFactory tarjoaa asiakaskäyttöön työkaluja:
| Kategoria | Esimerkkejä |
|---|---|
| Builds | Listaa buildit, luo buildeja resepteistä, tarkista buildin tila, yritä epäonnistuneita buildeja uudelleen |
| Recipes | Selaa malleja, validoi reseptit, mukauta malleja |
| Images | Hae latauslinkit valmiille artefakteille |
| VMs | Listaa VM:t, luo testi-VM:itä, käynnistä tai pysäytä VM:itä, avaa konsolilinkit |
| Tests | Suorita verifiointi, listaa testiajot, tarkastele testituloksia, hallitse uudelleenkäytettäviä testisarjoja |
| App UI testing | Ohjaa tester-VM:ää testaamaan mitä tahansa sovelluksen URL-osoitetta: uudelleenkäytettäviä, self-hardening GUI-skenaarioita. Deployia ei tarvita |
| App deployment | Deployaa Git-repo live-web-sovellukseksi julkisella esikatselu-URL:lla (https://<slug>.apps.openfactory.tech) |
Työkalujen saatavuus voi vaihdella suunnitelman ja organisaation oikeuksien mukaan.
Uudelleenkäytettävät testisarjat
Testisarjat voi luoda ennen kuin variantti tai ISO on rakennettu. Määritä yksi tai useampi testitapaus, custom assertions, ennalta määritetyt testit ja nimettyjä ISO-kohdeslotteja kuten primary, client tai server. Kun buildit ovat valmiita, sidot jokaisen slotin valmiiseen buildiin ja ajat sarjan.
| Tool | Käyttö |
|---|---|
create_test_suite | Luo uudelleenkäytettävä sarja ilman rakennettua varianttia |
list_test_suites | Listaa nykyiselle MCP-käyttäjälle saatavilla olevat sarjat |
get_test_suite | Näytä sarjan määrittely ja viimeaikainen ajohistoria |
update_test_suite_targets | Sido nimettyjä ISO-kohdeslotteja valmiisiin buildeihin |
run_test_suite | Aja sarja sidottuja ISO-kohdeslotteja vastaan |
list_test_suite_runs | Listaa sarjasta luodut ajot |
get_test_suite_status | Näytä authoring readiness ja viimeisimmän ajon tila |
App UI Testing: mikä tahansa URL, ei deployia
Testaa minkä tahansa web-sovelluksen käyttöliittymää osoittamalla hallittu tester-VM URL-osoitteeseen. Et tarvitse deployata sovellustasi OpenFactorylla testataksesi sitä. Tester-VM avaa paikallisen dev-palvelimen, esikatselu-/tuotantodeployn Vercelissä, AWS:ssä, Netlifyssä tai millä tahansa hostilla, tai minkä tahansa julkisen URL-osoitteen, johon VM pääsee. Sovelluksesi pysyy siellä, missä se jo pyörii.
Skenaariot kirjoitetaan tavallisella kielellä ja ovat self-hardening: ensimmäinen ajo oppii kunkin UI-elementin sijainnin, myöhemmät ajot toistavat muistista (ohittaen hitaan visual passin). Se tekee toistoista nopeita ja sietäviä pieniä UI-muutoksia. Skenaariot tukevat ympäristömuuttujia (${VAR}) ja 2FA:ta (${totp:VAR}, RFC 6238) kirjautumisiin; salaisuudet annetaan run time -vaiheessa eikä niitä tallenneta.
| Tool | Käyttö |
|---|---|
ensure_tester_vm | Hae tai luo pysyvä desktop tester-VM |
create_app_scenario | Tallenna uudelleenkäytettävä GUI-skenaario sovelluksen URL:lle |
run_app_scenario | Aja se (anna run-time-salaisuudet tässä) ja tallenna kuvakaappaukset + verdict |
list_app_scenarios / get_app_scenario | Selaa skenaarioita ja niiden hardened cachea |
start_app_test / record_app_test_step / finish_app_test | Ohjaa ja tallenna ad-hoc-ajo itse |
annotate_screenshot | Piirrä merkittyjä highlight-laatikoita kuvakaappaukseen |
Katso App UI Testing koko työnkulusta, step-skeemasta ja 2FA-esimerkeistä.
App Deployment: Git-repo julkiseen URL-osoitteeseen
Deployaa web-sovellus suoraan Git-repositoriosta ja saat julkisen esikatselu-URL:n (https://<slug>.apps.openfactory.tech), jonka voit avata, jakaa tai osoittaa testiskenaariossa. OpenFactory kloonaa repon, asentaa riippuvuudet, käynnistää sovelluksen ja suorittaa health checkit puolestasi. Ei mitään kytkettävää: ei port forwardingia, tunneleita tai DNS:ää.
Tämä sopii yhteen App UI testingin kanssa: deployaa sovellus ja aja skenaario esikatselu-URL:ia vastaan, tai ohita deploy ja testaa jo hostaamaasi sovellusta (Vercel, AWS, …).
| Tool | Käyttö |
|---|---|
create_app | Rekisteröi Git-repo sovellukseksi (name, source, slug) |
deploy_app | Deployaa sovellus ja palauta sen julkinen esikatselu-URL |
list_apps / get_app | Selaa sovelluksiasi, niiden URL-osoitteita ja deployhistoriaa |
iterate_app | Lähetä luonnollisen kielen muutos sovellukseen; agentti toteuttaa sen ja redeployaa |
get_app_build_status | Pollaa sovelluksen deploystatusta ja in-flight change tickets -tietoja |
Katso App Deployment koko työnkulusta. Jos haluat antaa käyttäjiesi puhua muutoksia sovellukseen mikrofonipainikkeesta, katso Voice Iterate Widget.
Esimerkkikehotteet
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.Turvallisuushuomiot
- Käytä API-avaimia vain asiakkaiden kanssa, joihin luotat.
- Peru vanhat avaimet konsolista, kun vaihdat koneita tai poistut projektista.
- Suosi hyväksyntää vaativia työkaluoikeuksia toiminnoille, jotka luovat buildeja, käynnistävät VM:itä tai muuttavat infrastruktuuria.
- Älä liitä OpenFactoryn API-avaimia kehotteisiin, tiketteihin, julkisiin repoihin tai jaettuihin dokumentteihin.
Vianmääritys
Työkalut eivät näy
Käynnistä MCP-asiakas uudelleen ja varmista, että palvelimen URL on tarkalleen:
https://console.openfactory.tech/mcp-stream/mcpJos asiakas on konfiguroitu poistetulla /mcp/sse-URL:lla, saat 410 Gone: vaihda URL yllä olevaan; muuta ei tarvitse.
Todennus epäonnistuu
Päivitä tämä sivu ja kopioi luotu konfiguraatio uudelleen. Kirjautuneiden käyttäjien tulee käyttää luotua Authorization-otsikkoa. Vieraiden tulee käyttää luotua X-Guest-Id-otsikkoa yllä olevasta kopioi-liitä-konfiguraatiosta.
Build- tai VM-toiminnot epäonnistuvat
Tarkista OpenFactory-suunnitelmasi, organisaation oikeudet ja buildin tila. Jotkin toiminnot vaativat valmiin buildin, persistent VM entitlement -oikeuden tai Enterprise-oikeudet.
Kuljetusvirheet
Päivitä MCP-asiakas, jos se ei tue Streamable HTTP:ää. Jos päivitys ei onnistu, vaihda HTTP+SSE compatibility endpointiin.