工具筛选与工作区端点

工作区真正有价值的地方，不只是“把服务放在一起”，而是“把工具按场景筛选后再对外暴露”。

工作区里的工具来自哪里

工作区工具来自你选中的 MCP 服务，但最终暴露给外部客户端的工具集合，还会受到两个层级影响：

• 服务级别的工具开关
• 工作区级别的工具开关

也就是说，一个工具必须同时在服务级别和工作区级别都保持可用，外部客户端才能真正看到它。

为什么还要做工作区级别筛选

工作区级别筛选适合以下情况：

• 同一服务在不同工作区里只开放部分工具
• 想给某个项目做一个更精简的工具集
• 想减少外部客户端看到的工具噪音

这样做比复制多个几乎相同的 MCP 服务配置更省事。

工作区工具页常见操作

在工作区的工具页中，你通常可以：

• 搜索工具
• 查看工具所属的 MCP 服务
• 开启或关闭某个工具
• 检查当前可用工具数量

如果你已经知道某个工具风险较高，建议在工作区层面也主动关闭。

工作区端点能做什么

每个工作区都会生成自己的网关端点。这个端点代表的是：

这让工作区天然适合做场景隔离。

从工作区生成 Skill 时也会使用工作区端点

工作区不只影响直接复制给外部客户端的网关配置，也会影响从工作区导出或安装的 Skills。

• 关闭 聚合生成 Skill 时，MCP2Skill 会为每个成员 MCP 服务生成独立 Skill，但这些 Skill 的调用脚本仍然指向该工作区端点
• 开启 聚合生成 Skill 时，MCP2Skill 会生成一个代表整个工作区的 Skill，同样调用该工作区端点

因此，即使非聚合模式下产物看起来像多个单 MCP Skill，实际可调用工具仍会受到工作区工具筛选限制。

系统工作区 ALL 的端点是 /all，普通工作区则使用自己的 /workspace/{name} 端点。

复制端点还是复制 JSON

工作区详情页提供的复制菜单通常有两种用法：

复制端点地址

适合：

• 你已经知道目标 AI 应用如何手动配置 MCP 连接
• 你只需要拿到 URL 或在别处自行拼接配置

复制 JSON 配置

适合：

• 你想快速接入 Claude Code 兼容客户端
• 你不想自己手写配置结构
• 你希望同时把必要请求头一起带过去

如果已经启用了 API Key，这种方式尤其方便。

什么时候用单 MCP 服务端点

更适合：

• 只想暴露某一个服务
• 正在调试单个服务
• 不需要工具组合和筛选

什么时候用工作区端点

更适合：

• 想把多个服务打包给同一个客户端
• 想控制外部看到的工具范围
• 想按项目或任务隔离工具

什么时候用 ALL 端点

更适合：

• 首次验证整个系统是否通了
• 临时测试所有已启用工具
• 快速排查“是不是工作区配置导致的问题”

但如果你在正式使用中追求清晰和可控，通常还是建议使用自建工作区端点。

工作区中的日志页有什么用

工作区详情页除了工具页，还有日志页。它适合用来回答：

• 某个工作区最近有没有被调用
• 调用失败是不是只发生在这个工作区
• 当前筛选后的工具集合是否符合预期

如果你刚修改过工具开关，建议做一次实际调用，再回到这里确认结果。

相关章节

• 想学习工作区创建与编辑：看 工作区基础
• 想从工作区生成 Skill：看 生成与安装 Skills
• 想把端点接给客户端：看 连接外部 AI 客户端
• 想看工作区调用结果：看 日志与诊断