連接 AI 助理
把 MCP 伺服器新增到你的 AI 用戶端，在五個權限分組裡決定它能存取什麼，用完之後撤銷它。
開啟陪讀蛙網頁應用的 MCP 頁面。那裡有伺服器網址、各用戶端的設定步驟，以及你已經授權過的所有用戶端。
伺服器網址對所有人都一樣：
https://api.readfrog.app/api/mcp用戶端之間的區別只在於網址填在哪裡，以及用戶端本身有什麼前置要求。
新增伺服器
用上面的網址新增一個遠端 MCP 伺服器，傳輸方式為 Streamable HTTP。ChatGPT 裡在開啟開發者模式後的 設定 → 外掛程式 中；Claude 裡在 設定 → 連接器 → 新增自訂連接器。Codex 和 Claude Code 各只需要一條命令，MCP 頁面上有。
授權方式選 OAuth 2.1。動態用戶端註冊和用戶端 ID 中介資料文件都支援，因此不需要填 client ID
或密鑰。必須明確填寫探索文件的用戶端可以用
https://api.readfrog.app/.well-known/oauth-protected-resource/api/mcp。
用戶端會把你帶到陪讀蛙的授權確認頁面。登入，核對頁面上顯示的應用程式名稱和識別碼，為它申請的每個權限分組選擇層級，然後點 允許。
有些用戶端把自訂連接器放在自己的付費方案後面。ChatGPT 需要付費方案；個人版 Claude 需要 Pro 或 Max，團隊版和企業版則需由擁有者在組織設定中新增連接器。Codex 和 Claude Code 沒有這類限制。
陪讀蛙這一側的要求是 Ultra 方案。不滿足的帳號仍然能完成授權，但之後每次工具呼叫都會被拒絕並給出說明 —— 重新登入不會改變這一點，因為任何權限授權都不會改變訂閱。
五個權限分組
一共就五個分組。account 只有讀取；其餘四個每個都可以設為不允許、讀取、或讀寫。你按分組選擇，而且只能在用戶端本次實際申請的分組裡選。
| 分組 | 讀取讓助理能看到 | 讀寫額外讓它能做 |
|---|---|---|
account | 你的姓名、電子郵件和頭像，不含任何筆記內容。 | 無 —— 這個分組沒有寫入層級。 |
notebases | 你的筆記庫及其欄位定義，包括欄位 ID。 | 新建、重新命名和刪除筆記庫；新增、修改和刪除欄位。 |
notes | 每條筆記的欄位內容，以及在其中搜尋。 | 新建、修改和刪除筆記。 |
card_templates | 產生卡片的正反面格式。 | 新建、修改和刪除模板。 |
study | 複習記錄、排程狀態、隊列數量和每日上限。 | 提交和撤銷複習、修改每日上限、暫停和擱置卡片。 |
有兩個工具橫跨分組。讀取一張算繪好的卡片 —— 它的正面、反面、學習狀態 —— 需要 notes:read 和 study:read 同時具備，因為卡片是筆記內容加排程狀態。只給其中一個，list_cards 和 get_card 都用不了。
寫入權限能毀掉什麼
寫入不只是「能新增東西」。每個分組的寫入層級都包含刪除，而筆記庫裡的刪除是連鎖的。
| 授權 | 最壞情況 |
|---|---|
notes:write | 一條筆記被永久刪除，連同由它產生的每一張卡片和這些卡片的複習記錄。 |
notebases:write | 整個筆記庫被永久刪除 —— 它的欄位、所有筆記、模板、卡片和全部複習歷史。 |
card_templates:write | 一個模板被刪除，連同由它產生的每一張卡片和這些卡片的複習記錄。來源筆記會保留。 |
study:write | 一次你根本沒做的複習被提交。FSRS 會當真，於是這張卡片的穩定度、難度和下次到期時間全部變化。 |
這些在陪讀蛙裡都無法撤銷。undo_review 能回復一張卡片最近的一次複習，但被刪掉的筆記、欄位、模板和筆記庫沒有任何撤銷手段。
先只給讀取。唯讀權限已經足夠查東西、規劃要複習什麼、回報你的進展 —— 而且它什麼都弄丟不了。只有當某個用法確實需要時，再把對應分組提到讀寫；在核准一次刪除之前，先看清助理打算刪什麼。
之後追加權限
一份授權裡只會有某次授權請求申請過的內容，層級是你當時選的。如果某個工具因為缺權限而失敗，用戶端會被告知它缺哪一項；很多用戶端會自己把你再帶回確認頁面，也有一些必須手動重新連接才會再申請。
反向也可以：再授權一次並把某個分組調低。確認頁面只能調低本次請求提到的分組，所以用戶端不再申請的那些授權會保持原樣。想一次清空，就撤銷這個連線。
管理與撤銷
MCP 頁面會列出每個已連接的用戶端：它註冊的名稱、應用程式識別碼、你何時連接、最近一次授權的時間，以及它目前持有的權限。
撤銷會刪除這個用戶端的權限，並立即讓它失去存取能力。更新權杖隨授權一起失效，所以它下次嘗試重連時會回到確認頁面，由你重新決定。之後你可以再連接同一個用戶端，新的授權從零開始。
撤銷不會往回追溯。第三方服務已經收到的內容仍然在那個服務手裡 —— 陪讀蛙如何處理資料見隱私權政策。在助理裡把連接器移除也值得做，但那件事本身並不撤銷陪讀蛙這一側的授權。
遇到問題
- 工具提示需要更多權限。 可以授權對應分組，也可以繼續拒絕、只用已允許的操作。如果用戶端不會自己再申請，重新連接一次。
- 連接成功，但每個工具都提示方案限制。 這個帳號不在 Ultra 方案上。
- 看不到新增的工具。 重新整理或重新連接連接器，用戶端會快取工具清單。
- 寫入失敗，提示筆記已經變化。 修改會對過時資料做保護。讓助理重新讀取這條筆記再重試。
- 提交複習失敗，提示需要時區。 提交一次複習要決定它屬於哪個學習日，所以它不會猜。把你的 IANA 時區告訴助理，或者登入後開啟一次陪讀蛙網頁應用，讓帳號把時區存下來。
如果還是卡住，請聯絡我們。