产品 MCP 工具：功能清单与调用示例

适用版本：产品管理插件 3.1.0；内容依据当前源码核对，更新日期：2026-10-10。

功能清单

当前产品插件提供 50 个工具，24 个查询、26 个写入。以下为当前源码工具清单；实际可见范围取决于访问密钥白名单。

表中名称不含自动添加的 PluginProduct__ 前缀。参数的类型、必填项、枚举和白名单以 tools/list 的 inputSchema 为准； 50 个工具均声明 outputSchema，用于描述和校验成功结果的 structuredContent。

工具	类型	用途
`get_product_options`	查询	产品类型、应用类型、销售形态与价格周期
`list_products`	查询	产品分页，包含未发布产品
`get_product`	查询	基础信息、价格、类型规格、套餐成员及最新在线版本
`create_product`	写入	创建未发布产品及初始价格、规格
`update_product`	写入	更新内容、分类和规格，禁止价格和发布状态
`update_product_pricing`	写入	完整替换价格策略
`publish_product`	写入	上架产品，执行现有产品与套餐校验
`unpublish_product`	写入	下架产品，保留订单和授权
`list_categories`	查询	分类分页
`get_category`	查询	分类详情
`create_category`	写入	使用调用者指定的稳定 ID 创建分类，默认启用
`update_category`	写入	分类名称、描述、排序和启用状态
`list_versions`	查询	产品版本分页及原生状态筛选
`get_version`	查询	版本内容与安装包引用
`create_version`	写入	创建未发布版本，校验产品与版本重复
`update_version`	写入	更新说明、兼容范围、下载地址或已有安装包引用
`publish_version`	写入	上线版本，不发送通知
`unpublish_version`	写入	下线在线版本
`list_license_orders`	查询	授权订单分页，包含套餐父订单和成员订单
`get_license_order`	查询	授权订单及套餐快照
`list_mall_orders`	查询	商城订单分页，按订单项筛选产品和类型
`get_mall_order`	查询	商城订单、订单项、物流及履约状态
`list_authorizations`	查询	授权用户、域名、有效期和关联订单
`get_authorization`	查询	单条授权，不含证书
`get_inventory_summary`	查询	实物库存或卡密状态计数
`list_card_key_records`	查询	卡密记录 ID、状态、关联订单与用户，不含卡号和卡密
`get_license_dashboard`	查询	授权业务看板
`get_license_order_trend`	查询	授权订单记录数量趋势
`get_license_revenue_trend`	查询	授权订单收入趋势
`get_license_top_products`	查询	按授权订单收入降序的前 6 个产品，同时返回订单记录数
`list_coupons`	查询	优惠券规则、有效期和使用情况
`get_coupon`	查询	优惠券详情，不创建、发放或核销
`create_authorization`	写入	给已有用户发放单品授权，固定已授权状态，使用稳定 ID
`update_authorization`	写入	仅修改授权域名，清空已保存证书
`extend_authorization`	写入	设置不早于当前期限的绝对到期时间，保持状态
`disable_authorization`	写入	设为未授权，保留记录
`enable_authorization`	写入	恢复有效期内授权，检查用户和产品等关联
`import_card_keys`	写入	按稳定批次 ID 导入 1～50 条卡密，返回安全记录
`list_card_key_batches`	查询	批次分页，可按产品和创建时间筛选
`get_card_key_batch`	查询	批次名称、计划导入量和发放计数
`get_card_key_record`	查询	单条卡密记录，不含卡号和卡密
`disable_card_key`	写入	停用未发放、未绑定订单的卡密
`enable_card_key`	写入	恢复未发放、未绑定订单的卡密
`create_coupon`	写入	创建一张普通券或共享券，初始 UNUSED
`update_coupon`	写入	编辑尚无使用记录且未绑定订单的优惠规则
`assign_coupon`	写入	将未使用优惠券分配给已有用户，不转移已有归属
`disable_coupon`	写入	用现有 EXPIRED 状态停用，保留使用历史
`enable_coupon`	写入	在有效期和剩余次数允许时恢复 UNUSED
`delete_product`	写入	删除未发布且无业务关联的产品及其类型规格
`delete_version`	写入	删除未发布或已下线版本，保留附件

查询示例

协议调用的 name 包含插件前缀，arguments 按实时 inputSchema 填写：

{"name":"PluginProduct__list_products","arguments":{"page":1,"size":20,"status":"PUBLISHED"}}

{"name":"PluginProduct__get_product","arguments":{"productKey":"PluginExample"}}

{"name":"PluginProduct__get_license_revenue_trend","arguments":{"dateStart":"2026-10-01 00:00:00","dateEnd":"2026-10-10 23:59:59"}}

示例 Key 和日期需替换成实际业务值。列表默认第 1 页、每页 20，最大 size 为 100。日期必须成对出现，格式为 yyyy-MM-dd HH:mm:ss，最多 366 天；看板工具必须指定日期范围。

内容更新示例

{"name":"PluginProduct__update_product","arguments":{"productKey":"PluginExample","name":"新的产品名称"}}

普通更新省略的允许字段保留现值，不能修改价格与发布状态。价格调整使用独立工具且完整替换价格策略；发布、下架以及版本上下线同样使用独立工具。示例为报文说明，执行前需读取目标资源并确认授权范围。

输出与脱敏

不返回授权证书、卡号、卡密、支付地址及原始内部快照。收件人、电话和详细地址省略，运单只保留末 4 位。URL 可能移除查询、账号和片段并标注 Redacted，不能当成完整签名下载链接。商城订单详情最多返回 100 个订单项，并用 itemsTruncated 标注截断。

看板仅统计授权订单，记录数含套餐成员。热门产品按授权收入排序，不是全站商品销量榜。

写入与重试

创建分类、授权、卡密批次和优惠券时按 Schema 使用稳定 ID。版本创建使用稳定产品与版本身份。并发冲突应重新读取并审查变更；超时或未知失败可能部分保存，先查询结果再决定下一步。

卡密部分导入禁止盲目重放；已发放卡密不能停用或恢复；共享券不能分配用户。删除产品需未发布且通过关联检查，删除版本只允许未发布或已下线，并保留附件。工具没有多资源事务承诺，也不提供支付重试、实物发货或套餐安装动作。

产品 MCP 工具：功能清单与调用示例

产品 MCP 工具：功能清单与调用示例

功能清单

查询示例

内容更新示例

输出与脱敏

写入与重试

相关文档

评论