Postman API リモートMCPを OpenAI Codex CLI にMCP接続する方法(設定手順)
Postman のリモートMCPサーバーを OpenAI Codex CLI に約1分でMCP接続。OAuth / 401 の問題は先に OAuth 2.1 デバッガーで確認できます。
🔒 Client-side only — never leaves your browser.
Or add to ~/.cursor/mcp.json:
{
"mcpServers": {
"postman": {
"url": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}claude mcp add --transport http postman https://mcp.postman.com/mcp
With credential header:
claude mcp add --transport http postman https://mcp.postman.com/mcp --header "Authorization: Bearer YOUR_API_KEY"
Or add to .vscode/mcp.json:
{
"servers": {
"postman": {
"type": "http",
"url": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}- Open Settings → Connectors (Integrations) → Add Custom Connector.
- Paste the endpoint URL:
https://mcp.postman.com/mcp - Provide your API key / Bearer token when prompted.
Bridge the remote endpoint into stdio with mcp-remote in claude_desktop_config.json:
{
"mcpServers": {
"postman": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.postman.com/mcp",
"--header",
"Authorization: Bearer YOUR_API_KEY"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"postman": {
"serverUrl": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add to ~/.kiro/settings/mcp.json (or .kiro/settings/mcp.json in your workspace), then reopen Kiro's Agent panel to pick up the server:
{
"mcpServers": {
"postman": {
"url": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add to ~/.codex/config.toml — Codex reads remote HTTP servers from [mcp_servers.*] tables:
[mcp_servers.postman] url = "https://mcp.postman.com/mcp" bearer_token_env_var = "POSTMAN_TOKEN"
Add to cline_mcp_settings.json (Cline → MCP Servers → Configure), or paste it via Cline's MCP marketplace file:
{
"mcpServers": {
"postman": {
"type": "streamableHttp",
"url": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}Add to ~/.gemini/settings.json under mcpServers — httpUrl for Streamable HTTP, url for legacy SSE:
{
"mcpServers": {
"postman": {
"httpUrl": "https://mcp.postman.com/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}接続手順
- TOML を編集 —
~/.codex/config.tomlに[mcp_servers.postman]とurl = "https://mcp.postman.com/mcp"を追記します。 - 資格情報を設定 —
bearer_token_env_var = "POSTMAN_TOKEN"を追加し、同名の環境変数にキーを export します。 - 検証 — オンライン Inspector に
https://mcp.postman.com/mcpを貼り付け、initialize と tools/list を実行して接続を確認します。
🧰 ツール一覧(16)
| Tool | Safety | Description | Parameters |
|---|---|---|---|
| getCollections ~29 tok | 🟢 Read | List Postman collections. | — |
| getCollection ~29 tok | 🟢 Read | Get a Postman collection. | — |
| createCollection ~30 tok | 🟠 Write | Create a Postman collection. | — |
| updateCollection ~30 tok | 🟠 Write | Update a collection (PUT). | — |
| patchCollection ~31 tok | 🟠 Write | Partially update a collection. | — |
| deleteCollection ~28 tok | 🔴 Destructive | Delete a collection. | — |
| createRequest ~30 tok | 🟠 Write | Add a request to a collection. | — |
| updateRequest ~31 tok | 🟠 Write | Update a request in a collection. | — |
| getEnvironments ~30 tok | 🟢 Read | List Postman environments. | — |
| getEnvironment ~28 tok | 🟢 Read | Get an environment. | — |
| createEnvironment ~29 tok | 🟠 Write | Create an environment. | — |
| getMocks ~26 tok | 🟢 Read | List mock servers. | — |
| createMock ~27 tok | 🟠 Write | Create a mock server. | — |
| getApis ~26 tok | 🟢 Read | List Postman APIs. | — |
| getWorkspaces ~29 tok | 🟢 Read | List Postman workspaces. | — |
| getWorkspace ~26 tok | 🟢 Read | Get a workspace. | — |