连接 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 时区告诉助手，或者登录后打开一次陪读蛙网页应用，让账号把时区存下来。
如果还是卡住，请联系我们。