原生 MCP 与项目文档

MCP接入

原生 MCP 与项目文档

通过智能体自己的 MCP 客户端直连 SlothVault。SlothTool 不转发调用,不保存 Key;只访问已有服务时,不必先部署应用。

连接与验证

  1. 在自己的 SlothVault 管理后台 MCP Key 页面获取匹配宿主的连接配置。
  2. 在宿主原生 MCP 设置中启用连接,完成工具发现及所需审批。
  3. 请求一次只读查询,例如“查询名称包含 SlothTool 的项目,返回 ID 和名称,不修改内容”。

收到实际工具结果才算调用成功。配置格式以实例生成内容及宿主当前说明为准,不照抄历史参数,也不将 Key 放入聊天、文档或 settings.json。

安装 Skill后,在选中的源码项目中可以这样提出任务:

使用 SlothVault Skill,为当前项目创建项目文档。先核对源码版本,保存为校验通过的草稿,不发布。

后续更新:

更新这个项目的文档。核对当前源码与原文档基线,新版本先复制旧文档,仅修订受影响内容,补充集中更新日志,不发布。

创建与更新流程使用稳定文档键、源码基线和修订号;已有同版本草稿复用,新版本保留旧文档后再增量修改。旧版没有元数据时先确认实体和源码身份,不按近似标题覆盖。

常见问题

表现检查位置
无工具宿主启用状态、连接配置和发现
401 / 403Key 的有效性与实例权限
超时服务、网络和宿主连接状态
参数不接受当前工具 schema;项目同步需 outline、get_many、apply_draft
VERSION_FROZEN改用可编辑草稿,不是连接错误

超时后先回读目标,避免重复创建。草稿准备不授权发布;缺少接口时先更新服务,不改用旧 Client。