MCP-integratie
OpenFactory ondersteunt het Model Context Protocol zodat AI-assistenten u kunnen helpen builds te maken, recepten te bekijken, VM’s te beheren en testresultaten na te lezen.
Gebruik MCP wanneer u OpenFactory wilt bedienen vanuit Claude, Cursor, Claude Code, OpenAI Codex of een andere MCP-compatibele client zonder steeds tussen tools te wisselen.
Vereisten
- Een MCP-client die remote MCP-servers ondersteunt
- Voor toegang via uw account: meld u in deze browser aan bij OpenFactory
- Voor gasttoegang: gebruik het gegenereerde guest token hieronder
Account-API-sleutels worden eenmalig getoond bij aanmaak en kunt u intrekken in de console. Guest tokens zijn browser-identifiers voor gemeten toegang; het zijn geen accountgeheimen.
Endpoints
| Transport | URL | Gebruik |
|---|---|---|
| Streamable HTTP | https://console.openfactory.tech/mcp-stream/mcp | Het OpenFactory MCP-endpoint |
Streamable HTTP is het enige ondersteunde transport. De oudere HTTP+SSE-endpoints (/mcp/sse, /mcp/messages) zijn buiten gebruik en geven nu 410 Gone; wijs elke client die ze nog gebruikt op de Streamable HTTP-URL hierboven, met dezelfde Authorization-header. Claude Code, Claude Desktop, Cursor, Codex en OpenCode ondersteunen Streamable HTTP.
Configuratie kopiëren en plakken
Start Claude Desktop, Cursor, OpenAI Codex of een andere langlopende MCP-client opnieuw na het wijzigen van de MCP-instellingen. OpenAI Codex leest MCP-servers uit ~/.codex/config.toml en verbindt rechtstreeks met Streamable HTTP: geen mcp-remote-bridge nodig. Aangepaste connectors in Claude.ai kunnen de server-URL en header als aparte velden vragen.
Beschikbare mogelijkheden
OpenFactory biedt klantgerichte tools voor:
| Categorie | Voorbeelden |
|---|---|
| Builds | Builds weergeven, builds uit recepten maken, buildstatus controleren, mislukte builds opnieuw proberen |
| Recipes | Sjablonen doorbladeren, recepten valideren, sjablonen aanpassen |
| Images | Downloadlinks voor voltooide artefacten |
| VMs | VM’s weergeven, test-VM’s maken, VM’s starten of stoppen, consolelinks openen |
| Tests | Verificatie uitvoeren, testruns weergeven, testresultaten bekijken, herbruikbare testsuites beheren |
| App UI testing | Een tester-VM aansturen om elke app-URL te testen: herbruikbare, self-hardening GUI-scenario’s. Geen deploy nodig |
| App deployment | Een Git-repo deployen naar een live webapp met een publieke preview-URL (https://<slug>.apps.openfactory.tech) |
Welke tools beschikbaar zijn, hangt af van uw abonnement en organisatierechten.
Herbruikbare testsuites
Testsuites kunt u aanmaken voordat een variant of ISO is gebouwd. Definieer een of meer testcases, custom assertions, vooraf gedefinieerde tests en benoemde ISO-doelslots zoals primary, client of server. Zodra builds klaar zijn, koppelt u elke slot aan een voltooide build en voert u de suite uit.
| Tool | Gebruik |
|---|---|
create_test_suite | Een herbruikbare suite maken zonder gebouwde variant |
list_test_suites | Suites weergeven die beschikbaar zijn voor de huidige MCP-gebruiker |
get_test_suite | Suitedefinitie en recente runhistorie bekijken |
update_test_suite_targets | Benoemde ISO-doelslots koppelen aan voltooide builds |
run_test_suite | Een suite uitvoeren tegen gekoppelde ISO-doelslots |
list_test_suite_runs | Runs weergeven die uit een suite zijn gemaakt |
get_test_suite_status | Authoring readiness en status van de laatste run bekijken |
App UI Testing: elke URL, geen deploy
Test de gebruikersinterface van elke webapp door een beheerde tester-VM op een URL te richten. U hoeft uw app niet met OpenFactory te deployen om hem te testen. De tester-VM opent een lokale dev-server, een preview- of productiedeploy op Vercel, AWS, Netlify of elke host, of elke publieke URL die vanaf de VM bereikbaar is. Uw app blijft draaien waar hij al draait.
Scenario’s zijn in gewone taal geschreven en zijn self-hardening: de eerste run leert waar elk UI-element staat, latere runs spelen dat geheugen af (zonder trage visuele pass). Daardoor zijn replays snel en bestand tegen kleine UI-wijzigingen. Scenario’s ondersteunen omgevingsvariabelen (${VAR}) en 2FA (${totp:VAR}, RFC 6238) voor aanmeldingen; geheimen worden bij run time doorgegeven en nooit opgeslagen.
| Tool | Gebruik |
|---|---|
ensure_tester_vm | Uw persistente desktop tester-VM ophalen of aanmaken |
create_app_scenario | Een herbruikbaar GUI-scenario voor een app-URL opslaan |
run_app_scenario | Uitvoeren (run-time geheimen hier doorgeven) en screenshots plus verdict vastleggen |
list_app_scenarios / get_app_scenario | Scenario’s en hun hardened cache doorbladeren |
start_app_test / record_app_test_step / finish_app_test | Zelf een ad-hoc run sturen en opnemen |
annotate_screenshot | Gelabelde highlight-boxen op een screenshot tekenen |
Zie App UI Testing voor de volledige workflow, het step-schema en 2FA-voorbeelden.
App Deployment: Git-repo naar een publieke URL
Deploy een webapp rechtstreeks vanuit een Git-repository en krijg een publieke preview-URL (https://<slug>.apps.openfactory.tech) die u kunt openen, delen of in een testscenario kunt gebruiken. OpenFactory kloont de repo, installeert dependencies, start de app en voert health checks uit. Niets om aan te sluiten: geen port forwarding, tunnels of DNS.
Dit sluit aan op App UI testing: deploy uw app en voer een scenario uit tegen de preview-URL, of sla de deploy over en test een app die u al host (Vercel, AWS, …).
| Tool | Gebruik |
|---|---|
create_app | Een Git-repo registreren als app (name, source, slug) |
deploy_app | De app deployen en de publieke preview-URL teruggeven |
list_apps / get_app | Uw apps, URL’s en deployhistorie doorbladeren |
iterate_app | Een wijziging in natuurlijke taal naar een app sturen; een agent past toe en redeployt |
get_app_build_status | Deploystatus en in-flight change tickets van een app pollen |
Zie App Deployment voor de volledige workflow. Om uw eigen gebruikers wijzigingen via een mic-knop te laten inspreken, zie het Voice Iterate Widget.
Voorbeeldprompts
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.Beveiligingsopmerkingen
- Gebruik API-sleutels alleen met clients die u vertrouwt.
- Trek oude sleutels in via de console wanneer u machines wisselt of een project verlaat.
- Geef de voorkeur aan toolrechten met verplichte goedkeuring voor acties die builds maken, VM’s starten of infrastructuur wijzigen.
- Plak geen OpenFactory API-sleutels in prompts, tickets, publieke repositories of gedeelde documenten.
Probleemoplossing
Tools verschijnen niet
Start uw MCP-client opnieuw en controleer of de server-URL exact is:
https://console.openfactory.tech/mcp-stream/mcpAls uw client is geconfigureerd met de buiten gebruik gestelde /mcp/sse-URL, krijgt u 410 Gone: wijzig de URL naar de URL hierboven; verder hoeft niets te veranderen.
Authenticatie mislukt
Vernieuw deze pagina en kopieer de gegenereerde configuratie opnieuw. Aangemelde gebruikers moeten de gegenereerde Authorization-header gebruiken. Gasten moeten de gegenereerde X-Guest-Id-header uit de copy-paste configuratie hierboven gebruiken.
Build- of VM-acties mislukken
Controleer uw OpenFactory-abonnement, organisatierechten en de buildstatus. Sommige acties vereisen een voltooide build, een persistent VM entitlement of Enterprise-rechten.
Transportfouten
Werk uw MCP-client bij als deze Streamable HTTP niet ondersteunt. Als bijwerken niet kan, schakel over naar het HTTP+SSE compatibility endpoint.