连接外部 AI 客户端

如果你不走 Skills 路径，或者你还需要兼容多种 AI 客户端，那么 MCP 网关路径 就是 MCP2Skill 的第二主线。

这一路径的重点不是节省 Token，而是：

• 一处配置，多端复用
• 不用在每个客户端里重复配置 MCP
• 不用让每个客户端都各自拉起一遍 MCP 进程
• 通过一个统一入口保留更好的可观测性

你需要先完成什么

在连接外部客户端之前，建议先确认：

• 至少一个 MCP 服务已经成功运行
• 或者至少一个工作区已经创建完成
• 你知道自己要暴露的是单服务端点、工作区端点还是 ALL 端点

如果你的目标其实是“让 AI Agent 长期复用能力并尽量节省 Token”，建议先回到 生成与安装 Skills。

如果这些都还没准备好，先回到 快速开始。

可以从哪里复制配置

当前版本中，以下位置通常都可以复制连接信息：

• MCP 服务详情页
• 工作区详情页
• 系统工作区 ALL

复制菜单通常提供两种选择：

• 复制端点地址
• 复制 JSON 配置

复制端点地址适合什么情况

适合你已经了解目标客户端的 MCP 配置格式，只需要拿到核心 URL 的情况。

常见用途：

• 在外部客户端中手动填写连接地址
• 自己维护一份更复杂的客户端配置
• 做调试或对接测试

复制 JSON 配置适合什么情况

适合你想快速接入 Claude Code 兼容的客户端。

这类 JSON 通常已经帮你准备好了：

• 服务名称
• 连接类型
• 网关 URL
• 必要请求头

如果启用了 API Key，对应的鉴权头也会被一并处理到配置中。

为什么这条路径依然值得保留

即使 Skills 是 MCP2Skill 的主线，网关路径依然非常重要，因为它解决的是另一类问题：

• 不同 AI 客户端的兼容接入
• 已有客户端工作流的平滑迁移
• 统一配置和统一运行带来的资源节省

很多用户最终会同时使用两条路径：

• Skill 路径 负责把 MCP 工具转换成可按需加载的 Skills，解决 Token 与工作流效率
• 网关路径 负责兼容和复用

如何选择要复制哪种端点

单 MCP 服务端点

适合：

• 只暴露一个服务
• 调试某个服务是否正常
• 把某个独立功能接给特定客户端

工作区端点

适合：

• 暴露一组经过筛选的工具
• 按项目、任务或使用场景隔离工具
• 给不同客户端提供不同工具范围

ALL 端点

适合：

• 快速检查全局连通性
• 测试所有已启用服务是否都可见

如果你追求长期稳定使用，通常还是优先使用“自建工作区端点”。

开启 API Key 后要注意什么

当你在设置中开启 API Key 认证后：

• 外部客户端必须携带正确的 API Key
• 直接复制 JSON 配置会更省事
• 手动配置时要特别注意请求头是否完整

如果外部客户端连不上，而你又刚开启了 API Key，优先检查这里。

接入后的第一轮验证

不管你接的是哪个客户端，都建议做一次最小验证：

1. 在客户端中保存或刷新 MCP 配置
2. 发起一次会触发工具调用的请求
3. 回到 MCP2Skill 查看仪表盘或日志

如果能看到调用记录，说明网关、客户端和工具链路都已经打通。

如果客户端能连上，但工具不对

重点检查下面几项：

• 你复制的是不是正确的端点
• 工作区中是否禁用了某些工具
• 服务级别是否关闭了相关工具
• 目标服务当前是否处于已连接状态

很多“客户端工具不完整”的问题，其实不是客户端问题，而是工作区或服务层面的筛选导致的。

推荐做法

• 如果目标是节省 Token，优先考虑 Skill 路径
• 用工作区端点作为长期配置
• 用 ALL 端点做全局调试
• 开启 API Key 时优先复制 JSON 配置
• 每次改完服务或工作区，都做一次实际调用验证

相关章节

• 想理解工作区端点差异：看 工具筛选与工作区端点
• 想配置端口或 API Key：看 常规与 MCP 设置
• 想看接入是否生效：看 日志与诊断