一、前提条件
·已创建云原生 AI 网关实例。
·已创建 HTTP 转 MCP 类型的 MCP Server 及其工具。
二、操作步骤
1. 登录 微服务平台控制台 ,在左侧导航栏单击 AI 网关 > 实例列表。
2. 在实例列表页面,单击需要配置的网关实例的“ID”,进入该网关实例的基本信息页面。
3. 在左侧导航栏单击 MCP 管理,在服务列表中单击目标 HTTP 转 MCP 服务的 ID/名称,进入服务详情页。
4. 在服务详情页顶部单击 Tools 管理 页签,在 Tools 列表页面选择目标 Tool 后进入到 Tool 基本信息页面。
5. 在 tool 详情页面选择“参数改写”tab 页面后,单击配置参数改写。
请求参数改写:
·参数重命名:为对外参数设置映射到后端的真实字段名(后端字段名)。
·参数位置(Position):指定参数在后端请求中的位置(如 Query、Header、Body 等)。
·固定注入字段(InjectFields):为后端请求注入固定值字段(如固定的鉴权头、渠道标识等)。
响应模板改写:
·响应模板(Response Body):使用 GJSON 语法从后端响应中提取并重组返回内容。
·错误响应模板:自定义错误场景下返回给客户端的内容。
6. 单击保存使配置生效。
三、相关说明
配置时请遵守以下限制:
| 配置项 | 取值范围 / 限制 |
| 工具参数数量 | ≤ 20 个 |
| 标签键长度 | ≤ 128 字符 |
| 标签值长度 | ≤ 4096 字符 |
| 请求 Body 模板长度 | ≤ 16384 字符 |
| 响应 Body 模板长度 | ≤ 16384 字符 |
| 错误响应模板长度 | ≤ 2048 字符 |
响应模板采用 GJSON 语法提取字段,配置后建议在调试中验证输出是否符合预期。