操作场景
默认情况下，一个 MCP 服务对外只有一个固定访问入口，所有请求统一转发到同一后端，无法按请求来源做差异化分发。通过 MCP 服务路由，你可以在同一个 MCP 服务下配置多条路由规则，基于 Path、HTTP 方法和 Header（含
Host）条件匹配入站请求，实现多租户隔离、多环境并行、灰度分流等场景。
典型场景：
多环境并行：同一 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 个字符 | - |
说明：
Header 多条条件之间为与（AND）关系，即全部满足才命中。
Host 与 Header 合计最多 8 条
3. 配置过程中，系统会实时校验该组匹配条件是否与同服务下已有路由冲突。若冲突，弹窗内会提示冲突的路由名称，需调整条件后才能提交。
4. 单击确定，列表中出现新建的路由，状态默认为已启用。
修改路由
1. 在路由规则页签中，单击目标路由操作列的编辑。
2. 修改所需参数后单击确定。
说明：
默认路由（
default）不支持修改。 该行不展示编辑按钮。可修改字段：路由名称、优先级、匹配路径与匹配方式、HTTP 方法、Header 匹配条件、描述。
修改后系统会重新校验唯一性，排除自身后仍与其他路由冲突则提交失败。
启用或禁用路由
1. 在路由管理页签中，单击目标路由操作列的禁用或启用。
2. 在确认弹窗中单击确定。
说明：
禁用状态的路由不参与流量匹配，但配置保留，可随时重新启用。
默认路由不支持禁用，始终保持启用状态。
启用/禁用操作幂等，重复执行同一状态不会报错。
删除路由
1. 在路由管理页签中，单击目标路由操作列的删除。
2. 在确认弹窗中单击确定。
说明：
默认路由不支持删除。 该行不展示删除按钮。
删除 MCP 服务时，其下所有自定义路由会被级联清理，无需逐条删除。
删除操作不可恢复，请确认该路由已无流量。
相关说明
路由匹配规则
单条路由内，匹配路径、HTTP 方法、所有 Header 条件之间为与（AND）关系，全部满足才命中该路由。
多条路由之间按优先级排序，数值大的优先匹配。
自定义路由（优先级 ≥ 1000）总是优先于默认路由（优先级 0）参与匹配。所有自定义路由都未命中时，请求回落到默认路由，保证服务始终可达。
仅已启用状态的路由参与匹配。
相同优先级下，由数据面按匹配条件的复杂度自动评分排序，条件更具体的路由优先命中。
