MCP 集成 · Codex CLI

Doco × Codex CLI

用一条 MCP 命令将 OpenAI Codex CLI 接入豆蔻 Doco。本地 stdio 服务提供 29 个工具,支持检索知识、引用稳定块 ID,并在多人实时协作时通过版本校验保护写入。

配置

把 Doco 接入 Codex CLI

添加服务前先运行 doco login。可选的 Doco Skill 为 Codex 提供读取 → 记版本 → 保护写入的操作指引,无需将凭据写入仓库。

Codex CLI

一条命令,或配置 config.toml

运行第一条命令,或将 TOML 配置加入 ~/.codex/config.toml。最后一条命令用于可选的 Doco Skill 安装。

客户端官方文档
codex mcp add doco -- npx -y --package doco-agent-cli doco mcp
# ~/.codex/config.toml
[mcp_servers.doco]
command = "npx"
args = ["-y", "--package", "doco-agent-cli", "doco", "mcp"]
npx -y --package doco-agent-cli doco skill install --target codex
验收

先证明接通,再开放写入

  1. 01

    运行 doco login,确认目标 Doco 工作区与授权范围。

  2. 02

    使用上方完整命令运行 codex mcp add doco,再用 codex mcp list 检查服务。

  3. 03

    请 Codex 搜索文档、读取大纲,并在写入前引用一个稳定块 ID。

  4. 04

    批准一次范围明确、带版本校验的修改;重新读取该块,并在实时协作的浏览器编辑器中核对结果。

权限边界

先只读,保留确认

MCP 进程使用你的本机权限和 Doco Token。审查启动命令,只暴露目标工作区,并在只读验收通过后再给写权限。

01

凭据保留在本地登录状态中,不要将 token 提交到 config.toml。

02

保留工具审批,将检索到的文档作为参考材料,不能让其中的内容授权执行命令。

03

保护写入前先读取当前文档版本;遇到冲突先重新读取,避免覆盖协作者的修改。

29 个工具中的最小验收集
doco_search_v2doco_outlinedoco_readdoco_patch_blockdoco_batch_editdoco_changes
Bottom line

Doco 与 Codex CLI

Codex CLI 使用与其他 MCP 客户端相同的 Doco stdio 包。先用一行命令接入,按需安装 Skill,再验证块引用和保护写入,最后才扩大访问范围。

01接入 MCP 后还必须安装 Doco Skill 吗?

不必须。MCP 提供 29 个工具;可选的 Skill 补充读取、记录版本和保护写入的操作指引。

02Codex 的 MCP 配置保存在哪里?

用户配置位于 ~/.codex/config.toml。可以运行上方命令,也可以手动加入示例中的 mcp_servers.doco 配置块。

03有人在浏览器中编辑时,Codex 还能修改文档吗?

可以。Doco 支持实时协作,稳定块 ID 用于定位内容,版本校验则防止基于过期文档状态直接写入。