APIG网关类商品转换MCP技术对接方案

简介

• MCP（Model Context Protocol，模型上下文协议）是AI领域的一项开放标准协议，旨在为大型语言模型（LLM）与外部数据源、工具之间建立标准化的连接方式。
• 云商店支持商家在云商店发布的APIG网关类商品，免费提供转换MCP能力。商家转换成功后，不仅保留原有API调试与调用的使用方式，而且新增MCP使用支持，使其无缝支持MCP协议标准，让商家的商品更高效地接入大模型生态。
• 云商店的APIG网关类商品转换MCP能力，无需商家做重复上架操作，让商家更高效地进行管理商品。

转换MCP操作步骤

1. 进入管理页面新增MCP服务：在“卖家中心> AI网关服务 > MCP服务管理”中，单击“创建MCP服务”；

   

2. 填写基本信息：MCP服务名称、内容分类、服务描述；

   

3. 选择服务类别：API转MCP；

   

4. 选择API分组信息：根据商家需求，选择需要转换的已上架并且在销售状态的API商品关联的API分组；

   

5. API鉴权信息配置：请配置您在API网关设置的应用鉴权信息(AppKey、AppSecret)，并检查应用绑定的API列表是否覆盖此次发布的所有API列表，AppKey、AppSecret获取步骤详见获取API鉴权信息配置；
   

   

   该配置影响商家进行自测，请确认按照要求进行填写。

6. 生成MCP模板信息：单击按钮，将通过您在APIG网关注册的接口信息，新生成一份MCP模板；

   

7. 修改MCP模板信息：商家可自定义修改MCP模板的信息，如description描述信息等是否准确，用于展示给用户准确的使用信息；

   

8. 调测MCP服务：配置完成后，单击“下一步”进行调测MCP服务；
   1. 单击“Connect”连接MCP服务；

      

   2. 单击“List Tools”获取接口列表；

      

   3. 选择需要调测的接口；

      

   4. 填写“入参”后，单击“Run Tool”请求调测；

      

   5. 调测成功后，并且业务处理与预期一致，单击“发布”，MCP服务发布成功后，用户即可使用MCP Server进行调用接口。

      

      

      • 原生MCP服务关联商品上架后，将变成“已锁定”状态，不允许修改“后端服务接入信息、后端服务鉴权信息”，不允许删除原生MCP服务；
      • 正式上线之前，请在MCP服务调测页完成接口验证，调测页面接口调用不会产生计费数据，云商店提供商家每天1000次的调测次数配额。

获取API鉴权信息配置

1. 进入管理页面：单击 配置鉴权>从【API网关-应用管理】获取应用鉴权信息；

   

2. 选择应用：商家可以选择“MARKETPLACE_APP”应用或者创建新应用，下面以“MARKETPLACE_APP”为例；

   

3. 绑定API：商家把需要转换的API进行绑定到该应用列表里；

   

   

   请勾选一个分组的所有API进行绑定。

4. 获取AppKey、AppSecret：绑定成功后，请将AppKey、AppSecret填写到配置框中。