# AI 助理連接器

把 ChatGPT、Claude 或 Meta Muse 連接到你的 Reading Journey 書庫，就能請它幫你加書、標記讀完、評分，或規劃「接下來讀」。設定只要兩分鐘左右，連接器免費使用。

伺服器位址: `https://mcp.readingjourney.app`

## 開始之前

- 一個 Reading Journey 帳號。你可以用 Apple、Google 或電子郵件和密碼登入，也可以在設定過程中建立帳號。
- 使用和 App 中相同的登入方式，助理才會連到你現有的書庫。
- **Claude**（網頁版、桌面版和手機 App）、ChatGPT 或 **Meta Muse**。
- 不需要 RJ+，連接時也不必安裝 App。

## 連接 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 的手機 App 也能使用。

## 連接 Meta Muse

1. 在 Muse 中開啟 **Settings > Connectors**。
2. 選擇 **Add custom connector**，貼上 `https://mcp.readingjourney.app`。
3. 在 Reading Journey 頁面上，用和 App 中相同的方式登入，確認權限後選擇**允許**。

Muse 的選單可能會隨版本變動；如果找不到 Connectors，請查看 Meta 關於自訂連接器的說明。

## 試試看

開啟新的對話，然後問問看，例如：

- 「把 Susanna Clarke 的《皮拉奈奇》加到我的 Reading Journey，設為想讀，並放進接下來讀。」
- 「我的接下來讀有哪些書？把第三本換成《黑暗的左手》。」
- 「我昨天讀完《明日，明日，又明日》了。幫我標記為已完成，給 4.5 顆星。」
- 「建立一個叫『讀書會 2026』的書單，把想讀的書裡日本作家寫的都加進去。」
- 「我現在在讀哪些書？哪些暫停了？」
- 「《Infinite Jest》我決定棄讀了，幫我標記為未讀完。」
- 「推薦三本我還沒有的療癒系奇幻小說，再把我選的那本加進去。」

之後打開 Reading Journey，就會看到你的變更。如果 App 已經開著，切換到別的 App 再切回來，就會同步。

## 助理能做和不能做的事

| 可以 | 不可以 |
| --- | --- |
| 查看並變更你的書、閱讀狀態、評分、書單、接下來讀、筆記、書評和日誌紀錄 | 查看你的照片或精確位置 |
| 加書、變更閱讀狀態、評分、記錄進度和設定目標 | 沒先問你就刪除書單、目標、某次閱讀，或有閱讀紀錄的書 |
| 管理接下來讀和 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 帳號會中斷所有助理的連接，但登出 App 不會。

## 疑難排解

| 你看到的訊息 | 解決方式 |
| --- | --- |
| 「此電子郵件和密碼與任何帳戶都不相符。」 | 檢查是否有打錯字，或在 App 中重設密碼（點**忘記密碼？**）。如果你在 App 中是用 Apple 或 Google 登入，請改選**透過 Apple 繼續**或**透過 Google 繼續**。 |
| 助理看到的書庫是空的 | 你登入的方式和 App 中不同。請中斷連接後重新連接，並使用相同的方式登入。 |
| 「請先確認你的電子郵件地址，然後登入。」 | 打開我們寄給你的確認信，然後再登入一次。 |
| 「此頁面已過期。」 | 回到助理，重新連接 Reading Journey。 |
| 服務提供者拒絕了 App 註冊 | 目前還不支援這個助理。支援的是 Claude、ChatGPT 和 Meta Muse。 |
| App 中看不到變更 | 確認 App 登入的是同一個帳號，然後切換到別的 App 再切回來。免費帳號的變更只會傳到負責同步的那台裝置。 |
| 「…只能在 Reading Journey App 中移除。」 | 這本書有閱讀紀錄，請在 App 的書籍頁面中刪除。 |
