MCP-integration

OpenFactory stöder Model Context Protocol så att AI-assistenter kan hjälpa dig skapa builds, granska recept, hantera VM:er och gå igenom testresultat.

Använd MCP när du vill arbeta med OpenFactory från Claude, Cursor, Claude Code, OpenAI Codex eller en annan MCP-kompatibel klient utan att växla fram och tillbaka mellan verktyg.

Krav

En MCP-klient som stöder fjärr-MCP-servrar
För kontoanknuten åtkomst: logga in på OpenFactory i den här webbläsaren
För gäståtkomst: använd den genererade gästtoken som visas nedan

Konto-API-nycklar visas en gång när de skapas och kan återkallas från konsolen. Gästtokens är webbläsaridentifierare för mätt åtkomst; de är inte konthemligheter.

Endpoints

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

Streamable HTTP är det enda transport som stöds. De äldre HTTP+SSE-endpoints (/mcp/sse, /mcp/messages) är avvecklade och returnerar nu 410 Gone; peka klienter som fortfarande använder dem mot Streamable HTTP-URL:en ovan, med samma Authorization-header. Claude Code, Claude Desktop, Cursor, Codex och OpenCode stöder Streamable HTTP.

Kopiera-klistra-in-konfiguration

Preparing your MCP config...

Starta om Claude Desktop, Cursor, OpenAI Codex eller annan långlivad MCP-klient efter att du ändrat MCP-inställningarna. OpenAI Codex läser MCP-servrar från ~/.codex/config.toml och ansluter direkt till Streamable HTTP: ingen mcp-remote-brygga behövs. Anpassade connectors i Claude.ai kan be om server-URL och header som separata fält.

Tillgängliga funktioner

OpenFactory exponerar kundvända verktyg för:

Kategori	Exempel
Builds	Lista builds, skapa builds från recept, kontrollera buildstatus, försök igen med misslyckade builds
Recipes	Bläddra bland mallar, validera recept, anpassa mallar
Images	Hämta nedladdningslänkar för färdiga artefakter
VMs	Lista VM:er, skapa test-VM:er, starta eller stoppa VM:er, öppna konsollänkar
Tests	Kör verifiering, lista testkörningar, granska testresultat, hantera återanvändbara testsviter
App UI testing	Styr en test-VM för att testa valfri app-URL: återanvändbara, self-hardening GUI-scenarier. Ingen deploy krävs
App deployment	Deploya ett Git-repo till en live webbapp med en offentlig förhands-URL (`https://<slug>.apps.openfactory.tech`)

Verktygens tillgänglighet varierar med plan och organisationsbehörigheter.

Återanvändbara testsviter

Testsviter kan skapas innan en variant eller ISO har byggts. Definiera ett eller flera testfall, custom assertions, fördefinierade tester och namngivna ISO-målplatser som primary, client eller server. När builds är klara binder du varje plats till en färdig build och kör sviten.

Tool	Användning
`create_test_suite`	Skapa en återanvändbar svit utan att kräva en byggd variant
`list_test_suites`	Lista sviter tillgängliga för den aktuella MCP-användaren
`get_test_suite`	Visa svitdefinition och senaste körhistorik
`update_test_suite_targets`	Bind namngivna ISO-målplatser till färdiga builds
`run_test_suite`	Kör en svit mot bundna ISO-målplatser
`list_test_suite_runs`	Lista körningar skapade från en svit
`get_test_suite_status`	Visa authoring readiness och status för senaste körning

App UI Testing: valfri URL, ingen deploy

Testa användargränssnittet för valfri webbapp genom att rikta en hanterad test-VM mot en URL. Du behöver inte deploya appen med OpenFactory för att testa den. Test-VM:en öppnar en lokal dev-server, preview/produktion på Vercel, AWS, Netlify eller valfri host, eller valfri offentlig URL som nås från VM:en. Appen stannar där den redan körs.

Scenarier skrivs på vanligt språk och är self-hardening: första körningen lär sig var varje UI-element finns, senare körningar spelar upp från det minnet (utan långsam visual pass). Det gör replay snabbt och tåligt mot små UI-ändringar. Scenarier stöder miljövariabler (${VAR}) och 2FA (${totp:VAR}, RFC 6238) vid inloggning; hemligheter skickas vid run time och lagras aldrig.

Tool	Användning
`ensure_tester_vm`	Hämta eller skapa din persistenta desktop test-VM
`create_app_scenario`	Spara ett återanvändbart GUI-scenario för en app-URL
`run_app_scenario`	Kör det (skicka run-time-hemligheter här) och spela in skärmdumpar + verdict
`list_app_scenarios` / `get_app_scenario`	Bläddra bland scenarier och deras hardened cache
`start_app_test` / `record_app_test_step` / `finish_app_test`	Styr och spela in en ad-hoc-körning själv
`annotate_screenshot`	Rita märkta highlight-rutor på en skärmdump

Se App UI Testing för hela arbetsflödet, step-schemat och 2FA-exempel.

App Deployment: Git-repo till offentlig URL

Deploya en webbapp direkt från ett Git-repo och få en offentlig förhands-URL (https://<slug>.apps.openfactory.tech) som du kan öppna, dela eller peka ett testscenario mot. OpenFactory klonar repot, installerar beroenden, startar appen och kör health checks åt dig. Inget att koppla: ingen port forwarding, tunnlar eller DNS.

Det passar ihop med App UI testing: deploya appen och kör ett scenario mot förhands-URL:en, eller hoppa över deploy och testa en app du redan hostar (Vercel, AWS, …).

Tool	Användning
`create_app`	Registrera ett Git-repo som app (name, source, slug)
`deploy_app`	Deploya appen och returnera dess offentliga förhands-URL
`list_apps` / `get_app`	Bläddra bland dina appar, deras URL:er och deployhistorik
`iterate_app`	Skicka en ändring i naturligt språk till en app; en agent tillämpar den och redeployar
`get_app_build_status`	Polla en apps deploystatus och in-flight change tickets

Se App Deployment för hela arbetsflödet. För att låta dina användare tala in ändringar i appen via en mikrofonknapp, se Voice Iterate Widget.

Exempelprompts


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.

Säkerhetsanteckningar

Använd API-nycklar bara med klienter du litar på.
Återkalla gamla nycklar i konsolen när du byter maskiner eller lämnar ett projekt.
Föredra verktygsbehörigheter som kräver godkännande för åtgärder som skapar builds, startar VM:er eller ändrar infrastruktur.
Klistra inte in OpenFactory API-nycklar i prompts, ärenden, offentliga repon eller delade dokument.

Felsökning

Verktyg syns inte

Starta om MCP-klienten och bekräfta att server-URL:en är exakt:


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

Om klienten är konfigurerad med den avvecklade /mcp/sse-URL:en får du 410 Gone: byt till URL:en ovan; inget annat behöver ändras.

Autentisering misslyckas

Uppdatera sidan och kopiera den genererade konfigurationen igen. Inloggade användare ska använda den genererade Authorization-headern. Gäster ska använda den genererade X-Guest-Id-headern från kopiera-klistra-in-konfigurationen ovan.

Build- eller VM-åtgärder misslyckas

Kontrollera din OpenFactory-plan, organisationsbehörigheter och buildstatus. Vissa åtgärder kräver en färdig build, persistent VM entitlement eller Enterprise-behörigheter.

Transportfel

Uppdatera MCP-klienten om den inte stöder Streamable HTTP. Om du inte kan uppdatera, byt till HTTP+SSE compatibility endpoint.