使用 CLI 与 MCP 连接 AI 助手

当前开放范围

CLI 与 MCP 目前属于开发者预览能力，适合熟悉终端和本地工具配置的用户。公开安装包暂未内置独立命令，当前接入工具随臻序源码提供；普通用户不需要进行任何配置。

CLI 可以做什么

• 查询全部事项，或按关键词、象限、状态和可见范围筛选。
• 查看单条事项详情。
• 创建默认私密的新事项。
• 更新标题、备注、象限、状态、截止时间和标签。
• 将事项标记为完成。

node scripts/zhenxu-cli.mjs list --status doingnode scripts/zhenxu-cli.mjs create --title "整理发布计划" --quadrant q1 --tag 发布node scripts/zhenxu-cli.mjs update <事项ID> --status doingnode scripts/zhenxu-cli.mjs done <事项ID>

连接 Codex

在臻序源码目录中执行以下命令，将标准 stdio MCP 注册到 Codex。注册完成后重启 Codex，即可在新任务中使用臻序工具。

• zhenxu_list_tasks：查询事项。
• zhenxu_get_task：读取事项详情。
• zhenxu_create_task：创建私密事项。
• zhenxu_update_task：更新事项。
• zhenxu_complete_task：完成事项。

codex mcp add zhenxu -- node /你的臻序源码路径/scripts/zhenxu-mcp.mjs

连接 WorkBuddy 或其他客户端

如果客户端支持自定义 stdio MCP Server，可将启动命令设置为 node，并把臻序 MCP 脚本的绝对路径作为参数。不同客户端的配置入口名称可能是“MCP Server”“本地工具”或“外部工具”。

command: nodeargs: /你的臻序源码路径/scripts/zhenxu-mcp.mjs

数据与权限边界

• 工具默认读写当前电脑上的臻序真实数据库，操作会直接出现在桌面端。
• AI 创建的事项默认仅自己可见，不会自动分享给组织成员。
• 已共享事项的修改继续使用臻序原有同步队列和权限规则。
• 工具不会绕过事项可见范围，也不会读取其他成员的私密事项。