#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 兼容性端点。