#MCP 集成
OpenFactory 支援 模型上下文協議 ，因此 AI 助理可以幫助您建立建置、檢查配方、管理虛擬機器並查看測試結果。
當您想要從 Claude、Cursor、Claude Code、OpenAI Codex 或其他 MCP 相容用戶端使用 OpenFactory，而無需在工具之間來回切換時，請使用 MCP。
要求
- 支援遠端MCP伺服器的MCP用戶端
- 對於帳戶支援的訪問，請在此瀏覽器中登入 OpenFactory
- 對於訪客訪問，請使用產生的訪客令牌，如下所示
帳戶 API 金鑰在建立後顯示一次，並且可以從控制台撤銷。訪客令牌是用於按流量計費的存取的瀏覽器識別碼；它們不是帳戶秘密。
端點
| 交通 | 網址 | 使用 |
|---|---|---|
| 串流 HTTP | https://console.openfactory.tech/mcp-stream/mcp | OpenFactory MCP 端點 |
Streamable HTTP 是唯一支援的傳輸。舊的 HTTP+SSE 端點（/mcp/sse、/mcp/messages）已停用，現在返回 410 Gone；將仍在使用它們的任何客戶端指向上面的 Streamable HTTP URL，並使用相同的 Authorization 標頭。 Claude Code、Claude Desktop、Cursor、Codex 和 OpenCode 皆支援 Streamable HTTP。
複製貼上配置
變更 MCP 設定後，重新啟動 Claude Desktop、Cursor、OpenAI Codex 或任何其他長時間運行的 MCP 用戶端。 OpenAI Codex 從 ~/.codex/config.toml 讀取 MCP 伺服器並直接連接到 Streamable HTTP：無需 mcp-remote 橋接器。 Claude.ai 自訂連接器可能會要求將伺服器 URL 和標頭作為單獨的欄位。
可用功能
OpenFactory 公開了面向客戶的工具，用於：
| 類別 | 範例 |
|---|---|
| 建置 | 列出建置、從配方建立建置、檢查建置狀態、重試失敗的建置 |
| 食譜 | 瀏覽範本、驗證配方、自訂範本 |
| 圖片 | 取得已完成工件的下載連結 |
| 虛擬機器 | 列出虛擬機器、建立測試虛擬機器、啟動或停止虛擬機器、開啟控制台連結 |
| 測試 | 執行驗證、列出測試運行、檢查測試結果、管理可重複使用的測試套件 |
| 應用程式 UI 測試 | 驅動測試虛擬機器來測試 any app URL：可重複使用、自強化的 GUI 場景。無需部署 |
| 應用部署 | 使用公共預覽 URL (https://<slug>.apps.openfactory.tech) 將 Git 儲存庫部署到即時 Web 應用程式 |
工具可用性可能會因計劃和組織權限而異。
可重複使用的測試套件
可以在建造變體或 ISO 之前建立測試套件。定義一
或更多測試用例、自訂斷言、預先定義測試和命名 ISO 目標
插槽，例如 primary、client 或 server。當構建準備好後，綁定每個
插入已完成的建置並運行套件。
| 工具 | 使用 |
|---|---|
create_test_suite | 建立可重複使用套件，無需建置變體 |
list_test_suites | 列出目前 MCP 使用者可用的套件 |
get_test_suite | 查看套件定義和最近運行歷史記錄 |
update_test_suite_targets | 將命名的 ISO 目標插槽綁定到已完成的建置 |
run_test_suite | 針對綁定的 ISO 目標槽運作套件 |
list_test_suite_runs | 列出從套件建立的運算 |
get_test_suite_status | 查看創作準備與最新運作狀態 |
應用程式 UI 測試：任何 URL，無需部署
透過將託管測試器虛擬機器指向 網址。 **您無需使用 OpenFactory 部署應用程式來測試它。 ** 測試虛擬機 開啟本機開發伺服器，在 Vercel、AWS 上進行預覽/生產部署， Netlify，或任何主機，或可從虛擬機器存取的任何公用 URL。您的應用程式會保留 它已經運行的地方。
場景以簡單語言編寫，並且是 self-hardening：第一次運行
了解每個 UI 元素的位置，然後從該記憶體中執行重播（跳過
緩慢的視覺傳遞）。這使得重播變得快速並且能夠適應小的 UI 變更。場景支援
environment variables (${VAR}) 和 2FA (${totp:VAR}, RFC 6238)
登入；秘密在運行時傳遞並且從不儲存。
| 工具 | 使用 |
|---|---|
ensure_tester_vm | 取得或建立您的持久桌面測試虛擬機器 |
create_app_scenario | 為應用程式 URL 儲存可重複使用的 GUI 場景 |
run_app_scenario | 運行它（在此處傳遞運行時秘密）並記錄螢幕截圖+結論 |
list_app_scenarios / get_app_scenario | 瀏覽場景及其強化快取 |
start_app_test / record_app_test_step / finish_app_test | 自行駕駛並記錄一次暫時跑步 |
annotate_screenshot | 在螢幕截圖上繪製標記的突出顯示框 |
請參閱套用 UI 測試 以了解完整的工作流程、步驟 架構和 2FA 範例。
應用程式部署：Git 儲存庫到公用 URL
直接從 Git 儲存庫部署 Web 應用程式並取得 public preview URL
(https://<slug>.apps.openfactory.tech)，您可以開啟、分享或指向測試
場景於. OpenFactory 克隆儲存庫，安裝依賴項，啟動應用程序，
並為您進行健康檢查。沒有什麼需要連接的：沒有連接埠轉發，
隧道或 DNS。
這與應用程式 UI 測試配對：部署您的應用程序，然後針對其運行場景 預覽 URL，或跳過部署並測試您已託管的應用程式（Vercel、AWS 等）。
| 工具 | 使用 |
|---|---|
create_app | 將 Git 儲存庫註冊為應用程式（名稱、來源、slug） |
deploy_app | 部署應用程式並返回其公開預覽 URL |
list_apps / get_app | 瀏覽您的應用程式、其 URL 和部署歷史記錄 |
iterate_app | 向應用程式發送自然語言變更；代理應用它並重新部署 |
get_app_build_status | 輪詢應用程式的部署狀態和正在進行的變更票據 |
請參閱套用部署 以了解完整的工作流程。為了讓你的 自己的用戶透過麥克風按鈕說出對您的應用程式的更改，請參閱 語音迭代小工具。
提示範例
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.安全說明
- 僅對您信任的客戶使用 API 金鑰。
- 當您輪調機器或離開專案時，從控制台撤銷舊金鑰。
- 對於建立建置、啟動虛擬機器或變更基礎架構的操作，首選需要核准的工具權限。
- 請勿將 OpenFactory API 金鑰貼到提示、票證、公用儲存庫或共用文件中。
故障排除
工具不出現
重新啟動 MCP 用戶端並確認伺服器 URL 準確無誤：
https://console.openfactory.tech/mcp-stream/mcp如果您的用戶端配置了已停用的 /mcp/sse URL，它將獲得
410 Gone：將 URL 改為上面的 URL；沒有其他需要改變的。
身份驗證失敗
刷新此頁面並再次複製生成的配置。登入使用者應使用產生的 Authorization 標頭。來賓使用者應使用上面複製貼上配置中產生的 X-Guest-Id 標頭。
建置或虛擬機器操作失敗
檢查您的 OpenFactory 計劃、組織權限和建置狀態。某些操作需要完成的建置、持久性 VM 權利或企業權限。
傳輸錯誤
如果您的 MCP 用戶端不支援 Streamable HTTP，請更新它。如果無法更新，請切換到 HTTP+SSE 相容性端點。