Codex 如何连接 Filesystem MCP？让 AI 安全访问指定目录

大家好，我是 Codex 中文网的站长宇哥。

本文按 2026 年 8 月的 Codex 公开能力整理。Codex CLI、模型、Skill、Plugin 和第三方兼容接口更新较快，具体字段与可用能力请以你当前版本和官方文档为准。

Filesystem MCP 最容易“能用但权限太大”。只暴露任务真正需要的目录，并让写入路径尽量单独配置，避免把整个 $HOME 当工作区。

Codex 里的 MCP 配置放在哪里

Codex 会把 MCP 配置与其他设置一起保存在 config.toml。默认用户级位置是 ~/.codex/config.toml，受信任项目也可以使用 .codex/config.toml 做项目级配置。CLI、IDE 扩展和 ChatGPT 桌面端的 Codex 能共享这套配置。

从最小连接开始

官方 CLI 提供 codex mcp add 一类命令来添加 MCP Server。以本地 stdio Server 为例，思路是“先在终端独立启动成功，再交给 Codex 管理”。

# 形式示意：具体包名和参数以目标 MCP Server 文档为准
codex mcp add my-server -- npx -y some-mcp-server

如果 Server 自己都启动失败，继续修改 Codex 配置通常没有意义。先确认可执行文件、依赖、环境变量和标准输入输出协议。

数据库 MCP 的最低安全线

• 使用单独账号，不复用应用的高权限账号；
• 默认只读，真正从数据库权限层撤掉 DDL/DML；
• 限制能访问的库、Schema 或表；
• 给昂贵查询设置超时和行数限制；
• 记录 Tool Call 和数据库审计日志；
• 生产数据包含隐私信息时，先做脱敏和访问审批。

Skill 和 MCP 怎么配合

一个可靠做法是：MCP 提供能力，Skill 规定流程。比如数据库 MCP 暴露 query 工具，sql-review Skill 规定“先静态审查 SQL → 再用只读工具验证执行计划 → 最后输出风险”。这样既不会把业务规则散落在每次 Prompt 里，也不会让 MCP Server 承担不必要的 Agent 决策。

常见问题

这篇文章适合新手照着做吗？

适合。建议先按文章里的顺序理解问题背景，再在自己的项目里做最小验证，不要一次修改太多配置。

文章里的命令和配置需要完全照抄吗？

不建议完全照抄。Codex、模型接口和第三方工具更新很快，执行前要结合当前系统、项目目录、账号权限和官方文档再确认一遍。

总结

围绕“Codex 如何连接 Filesystem MCP”，建议始终从最小权限和最小工具集开始。先确保 Server 能独立工作，再让 Codex 连接；能用之后再增加认证、远程部署和自动化。这样排错和安全控制都会简单很多。

参考资料

• OpenAI：Model Context Protocol
• OpenAI：Configuration Reference
• OpenAI：Agent approvals & security

如果你通过第三方 API、中转站或兼容层使用 Codex，协议行为可能与 OpenAI 官方链路不同，排查时要把“Codex 客户端”和“上游接口”分开验证。