原生MCP商品上架操作文档

How native MCP integration and listing works

To list a Native MCP product in Alibaba Cloud Marketplace, you must host your MCP service on Alibaba Cloud AI Gateway and associate it with the product. Alibaba Cloud AI Gateway handles request routing, user authentication, service management, and monitoring for the MCP service. Alibaba Cloud Marketplace is deeply integrated with Alibaba Cloud AI Gateway. During product listing, you only need to provide the MCP service's endpoint address and backend authentication information. The marketplace then automatically deploys the MCP service on AI Gateway and associates it with your listed product.

Integration methods

When you list an MCP product, set the interface/protocol type to MCP. Alibaba Cloud Marketplace offers two AI Gateway instance types: a shared instance or a dedicated instance.

MCP protocol information

(1) MCP protocol link: Enter the Native MCP protocol URL and click Parse. The system automatically parses the HTTP protocol, service domain, and service path from the link. Verify the information.

(2) MCP transport mechanism: Select either sse or StreamableHttp based on your implementation.

Authentication

For an MCP service hosted on AI Gateway and successfully listed in Alibaba Cloud Marketplace, the marketplace centrally manages access permissions based on the user's subscription lifecycle. Therefore, your MCP service backend no longer needs to perform separate authentication, which simplifies your service-side permission logic.

During the hosting process, you can configure authentication credentials for your MCP service as key-value pairs by using a custom HTTP header or query parameter. When AI Gateway routes a user request to your backend MCP service endpoint, it automatically adds the configured authentication information to the HTTP request. This ensures the call is legitimate and originates from the Alibaba Cloud Marketplace environment.

In the authentication configuration section, you can add multiple key-value pairs as custom HTTP headers or query parameters. Use the Add and Delete buttons to manage the entries.

Interface validation

After entering the MCP integration and authentication information, you must click Validate MCP Interface. The system automatically loads, validates, and displays the interface and its description. This step is mandatory. It prevents you from listing a product with an invalid protocol, which could prevent customers from using the service after subscribing.

After a successful validation, the page displays the name, functional description, and parameter details (including parameter types and coordinate formats) for each interface tool. Confirm the information, then click Next.

Associate a dedicated instance

Select an existing AI Gateway instance to associate. After the initial authorization, the system automatically loads the AI Gateway instances under your account. Select the instance you want to associate. If the list is empty, verify that you have activated an AI Gateway instance and that you are using the correct account.

Select a target region, such as China (Hangzhou) or China (Shanghai), and then select the target dedicated instance from the list to associate it.

Product, business, and agreement

Fill in the required marketing attributes, including the product image, description, category, and customer agreement.

Sales

Sales model

Currently, Native MCP integration supports the pay-as-you-go pricing model. This model includes two options: pure post-paid billing per call, or a combination of post-paid billing and pre-paid resource packages.

Set Visible in Storefront to Yes, and set Enterprise Customers Only to No.

Billing settings

(1) Billing Cycle: You can select either Hourly Billing or Daily Billing. This setting cannot be changed after selection. The service provider must push usage data to Alibaba Cloud Marketplace, which then calculates charges and adds them to the customer's bill.

First, set the metering dimension for post-paid pricing.

Available metering dimensions include: number of uses, usage duration, data transfer, character count, daily active users, storage space, vCPU, memory, token count, and items/sets. Select one to proceed with pricing configuration.

Configure the per-call unit price (post-paid, required).

Configure pricing for pre-paid resource packages (optional). For example, 1,000 calls for 100 CNY. Users can purchase packages multiple times. The system consumes the package quota first. After it is depleted, billing automatically switches to the post-paid model.

When configuring a billing item, enter a Billing item name (for example, "Per-use metering"), select a Pricing method of either Fixed pricing or Tiered pricing, and set the unit price (for example, 0.02 CNY/call). For a resource package, you must set the Usage amount, Price, Package validity period, and Limit to one purchase. You can click + Add resource package to add more package specifications or click + Add billing item to add more billing items.

Post-paid MCP metering

For post-paid MCP products, Alibaba Cloud bills and charges customers based on the actual usage data that you push after they activate the service.

Instance ID identification

When your post-paid API or MCP service serves requests, it must identify and record the Alibaba Cloud Marketplace instance ID for each request. This allows you to aggregate usage data by instance ID for each billing cycle (hourly or daily) and push it to Alibaba Cloud Marketplace.

For an MCP service configured on AI Gateway, when AI Gateway routes a request to the backend MCP service, it adds the header X-Mse-Consumer: ${InstanceId} to the request. In this header, ${InstanceId} represents the request's Alibaba Cloud Marketplace instance ID.

Pushing metering data

Aggregate actual usage data by Alibaba Cloud Marketplace instance ID based on the billing cycle (hourly or daily) and metering dimension (such as usage count, duration, or tokens) that you configured when listing the product. Then, push the metering data to the Alibaba Cloud Marketplace platform by using the Push metering data API. Alibaba Cloud Marketplace then bills and charges the customer.