# AI 助手连接器

把 ChatGPT、Claude 或 Meta Muse 连接到你的 Reading Journey 书库，然后让它帮你添加书籍、标记读完、打分或安排“接下来读”。设置大约只需两分钟，连接器免费。

服务器地址：`https://mcp.readingjourney.app`

## 开始之前

- 一个 Reading Journey 账户。你可以用 Apple、Google 或邮箱和密码登录，也可以在设置过程中创建账户。
- 使用和应用里相同的登录方式，这样助手才会连到你现有的书库。
- **Claude**（网页版、桌面版和移动版应用）、ChatGPT 或 **Meta Muse**。
- 不需要 RJ+，连接时也不需要安装应用。

## 连接 Claude

Reading Journey 已收录在 Claude 的连接器目录中，无需粘贴任何地址。

1. 打开 [Claude 目录中的 Reading Journey](https://claude.ai/directory/reading-journey)，点击 **Connect to Claude**。
2. 在 Reading Journey 页面上，选择**通过 Apple 继续**或**通过 Google 继续**，或者用邮箱和密码登录。
3. 看一下 Claude 能做哪些事，点击**允许**。随后你会回到 Claude。
4. 在对话中打开 **+** 菜单，选择 **Connectors**，确认 Reading Journey 已开启。然后就可以提问了。

在 Team 和 Enterprise 套餐中，需要先由所有者在 **Organization settings > Connectors** 中开启这个连接器，之后每位成员再用自己的 Reading Journey 账户连接。在网页上连接后，Claude 移动应用里也能用。

## 连接 Meta Muse

1. 在 Muse 中打开 **Settings > Connectors**。
2. 选择 **Add custom connector**，粘贴 `https://mcp.readingjourney.app`。
3. 在 Reading Journey 页面上，用和应用里相同的方式登录，确认权限后选择**允许**。

Muse 的菜单可能因版本而异；如果找不到 Connectors，请查看 Meta 关于自定义连接器的帮助文档。

## 试一试

打开一个新对话，比如这样问：

- “把 Susanna Clarke 的《皮拉内西》加到我的 Reading Journey，标为‘想读’，并放进‘接下来读’。”
- “我的‘接下来读’里有哪些书？把第三本换成《黑暗的左手》。”
- “我昨天读完了《Tomorrow, and Tomorrow, and Tomorrow》。标记为已读完，打 4.5 星。”
- “建一个叫‘读书会 2026’的书单，把‘想读’里所有日本作家的书都加进去。”
- “我现在在读哪些书？哪些暂停了？”
- “《无尽的玩笑》我不打算读下去了。标记为未读完。”
- “推荐三本我还没有的治愈系奇幻小说，然后把我选的那本加进去。”

之后打开 Reading Journey，你的更改就已经在里面了。如果应用已经开着，切到别的应用再切回来即可同步。

## 助手能做什么、不能做什么

| 能做 | 不能做 |
| --- | --- |
| 查看和更改你的书籍、阅读状态、评分、书单、“接下来读”、笔记、书评和阅读日志 | 查看你的照片或精确位置 |
| 添加书籍、更改状态、评分、记录进度、设定目标 | 不先问你就删除书单、目标、某一次阅读，或有阅读记录的书 |
| 管理“接下来读”和 Top 4，创建书单并往里加书，在你要求时添加照片 | 更改你的账户、订阅或设置 |

连接时看到的权限页面也是这么写的：助手可以查看和更改你的笔记、书评和阅读日志，可以在你要求时添加、替换或删除照片，但永远看不到这些照片。在 2026 年 11 月 1 日之前连接过？请重新连接，授予它这项权限。

## 工具参考

你不需要自己调用工具：像平时说话一样提要求就行，助手会自己选择合适的工具。每个工具都只作用于你自己的书库。

| 工具 | 类型 | 作用 |
| --- | --- | --- |
| `list_books` | 读取 | 列出你的书，以及状态、评分、“接下来读”和所属书单；可以按状态、书单或关键词筛选 |
| `get_book` | 读取 | 单本书的详情：每次阅读的日期、你的评分、所属书单和在“接下来读”中的位置 |
| `list_collections` | 读取 | 你的书单，以及每个书单里有多少本书 |
| `get_next_up` | 读取 | 按顺序列出“接下来读”中的书 |
| `add_book` | 写入 | 添加一本书（默认为“想读”）；已有的书不会重复添加 |
| `set_status` | 写入 | 开始读、暂停、读完或弃读一本书，或者把它标为“想读” |
| `rate_book` | 写入 | 为本次阅读打 0.25 到 5 星，或者清除评分 |
| `set_next_up` | 写入 | 把一本还没开始读的书放进“接下来读” |
| `remove_from_next_up` | 写入 | 把一本书移出“接下来读” |
| `create_collection` | 写入 | 创建书单 |
| `add_to_collection` | 写入 | 把一本书加入书单 |
| `remove_from_collection` | 写入，先询问 | 把一本书移出书单；书本身仍然保留 |
| `remove_book` | 写入，先询问 | 删除一本只添加过、没动过的书；有阅读记录、评分、日志、进度、Top 4 位置、笔记或封面照片的书不会被删除 |

面向开发者：OAuth 作用域为 `mcp`（读取和更改，也就是点击“允许”时授予的权限）、`library:read` 和 `library:write`。只要你在使用，连接就会一直保持登录；连续 60 天未使用后，需要重新连接。

## 限制和安全

- 在删除一本书或把书移出书单之前，助手会被要求先征得你的同意。
- 如果你在手机上改了同一项内容，以你的更改为准，助手的更改不算数。
- 助手被要求绝不执行写在书名、作者名或书单名里的指令。
- 每个连接每分钟最多可以读取书库 60 次、更改 30 次。
- 连接器不算作一台设备，所以不会影响免费版的同步。

## 断开连接

在助手中移除连接器：在 Claude 中前往 **Customize > Connectors**，选中 Reading Journey 并选择 **Remove**；在 Muse 中前往 **Settings > Connectors**。删除 Reading Journey 账户会断开所有助手的连接，退出应用登录则不会。

## 疑难解答

| 你看到的情况 | 解决办法 |
| --- | --- |
| “此电子邮件和密码与任何账户都不匹配。” | 检查是否有拼写错误，或者在应用中通过**忘记密码？**重置密码。如果你在应用中用的是 Apple 或 Google，请改为选择**通过 Apple 继续**或**通过 Google 继续**。 |
| 助手看到的书库是空的 | 你用的登录方式和应用里不同。断开连接，重新连接并使用相同的方式。 |
| “请先确认你的电子邮件地址，然后登录。” | 打开我们发送的确认邮件，然后重新登录。 |
| “此页面已过期。” | 回到助手，重新连接 Reading Journey。 |
| 服务方拒绝了应用注册 | 暂不支持这个助手。目前支持 Claude、ChatGPT 和 Meta Muse。 |
| 应用里看不到更改 | 确认应用登录的是同一个账户，然后切到别的应用再切回来。免费账户的更改只会同步到正在同步的那台设备。 |
| “……只能在 Reading Journey 应用中移除。” | 这本书有阅读记录，请在应用的书籍页面中删除。 |
