docs: discourage MCP filesystem workspace config (#3141)

This commit is contained in:
Nan Gao
2026-05-22 03:19:23 +02:00
committed by GitHub
parent c881d95898
commit 253542ea0d
6 changed files with 44 additions and 34 deletions
@@ -193,15 +193,23 @@ BETTER_AUTH_SECRET=local-dev-secret-at-least-32-chars
```json
{
"mcpServers": {
"filesystem": {
"my-server": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"],
"args": ["-y", "@my-org/my-mcp-server"],
"enabled": true
}
}
}
```
<Callout type="warning">
不要为 DeerFlow 工作区文件引入 MCP filesystem server。它会与 DeerFlow
内置文件工具形成路径语义不同的重复能力,让 LLM 行为不稳定。DeerFlow
当前没有为 filesystem server 适配 MCP Roots 模式,也不会把{" "}
<code>/mnt/user-data/...</code> 这类沙箱路径映射成{" "}
<code>@modelcontextprotocol/server-filesystem</code> 可接受的路径。
</Callout>
### 技能启用状态
技能启用状态会反映在 `extensions_config.json` 中。你可以直接编辑它,或通过 DeerFlow 应用界面进行管理。