Codex MCP 工具配置实战：从入门到多服务器并行

什么是 MCP？

MCP（Model Context Protocol）是 AI 与外部工具之间的标准桥梁。没有 MCP，AI 只能聊天；有了 MCP，AI 才能真正调用浏览器、数据库、命令行等工具。

Codex 的 MCP 配置存储在 ~/.codex/config.toml 中，支持同时配置多个 MCP 服务器，每个服务器提供一组工具供 Codex 按需调用。

方法一：使用 CLI 命令快速添加

这是最快捷的方式，一条命令完成安装：

# 添加一个 MCP 服务器
codex mcp add <服务器名称> -- <npx命令>
复制

实际例子——添加 GitHub MCP 服务：

codex mcp add github -- npx -y @modelcontextprotocol/server-github
复制

添加数据库 MCP 服务：

codex mcp add my-database -- npx -y @my/database-mcp
复制

方法二：手动编辑配置文件

打开 ~/.codex/config.toml，添加以下内容：

[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]

[mcp_servers.my-tool]
command = "python3"
args = ["/path/to/mcp_server.py"]
env = { API_KEY = "your-key-here" }
复制

验证配置是否成功

配置完成后，重启 Codex，在交互界面输入：

/mcp
复制

如果看到已配置的服务器列表且状态为「已连接」，说明配置成功。

多服务器并行配置示例

假设你想同时接入 GitHub、数据库和一个内部工具：

[mcp_servers.github]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-github"]
env = { GITHUB_PERSONAL_ACCESS_TOKEN = "ghp_你的Token" }

[mcp_servers.postgres]
command = "npx"
args = ["-y", "@modelcontextprotocol/server-postgres", "postgresql://user:pass@localhost/db"]

[mcp_servers.internal]
command = "python3"
args = ["/opt/mcp-servers/internal.py"]
复制

重启 Codex 后输入 /mcp，你会看到三个服务器均已连接。

注意事项

1. Token 安全：不要把真实 Token 直接写在配置文件中提交到 Git 仓库，建议通过环境变量注入。
2. 版本兼容：不同 MCP 服务器对 Codex 版本有最低要求，安装前确认兼容性。
3. 重启生效：修改 config.toml 后必须重启 Codex TUI，配置不会自动热更新。
4. 端口冲突：如果使用本地启动的 MCP 服务，确认端口未被占用。

常见 MCP 服务器推荐

来源：CSDN 开源社区多篇 Codex MCP 配置教程（agent.csdn.net、blog.csdn.net）

资料最后核对日期：2026-09-19 · 内容整理自 CodexGuide 社区公开教程