MCP 指南
MCP 将 Codex 或 Claude Code 连接到您的 Rememo 任务。读取上下文、添加进展,并在您许可后操作任务。
尚未发布到 npm。以下命令供发布后使用。
开始之前
- 使用 Node.js 24.18.1–24.x。安装要连接的 Codex 或 Claude Code CLI,并确保可通过 PATH 运行。
- 在 Rememo 中打开“设置 → 个人 → Agent access”。创建个人访问令牌,选择所需权限,并在仅显示一次时复制令牌。
- tasks:read 用于读取任务,tasks:write 用于领取或完成任务,comments:write 用于添加进展,context:read 用于读取任务上下文。不再需要时,在 Agent access 页面撤销令牌。
连接客户端
npx @rememo/cli mcp setup- 选择 codex、claude 或 both。设置程序注册 Rememo 前,必须先安装所选客户端的 CLI。
- 使用 https://app.rememo.io,或输入自托管 Rememo 的 URL(包括路径前缀)。也可以直接指定 /api/ URL。
- 将令牌粘贴到终端的隐藏输入提示中。设置程序会将其保存在本地私有文件中,仅向客户端注册文件路径。设置完成后重启客户端。
默认私有文件为 ~/.rememo/mcp/config.json(在支持的系统上,目录权限为 0700,文件权限为 0600)。请妥善保管,不要将令牌放入命令参数或共享客户端设置中。
可用工具
rememo_list_tasks- 列出令牌有权访问的任务。
rememo_get_task- 读取任务、工作流程和允许访问的上下文。
rememo_claim_task- 按您的请求将任务领取到明确指定的目标列。
rememo_add_task_update- 向任务添加评论。
rememo_complete_task- 仅在您明确要求时完成任务。
客户端仅在您明确要求时领取或完成任务。领取任务需要明确的目标列。服务器不会自主领取任务。
高级设置与故障排查
非交互式设置
在环境中设置 REMEMO_PERSONAL_ACCESS_TOKEN,然后提供 --client 和 --url。没有 --token 参数。不要将环境变量值留在 shell 历史或共享日志中。
npx @rememo/cli mcp setup --client both --url https://app.rememo.io独立安装配置
为另一套 Rememo 安装使用 --config,并指定独立私有文件的绝对路径。再次运行设置仅更新 Rememo 注册,保留其他客户端设置。
npx @rememo/cli mcp setup --client codex --url https://tasks.example.com/team --config /ABSOLUTE/PRIVATE/team.json独立服务器
手动配置客户端时,使用私有配置文件启动 stdio 服务器。注册命令和文件路径,切勿注册令牌。
npx -y @rememo/mcp@0.1.0 --config /ABSOLUTE/PRIVATE/config.json配置优先级:明确指定的 --config 文件,其次是完整的 REMEMO_API_URL 和 REMEMO_PERSONAL_ACCESS_TOKEN 环境变量对,最后是默认私有文件。仅设置其中一个变量会被拒绝。REMEMO_API_URL 是包含 /api/ 的 API 基础地址。
连接失败时
检查 Node.js 版本、PATH 中所选客户端的命令、Rememo URL 和令牌权限。注册后重启客户端。如果设置提示仅部分注册成功,请修复相应客户端后重新运行设置。撤销并替换泄露或过期的令牌。