SuperAPI AI 工具集

setup-zoom-marketplace-app

部署与运维

查看项目

更新于 10-25 20:20

技能介绍

该技能用于在集成开发前设置 Zoom Marketplace 应用边界。主要用途是创建、更新、选择或验证拥有集成的 Zoom Marketplace 应用,适用于 General App 清单、Server-to-Server OAuth 应用、Meeting SDK 等场景。

主要能力包括:识别任务为新建或更新应用,并分类产品场景、参与者、账户所有权和应用模型;检查机器可读模板索引,验证 app_type、usage、unsupported_app_types 和 supports_manifest_update 后选择最窄模板;需要公共 URL 时获取用户自己的 HTTPS 应用基础 URL 和已实现的路由路径,可使用托管服务或通过 ngrok/Cloudflare Tunnel 暴露本地应用;新建应用时替换示例名称、URL、域、联系人、命令和范围,仅保留精确操作所需的范围;检查 app-builder-for-agents 工具是否可用,优先使用辅助工具执行验证、创建或更新操作;任何写操作前展示目标账户、应用模型、显示名称、用户拥有 URL、范围、产品和订阅的简洁预览,并获得明确确认;对于现有 General App,导出完整清单,在内存中应用更改,使用其 app_id 验证,替换并再次导出;新建 General App 时验证内部清单并检查 HTTP 状态和响应 ok 值;创建原生 S2S 和 Meeting SDK 应用需主范围,这些是创建请求而非 General App 清单;完成公共模式无法可靠编码的创建后设置,包括 WebSocket 交付和部分 Webhook 或 RTMS 事件订阅;将生成的 secrets 存储在 secret manager 中,仅记录安全环境变量名称,并返回所属产品工作流。

使用方式包括:应用辅助工具串联规则,当其他插件技能路由到此技能时,发现并检查 app-builder-for-agents 工具的输入模式,优先使用支持的辅助工具而非手动执行 Marketplace API 请求;写操作前使用读取和验证操作;将创建、更新、凭证生成、范围更改、订阅更改和删除视为账户变更,需在首次变更前及目标账户、应用、URL、范围或操作变化时再次确认;成功变更后读回应用或导出清单并与批准配置比较,不能仅凭写响应声明成功;辅助工具不可用、未认证或不支持所需操作时,报告限制并继续生成已验证负载和精确手动或 API 步骤,不得声称应用已创建或更改。可选 Claude Code Marketplace 辅助工具:注册单独托管的 Marketplace 辅助 MCP 服务器,插件不捆绑或托管该辅助服务器;先启动辅助工具,通过 HTTPS 暴露其 /mcp 端点,并注册当前端点:claude mcp add --transport http app-builder-for-agents https://marketplacehelper.asdc.cc/mcp;当前辅助端点为此 URL,若更改需更新注册;若运行不同本地辅助实例,使用 ngrok http HELPER_PORT 或 cloudflared tunnel --url http://localhost:HELPER_PORT 暴露端口;辅助 MCP URL 仅作为 Claude Code 服务器注册值,切勿将其主机名、辅助操作员的 OAuth 客户端 ID、授权 URL 或回调 URL 用作用户应用的 OAuth 重定向、主页 URL、允许列表条目或 Webhook URL;仅注册信任的辅助端点,因为其可创建或修改 Marketplace 应用并可能处理应用凭证;注册后使用 /setup-zoom-marketplace-app,技能在工具可用时自动选择辅助工具。本地隧道 URL 同步:创建或更新本地运行的应用前,使用 ngrok 或 Cloudflare Tunnel 暴露应用;辅助工具自身的公共 MCP 端点和应用的公共测试 URL 是分开的;创建或更新前收集当前应用隧道主机名和实际路由路径;对于开发配置,更新清单中匹配字段:oauth_information.development_redirect_uri、oauth_information.oauth_allow_list、features.development_home_uri(当应用有主页 URL 时)、event_subscription.subscriptions[].development_webhook_url(当应用有 Webhook 时);从 Zoom 为用户应用颁发的客户端 ID 和该应用配置的精确重定向 URI 构建任何 OAuth 授权 URL,不得替换为 Marketplace 辅助部署的凭证或 URL;若所需应用端点不可用,帮助用户启动隧道或获取其托管端点后再创建应用;每次隧道重启后,假定先前主机名无效,并在测试 OAuth、打开应用主页或等待 Webhook 交付前更新这些开发 URL;除非用户明确要求,否则不要用临时隧道替换生产 URL;隧道仅转发流量,本地服务器必须实现每个路由及其 OAuth 或 Webhook 验证行为。

限制与防护规则包括:不要在一个 General App 中混合用户和管理员范围后缀;不要为 Meeting/Webinar RTMS 或 Team Chat 聊天机器人订阅使用 S2S;不要发明 Webhook 或 webhook_only 应用类型;不要对原生 s2s_oauth 或 meeting_sdk 应用使用 General App 清单更新工作流;仅使用用户自己的隧道或托管端点用于应用的 OAuth 重定向、允许列表、主页和 Webhook URL,切勿将 Marketplace 辅助工具的端点或其操作员的 OAuth 应用凭证复制到用户应用;更新期间除非用户明确要求,否则永不删除现有范围或事件订阅;不要打印、提交或在日志或测试工件中保留生成的客户端 secrets;将模式验证视为必要但不充分,许可、权利、授权和 Marketplace 审查仍可能阻止运行时使用。