MCP-Integration

OpenFactory unterstützt das Model Context Protocol , damit KI-Assistenten beim Erstellen von Builds, Inspizieren von Rezepten, Verwalten von VMs und Prüfen von Testergebnissen helfen können.

Nutzen Sie MCP, wenn Sie OpenFactory aus Claude, Cursor, Claude Code, OpenAI Codex oder einem anderen MCP-kompatiblen Client bedienen wollen, ohne zwischen Tools zu wechseln.

Anforderungen

Ein MCP-Client mit Unterstützung für Remote-MCP-Server
Für account-gestützten Zugriff: in diesem Browser bei OpenFactory anmelden
Für Gastzugriff: den unten angezeigten generierten Guest-Token nutzen

Account-API-Keys werden einmal bei Erstellung angezeigt und können in der Konsole widerrufen werden. Guest-Tokens sind Browser-Identifikatoren für metered access; sie sind keine Account-Geheimnisse.

Endpoints

Transport	URL	Nutzung
Streamable HTTP	`https://console.openfactory.tech/mcp-stream/mcp`	Der OpenFactory-MCP-Endpoint

Streamable HTTP ist der einzige unterstützte Transport. Die älteren HTTP+SSE-Endpoints (/mcp/sse, /mcp/messages) sind retired und liefern jetzt 410 Gone; zeigen Sie jeden Client, der sie noch nutzt, auf die Streamable-HTTP-URL oben mit demselben Authorization-Header. Claude Code, Claude Desktop, Cursor, Codex und OpenCode unterstützen Streamable HTTP.

Copy-Paste-Konfiguration

Preparing your MCP config...

Starten Sie Claude Desktop, Cursor, OpenAI Codex oder einen anderen dauerhaft laufenden MCP-Client nach Änderung der MCP-Einstellungen neu. OpenAI Codex liest MCP-Server aus ~/.codex/config.toml und verbindet direkt mit Streamable HTTP: kein mcp-remote-Bridge nötig. Claude.ai Custom Connectors können Server-URL und Header als getrennte Felder abfragen.

Verfügbare Fähigkeiten

OpenFactory stellt kundenseitige Tools bereit für:

Kategorie	Beispiele
Builds	Builds listen, Builds aus Rezepten erstellen, Build-Status prüfen, fehlgeschlagene Builds retry
Recipes	Templates browsen, Rezepte validieren, Templates anpassen
Images	Download-Links für abgeschlossene Artefakte
VMs	VMs listen, Test-VMs erstellen, VMs starten/stoppen, Konsolen-Links öffnen
Tests	Verifikation ausführen, Test-Runs listen, Testergebnisse inspizieren, wiederverwendbare Test-Suites verwalten
App UI testing	Tester-VM steuern, um jede App-URL zu testen: wiederverwendbare, self-hardening GUI-Szenarien. Kein Deploy nötig
App deployment	Git-Repo als Live-Web-App mit öffentlicher Preview-URL deployen (`https://<slug>.apps.openfactory.tech`)

Tool-Verfügbarkeit kann nach Plan und Organisationsberechtigungen variieren.

Wiederverwendbare Test-Suites

Test-Suites können angelegt werden, bevor eine Variant oder ein ISO gebaut wurde. Definieren Sie einen oder mehrere Test Cases, Custom Assertions, vordefinierte Tests und benannte ISO-Target-Slots wie primary, client oder server. Wenn Builds bereit sind, binden Sie jeden Slot an einen abgeschlossenen Build und führen Sie die Suite aus.

Tool	Nutzung
`create_test_suite`	Wiederverwendbare Suite ohne gebaute Variant erstellen
`list_test_suites`	Suites des aktuellen MCP-Users listen
`get_test_suite`	Suite-Definition und recente Run-Historie anzeigen
`update_test_suite_targets`	Benannte ISO-Target-Slots an abgeschlossene Builds binden
`run_test_suite`	Suite gegen gebundene ISO-Target-Slots ausführen
`list_test_suite_runs`	Aus einer Suite erzeugte Runs listen
`get_test_suite_status`	Authoring-Readiness und Latest-Run-Status anzeigen

App UI Testing: jede URL, kein Deploy

Testen Sie die Benutzeroberfläche jeder Web-App, indem Sie eine verwaltete Tester-VM auf eine URL richten. Sie deployen Ihre App nicht mit OpenFactory, um sie zu testen. Die Tester-VM öffnet einen lokalen Dev-Server, Preview/Production auf Vercel, AWS, Netlify oder jedem Host oder jede vom VM erreichbare öffentliche URL. Ihre App bleibt, wo sie bereits läuft.

Szenarien sind in Plain Language geschrieben und self-hardening: der erste Lauf lernt, wo jedes UI-Element ist, spätere Läufe spielen aus diesem Gedächtnis ab (ohne langsamen Visual Pass). Das macht Replays schnell und widerstandsfähig gegen kleine UI-Änderungen. Szenarien unterstützen Umgebungsvariablen (${VAR}) und 2FA (${totp:VAR}, RFC 6238) für Sign-ins; Secrets werden zur Laufzeit übergeben und nie gespeichert.

Tool	Nutzung
`ensure_tester_vm`	Persistente Desktop-Tester-VM holen oder anlegen
`create_app_scenario`	Wiederverwendbares GUI-Szenario für eine App-URL speichern
`run_app_scenario`	Ausführen (Run-time-Secrets hier übergeben) und Screenshots + Verdict aufzeichnen
`list_app_scenarios` / `get_app_scenario`	Szenarien und deren hardened cache browsen
`start_app_test` / `record_app_test_step` / `finish_app_test`	Ad-hoc-Lauf selbst steuern und aufzeichnen
`annotate_screenshot`	Beschriftete Highlight-Boxen auf Screenshot zeichnen

Siehe App UI Testing für den vollen Workflow, das Step-Schema und 2FA-Beispiele.

App Deployment: Git-Repo zu öffentlicher URL

Deployen Sie eine Web-App direkt aus einem Git-Repository und erhalten Sie eine öffentliche Preview-URL (https://<slug>.apps.openfactory.tech), die Sie öffnen, teilen oder in ein Test-Szenario zeigen können. OpenFactory klont das Repo, installiert Abhängigkeiten, startet die App und führt Health-Checks aus. Nichts zum Verdrahten: kein Port Forwarding, Tunnels oder DNS.

Das passt zu App UI Testing: App deployen, dann Szenario gegen Preview-URL, oder Deploy überspringen und App testen, die Sie schon hosten (Vercel, AWS, …).

Tool	Nutzung
`create_app`	Git-Repo als App registrieren (Name, Source, Slug)
`deploy_app`	App deployen und öffentliche Preview-URL zurückgeben
`list_apps` / `get_app`	Apps, URLs und Deploy-Historie browsen
`iterate_app`	Natural-Language-Änderung an App dispatchen; Agent wendet an und redeployt
`get_app_build_status`	Deploy-Status und in-flight Change Tickets einer App pollen

Siehe App Deployment für den vollen Workflow. Damit Ihre Nutzer Änderungen per Mikrofon-Button sprechen können, siehe Voice Iterate Widget.

Beispiel-Prompts


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.

Sicherheitshinweise

API-Keys nur mit Clients nutzen, denen Sie vertrauen.
Alte Keys in der Konsole widerrufen bei Maschinenwechsel oder Projektwechsel.
Approval-required Tool-Permissions bevorzugen für Aktionen, die Builds erstellen, VMs starten oder Infrastruktur ändern.
OpenFactory-API-Keys nicht in Prompts, Tickets, öffentliche Repositories oder geteilte Dokumente einfügen.

Fehlerbehebung

Tools erscheinen nicht

MCP-Client neu starten und bestätigen, dass die Server-URL exakt ist:


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

Ist Ihr Client mit der retired /mcp/sse-URL konfiguriert, erhalten Sie 410 Gone: URL auf die obige ändern; sonst nichts.

Authentifizierung schlägt fehl

Seite refreshen und generierte Konfiguration erneut kopieren. Angemeldete Nutzer sollten den generierten Authorization-Header nutzen. Gäste den generierten X-Guest-Id-Header aus der Copy-Paste-Konfiguration oben.

Build- oder VM-Aktionen schlagen fehl

OpenFactory-Plan, Organisationsberechtigungen und Build-Status prüfen. Manche Aktionen brauchen abgeschlossenen Build, persistent VM entitlement oder Enterprise-Berechtigungen.

Transport-Fehler

MCP-Client aktualisieren, wenn Streamable HTTP nicht unterstützt wird. Wenn Update nicht möglich, auf den HTTP+SSE-Kompatibilitäts-Endpoint wechseln.