操作场景
在 MCP Server 的日常运维中,您可能需要临时停止某个服务对外提供能力(如发布、维护期间),或在恢复后重新对外提供服务。通过 上下线管理,您可以手动控制 MCP Server 及其工具的可用状态;同时可配置 健康检查,由网关自动探测后端健康状况并联动服务状态。
前提条件
已创建云原生 AI 网关实例。
已创建 MCP Server。
操作步骤
手动上线 / 下线 MCP Server
1. 登录 微服务平台控制台 ,在左侧导航栏单击 云原生智能网关 > 实例列表。
2. 在实例列表页面,单击需要配置的网关实例的“ID”,进入该网关实例的基本信息页面。
3. 在左侧导航栏单击 MCP 管理,然后单击 MCP 服务页签,找到目标 MCP 服务后单机进入 MCP 服务详情页面。
4. 单击「运行状态」操作列的 上线(Online) 或 下线(Offline):
下线:该 Server 暂停对外提供服务。
上线:恢复对外提供服务。

启用 / 禁用单个工具
切换到「Tools 管理」标签页,选择目标工具,单击启用(Enable)或 禁用(Disable),控制单个工具是否对外可用。

配置健康检查
1. 在 MCP 服务详情页,找到健康检查配置区域,单击编辑。

2. 配置以下参数:
参数 | 取值范围 / 默认值 | 说明 |
检查类型(Type) | MCP / HTTP | 探测协议类型 |
检查间隔(Interval) | 默认 30(秒) | 探测周期 |
超时时间(Timeout) | 默认 5(秒) | 单次探测超时 |
失败阈值(FailThreshold) | 默认 3(次) | 连续失败判定为不健康 |
恢复阈值(RecoverThreshold) | 默认 1(次) | 连续成功判定为恢复 |
检查路径(Path) | 默认 /health | 仅 HTTP 类型需配置 |
请求方法(Method) | 默认 GET | 仅 HTTP 类型需配置 |
3. 单击保存使健康检查生效。
相关说明
手动下线后,服务状态不受健康检查自动恢复影响,需手动重新上线。
健康检查类型为 HTTP 时才需配置检查路径与请求方法;类型为 MCP 时按 MCP 协议探测。
上下线、启停操作即时生效,建议在变更窗口内操作以避免影响线上调用。