Integracja MCP

OpenFactory obsługuje Model Context Protocol , dzięki czemu asystenci AI mogą pomóc tworzyć buildy, przeglądać receptury, zarzązać VM-ami i analizować wyniki testów.

Używaj MCP, gdy chcesz pracować z OpenFactory z Claude, Cursor, Claude Code, OpenAI Codex lub innego klienta zgodnego z MCP, bez ciągłego przełączania między narzędziami.

Wymagania

Klient MCP obsługujący zdalne serwery MCP
Dla dostępu powiązanego z kontem: zaloguj się do OpenFactory w tej przeglądarce
Dla dostępu gościa: użyj wygenerowanego tokena gościa pokazanego poniżej

Klucze API konta są pokazywane raz przy utworzeniu i można je unieważnić w konsoli. Tokeny gościa to identyfikatory przeglądarki do dostępu licznikowego; nie są sekretami konta.

Endpointy

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

Streamable HTTP to jedyny obsługiwany transport. Starsze endpointy HTTP+SSE (/mcp/sse, /mcp/messages) zostały wycofane i zwracają teraz 410 Gone; skieruj każdego klienta, który ich jeszcze używa, na URL Streamable HTTP powyżej, z tym samym nagłówkiem Authorization. Claude Code, Claude Desktop, Cursor, Codex i OpenCode obsługują Streamable HTTP.

Konfiguracja do skopiowania

Preparing your MCP config...

Po zmianie ustawień MCP uruchom ponownie Claude Desktop, Cursor, OpenAI Codex lub innego długo działającego klienta MCP. OpenAI Codex czyta serwery MCP z ~/.codex/config.toml i łączy się ze Streamable HTTP bezpośrednio: most mcp-remote nie jest potrzebny. Niestandardowe łączniki Claude.ai mogą prosić o URL serwera i nagłówek jako osobne pola.

Dostępne możliwości

OpenFactory udostępnia narzędzia dla klientów w obszarach:

Kategoria	Przykłady
Builds	Listowanie buildów, tworzenie buildów z receptur, sprawdzanie statusu buildu, ponawianie nieudanych buildów
Recipes	Przeglądanie szablonów, walidacja receptur, dostosowywanie szablonów
Images	Linki do pobrania ukończonych artefaktów
VMs	Listowanie VM, tworzenie VM testowych, uruchamianie lub zatrzymywanie VM, otwieranie linków do konsoli
Tests	Uruchamianie weryfikacji, listowanie przebiegów testów, podgląd wyników, zarządzanie wielokrotnie używanymi zestawami testów
App UI testing	Sterowanie VM testera, aby testować dowolny URL aplikacji: wielokrotnie używane, self-hardening scenariusze GUI. Deploy nie jest wymagany
App deployment	Wdrożenie repozytorium Git do działającej aplikacji web z publicznym URL podglądu (`https://<slug>.apps.openfactory.tech`)

Dostępność narzędzi zależy od planu i uprawnień organizacji.

Wielokrotnie używane zestawy testów

Zestawy testów można utworzyć, zanim zostanie zbudowany wariant lub ISO. Zdefiniuj jeden lub więcej przypadków testowych, custom assertions, predefiniowane testy i nazwane sloty docelowe ISO, np. primary, client lub server. Gdy buildy są gotowe, przypisz każdy slot do ukończonego buildu i uruchom zestaw.

Tool	Zastosowanie
`create_test_suite`	Utworzenie wielokrotnie używanego zestawu bez wymaganego zbudowanego wariantu
`list_test_suites`	Listowanie zestawów dostępnych dla bieżącego użytkownika MCP
`get_test_suite`	Podgląd definicji zestawu i ostatniej historii uruchomień
`update_test_suite_targets`	Przypisanie nazwanych slotów docelowych ISO do ukończonych buildów
`run_test_suite`	Uruchomienie zestawu względem przypisanych slotów docelowych ISO
`list_test_suite_runs`	Listowanie uruchomień utworzonych z zestawu
`get_test_suite_status`	Podgląd authoring readiness i statusu ostatniego uruchomienia

App UI Testing: dowolny URL, bez deploy

Testuj interfejs użytkownika dowolnej aplikacji web, kierując zarządzaną VM testera na URL. Nie musisz wdrażać aplikacji w OpenFactory, żeby ją testować. VM testera otwiera lokalny serwer dev, wdrożenie preview/produkcji na Vercel, AWS, Netlify lub dowolnym hoście, albo dowolny publiczny URL osiągalny z VM. Aplikacja zostaje tam, gdzie już działa.

Scenariusze są pisane prostym językiem i są self-hardening: pierwsze uruchomienie uczy się położenia elementów UI, kolejne odtwarzają z tej pamięci (pomijając wolny visual pass). Dzięki temu replay jest szybki i odporny na drobne zmiany UI. Scenariusze obsługują zmienne środowiskowe (${VAR}) i 2FA (${totp:VAR}, RFC 6238) przy logowaniu; sekrety przekazujesz w run time i nigdy nie są zapisywane.

Tool	Zastosowanie
`ensure_tester_vm`	Pobranie lub utworzenie trwałej desktopowej VM testera
`create_app_scenario`	Zapisanie wielokrotnie używanego scenariusza GUI dla URL aplikacji
`run_app_scenario`	Uruchomienie (sekrety run time podaj tutaj) i zapis screenshotów oraz verdict
`list_app_scenarios` / `get_app_scenario`	Przeglądanie scenariuszy i ich hardened cache
`start_app_test` / `record_app_test_step` / `finish_app_test`	Samodziste prowadzenie i nagrywanie ad-hoc uruchomienia
`annotate_screenshot`	Rysowanie opisanych ramek podświetlenia na screenshocie

Pełny workflow, schemat step i przykłady 2FA: App UI Testing.

App Deployment: repozytorium Git do publicznego URL

Wdróż aplikację web prosto z repozytorium Git i otrzymaj publiczny URL podglądu (https://<slug>.apps.openfactory.tech), który możesz otworzyć, udostępnić lub wskazać w scenariuszu testowym. OpenFactory klonuje repo, instaluje zależności, uruchamia aplikację i wykonuje health checki. Nic nie trzeba podłączać: bez port forwarding, tuneli ani DNS.

To łączy się z App UI testing: wdróż aplikację i uruchom scenariusz względem URL podglądu albo pomiń deploy i testuj aplikację, którą już hostujesz (Vercel, AWS, …).

Tool	Zastosowanie
`create_app`	Rejestracja repozytorium Git jako aplikacji (name, source, slug)
`deploy_app`	Wdrożenie aplikacji i zwrot publicznego URL podglądu
`list_apps` / `get_app`	Przeglądanie aplikacji, ich URL i historii deploy
`iterate_app`	Wysłanie zmiany w języku naturalnym do aplikacji; agent stosuje ją i redeploy
`get_app_build_status`	Odpytywanie statusu deploy aplikacji i in-flight change tickets

Pełny workflow: App Deployment. Aby użytkownicy mogli wymawiać zmiany aplikacji przyciskiem mikrofonu, zobacz Voice Iterate Widget.

Przykładowe prompty


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.

Uwagi dotyczące bezpieczeństwa

Używaj kluczy API tylko z klientami, którym ufasz.
Unieważniaj stare klucze w konsoli przy wymianie maszyn lub opuszczeniu projektu.
Preferuj uprawnienia narzędzi wymagające zatwierdzenia dla akcji tworzących buildy, uruchamiających VM lub zmieniających infrastrukturę.
Nie wklejaj kluczy API OpenFactory do promptów, ticketów, publicznych repozytoriów ani współdzielonych dokumentów.

Rozwiązywanie problemów

Narzędzia się nie pojawiają

Uruchom ponownie klienta MCP i potwierdź, że URL serwera jest dokładnie:


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

Jeśli klient jest skonfigurowany ze wycofanym URL /mcp/sse, otrzymasz 410 Gone: zmień URL na powyższy; reszta konfiguracji zostaje bez zmian.

Uwierzytelnianie nie działa

Odśwież tę stronę i skopiuj ponownie wygenerowaną konfigurację. Zalogowani użytkownicy powinni używać wygenerowanego nagłówka Authorization. Goście powinni używać wygenerowanego nagłówka X-Guest-Id z konfiguracji do skopiowania powyżej.

Akcje build lub VM kończą się niepowodzeniem

Sprawdź plan OpenFactory, uprawnienia organizacji i status buildu. Niektóre akcje wymagają ukończonego buildu, persistent VM entitlement lub uprawnień Enterprise.

Błędy transportu

Zaktualizuj klienta MCP, jeśli nie obsługuje Streamable HTTP. Jeśli aktualizacja nie wchodzi w grę, przełącz się na HTTP+SSE compatibility endpoint.