用途:通过 kelviq MCP 工具构建并发布 Kelviq 定价目录。模型层次为:产品包含套餐,套餐向功能授予权益,未发布前不会生效。
前提配置:需要 kelviq: MCP 工具(@kelviq/mcp-server,KELVIQ_SERVER_API_KEY),并参考 kelviq 技能的 Setup 部分获取 .mcp.json 片段与 KELVIQ_ENV=sandbox 沙箱测试方式。
主要流程:先调用 kelviq:product_create(必填 name、taxCode,税码不明须询问用户,不可猜测),保留返回的产品 UUID;再用 kelviq:feature_create 创建功能,featureType 可选 BOOLEAN(标志)、CUSTOMIZABLE(数值数量,如席位)或 METER(用量追踪,如 API 调用),保留每个功能 UUID;然后 kelviq:plan_create 以产品 UUID 作为 product 参数创建套餐,套餐进入 DRAFT 状态,不可见、不可购买;接着 kelviq:plan_entitlements_add 用功能 UUID 附加权益,details 结构取决于功能类型,可查阅 kelviq:docs_read 的 product-catalog/entitlements。
价格:MCP 无价格写入工具(有意为之)。需引导用户在 Kelviq 仪表盘设置价格,或在 Git 管理定价时使用 pricing-as-code 技能的 kelviq push 流程;kelviq:plan_prices_list 可读回已有价格确认。
发布与验证:kelviq:plan_publish 使套餐及其仅 DRAFT 的权益生效;仅当需要迁移旧版本套餐的既有客户到新功能/定价时才传 updateFeatures 或 updatePricing,设置前必须与用户确认。验证用 kelviq:plan_retrieve、kelviq:plan_prices_list,以及按产品 UUID 调用 kelviq:offering_get_product 查看公开定价视图。引导式流程可用 setup_product 或 launch_plan MCP 提示。
其他要点:免费套餐使用 chargePeriod: ONE_TIME;更新已发布套餐时 kelviq:plan_update 会创建新草稿,旧版本保持在线直至发布新草稿;plan_file_update、plan_file_delete、plan_file_download 管理既有文件附件,均不能上传新文件,新文件需通过媒体上传端点或仪表盘。字段级细节请先阅读 kelviq:docs_read 相关文档,不要凭记忆枚举 schema。