把 AI 助手接进思源（MCP 接入指南）

这是什么？

MCP（Model Context Protocol）是一个开放协议，简单说就是 AI 工具的"万能插头"：插上之后，你的 AI 助手就不只是聊天，而是能直接操作思源笔记——查资料、看进度，甚至替你干活。​

番茄工具箱、渐进学习、仿写练习三个插件已经把各自的能力接入了思源内核自带的 MCP 服务。你的 AI 助手接上之后，就能这样用：​

你对 AI 说	AI 替你做的
「看看我这周专注了几个番茄，时间都花在哪些文档上」	调用番茄工具箱查询专注记录并汇总
「帮我找找笔记里所有写过『间隔重复』的地方」	调用全库语义 / 关键词搜索
「今天的渐进阅读到期队列怎么样？没读完的帮我推到明天」	调用渐进学习查书单进度、到期队列、代你推迟重访
「把《XXX》这篇文档搭成一个仿写练习现场」（Pro）	调用仿写练习通读原文、设计锚点，一键装配出练习

除此之外，思源内核还自带 29 个通用工具（读写笔记、搜索、导出、历史版本、SQL 查询等），AI 能力上限就是你的整座笔记库。​

准备工作（三样）

1.
思源笔记 ≥ 3.7.0（建议直接升级到最新版），并且保持运行——MCP 服务随思源启动。​

2.
插件升到最新版：番茄工具箱 ≥ 5.8.0、渐进学习 ≥ 3.11.0、仿写练习 ≥ 1.4.0（都在思源「设置 → 集市」或已安装列表里更新）。​

3.
一个支持 MCP 的 AI 工具（下文给出 ZCode / Trae / CodeBuddy / Qoder 四个的配置方法，其他支持 MCP 的工具同理）。​

💡 AI 工具和思源要在同一台电脑上使用（MCP 地址是本机地址）。手机端的接入方式见文末进阶。​

三步接入

第 1 步：找到思源的 MCP 地址（大概率不用找）

思源第一个启动的工作空间恒定监听 6806 端口——这是思源官方为浏览器剪藏扩展等外部程序预留的固定通道。所以默认地址就是：​

代码块

http://127.0.0.1:6806/mcp

两种例外情况：

•

6806 被其他程序占用，或你同时开了多个工作空间：思源会另用一个随机端口。打开思源「设置 → 关于」，「在浏览器上使用」一段里列出了实际可用的网络地址（比如 http://127.0.0.1:53065），把里面的端口号换进上面的地址即可。

•
API 令牌：在思源「设置 → 关于 → API 令牌」。如果你的思源设置过「访问授权码」（锁屏密码），连接时必须带上这个令牌；没设过（默认情况）不带也能连，但建议统一填上，最稳妥。​

💡 思源侧没有任何需要手动开启的开关——MCP 服务随思源启动自动就绪，把插件更新到位、保持思源运行就行。​

第 2 步：在 AI 工具里添加这个 MCP

各工具的配置入口不同，JSON 格式基本一致，选你的工具照抄：​

智谱 ZCode（命令行 AI 编程助手，需 GLM 编码套餐）

装好 ZCode 并登录后，两种方式任选：

•
图形界面：Settings → MCP 里添加。​

•
编辑配置文件 ~/.zcode/cli/config.json，加入 mcp.servers 段（已有该段就往里加一条）：​

代码块

{​
  "mcp": {​
    "servers": {​
      "siyuan": {​
        "type": "http",​
        "url": "http://127.0.0.1:6806/mcp",​
        "headers": {​
          "Authorization": "Token 把这里换成你的API令牌"​
        }​
      }​
    }​
  }​
}​

保存后重开会话即自动连接，Settings → MCP 里能看到 siyuan 已连接、工具已列出。​

字节跳动 Trae（AI IDE）

IDE 右上角「设置」→ 左侧「MCP」→ 右上「添加 > 手动添加」，粘贴下面的 JSON 确认即可（也可以点「原始配置(JSON)」直接编辑 mcp.json）：​

代码块

{​
  "mcpServers": {​
    "siyuan": {​
      "url": "http://127.0.0.1:6806/mcp",​
      "headers": {​
        "Authorization": "Token 把这里换成你的API令牌"​
      }​
    }​
  }​
}​

把 AI 助手接进思源（MCP 接入指南）​

把 AI 助手接进思源（MCP 接入指南）