HoRain云--Codex MCP 服务器配置 HoRain云小助手个人主页 个人专栏: 《Linux 系列教程》《c语言教程》⛺️生活的理想就是为了理想的生活!⛳️ 推荐前些天发现了一个超棒的服务器购买网站性价比超高大内存超划算忍不住分享一下给大家。点击跳转到网站。专栏介绍专栏名称专栏介绍《C语言》本专栏主要撰写C干货内容和编程技巧让大家从底层了解C把更多的知识由抽象到简单通俗易懂。《网络协议》本专栏主要是注重从底层来给大家一步步剖析网络协议的奥秘一起解密网络协议在运行中协议的基本运行机制《docker容器精解篇》全面深入解析 docker 容器从基础到进阶涵盖原理、操作、实践案例助您精通 docker。《linux系列》本专栏主要撰写Linux干货内容从基础到进阶知识由抽象到简单通俗易懂帮你从新手小白到扫地僧。《python 系列》本专栏着重撰写Python相关的干货内容与编程技巧助力大家从底层去认识Python将更多复杂的知识由抽象转化为简单易懂的内容。《试题库》本专栏主要是发布一些考试和练习题库涵盖软考、HCIE、HRCE、CCNA等目录⛳️ 推荐专栏介绍什么是 MCPMCP 基础配置Codex 配置菜单配置文件位置stdio 类型服务器配置 stdio MCP 服务器HTTP 类型服务器配置 HTTP MCP 服务器MCP 工具配置限制可用工具工具白名单/黑名单超时配置配置超时MCP 认证配置OAuth 配置配置 OAuthHTTP 头配置配置 HTTP 头OAuth 回调配置配置 OAuth 回调MCP 工具权限配置工具权限常用 MCP 服务器文件系统服务器文件系统 MCPGitHub 服务器GitHub MCPPostgreSQL 服务器PostgreSQL MCP常用 MCP 服务器故障排除服务器启动失败工具调用超时认证问题常见问题Q: MCP 服务器无法启动Q: 工具权限在哪里配置Q: 如何禁用某个 MCP 服务器Q: 支持多少个 MCP 服务器MCPModel Context Protocol模型上下文协议允许 Codex 与外部工具和服务集成。本节详细介绍如何配置和使用 MCP 服务器。什么是 MCPMCP 是一个开放协议允许 AI 模型与外部工具和服务进行标准化交互。通过 MCP 服务器你可以扩展 Codex 的能力连接文件系统访问数据库集成项目管理工具调用外部 APIMCP 基于开放的 Model Context Protocol 构建支持跨不同工具的标准化集成。MCP 基础配置Codex 配置菜单通过设置菜单可以管理或添加 MCP 服务连接至自定义 MCP:配置文件位置MCP 服务器在~/.codex/config.toml的mcp_servers部分配置。stdio 类型服务器配置 stdio MCP 服务器[mcp_servers.filesystem]# 服务器启动命令command npx# 传递给命令的参数args [-y, modelcontextprotocol/server-filesystem, ./docs]# 服务器工作目录cwd /path/to/workdir# 传递环境变量env {NODE_ENV production}HTTP 类型服务器配置 HTTP MCP 服务器[mcp_servers.docs]# MCP HTTP 服务器端点url https://docs.example.com/mcp# 包含的 HTTP 头http_headers {Authorization Bearer token}MCP 工具配置限制可用工具你可以限制 MCP 服务器暴露的工具工具白名单/黑名单[mcp_servers.filesystem]# 允许的工具列表enabled_tools [read_file, write_file, list_directory]# 拒绝的工具列表在 enabled_tools 之后应用disabled_tools [delete_file]使用工具限制可以提高安全性只暴露你需要的工具。超时配置配置超时[mcp_servers.slow_server]command pythonargs [-m, slow_server]# 启动超时秒默认 10startup_timeout_sec 30# 每个工具调用超时秒默认 60tool_timeout_sec 120MCP 认证配置OAuth 配置配置 OAuth[mcp_servers.protected]url https://api.example.com/mcp# 请求的 OAuth 范围scopes [read, write]# OAuth 资源参数oauth_resource codex-integration# Bearer token 环境变量bearer_token_env_var EXAMPLE_API_TOKENHTTP 头配置配置 HTTP 头[mcp_servers.api]url https://api.example.com/mcp# 从环境变量填充 HTTP 头env_http_headers {X_API_KEY MY_API_KEY}# 静态 HTTP 头http_headers {X_Custom_Header value}OAuth 回调配置配置 OAuth 回调# 固定回调端口mcp_oauth_callback_port 8080# 自定义回调 URLmcp_oauth_callback_url https://my-devbox.example.com/callback# 凭证存储位置mcp_oauth_credentials_store keyring # file | keyring | autoMCP 工具权限你可以为每个 MCP 服务器的工具单独设置权限配置工具权限[mcp_servers.docs.tools.search]# 权限模式ask | approve | denyapproval_mode approve权限模式说明ask每次执行前询问默认approve自动批准deny自动拒绝配置工具权限时要小心确保只授予你信任的工具自动批准权限。常用 MCP 服务器文件系统服务器文件系统 MCP[mcp_servers.filesystem]command npxargs [-y, modelcontextprotocol/server-filesystem, ./docs]GitHub 服务器GitHub MCP[mcp_servers.github]command npxargs [-y, modelcontextprotocol/server-github]env {GITHUB_PERSONAL_ACCESS_TOKEN your-token-here}PostgreSQL 服务器PostgreSQL MCP[mcp_servers.postgres]command npxargs [-y, modelcontextprotocol/server-postgres, postgresql://user:passlocalhost/db]常用 MCP 服务器你可以通过 npm 安装更多 MCP 服务器# 搜索 MCP 服务器 npm search modelcontextprotocol/server # 安装 MCP 服务器 npm install -g modelcontextprotocol/server-filesystemOpenAI 官方提供了多种 MCP 服务器查看 GitHub 仓库 获取完整列表。故障排除服务器启动失败检查以下内容命令和参数是否正确是否已安装必要的依赖环境变量是否设置正确工具调用超时增加超时时间tool_timeout_sec 120认证问题确保 OAuth 回调端口未被占用凭证存储配置正确。使用codex --verbose可以查看详细的 MCP 调试信息。常见问题Q: MCP 服务器无法启动检查命令是否正确安装尝试手动运行命令确认没有错误。Q: 工具权限在哪里配置在配置文件的mcp_servers.id.tools.tool部分配置。Q: 如何禁用某个 MCP 服务器在配置中添加enabled false或直接删除配置。Q: 支持多少个 MCP 服务器❤️❤️❤️本人水平有限如有纰漏欢迎各位大佬评论批评指正如果觉得这篇文对你有帮助的话也请给个点赞、收藏下吧非常感谢! Stay Hungry Stay Foolish 道阻且长,行则将至,让我们一起加油吧