快速开始

本篇提供两条最短上手路径，但会明确给出推荐顺序。

默认推荐路径是 Skill 路径，因为它更符合 MCP2Skill 的核心初衷：把 MCP 工具转换为可按需加载的 Skill，减少 Token 消耗，并减少你在不同 AI 客户端之间来回维护配置的负担。

上手前准备

开始之前，建议先确认：

• 你已经知道自己要接入的 MCP 服务来自哪里
• 如果你打算导入旧配置，原应用的配置文件仍然存在
• 如果你打算手动添加远程服务，已经准备好正确的 URL、请求头或授权条件

先选一条主路径

推荐路径：Skill 路径

适合你希望：

• 把 MCP 工具转换成 Skill
• 服务 AI Agent
• 利用按需加载进一步节省 Token 和重复上下文

推荐流程：

1. 导入或添加 MCP 服务
2. 确认服务和工具可用
3. 生成 Skill
4. 安装到 AI Agent
5. 在实际 AI 工作流里验证收益

次路径：网关路径

适合你希望：

• 把同一套 MCP 配置给多个 AI 客户端复用
• 不想在每个客户端里重复配置 MCP
• 用一个统一网关替代多个客户端各自启动 MCP

推荐流程：

1. 导入或添加 MCP 服务
2. 确认服务和工具可用
3. 创建工作区
4. 复制端点或 JSON 配置
5. 在外部 AI 客户端中接入

第一步：导入已有配置

这是最省时间的方式。

1. 打开左侧导航中的 MCP
2. 点击右上角的 导入
3. 选择导入来源
4. 预览识别到的服务列表
5. 勾选需要导入的服务
6. 执行导入

导入完成后，你会立即在 MCP 服务列表里看到这些服务。

如果没有现成配置：手动添加 MCP 服务

如果你没有现成配置，可以直接新建。

1. 进入 MCP
2. 点击右上角 添加
3. 选择服务类型
4. 填写基础信息和连接配置
5. 视情况开启服务
6. 保存配置

建议至少先添加并验证一个服务，确认整个流程通畅后，再继续批量整理。

第二步：启动并确认服务可用

添加或导入之后，先确认服务本身能工作。

1. 在 MCP 服务列表中打开目标服务
2. 查看状态是否为已连接或正在运行
3. 打开详情页中的工具列表
4. 确认工具名称已经成功加载

如果是远程服务且需要授权，请先完成授权流程，再回到工具列表确认结果。无论你后面走 Skill 路径还是网关路径，这一步都不能跳。

推荐路径：生成并安装第一个 Skill

如果你的目标是节省 Token，下一步不要急着建工作区，而是先把可用 MCP 工具转换成 Skill。

1. 打开一个已经可用的 MCP 服务详情页，或者先整理一个工作区
2. 点击生成 Skill
3. 预览生成结果
4. 选择导出到目录，或直接安装到 AI Agent
5. 在实际 AI Agent 中验证

推荐你优先用“一个高频工具服务”做第一轮 Skill 验证，这样收益最容易感知。

次路径：创建你的第一个工作区

如果你的目标是统一接入多个 AI 客户端，当至少有一个服务可用后，就可以创建工作区。

1. 在左侧工作区区域点击新增按钮
2. 填写工作区名称、显示名称和描述
3. 勾选要纳入该工作区的 MCP 服务
4. 如有需要，在工作区里进一步禁用部分工具
5. 保存工作区

工作区保存后，会自动生成一个可供外部客户端使用的网关端点。

次路径：复制端点或 JSON 配置

下一步是把 MCP2Skill 接给外部 AI 应用。

1. 打开工作区详情页
2. 找到网关端点区域
3. 点击复制菜单
4. 选择复制端点地址，或复制 JSON 配置

如果你只想先快速测试，也可以直接使用系统工作区 ALL 的端点。

验证结果

如果你走的是 Skill 路径，建议验证：

1. Skill 是否已经出现在目标 AI Agent 目录
2. AI Agent 是否能正确识别并使用该 Skill
3. 是否达到了你预期的复用和 Token 控制效果

如果你走的是网关路径，建议验证：

1. 重启或刷新外部 AI 应用中的 MCP 配置
2. 发起一次会使用 MCP 工具的请求
3. 回到 MCP2Skill 的仪表盘、统计或日志页面观察结果

只要能看到调用记录，说明链路已经打通。

推荐顺序总结

• 目标是节省 Token：优先走 Skill 路径
• 目标是统一接入多个 AI 客户端：优先走 网关路径
• Skill 路径 解决的是 Token 和工作流效率
• 网关路径 解决的是接入兼容和统一管理
• 两者并不冲突，很多用户会先整理 MCP，再同时使用这两条路径

如果中途遇到问题

• 服务没有启动：看 MCP 服务管理
• Skill 安装或识别不对：看 生成与安装 Skills
• 远程授权失败：看 远程服务与 OAuth 授权
• 客户端接不上：看 连接外部 AI 客户端
• 没有看到工具：看 常见问题与故障排查