可以用来做什么
让 Agent 先读规范再写代码
让 Agent 先读规范再写代码
用 Linkly AI 的
search 工具找到架构决策记录和需求文档，再用 read
阅读相关章节。ZCode Agent 拿着你的项目约定写代码，而不是靠猜。让 Goal Mode 和 Subagents 基于真实资料工作
让 Goal Mode 和 Subagents 基于真实资料工作
ZCode 通过 Goal Mode 和 Subagents 自主执行长周期任务。接入 Linkly AI
后，这些任务可以按需检索本地资料——多步骤的重构或迁移始终锚定在你真实的文档上。
一套知识库在所有工作区共享
一套知识库在所有工作区共享
在用户级配置一次 Linkly AI，所有 ZCode
工作区都能访问同一批本地文档。无需重复上传附件，也无需为每个项目单独配置。
前置条件
- 已安装 ZCode
- Linkly AI Desktop 已启动，MCP 服务正在运行
配置步骤
- 本地 MCP HTTP（推荐）
- 远程 MCP
- CLI Stdio（备选）
1
打开 MCP 服务器页面
打开 ZCode 设置，进入 MCP 服务器 页面，点击 新建 MCP 服务器。
2
选择作用域
选择 用户 让 Linkly AI 在所有工作区可用，或选择 工作区
仅在当前项目中可用。
3
填写配置并添加
填写以下信息：
- 类型：
HTTP - 名称：
linkly-ai - URL：
http://127.0.0.1:60606/mcp
linkly-ai 的开关已打开。安装 Skills
ZCode 支持 Agent Skills，你可以顺便安装 Linkly AI Skills，教会 Agent 如何高效使用这些工具：$ 选择 linkly-ai 即可调用。
开始使用
配置完成后，直接在 ZCode 中提问，Agent 会自动调用 Linkly AI 工具。例如：- “搜索我的文档，找找这个模块的架构决策”
- “读一下我的 API 规范，检查这个实现是否符合”
常见问题
在 .agents/mcp.json 中配置的服务消失了
在 .agents/mcp.json 中配置的服务消失了
同一作用域内
.zcode 配置优先：只要 ZCode 从 .zcode 配置文件中读到了任何
MCP 服务，该作用域下的 .agents/mcp.json
就会被整体跳过，而不是合并。请把这些服务迁移到 .zcode 配置文件中。HTTP 方式连接失败
HTTP 方式连接失败
检查 Linkly AI Desktop 是否正在运行、MCP 服务是否已启动。可以在终端执行
curl http://127.0.0.1:60606/mcp 测试连通性。服务在列表中但工具不可用
服务在列表中但工具不可用
被停用的服务会在配置对象中写入
"enable": false。在 MCP 服务器
页面重新打开开关，或从配置文件中删除该字段。Stdio 方式报找不到 linkly 命令
Stdio 方式报找不到 linkly 命令
确认已安装 Linkly AI CLI，且
linkly 命令在 PATH
中可用。可执行 linkly --version 验证。