Codex 怎么安装 MCP？

你真的需要安装 MCP 吗？

如果只是普通网页开发，先看看 Codex 网页开发最小配置 再决定。先把项目环境、AGENTS.md 和测试做好，0 个插件也可以开始。

MCP 到底是什么？

MCP 可以理解成“AI 的万能插座”。它让 Codex 有机会连接开发文档、GitHub、浏览器、数据库和项目管理工具。

你不必先记住所有专业定义。先知道：它是让 Codex 使用外部工具的一种连接方式，不是必须装上的“总软件”。

完整看懂 MCP →

Codex 中的 MCP 是怎么工作的？

Codex 作为 Agent，负责理解任务、决定什么时候需要工具。MCP Server 负责提供具体能力。

安装 MCP 不等于把另一个 AI 模型装进 Codex。它更像增加一个外部工具接口；能做什么，仍取决于服务器提供的能力和你授予的权限。

来源：Codex MCP 官方说明。

安装前先检查这三件事

codex --version

方法一：用 codex mcp add

对大多数初次配置的用户，先从 CLI 添加一个服务器比较容易理解。本地 stdio 启动的基本格式：

codex mcp add <server-name> -- <server-command>

如果服务器需要环境变量，官方格式为：

codex mcp add <server-name> --env VAR1=VALUE1 --env VAR2=VALUE2 -- <stdio-server-command>

• server-name：你给这个 MCP 起的名字，用来 list、get 或 remove。
• --env：传入环境变量（Environment Variable），可以理解为交给程序的配置值；只有服务器要求时才需要。
• --：分界线，告诉 Codex 后面是 MCP Server 自己的启动命令。
• stdio-server-command：真正启动服务器的命令。

stdio 是 Codex 与本地服务器通过标准输入、输出交换信息的一种常见方式。上面的尖括号内容是待替换的占位符，不要连同尖括号原样执行。

来源：官方 CLI 配置格式。

官方示例：Context7

Codex 官方文档使用这个示例：

codex mcp add context7 -- npx -y @upstash/context7-mcp

然后查看：

codex mcp list

来源：Codex 官方 Context7 示例。

再看一个真实例子：Playwright MCP

Playwright 官方 README 提供的 Codex 示例：

codex mcp add playwright npx "@playwright/mcp@latest"

添加后查看：

codex mcp list

这里保留 Playwright 官方示例原文；前一节带 -- 的写法仍是通用 stdio 语法。

来源：Playwright MCP 官方 README。

我已经装了哪些 MCP？

codex mcp list

它用于查看当前已经配置的 MCP Servers。想看当前 Codex 支持的全部 MCP 子命令：

codex mcp --help

页面不预填命令输出，你看到的内容应来自自己的实际配置与版本。

查看单个 MCP

codex mcp get <server-name>

例如：

codex mcp get playwright

用它检查单个已配置 MCP 的信息。不同版本的返回字段可能变化，不必对照网上截图逐字匹配。

来源：Codex CLI MCP 子命令实现。

如果 MCP 需要网页登录怎么办？

OAuth 可以简单理解成：不把密码直接交给 Codex，而是去对应网站确认授权。

对于已经添加、并且支持 OAuth 的 MCP Server：

codex mcp login <server-name>

例如，配置好 Linear 服务器后：

codex mcp login linear

某些远程 MCP 会打开浏览器，让你登录对应服务并授权。先看清网站域名和申请权限，再决定是否同意。 不是所有 MCP 都需要 login，也不是填写了一个名字就能凭空登录服务。

来源：官方 OAuth 登录说明。

MCP 不一定运行在你电脑上

本地 MCP：Codex 启动一个本地命令，例如通过 npx、python 或 docker 运行服务器。

远程 MCP：Codex 连接一个网络地址。当前 CLI 支持 --url，例如：

codex mcp add linear --url https://mcp.linear.app/mcp

对于支持 OAuth 的远程服务器，需要时再执行：

codex mcp login linear

来源：官方支持的 MCP 类型与 CLI 的 URL 参数实现。

方法二：直接修改 config.toml

想手动维护配置时，Codex 用户级文件默认位于：

~/.codex/config.toml

也支持项目级：

.codex/config.toml

项目级配置只有在项目被信任时才会加载。 CLI 与 IDE 扩展共享 Codex 配置层。ChatGPT 网页版不会读取这个本地文件。

修改前先备份原文件，只编辑目标 MCP 条目，保留其他配置。本站不会读取、上传或替你改写 config.toml。

来源：Codex configuration basics。

本地 stdio 配置示例

[mcp_servers.example]
command = "npx"
args = ["-y", "example-mcp-server"]

Codex 使用 mcp_servers，不是很多 JSON 客户端里的 mcpServers。TOML 和 JSON 不是同一种格式：不要把整段 JSON 直接粘进 TOML 文件。

带环境变量的示例

[mcp_servers.example]
command = "example-server"
args = ["--port", "4000"]
env = { "API_KEY" = "YOUR_KEY" }

两个 TOML 块是各自独立的示例，不要在同一个文件里重复定义同名 [mcp_servers.example] 表。

来源：官方 stdio 配置字段。

MCP 应该装全局，还是只给一个项目用？

• 用户级 ~/.codex/config.toml：适合多个项目都会使用的配置。
• 项目级 .codex/config.toml：适合只希望某个可信项目使用的配置。

本站建议：能限制范围时，就不要无脑全局添加。 这是编辑建议，不是 Codex 的强制要求。

两层配置有优先级，不是互相完全隔离的安装目录。不要以为进入了项目目录，就会自动把所有 MCP 添加命令变成项目级设置；需要项目范围时，按官方配置层说明检查。

来源：配置范围与优先级。

怎么知道 MCP 真的连上了？

codex mcp list

配置存在 ≠ 一定能正常调用

list 能看到服务器，不代表所有 Tool 都可用。还可能有 Server 启动失败、Runtime 不存在、OAuth 未登录、环境变量缺失、网络或版本兼容问题。

配置后做一个真实但低风险的小任务。 本文不提供“100% 安装成功”的承诺，也没有替你实测 MCP。

不想用了，怎么删除？

会装，也要会删。

codex mcp remove <server-name>

例如：

codex mcp remove playwright

然后再检查：

codex mcp list

通常 remove 是移除 Codex 中的 MCP 配置，不等于删除第三方软件账号或清空其数据。不要据此推断第三方服务的数据处理方式。

如果仍看到同名条目，先核对是否有其他配置层，不要删除整个 .codex 目录。

来源：Codex MCP remove 实现。

不要一次装十几个 MCP

Codex 官方最佳实践建议：工具要解决真实工作流问题，先从 1–2 个确实能减少重复劳动的工具开始，再按需要增加。

这也符合本站的选择原则。别看到“20 个 Codex 必装 MCP”就全部接入：

• 配置更多，出错时更难定位。
• 工具功能可能重复，很多最后根本不用。
• Context 可能增加，也会影响 Token 的使用；具体取决于工具和客户端，不能套一个固定数字。
• 授权范围随连接的外部工具扩大，需要多一份判断和维护。

能不用的，不装。 真正需要的时候，再加。

MCP 安装失败：先检查这 6 项

Windows 用户先注意这些

PowerShell、cmd 和其他 Shell 的命令解析可能不同。按你当前使用的终端排查：

• npx / Node 等所需程序是否在 PATH 中。
• 官方 MCP 启动命令能否在当前终端执行。
• 路径里的空格或特殊字符是否被第三方 Server 正确处理。
• 使用的是不是同一套运行环境。

这些是排查方向，不是“Windows 上所有 MCP 都有问题”的结论。本文不提供没有具体依据的 Windows 通用修复命令，也不建议关闭安全检查。

这几种做法不建议

看见热门就全部安装

先确定用途，再决定是否接入。

把陌生 API Key 直接交给不可信 Server

先核实来源与权限。能添加，不代表值得信任。

配置坏了就疯狂重复安装

先 list / get 查清现状；确定不需要或需要重新配置时，再 remove 并核对配置。不要一边报错，一边不断增加同类条目。

把 MCP 当成“能力越多越好”

工具越多，不一定工作越好。你要的是更顺畅的任务流程，不是更长的工具名单。

30秒安装流程

常见问题

Codex 支持 MCP 吗？

支持。Codex CLI 提供 MCP Server 配置和管理命令，可连接本地 stdio 或支持的远程服务器。

Codex Desktop / IDE 和 CLI 的 MCP 配置一样吗？

本篇主要讲本地 CLI 与 IDE：它们共享 Codex 配置层。官方 MCP 文档也说明，同一 Codex 主机上的桌面应用可共享这一配置；远程主机不要假设是同一份文件。

ChatGPT 网页版不会读取本地 Codex config.toml。 不要把网页版插件设置和本机文件混为一谈。

MCP 配置文件在哪？

用户级是 ~/.codex/config.toml，项目级是 .codex/config.toml；项目级只在可信项目加载。

我需要安装多少个 MCP？

没有固定数量。本站建议先从 1–2 个明确有用的开始，真正需要时再加。

删除 MCP 会删除原来的软件账号吗？

通常 codex mcp remove 只是移除 Codex 中的配置。它不是删除第三方账号的指令；第三方数据、授权与账号规则要另看该服务说明。

MCP 和 Plugin 是一回事吗？

不是完全一回事。MCP 描述工具连接方式，Plugin 可以是打包多种能力的扩展形式。先看 MCP 是什么？，不要只凭名字判断安装方式。

相关正式内容

• MCP 是什么？
• CLI 是什么？
• API 是什么？
• Context 是什么？
• Playwright MCP 值得装吗？
• Playwright MCP vs CLI

这是安装教程，不是自动安装器。本站不读取你的配置、不收集密钥、不自动启动 MCP Server。