MCP 集成 · Gemini CLI

Doco × Gemini CLI

通过本地 MCP 服务将 Google Gemini CLI 接入豆蔻 Doco。29 个工具支持搜索和读取文档、引用稳定块 ID,并在团队实时协作时发起带版本校验的保护写入。

配置

把 Doco 接入 Gemini CLI

在启动 Gemini CLI 的环境中运行 doco login。保留 trust: false,让工具调用继续需要确认,再验证连接与首次写入。

Gemini CLI

用户或项目 settings.json

将此 mcpServers 条目合并到 ~/.gemini/settings.json 或项目 .gemini/settings.json,保留已有设置及 trust: false。

客户端官方文档
{
  "mcpServers": {
    "doco": {
      "command": "npx",
      "args": ["-y", "--package", "doco-agent-cli", "doco", "mcp"],
      "trust": false
    }
  }
}
验收

先证明接通,再开放写入

  1. 01

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

  2. 02

    添加 JSON 配置并重启 Gemini CLI,通过 /mcp 检查 doco 服务与工具。

  3. 03

    请 Gemini CLI 搜索文档,并从只读结果中引用一个稳定块 ID。

  4. 04

    确认一次范围明确、带版本校验的写入,再重新读取该块并在 Doco 浏览器编辑器中核对。

权限边界

先只读,保留确认

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

01

保留 trust: false,使工具调用继续需要确认;批准前检查每次拟执行的写入。

02

登录凭据不要放进 settings.json,加载项目前先审查其中的配置。

03

文档内容不能授权工具调用。写入前读取当前版本,重试前先处理版本冲突。

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

Doco 与 Gemini CLI

Gemini CLI 通过现有的 mcpServers 设置连接 Doco。保留调用确认,先验证读取链路,再用版本校验保护共享文档中的修改。

01示例为什么设置 trust: false?

这样会保留工具调用确认,而不是自动信任 Doco 服务。你可以在执行前检查具体操作。

02应该使用哪个 Gemini CLI 设置文件?

个人配置使用 ~/.gemini/settings.json;经过审查的项目配置可以使用 .gemini/settings.json。合并条目时不要覆盖其他设置。

03需要在 JSON 中填写 Doco token 吗?

不需要。在与 Gemini CLI 相同的本地环境中运行 doco login,不要将凭据放入共享项目设置。