配置 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。