配置 Postman MCP 的工具范围与认证

默认工具入口为 /minimal,完整工具入口为 /mcp。US 支持 OAuth,EU 使用 API key;本地 stdio 连接单独配置。

Postman 给 Codex CLI 有专节。远程是 Streamable HTTP,不是 npx mcp-remote 包装。US 默认 OAuth,不必先造 API key。EU 远程只有 API key,没有 OAuth。

远程按工具面换路径,同一张 postman 表改 url,不要叠四张:

配置 US EU
Minimal(默认) https://mcp.postman.com/minimal https://mcp.eu.postman.com/minimal
Code https://mcp.postman.com/code https://mcp.eu.postman.com/code
Full https://mcp.postman.com/mcp https://mcp.eu.postman.com/mcp
Learn https://mcp.postman.com/learn https://mcp.eu.postman.com/learn

Full 是 /mcp不是光主机根,也不是 /minimal。Learn 查文档;Code 生成客户端代码。先走 Minimal,工具太多再换面。

US 主路径:

codex mcp add postman --url https://mcp.postman.com/minimal

若浏览器未打开,运行 codex mcp login postman。文档没强制写 login,现行 Codex 对 OAuth 远程仍常用这一步。

[mcp_servers.postman]
url = "https://mcp.postman.com/minimal"
enabled = true

US 无头 / CI 才加 API key。EU 远程必须走密钥,不要 mcp login

codex mcp add postman --url https://mcp.eu.postman.com/minimal --bearer-token-env-var POSTMAN_API_KEY
[mcp_servers.postman]
url = "https://mcp.eu.postman.com/minimal"
bearer_token_env_var = "POSTMAN_API_KEY"
enabled = true

变量必须在启动 Codex 的那个进程里。OAuth 与 Bearer token 请选择一种认证方式。API key 认证无需 OAuth 登录。通过环境变量提供 token。

当前连接无需设置 experimental_use_rmcp_client。现行 Codex 自带 Streamable HTTP;codex mcp add --url 不认得就升级 CLI,不要开实验开关。

本机是另一台 stdio,包名 @postman/postman-mcp-server不要和远程共用 postman 表,另起 postman-local。文档写成 codex mcp add postman --env POSTMAN_API_KEY= 再接密钥,不要抄——那会把字面量写进 env 表。改用 env_vars,密钥放在启动 Codex 的进程里:

[mcp_servers.postman-local]
command = "npx"
args = ["-y", "@postman/postman-mcp-server"]
env_vars = ["POSTMAN_API_KEY"]
enabled = true

本机工具面用旗标,不是 URL:默认 Minimal;Code 加 --code,Full 加 --full,Learn 加 --learn。EU 本机再加 --region eu,或设 POSTMAN_API_BASE_URL。启动横幅打到 stdout 会 Transport closed,可在 args 里加 --quiet

网页 Cloud 不读取 ~/.codex/config.toml。配置后重新打开会话。用 codex mcp get postman 看传输是 streamable_http,url 是 https://mcp.postman.com/minimal

来源