原生MCP商品上架操作文档
本文档主要介绍云市场支持伙伴原生MCP接入上架的模式。
原生MCP模式接入上架方式
伙伴在云市场发布原生MCP商品，需使用阿里云AI网关托管MCP服务并关联到在云市场发布的MCP商品。阿里云AI网关承载了MCP服务的请求路由、用户鉴权、服务管理监控等。云市场与阿里云AI网关深度集成，在商品发布时仅需填写MCP服务的Endpoint地址、后端鉴权信息等配置，云市场会自动化的完成MCP服务在AI网关的部署并关联到所发布的MCP商品上。
接入方式
MCP商品发布时接口/协议形式选择MCP，阿里云云市场提供了AI网关共享实例或专享实例两种类型供伙伴选择。
共享实例和专享实例的区别
共享实例由云市场平台提供，云资源费用目前由平台承担，伙伴无需额外付费。共享实例为多租共享使用，有并发连接数和QPS限制（单MCP服务限制请求QPS<100, 并发连接数<1000），适用于POC阶段或对性能要求低的场景。
专享实例适用于伙伴对稳定性和性能有高要求的场景（比如高并发，接口响应时间高等非基础要求），由伙伴开通阿里云AI网关实例并授权云市场基于该实例发布MCP服务。专享实例由伙伴独享，支持高可用（SLA不低于99.99%）和灵活扩缩容，云资源费用由伙伴承担。可参考伙伴开通AI网关用于云市场MCP专享实例
MCP协议信息
当伙伴将原生 MCP 服务（支持 MCP的SSE 和 StreamableHttp ）上架至阿里云云市场时，需将该服务托管至阿里云 AI 网关。AI 网关将负责上架后 MCP 服务的用户授权管理、访问路由等核心职责。
（1）MCP协议链接：
输入原生的MCP协议URL，点击“解析”操作，系统会根据协议链接自动解析http协议、服务域名、服务路径，请核实内容；
（2）MCP传输机制，支持选择sse或StreamableHttp，请按实际选择。
鉴权信息
托管至 AI 网关并成功上架至阿里云云市场的 MCP 服务，其访问权限将由云市场基于用户的订阅生命周期统一管控。因此，MCP 服务后端无需再对用户访问权限进行额外鉴权，可简化服务侧的权限逻辑。
在托管过程中，合作伙伴可配置 MCP 服务的鉴权凭证信息，支持通过自定义 HTTP Header 或 Query 参数（Key-Value 形式）进行设置。AI 网关在将用户请求路由至后端 MCP 服务 Endpoint 时，会自动在 HTTP 请求中附加已配置的鉴权信息，以确保请求来源于阿里云云市场环境下的合法调用。
所配置的鉴权凭证信息属于敏感配置，不得对外泄露，且仅限用于阿里云云市场上架的 MCP 服务，不得用于其他非授权场景。
接口信息校验
MCP接入信息 & 鉴权信息完整录入后，需点击“MCP接口校验”，系统自动加载校验和展示接口及描述信息。【该步骤必须操作，避免输入的是无效协议信息，导致商业化后用户订购后无法使用】
关联已订阅的专享实例（该步骤为专享实例操作项）
若伙伴选择使用自购的 AI 网关专享实例进行服务托管，需授权阿里云云市场使用云市场伙伴服务关联角色AliyunServiceRoleForMarketSupplier（如操作授权的登录账号为RAM子账号或RAM角色， 需有AliyunMarketplaceFullAccess系统策略）。云市场将通过该角色查询并操作伙伴的 AI 网关实例，完成 MCP 服务的托管配置，以及用户订阅后的服务授权流程。
选择关联已订阅的AI网关实例：首次授权完成后，系统会自动加载伙伴账号下的 AI 网关实例，选择关联。（如展示为空，请检查是否已开通AI网关实例或检查开通账号）。
发布MCP商品支持跨阿里云账号的资源授权，参考跨阿里云账号的资源授权授权完成后，被授权账号可输入资源授权的账号UID进行同步，跨账号关联已订阅的AI网关实例。
商品基本信息、业务信息及协议信息
请按需填写包括商品图片、商品描述、类目、对客协议等相关营销属性内容。
商品销售信息
售卖方式
前原生MCP接入，支持按量售卖一种定价模式（包括此选项下纯后付费单次调用计价，以及后付费+预付费资源包计价两种形态）；
计费设置
（1）扣费周期：支持“按小时出账扣费”、“按天出账扣费”两种选项。选择后不支持变更，需要服务商将用户使用的计量数据推送给云市场，云市场负责计费并计入客户账单。
（2）定价设置：
先设置后付费定价计量维度
配置单次调用单价（后付费，必选）
配置预付费资源包定价（预付费包，非必选。举例1000次100元。用户可重复订购，先消耗次数包，次数包用完自动切换后付费）
后付费MCP推送计量说明
后付费定价的MCP，用户开通后按伙伴推送的实际使用量，由阿里云出账并扣费。
MCP后端服务识别云市场实例ID
后付费API/MCP实际向用户提供服务时，需要识别每个请求对应的云市场实例ID并进行记录，以便按扣费周期(按小时/天)汇总每个云市场实例ID维度的实际用量数据并推送到云市场。
在AI网关配置的MCP服务，请求路由到后端MCP时，会在到达后端的请求Header中添加X-Mse-Consumer: ${InstanceId}，其中${InstanceId}是该请求对应的云市场实例ID。
HTTP/1.1 规范中 Header 名称是「大小写不敏感」的，许多Web 框架在内部处理时，可能会统一将 header key 转为小写，MCP服务中解析X-Mse-Consumer时，需考虑大小写兼容。
云市场会在商品上架时以及面向用户的商品展示时使用到MCP服务支持的Tools列表，该操作依赖的MCP Tools列表查询请求（tools/list）会在请求Header中默认透传X-Mse-Consumer=default-query-tool，以表明使用该身份进行MCP Tools列表查询和展示。云市场不会使用该身份发起调用请求（tools/call）。
伙伴推送计量数据到云市场
根据实例对应商品在上架时配置的扣费周期(按小时/天)和计量维度(按使用次数/使用时长/使用tokens数等)汇总云市场实例ID维度的实际用量数据，并通过推送计量数据接口推送计量数据到云市场平台，由云市场平台向用户出账并扣费。
伙伴在对用户访问进行计量统计时，应仅针对 MCP Tools 调用请求（tools/call）进行计量。伙伴也可以灵活进行计量策略配置，允许对特定工具（tools）设置为免费调用，从而实现按需计费与部分功能豁免相结合的精细化计量模式。