Factory Setup 的用途是为「非 Warp 本身」的编码智能体引导（bootstrap）Warp Factory 访问权限：安装并认证 oz CLI、注册托管的 Factory MCP 服务器、验证连接，然后移交（hand off）给权威运营技能。资料明确说明这是一个一次性设置技能，不是日常运营手册。
主要能力与范围 本技能会：检测目标客户端（Claude Code、Codex、Cursor 或通用 MCP 客户端）；安装/认证 CLI 并签发 API Key；为该客户端注册 Factory MCP 服务器；验证连接（工具可见、list_factories 可用、权威技能可读）；可选地帮助选择或创建一个 factory 并保存为默认；在设置结束后停止并移交。 本技能不做：不复制第 2 天（day-2）运营手册——该内容位于 MCP 连接本身的 skill://warp/factory-mcp/SKILL.md，连接后即为权威来源；不自动化为某个 factory 进行 Slack、Linear、GitHub 集成 OAuth，这类操作应指引用户在 Factory Web 应用中完成，不要在此脚本化。
步骤 1 — 选择服务器根（server root） Factory MCP 始终挂载在 {server_root}/api/v1/mcp/factory。第三方客户端不知道 Warp 的服务器根，因此需要显式指定：默认服务器根为 https://app.warp.dev，CLI 二进制为 oz，MCP URL 为 https://app.warp.dev/api/v1/mcp/factory。如果机器已设置 FACTORY_MCP_URL，则原样使用；如果设置的是 WARP_SERVER_ROOT，则按 {WARP_SERVER_ROOT}/api/v1/mcp/factory 构建 URL；否则使用 https://app.warp.dev，不要让用户选择服务器根，也不要指向其他主机。若注册或调用 MCP URL 出现 not-found/功能被禁用类错误，应告知用户其账号尚未开启 Factory MCP 并停止，不要猜测或替换其他主机。
步骤 2 — 获取 CLI 与 API Key Warp 的 CLI 在软发布阶段以 oz 提供，GA 时更名为 warp，资料建议提及一次以免用户困惑。资料指出安装命令尚未最终确定（原文为 PLACEHOLDER，明确要求不要凭空编造命令），应询问用户如何安装 oz，或指引其查看 https://docs.warp.dev 获取当前说明。CLI 可用并登录（oz login）后，签发 API Key：oz api-key create --expires-in 30d "factory-setup"。该 Key 须视为机密，导出到环境变量（如 WARP_API_KEY）并在后续使用，不要写入会被提交的配置文件，也不要回显到共享终端或日志。API Key + Authorization: Bearer 是受支持的认证路径，适用于所有客户端；目前第三方客户端不支持 OAuth——Factory MCP 不支持动态客户端注册，也没有为外部使用注册的按客户端 OAuth client，因此客户端内置的「使用 OAuth 连接」流程会失败，出现 OAuth 失败时应回退到 API Key 而非调试 OAuth。
步骤 3 — 检测客户端并注册 MCP 服务器 将 {mcp_url} 替换为步骤 1 的地址，使用 $WARP_API_KEY。 Claude Code：claude mcp add --transport http warp-factory {mcp_url} --header "Authorization: Bearer $WARP_API_KEY"。标志名可能随版本变化，失败时先运行 claude mcp add --help。不要使用 claude mcp login / --client-id。 Codex：codex mcp add warp-factory --url {mcp_url} --bearer-token-env-var WARP_API_KEY。这会在 ~/.codex/config.toml 写入带 url 与 bearer_token_env_var 的 [mcp_servers.warp-factory] 块；需确保 Codex 运行所在的 shell/会话中已导出 WARP_API_KEY。不要使用 --oauth-client-id / codex mcp login。 Cursor：没有 MCP CLI，需编辑 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目级），在 mcpServers 下配置 warp-factory 的 url 与 headers 中的 Authorization: Bearer ${env:WARP_API_KEY}。不要在文件中内联原始密钥；确保 Cursor 启动环境中确实设置了 WARP_API_KEY（仅 .bashrc/.zshrc 中的导出不一定被桌面应用继承），编辑后重启 Cursor，并在 Settings → Tools & MCP 检查连接为绿色。使用 headers 块而非 auth 块。 通用/其他支持 MCP 的客户端：任何支持带自定义头的 streamable HTTP 的客户端都可直接连接，指向 {mcp_url} 并带 Authorization: Bearer $WARP_API_KEY 头，没有 Warp 专属的传输方式。
步骤 4 — 验证 从已挂载 MCP 服务器的客户端：列出工具（tools/list 或等价方式），确认存在 list_factories、create_factory、list_tasks、search_task、get_task、message_foreman、get_conversation、send_task、complete_task、list_notification_routes；调用 list_factories，任何不含认证错误的响应即成功（空列表表示该主体尚无 factory，属正常）；读取资源 skill://warp/factory-mcp/SKILL.md，成功读取即证明运营技能移交可用。若客户端本身不支持 resources/read（部分仅工具型客户端），应自行用一条独立的 JSON-RPC 调用对同一已认证端点获取（资料称已验证无需先 initialize 握手即可工作），并把返回文本放到智能体在开始真正 Factory 工作前会读取的位置；技能文本位于返回 JSON 的 result.contents[0].text。任一步骤失败应停止并报告确切错误，不要猜测修复方式。
步骤 5 — 可选：选择或创建 factory 步骤 4 通过后设置即完成，本步骤是可选后续，而非成功标准。若用户已有 factory，可用 list_factories 找到其 factory_uid，并按需保存为默认（遵循运营技能的 ~/.warp/factory/config.json 约定，见 skill://warp/factory-mcp/references/factory-config.md）。若要新建，create_factory 需要 team_uid、name、code_forge 以及至少一条 repositories 条目（owner/repo），integrations 可选；头像为 REST 专属，不能通过 MCP 设置。连接 Slack、Linear、GitHub 或 Jira 集成不在本技能范围内，应指引用户前往 Factory Web 应用，不要从本技能脚本化集成 OAuth。
步骤 6 — 移交并停止 验证完成后告知用户设置已结束。第 2 天的运营——查找任务、委派工作、把任务拉到本地、与 foreman 协调、交回工作——完全由服务器暴露的权威技能 skill://warp/factory-mcp/SKILL.md 管辖，此后的任何操作都应阅读并遵循该技能，不要在此重新实现其运营规则。
故障排查 MCP URL 返回 404 / 疑似功能禁用错误：用户账号尚未启用 Factory MCP，应报告并停止，这不是技能缺陷，也没有其他有效替代主机。 401 Unauthorized：API Key 缺失、错误或过期，需重新创建（步骤 2）并重新注册。 OAuth client not found / OAuth 流程被拒 / DCR 失败：属预期情况——Factory MCP 未为第三方客户端注册 OAuth client，应改用步骤 2 的 API Key 路径。 对技能 URI 的 resources/read 失败或不支持：部分客户端未实现 MCP 资源；工具面仍可用，应自行用步骤 4 的独立 curl 调用获取权威技能。
适用场景与限制 适用于把 Claude Code、Codex、Cursor 或其他支持 MCP 的客户端接入 Warp Factory 的一次性初始化。限制包括：安装命令未最终确定；第三方客户端不支持 OAuth，仅支持 API Key；集成类 OAuth 不在范围内；头像无法通过 MCP 设置；账号未启用 Factory MCP 时无法使用。资料未提供收费、价格或性能效果等其他信息。