01
Cascade 对同时启用的工具总量有限制,应关闭不用的工具/server,而不是一次暴露全部。
Windsurf 支持 stdio、Streamable HTTP 和 SSE。本指南使用本地 stdio,让 Doco device login 和 CLI 配置留在本机。
打开 Windsurf Settings → Cascade → MCP Servers,或编辑 ~/.codeium/windsurf/mcp_config.json 后重新加载。
客户端官方文档{
"mcpServers": {
"doco": {
"command": "npx",
"args": ["-y", "--package", "doco-agent-cli", "doco", "mcp"]
}
}
}运行 doco login,把凭据保留在本地 Doco 配置。
在 Windsurf MCP 设置或原始配置文件中添加 doco server。
打开 MCP 面板,只启用当前任务需要的 Doco 工具并确认连接状态。
先让 Cascade 搜索并引用一个块;读路径正确后再测试保护写入。
MCP 进程使用你的本机权限和 Doco Token。审查启动命令,只暴露目标工作区,并在只读验收通过后再给写权限。
Cascade 对同时启用的工具总量有限制,应关闭不用的工具/server,而不是一次暴露全部。
写入保留审批;连接成功不等于可以修改任意文档。
无头凭据使用环境插值,绝不把真实 Token 放进共享 JSON。
doco_search_v2doco_outlinedoco_readdoco_patch_blockdoco_batch_editdoco_changesWindsurf 能把 Doco 作为标准本地 MCP server 启动。关键在工具纪律:只暴露当前流程需要的集合,并保留写入确认。
原始配置位于 ~/.codeium/windsurf/mcp_config.json,也可以通过 Cascade MCP 面板管理。
Windsurf 支持 Streamable HTTP,但 Doco 远程入口当前需要调用者 API Token。本地 stdio 更适合浏览器 device login。
更小的活动工具集能减少歧义并显式保留权限边界;只有真正需要的流程才开放写入。