原生 MCP 与项目文档
原生 MCP 与项目文档
通过智能体自己的 MCP 客户端直连 SlothVault。SlothTool 不转发调用,不保存 Key;只访问已有服务时,不必先部署应用。
连接与验证
- 在自己的 SlothVault 管理后台 MCP Key 页面获取匹配宿主的连接配置。
- 在宿主原生 MCP 设置中启用连接,完成工具发现及所需审批。
- 请求一次只读查询,例如“查询名称包含 SlothTool 的项目,返回 ID 和名称,不修改内容”。
收到实际工具结果才算调用成功。配置格式以实例生成内容及宿主当前说明为准,不照抄历史参数,也不将 Key 放入聊天、文档或 settings.json。
安装 Skill后,在选中的源码项目中可以这样提出任务:
使用 SlothVault Skill,为当前项目创建项目文档。先核对源码版本,保存为校验通过的草稿,不发布。
后续更新:
更新这个项目的文档。核对当前源码与原文档基线,新版本先复制旧文档,仅修订受影响内容,补充集中更新日志,不发布。
创建与更新流程使用稳定文档键、源码基线和修订号;已有同版本草稿复用,新版本保留旧文档后再增量修改。旧版没有元数据时先确认实体和源码身份,不按近似标题覆盖。
常见问题
| 表现 | 检查位置 |
|---|---|
| 无工具 | 宿主启用状态、连接配置和发现 |
| 401 / 403 | Key 的有效性与实例权限 |
| 超时 | 服务、网络和宿主连接状态 |
| 参数不接受 | 当前工具 schema;项目同步需 outline、get_many、apply_draft |
| VERSION_FROZEN | 改用可编辑草稿,不是连接错误 |
超时后先回读目标,避免重复创建。草稿准备不授权发布;缺少接口时先更新服务,不改用旧 Client。