MCP 集成 · Windsurf Cascade

Doco × Windsurf Cascade

将 stdio 包加入 MCP 设置或原始 mcp_config.json,即可让 Windsurf Cascade 接入 Doco,并发现结构化、版本保护的知识工具。

配置

把 Doco 接入 Windsurf Cascade

Windsurf 支持 stdio、Streamable HTTP 和 SSE。本指南使用本地 stdio,让 Doco device login 和 CLI 配置留在本机。

Windsurf Cascade

原始 mcp_config.json

打开 Windsurf Settings → Cascade → MCP Servers,或编辑 ~/.codeium/windsurf/mcp_config.json 后重新加载。

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

先证明接通,再开放写入

  1. 01

    运行 doco login,把凭据保留在本地 Doco 配置。

  2. 02

    在 Windsurf MCP 设置或原始配置文件中添加 doco server。

  3. 03

    打开 MCP 面板,只启用当前任务需要的 Doco 工具并确认连接状态。

  4. 04

    先让 Cascade 搜索并引用一个块;读路径正确后再测试保护写入。

权限边界

先只读,保留确认

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

01

Cascade 对同时启用的工具总量有限制,应关闭不用的工具/server,而不是一次暴露全部。

02

写入保留审批;连接成功不等于可以修改任意文档。

03

无头凭据使用环境插值,绝不把真实 Token 放进共享 JSON。

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

Doco 与 Windsurf Cascade

Windsurf 能把 Doco 作为标准本地 MCP server 启动。关键在工具纪律:只暴露当前流程需要的集合,并保留写入确认。

01Windsurf 把 MCP 设置存在哪里?

原始配置位于 ~/.codeium/windsurf/mcp_config.json,也可以通过 Cascade MCP 面板管理。

02Windsurf 能使用 Doco 远程 HTTP 吗?

Windsurf 支持 Streamable HTTP,但 Doco 远程入口当前需要调用者 API Token。本地 stdio 更适合浏览器 device login。

03为什么不自动启用 29 个工具?

更小的活动工具集能减少歧义并显式保留权限边界;只有真正需要的流程才开放写入。