連接 AI 助理
把 MCP 伺服器新增到你的 AI 用戶端，在五個權限分組裡決定它能存取什麼，用完之後撤銷它。
開啟陪讀蛙網頁應用的 MCP 頁面。那裡有伺服器網址、各用戶端的設定步驟，以及你已經授權過的所有用戶端。
伺服器網址對所有人都一樣：
https://api.readfrog.app/api/mcp陪讀蛙已上架 ChatGPT 和 Claude。可從各自的目錄直接加入，也可以用伺服器位址連接其他 MCP 用戶端。
新增伺服器
授權方式選 OAuth 2.1。動態用戶端註冊和用戶端 ID 中介資料文件都支援，因此不需要填 client ID
或密鑰。必須明確填寫探索文件的用戶端可以用
https://api.readfrog.app/.well-known/oauth-protected-resource/api/mcp。
用戶端會把你帶到陪讀蛙的授權確認頁面。登入，核對頁面上顯示的應用程式名稱和識別碼，為它申請的每個權限分組選擇層級，然後點 允許。
在受管理的工作區中，可能需要管理員先啟用此外掛。 團隊版和企業版可能需要組織先啟用此連接器。
陪讀蛙在任何方案上都能用：免費帳號每天可以執行 10 次工具，Pro 帳號 50 次，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 頁面會列出每個已連接的用戶端：它註冊的名稱、應用程式識別碼、你何時連接、最近一次授權的時間，以及它目前持有的權限。
撤銷會刪除這個用戶端的權限，並立即讓它失去存取能力。更新權杖隨授權一起失效，所以它下次嘗試重連時會回到確認頁面，由你重新決定。之後你可以再連接同一個用戶端，新的授權從零開始。
撤銷不會往回追溯。第三方服務已經收到的內容仍然在那個服務手裡 —— 陪讀蛙如何處理資料見隱私權政策。在助理裡把連接器移除也值得做，但那件事本身並不撤銷陪讀蛙這一側的授權。
遇到問題
- 工具提示需要更多權限。 可以授權對應分組，也可以繼續拒絕、只用已允許的操作。如果用戶端不會自己再申請，重新連接一次。
- 每個工具都提示每日呼叫次數已用完。 這個帳號當天的工具呼叫次數用完了，提示裡寫著什麼時候可以再次呼叫。
- 看不到新增的工具。 重新整理或重新連接連接器，用戶端會快取工具清單。
- 寫入失敗，提示筆記已經變化。 修改會對過時資料做保護。讓助理重新讀取這條筆記再重試。
- 提交複習失敗，提示需要時區。 提交一次複習要決定它屬於哪個學習日，所以它不會猜。把你的 IANA 時區告訴助理，或者登入後開啟一次陪讀蛙網頁應用，讓帳號把時區存下來。
如果還是卡住，請聯絡我們。