用途：在 Claude 中通过 remarkable-mcp（stdio MCP 服务器，二进制位于 ~/.local/bin/remarkable-mcp，也可用 uvx remarkable-mcp）读写 reMarkable 云端或经 SSH/USB 直连平板上的文档。
主要能力：remarkable_status 查看认证/传输/能力与文档数；remarkable_browse 列目录与过滤；remarkable_recent 取最近修改；remarkable_search 查找文档并返回路径与页面 OCR；remarkable_read 读取页面文本/OCR，content_type="annotations" 列出有批注的页面与高亮文本；remarkable_image 将页面渲染为 PNG，render_merged=true 合成 PDF、笔迹与高亮；remarkable_canvas 交互式画布；remarkable_upload 上传本地文件；remarkable_mkdir/move/rename/delete 管理文档与文件夹。
使用方式：以用户级注册服务器 claude mcp add remarkable -s user -- remarkable-mcp，用 claude mcp list 确认连接。认证令牌存于 ~/.rmapi，存在即已认证；新设备需从 https://my.remarkable.com/device/desktop 获取一次性码后运行 remarkable-mcp --register <code>。默认走云 API，可用 --ssh、--usb、--no-cloud-fallback；写工具默认开启，--read-only 可只读。会话中新增 MCP 或重装不会立即生效，可用 scripts/rm_mcp.py 直接驱动 stdio 服务器。
适用场景：把草稿上传到平板供批注、读取批注并转写为评论清单、按版本迭代评审并保留历史。上传为追加式，不会覆盖，需在文件名中写入日期与版本号，并沿用已有文档族名与最高版本号。
限制与陷阱：文档须按路径或名称寻址，不能用上传返回的 UUID；页码从 1 开始；批注需平板同步后才在云端可见；图像以 MCP resource blob 返回，需保存为 .png 再读取；content_type="raw" 按文本块分页，页码不可用于定位；render_merged 与批注高亮提取需补丁构建，PyPI ≤ 1.0.0 存在渲染错位与高亮缺失问题，此时可用平板端“发送邮件”导出 PDF/PNG。高亮文本偶有缺字或断句，宜作定位而非逐字转录。