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