一、操作场景
典型场景：
·多环境并行：同一 MCP 服务同时支持生产域名 mcp-prod.example.com 与测试域名 mcp-test.example.com。
·多租户隔离：按 Host 或 X-Tenant-Id Header 将不同租户流量分发到独立入口。
·灰度分流：携带 X-Canary: true 的请求单独走一条路由。
·版本路由：按 X-Version 的正则模式（如 ^v[2-3]\\..*）匹配。
注意：说明：
注意：所有路由规则共用同一个后端服务（Upstream）。路由规则只控制“哪些请求能进来”，不控制“转发到哪里”。如需变更后端，请编辑 MCP 服务本身。
二、前提条件
·已创建 AI 网关类型的云原生 API 网关实例，且实例状态为运行中。
·网关数据面版本 ≥ 3.9.5。
·已在该实例下创建 MCP 服务（标准 MCP 服务或 HTTP 转 MCP 服务均支持）。
三、名词解释
| 术语 | 说明 |
| 默认路由 | 创建 MCP 服务时系统自动生成的路由，名称固定为 default，优先级为 0。不可修改、不可删除、不可禁用，作为兜底入口保证服务可达 |
| 自定义路由 | 用户手动创建的路由规则，优先级默认从 1000 起步。可增删改查、可启用/禁用 |
| 匹配表达式 | 系统根据你配置的 Path、Methods、Header 条件自动生成的路由匹配表达式，只读展示，无需手工编写 |
四、查看路由列表
1. 登录 AI 网关控制台。
2. 在左侧导航栏选择实例列表，单击目标 AI 网关实例 ID 进入实例详情页。
3. 选择 MCP 管理，单击目标 MCP 服务名称进入详情页。
4. 选择路由规则页签，查看相关信息。
| 列名 | 说明 |
| 优先级 | 0，数值越大优先匹配。默认路由为 0 |
| 路由名称 | 默认路由固定为 default，并带默认标签 |
| 状态 | 已启用 / 已禁用 |
| 匹配路径 | 路径值 + 匹配方式标签（精确/前缀/正则） |
| Host 匹配 | 不限 |
| Path 匹配 | 精确匹配，/mcpservers/mcp 服务名称/mcp |
| Header 匹配 | 无条件显示 — |
| HTTP 方法 | 允许的方法列表 |
| 创建时间 | 路由创建时间 |
| 操作 | 编辑 / 启用/禁用 / 删除（默认路由行无操作按钮） |
五、新建路由
1. 在路由规则页签中，单击添加规则。
2. 在弹窗中配置填写：
·基本信息：
| 参数名 | 是否必填 | 取值范围/默认值 | 说明 |
| 路由名称 | 必填 | 最长 64 个字符 | 同一 MCP 服务下不可重复。 不可使用 default（系统保留） |
| 优先级 | 选填 | 默认 1000 | 数值越大优先匹配。自定义路由建议保持 ≥ 1000，确保优先于默认路由 |
| 描述 | 选填 | 最长 200 个字符 | – |
·配置 Path 匹配：
| 参数名 | 是否必填 | 取值范围/默认值 | 说明 |
| 匹配路径 | 选填 | 最长 256 个字符 | 需以 / 开头，如 /api。不同路由的路径可以重复，通过其他条件区分 |
| 匹配方式 | 选填 | 精确 / 前缀 / 正则 | 精确：路径完全一致；前缀：路径以指定值开头；正则：路径符合 RE2 正则表达式 |
注意：说明：
注意：正则模式必须是合法的 RE2 语法（如 ^/api/v[0-9]+$）。非法正则在提交时即被拦截。
·配置 Host 匹配
| 参数名 | 是否必填 | 取值范围/默认值 | 说明 |
| 匹配方式 | 必填 | 精确 / 前缀 / 正则 | 正则必须为合法 RE2 语法 |
| 匹配值 | 必填 | – | 填写目标 Host 值 |
·配置 HTTP 方法（本期新增能力）：
| 参数名 | 是否必填 | 取值范围 | 说明 |
| HTTP 方法 | 选填 | GET / POST / PUT / DELETE / PATCH / HEAD / OPTIONS | 多选，作为方法白名单。不选择表示不限制方法 |
·配置 Header 匹配，单击添加 Header 条件新增一行：
| 参数名 | 是否必填 | 取值范围/默认值 | 说明 |
| Header 名称 | 必填 | 最长 64 个字符 | 大小写不敏感。填写 Host 时系统自动识别为对请求域名的匹配（无需单独的 Host 配置项） |
| 匹配方式 | 必填 | 精确 / 前缀 / 正则 | 正则必须为合法 RE2 语法 |
| 匹配值 | 必填 | 最长 256 个字符 | – |
注意：说明：
3. 配置过程中，系统会实时校验该组匹配条件是否与同服务下已有路由冲突。若冲突，弹窗内会提示冲突的路由名称，需调整条件后才能提交。
4. 单击确定，列表中出现新建的路由，状态默认为已启用。
六、修改路由
1. 在路由规则页签中，单击目标路由操作列的编辑。
2. 修改所需参数后单击确定。
注意：说明：
七、启用或禁用路由
1. 在路由管理页签中，单击目标路由操作列的禁用或启用。
2. 在确认弹窗中单击确定。
注意：说明：
八、删除路由
1. 在路由管理页签中，单击目标路由操作列的删除。
2. 在确认弹窗中单击确定。
注意：说明：
九、路由匹配规则
·单条路由内，匹配路径、HTTP 方法、所有 Header 条件之间为与（AND）关系，全部满足才命中该路由。
·多条路由之间按优先级排序，数值大的优先匹配。
·自定义路由（优先级 ≥ 1000）总是优先于默认路由（优先级 0）参与匹配。所有自定义路由都未命中时，请求回落到默认路由，保证服务始终可达。
·仅已启用状态的路由参与匹配。
·相同优先级下，由数据面按匹配条件的复杂度自动评分排序，条件更具体的路由优先命中。