---
title: "配置 Postman MCP 的工具范围与认证"
summary: "默认工具入口为 /minimal，完整工具入口为 /mcp。US 支持 OAuth，EU 使用 API key；本地 stdio 连接单独配置。"
category: mcp
level: starter
surfaces: [cli, app, ide]
tags: ["MCP", "Postman", "OAuth", "stdio"]
canonical: /tips/postman-codex-mcp/
---

# 配置 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 主路径：

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

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

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

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

```bash
codex mcp add postman --url https://mcp.eu.postman.com/minimal --bearer-token-env-var POSTMAN_API_KEY
```

```toml
[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 的进程里：

```toml
[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`。

## 来源

- [Postman · Remote MCP](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-remote-server)
- [Postman · Local MCP](https://learning.postman.com/docs/reference/postman-api/postman-mcp-server/postman-mcp-local-server)
- [postmanlabs/postman-mcp-server](https://github.com/postmanlabs/postman-mcp-server)