ProdHub Application Delivery

ProdHub Agent Kit

为任何兼容 MCP 的编码框架提供一条安全、可重复的路径，从源代码到 ProdHub Preview Space。

此工具包不包含凭据。ProdHub 使用基于浏览器的 OAuth，将每个会话限定在获批的组织范围内，并应用与产品 UI 相同的角色控制。

安装

规范的远程 MCP 端点为：

https://app.prodhub.in/mcp

ProdHub 的机器发现信息见 server.json，并已在官方 MCP Registry 中以 io.github.SwaDeshiTech/prodhub 发布。MCP 客户端和基于注册表的目录可使用该条目发现托管的 Streamable HTTP 端点，无需依赖通用网页搜索。

Codex

codex mcp add prodhub --url https://app.prodhub.in/mcp

将 AGENTS.md 中的交付说明合并到 Codex 应使用 ProdHub 的代码库中；保留现有项目说明。也请复制配套文档，或保留指向此工具包的链接。

Gemini CLI

gemini mcp add prodhub https://app.prodhub.in/mcp --transport http --scope user

将 GEMINI.md 复制到该代码库，或将其中的说明合并到现有项目文件中。

Claude Code 和其他 MCP 客户端

使用 mcp.json 中的远程服务条目，然后将 CLAUDE.md 复制或合并到客户端使用的项目指导文件中。

ChatGPT 和 Codex 插件

此代码库也是一个可移植的 Agent Plugins 软件包：

• plugin.json 包含公开列表、引导、审核和发布元数据。
• mcp.json 声明了远程 ProdHub MCP 服务，以及使用动态客户端注册的 OAuth。
• skills/get-started/SKILL.md 提供安装后的设置和安全交付工作流。
• assets/prodhub-icon.svg 是目录和编辑器中的方形图标。

生成要在 OpenAI Plugins 提交门户上传的 ZIP 文件：

./scripts/package-chatgpt-plugin.sh

最终提交前，请录制审核人员可访问的演示，并将其 URL 添加到 plugin.json 中的 extensions.com.openai.review.demo_recording_url。仅在安全审核表单中填写专用测试账户凭据；切勿将其提交到此代码库。

请遵循完整的 ChatGPT 提交清单，完成审核测试环境、域名验证、上传和发布步骤。

首次连接

1. 在客户端中添加 MCP 端点。
2. 启动 OAuth 连接。登录 ProdHub 并选择一个组织。
3. 批准授权页面。
4. 要求编码框架部署一个分支或创建一个 Preview Space。

Agent 应先调用 get_prodhub_delivery_capabilities，再调用 list_available_product_areas，检查代码库和 prodhub_build 契约，展示计划并获得批准，然后创建资源。产品区域响应经过筛选，遵循 ProdHub UI 使用的相同基于角色的标签页配置，且无需选择组织。

请阅读 docs/preview-delivery.md 中的完整工作流。

部署前了解产品

从产品概念开始，了解应用、配置文件、提供方连接、Preview Space 和流水线执行之间的区别。然后遵循端到端 Preview Space 操作指南。该指南涵盖新建应用、现有配置文件、凭据同步、分支／修订验证、规划、显式选择配置文件、资源配置、监控、在同一环境中重试以及生命周期交接。

检查源代码时，请使用配置文件字段定义；交付失败时，请参阅故障恢复。这些指南描述的是当前实现；已连接服务的 tools/list 是判断工具可用性的权威依据。

示例请求

• “将此存储库的 feature/login 分支部署到一个新的 Preview Space，保留一天。”
• “复用现有目录应用的配置，并给我一个已验证的预览 URL。”
• “检查此 Preview Space 失败的原因，修复配置，然后在同一环境中重试。”

Agent 应保留工具返回的应用、配置、环境和执行 ID。用户不应需要手动查找这些 ID。本地尚未提交的更改不会包含在远程构建中。

重要限制

plan_application_preview 为已保存配置的现有应用规划交付。新应用接入需要先有单独的方案，然后才能创建这些记录。规划器不会验证源代码或预留资源。

url_available 响应表示 URL 已存在，并不一定意味着应用已完成部署。请检查当前执行并验证应用响应，然后再报告成功。目前，提前删除环境和通用配置更新都需要使用受支持的产品流程；不要为此编造 MCP 工具。

mcp.json 是一个配置示例。不同客户端的文件名和架构各不相同；仅克隆此存储库并不会注册 MCP 服务。

文件

• server.json：托管服务的官方 MCP Registry 元数据。
• mcp.json：可移植的远程 MCP 配置。
• plugin.json：ChatGPT 和 Codex 公共插件元数据。
• skills/get-started/SKILL.md：插件接入工作流。
• docs/chatgpt-submission.md：公共目录提交清单。
• AGENTS.md：面向 Codex 的项目说明。
• CLAUDE.md：Claude Code 项目说明。
• GEMINI.md：Gemini CLI 项目说明。
• docs/preview-delivery.md：安全交付工作流。

浏览器设置页面请参阅 prodhub.in/setup。

发布发现元数据

Publish MCP Registry metadata GitHub 工作流使用 GitHub OIDC 验证并发布 server.json。无需注册表令牌或长期密钥。每当公共 MCP 身份或工具契约发生变化时，都应递增清单版本；将该更新合并到 main 后，会重新发布该条目。