操作场景
随着 AI 应用的普及，企业内部分散的 AI 工具、数据源需要被统一注册、发现和治理。北极星 AI 能力将成熟的服务治理能力延伸至 AI 领域，作为企业私有的 MCP 注册中心，帮助你统一管理两类 MCP 服务：
服务类型 | 后端实体 | 核心价值 | 适用场景 |
标准 MCP 服务 | 已实现 MCP 协议的 MCP Server | 服务管理。直接管理已标准化的 MCP 能力 | 新建或可改造的、重要的 AI 能力 |
微服务转 MCP 服务 | 微服务（HTTP/HTTPS） | 协议转换与包装。联动网关将普通微服务“转换”为 MCP 服务 | 存量、无法改造的传统业务系统 |
本文档介绍如何在北极星控制台创建、配置和管理 MCP 服务，以及为“微服务转 MCP 服务”配置 MCP Tools。
前提条件
已创建 北极星（Polaris）实例。
已使用具备相应权限的腾讯云账号登录。
（微服务转 MCP 服务场景）已在北极星注册中心注册了对应的微服务，且与目标 MCP 服务处于同一命名空间。
操作步骤
步骤一：进入 MCP 服务管理
1. 登录 服务治理中心控制台。
2. 在实例列表中单击目标 北极星实例 ID，进入实例详情页。
3. 在左侧导航栏选择 MCP 管理，进入 MCP 服务列表页。
步骤二：查看 MCP 服务列表
服务列表展示当前实例下的所有 MCP 服务，包含以下信息：
字段 | 说明 |
名称/ID | MCP 服务名称及 ID，单击可进入服务详情页 |
命名空间 | MCP 服务所在命名空间 |
服务类型 | 标准 MCP 服务（原生、外部导入）、微服务转 MCP 服务 |
服务协议 | SSE、Streamable HTTP |
关联 Tools 数 | 标准 MCP 服务：由后端动态发现（SDK 上报）；微服务转 MCP 服务：显示实际配置数量，为 0 时提示“暂无 Tool” |
描述 | MCP 服务描述 |
创建/修改时间 | 服务的创建与最近修改时间 |
操作 | 编辑、删除；微服务转 MCP 服务额外提供“管理 Tool” |
您可以进行以下操作：
搜索：通过顶部搜索框按服务名称、ID、命名空间、协议类型、服务来源、描述进行模糊搜索。
筛选：通过表头的“服务类型”、“服务来源”下拉筛选器进行筛选。
批量删除：勾选多个服务后单击顶部删除，弹窗确认后批量删除。
步骤三：新建 MCP 服务
在列表页单击新建，根据服务类型选择对应的创建方式。
方式一：新建标准 MCP 服务
适用于新增一个已符合 MCP 协议的后端服务（MCP Server）。
配置项 | 必填 | 说明 |
命名空间 | 是 | 选择或输入 MCP 服务所在命名空间 |
服务名称 | 是 | 唯一标识，支持中英文、数字、 -、_，限 64 字符 |
服务类型 | 是 | 选择“标准 MCP 服务” |
服务协议 | 是 | SSE 或 Streamable HTTP |
服务端点 | 否 | 北极星支持两种接入方式（见下方说明） |
描述 | 否 | 服务描述 |
授权 / 可见性 | 否 | 配置方式与普通微服务一致 |
说明：北极星 MCP 注册中心支持两种接入方式：
1. 直接注册：MCP Server 通过 SDK 注册到北极星，自动被发现，无需填写 URL。
2. URL 关联（外部导入）：将已有 MCP 服务的 URL 关联到北极星，需填写服务地址（域名或 IP）和服务端口。
配置完成后，单击确完成创建。
方式二：新建微服务转 MCP 服务
适用于将已注册在北极星的微服务转换包装成 MCP 服务（需联动 MCP 网关完成协议转换）。
配置项 | 必填 | 说明 |
命名空间 | 是 | 选择或输入 MCP 服务所在命名空间 |
服务名称 | 是 | 唯一标识 |
服务类型 | 是 | 选择“微服务转 MCP 服务” |
服务协议 | 是 | SSE 或 Streamable HTTP |
后端服务-命名空间 | 是 | 选择后端微服务所在命名空间（需与 MCP 服务同一命名空间） |
后端服务-服务来源 | 是 | 从命名空间的服务列表中选择，也支持跳转新建 |
后端服务-传输协议 | 是 | HTTP、HTTPS |
描述 / 授权 / 可见性 | 否 | 配置方式与普通微服务一致 |
说明：
创建成功后，建议前往该服务的 MCP Tools 管理 配置工具，完成微服务 API 到 MCP Tool 的映射。
步骤四：编辑与删除 MCP 服务
编辑：在操作列单击编辑，表单回显现有配置。
说明：
为避免下游配置失效，“服务类型”“服务协议”不可修改，仅支持修改描述；如需更换类型或协议，请新建服务。
删除：单击删除，弹窗确认后删除。
说明：
删除前系统会校验是否存在服务实例。
步骤五：查看 MCP 服务详情
单击服务名称进入详情页，可查看与管理：
服务详情：查看、编辑、删除 MCP 服务配置。
MCP 服务实例：查看服务实例信息（页面展示与逻辑与微服务实例一致）。
MCP Tools：仅“微服务转 MCP 服务”涉及 Tool 管理。
权限管理：与微服务权限管理保持一致。
管理 MCP Tools（微服务转 MCP 服务）
MCP Tool 是 AI 模型可调用的具体工具单元。一个 MCP Tool 对应后端 HTTP 服务的一个或多个 API 端点，定义了 AI 调用的名称、描述、参数及到 HTTP 请求的映射规则。
说明：
本模块专为“微服务转 MCP 服务”设计。“标准 MCP 服务”的 Tools 由后端 MCP Server 动态提供，无需在此手动配置。
进入 Tools 管理
在“微服务转 MCP 服务”的详情页单击 MCP Tools 页签，或在列表页操作列单击管理 Tool。列表支持按 Tool 名称、描述模糊搜索，按状态筛选。
新建 / 编辑 MCP Tool
单击新建或编辑，弹出配置表单：
配置项 | 必填 | 说明 |
名称 | 是 | 支持中英文、数字、 -、_，限 64 字符，如 get_user_info |
是否启用 | 是 | 默认开启；关闭后该 Tool 不可见、不可被调用 |
描述 | 是 | 自然语言描述，如“根据用户 ID 查询用户详细信息” |
协议转换配置 | 是 | 选择后端 API 接受的请求格式：JSON 请求体 / 表单数据。选择后载入对应模板，可编辑 URL、请求方法、请求头等 |
参数配置 | 是 | 定义 AI 调用时需提供的参数 |
参数配置支持动态表单，每行可配置：参数名、类型、描述、是否必填。支持的参数类型如下：
参数类型 | 用途 | 说明 |
string | 文本字符串 | 名称、ID、关键词等，可映射到请求任意位置 |
number | 数值（整数/浮点） | 年龄、价格、页码等，可配置最小值/最大值约束 |
boolean | 布尔值 | 开关、状态标志，描述应说明 true/false 含义 |
object | JSON 对象 | 嵌套结构（如地址、筛选条件），建议在描述中说明字段结构 |
array | 值数组 | ID 列表、标签等，可配置数组项类型 |
说明：
对于 object、array 复杂类型，可在参数结构区域通过“展开/嵌套”方式定义其内部子参数。
移除 Tool
在 Tool 列表操作列单击删除，弹窗确认后移除。移除后该 Tool 将无法被调用。
其他相关能力
注册到北极星的 MCP 服务可复用北极星既有的管理能力：
配置中心：通过配置分组和配置文件，为 MCP 服务提供分布式配置管理（操作方式与微服务配置中心一致）。
可观测：在监控页面查看 MCP 服务的注册配置监控、服务调用监控（请求数、请求失败、请求延时、调用时延等），监控页支持按“MCP 服务请求/微服务请求”“MCP 注册中心/微服务注册中心”筛选。
