AI 助手
MCP 服务
打开 Reeden 的 MCP 服务,让电脑上的其他 AI 客户端读取你的书库、笔记和阅读统计。
MCP 服务能做什么
如果你平时用支持 MCP 的 AI 客户端(例如一些桌面版 AI 助手、编程工具),打开 Reeden 的 MCP 服务后,这些客户端就能在 Reeden 运行期间:
- 查询书库、书籍信息、笔记和书评
- 查看阅读统计
- 导出某本书的笔记
- 在 Reeden 里打开某本书
- 生成书库整理计划,在 Reeden 里打开,由你确认后才应用
MCP 服务是会员功能,电脑、安卓和 iPhone / iPad 上可以用,鸿蒙版暂不支持。
打开 MCP 服务
- 打开「设置 → AI 助手」
- 点右上角更多菜单里的「MCP 服务」
- 打开「启用 MCP 服务」,状态变成「运行中」就可以连接了
- 想每次打开 Reeden 都自动运行,打开「随应用启动」
手机上把 Reeden 切到后台后,系统可能会暂停 MCP 服务,用的时候把 Reeden 留在前台。
在 AI 客户端里连接
MCP 服务页面里有连接要用的三样东西,「连接地址」和「访问令牌」右侧有复制按钮:
| 项目 | 说明 |
|---|---|
| 「连接地址」 | 默认是 http://127.0.0.1:28890/mcp,只有这台设备上的程序能连 |
| 「端口」 | 默认 28890,和别的程序冲突时改成 1024–65535 之间的其他数字 |
| 「访问令牌」 | 客户端连接时要带上的密码 |
在 AI 客户端里添加一个 MCP 服务器,类型选 HTTP(有的客户端叫 Streamable HTTP),地址填「连接地址」,再加一个请求头:
Authorization: Bearer 你的访问令牌不同客户端的配置写法不一样,以客户端自己的说明为准。
页面下方的「配套 Skill」是推荐给 AI 客户端安装的使用说明,装上后 AI 能更准确地理解书库和笔记,点「查看使用说明」看安装方法。
访问令牌和局域网
- 访问令牌相当于密码,拿到它的人能读取你的书库和笔记。不要发给别人,也不要截图外传。觉得泄露了,点「重新生成令牌」,旧令牌立即失效,已经配置好的客户端要换成新令牌
- 默认只允许本机连接。打开「允许局域网访问」后,同一个网络里的其他设备也能连,「连接地址」会多出一个局域网地址
- 只在家里、自己的办公室这类可信网络里开局域网访问,在公共 Wi-Fi 上不要打开。用完可以关掉
常见问题
状态显示「启动失败」
多半是端口被别的程序占用了,换一个端口再打开。页面上会显示具体的错误信息。
客户端连不上
- 确认 Reeden 正在运行,MCP 服务状态是「运行中」
- 确认客户端里的地址、端口和「连接地址」一致
- 确认请求头里的访问令牌是最新的,重新生成过令牌要同步更新
- 从别的设备连接时,确认已打开「允许局域网访问」,并且两台设备在同一个网络
会员到期后还能用吗
不能。会员到期后 MCP 服务会停止,重新开通会员后会按原来的开关自动启动。
Reeden