MCP 服务管理

MCP 页面是整个 MCP2Skill 的基础。所有工作区、端点和 Skills 都建立在 MCP 服务已经正确配置的前提上。

MCP 页面能做什么

在当前版本中，你可以在这里：

• 查看所有 MCP 服务
• 搜索服务
• 添加服务
• 从 MCP Market 发现并安装服务
• 导入配置
• 导出配置
• 启用或停用服务
• 打开详情页查看工具、配置和调用历史
• 从单个服务生成 Skill

支持的服务类型

STDIO

适合本地命令启动型服务，常见于通过命令行运行的 MCP 服务。

需要关注的字段通常包括：

• 命令
• 参数
• 环境变量
• 工作目录

SSE

适合通过远程 SSE 地址连接的 MCP 服务。某些服务可能还需要 OAuth 授权。

常见字段：

• 服务 URL
• 自定义请求头

Streamable HTTP

适合远程 HTTP 端点型 MCP 服务。

常见字段：

• 服务 URL
• 自定义请求头

从 MCP Market 发现服务

当前源码中 MCP 页面包含 Discover 入口，用来浏览内置市场数据并快速安装常见 MCP 服务。

使用市场入口时，建议先查看服务详情和需要填写的环境变量，再决定是否安装。安装后仍然要回到服务列表或详情页确认连接状态、工具数量和授权情况。

市场安装适合快速接入常见服务；如果你有自定义命令、本地脚本或私有远程服务，仍然可以使用手动添加。

添加服务

新增 MCP 服务时，建议按下面的顺序填写：

1. 选择服务类型
2. 填写名称标识
3. 填写显示名称
4. 补充描述
5. 根据类型填写连接配置
6. 视情况开启服务
7. 保存

名称标识 通常用于工具命名空间和端点标识，建议保持稳定，不要频繁改动。

编辑服务

编辑模式下，主要适合处理以下情况：

• 修改显示名称或描述
• 更新 URL、命令参数、请求头或环境变量
• 调整工作目录
• 修正错误配置

如果你发现服务明明存在但始终连不上，先回到编辑页检查配置是否填写完整。

启用与停用

每个服务都可以单独启用或停用。

• 启用 后，MCP2Skill 会尝试建立连接并拉取工具列表
• 停用 后，服务不会再对外提供可调用工具
• 工作区中的相关工具也会随之不可用

建议在导入大量服务之后，优先逐个检查关键服务是否成功运行。

如何理解服务状态

常见状态可以这样理解：

如果是远程服务，还可能看到和授权相关的状态，详见 远程服务与 OAuth 授权。

查看工具列表

服务详情页中的工具列表非常重要，它能帮助你判断当前服务是不是“真的可用”。

建议重点看三件事：

• 工具数量是否符合预期
• 工具名称是否正常显示
• 是否有工具被手动关闭

如果服务状态是正常的，但工具列表为空，通常意味着初始化没有成功完成，或者远程服务还没授权。

在服务级别启停工具

当前版本支持在单个服务内部对工具做开关控制。

这适合以下场景：

• 某个工具风险较高，不想对所有工作区开放
• 某个工具还在测试阶段，暂时先关闭
• 某个服务工具太多，希望先收缩暴露范围

服务级别关闭的工具，在工作区中也不会重新变成可用。

查看配置信息与调用历史

服务详情页除了工具列表，还可以看到：

• 配置信息
• 调用历史
• 网关端点
• JSON 配置复制入口

这意味着你通常不需要来回切换页面，就能完成“检查配置、复制端点、看调用结果”这整套动作。

删除服务前要注意什么

删除是不可逆操作。删除前建议确认：

• 这个服务是否仍被某个工作区依赖
• 是否还有外部 AI 应用在使用它的端点
• 是否还需要它的历史调用记录作为参考

如果你只是暂时不用它，通常先停用会比直接删除更稳妥。

相关章节

• 远程服务授权问题：看 远程服务与 OAuth 授权
• 批量导入或导出：看 导入与导出配置
• 想把服务整理进工作区：看 工作区基础