ReedenReeden
AI 助手

MCP 服务

打开 Reeden 的 MCP 服务,让电脑上的其他 AI 客户端读取你的书库、笔记和阅读统计。

MCP 服务能做什么

如果你平时用支持 MCP 的 AI 客户端(例如一些桌面版 AI 助手、编程工具),打开 Reeden 的 MCP 服务后,这些客户端就能在 Reeden 运行期间:

  • 查询书库、书籍信息、笔记和书评
  • 查看阅读统计
  • 导出某本书的笔记
  • 在 Reeden 里打开某本书
  • 生成书库整理计划,在 Reeden 里打开,由你确认后才应用

MCP 服务是会员功能,电脑、安卓和 iPhone / iPad 上可以用,鸿蒙版暂不支持。

打开 MCP 服务

  1. 打开「设置 → AI 助手」
  2. 点右上角更多菜单里的「MCP 服务」
  3. 打开「启用 MCP 服务」,状态变成「运行中」就可以连接了
  4. 想每次打开 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 服务会停止,重新开通会员后会按原来的开关自动启动。