关于 Postman MCP Server
Postman MCP Server 将 AI Agent 和编码助手连接到 Postman 工作区、集合、规范及环境。它提供 Minimal、Code、Full 和 Learn 工具配置，并支持远程 OAuth 与本地 API 密钥认证。
主要功能
- 01访问 Postman 工作区与集合
- 02管理规范与环境
- 03根据 API 定义生成客户端代码
- 04搜索 Postman Docs 获取指南
- 05提供 Minimal、Code、Full 和 Learn 配置
适用场景
- 01使用 Postman 集合测试 API
- 02让代码与集合及规范保持同步
- 03创建和管理工作区与环境
- 04根据 API 定义生成客户端代码
MCP 相关
该服务通过远程或本地连接向 MCP 客户端提供 Postman 平台能力。远程服务支持 OAuth；本地及 EU 服务使用 Postman API 密钥认证。
配置
远程服务无需本地安装。选择你使用的客户端，复制配置或使用一键安装。
https://mcp.postman.com/mcpclaude mcp add --transport http com-postman-postman https://mcp.postman.com/mcp{"mcpServers":{"com-postman-postman":{"type":"http","url":"https://mcp.postman.com/mcp"}}}在 Cursor 中打开{"servers":{"com-postman-postman":{"type":"http","url":"https://mcp.postman.com/mcp"}}}在 VS Code 中打开{"mcpServers":{"com-postman-postman":{"type":"http","url":"https://mcp.postman.com/mcp"}}}{"mcpServers":{"com-postman-postman":{"serverUrl":"https://mcp.postman.com/mcp"}}}命令在终端中运行；JSON 粘贴到对应客户端的 MCP 配置后重启。需要授权的服务会在首次连接时提示登录。
https://mcp.postman.com/mcp需要授权https://mcp.postman.com/minimal需要授权https://mcp.eu.postman.com/mcp需要授权https://mcp.eu.postman.com/minimal需要授权工具
详细介绍
Postman MCP 服务
Postman MCP 服务 实现了 Model Context Protocol (MCP)，可将 AI Agent 和编码助手（包括 Claude Code、Cursor、VS Code Copilot、GitHub Copilot CLI 和 Gemini CLI）直接连接到你的 Postman 工作区、集合、规范和环境。
Postman 也提供此服务的 npm 软件包。
如需包含针对特定 Agent 的设置说明的完整安装指南，请参阅 Postman 的 MCP 服务产品页面。
Postman MCP 服务集合
Postman MCP 服务集合 是探索、测试和连接 Postman MCP 服务的最快方式。你可以用它来：
工具配置
- 精简 —（默认）仅包含 Postman 基本操作所需的核心工具。适合只想修改单个 Postman 元素（如集合、工作区或环境）的用户。
- 代码 — 包含用于根据公开和内部 API 定义生成高质量、结构清晰的客户端代码的工具。适合需要使用 API 或为 Agent 获取 API 上下文的用户。
- 完整 — 包含所有可用的 Postman API 工具（100 多个）。适合需要进行高级协作并使用 Postman Enterprise 功能的用户。
- 学习 — 搜索 Postman 文档，查找指南、教程和参考内容。适合需要了解 Postman 功能、查阅 API 概念或寻找学习资源的 Agent。
身份验证
为获得最佳开发体验并实现最快设置，请在远程服务（https://mcp.postman.com）上使用 OAuth。OAuth 完全符合 MCP 授权规范，无需手动配置 API 密钥。
欧盟远程服务和本地服务仅支持通过 Postman API 密钥进行身份验证。
快速入门
远程（任何兼容 OAuth 的 MCP 主机）：
将此 URL 添加到 MCP 主机的配置中：
https://mcp.postman.com/minimal
将 /minimal 改为 /code 或 /mcp，即可使用代码模式或完整模式。对于欧盟服务或 API 密钥身份验证，请将 Authorization: Bearer <POSTMAN_API_KEY> 作为标头传入。
本地：
npx @postman/postman-mcp-server
添加 --code 或 --full，即可使用代码模式或完整模式。将 POSTMAN_API_KEY 设为环境变量。
如需 IDE 专属的设置说明，请参阅下表。更多信息请参阅 Postman MCP 服务文档。
支持的 Agent 和 IDE
| Agent / IDE | 远程 | 本地 |
|---|---|---|
| Claude Code | 文档 | 文档 |
| Claude Desktop | 文档 | 文档 |
| Cursor | 文档 | 文档 |
| VS Code | 文档 | 文档 |
| Codex | 文档 | 文档 |
| Antigravity CLI | 文档 | 文档 |
| GitHub Copilot CLI | 文档 | 文档 |
| Kiro | 文档 | 文档 |
| Docker | — | 文档 |
欧盟支持
Postman MCP Server 支持远程和本地服务使用欧盟区域：
- 对于可流式传输的 HTTP，远程服务的地址为
https://mcp.eu.postman.com/mcp（Full）、https://mcp.eu.postman.com/code和https://mcp.eu.postman.com/minimal。 - 对于 STDIO 公共包，请使用
--region eu标志，或直接设置POSTMAN_API_BASE_URL环境变量。 - 欧盟服务不支持 OAuth。欧盟远程服务仅支持 API 密钥身份验证。
使用场景
- API 测试 — 使用 Postman 集合持续测试 API。使用本地服务测试本地 API，因为远程服务无法访问你的工作站网络。
- 代码同步 — 让代码与 Postman Collections 和规范保持同步。
- 集合管理 — 创建集合并添加标签、更新文档、添加评论，或跨多个集合执行操作，无需离开编辑器。
- 工作区和环境管理 — 创建工作区和环境，并管理环境变量。
- 自动创建规范 — 根据代码创建规范，并使用这些规范生成集合。
- 客户端代码生成 — 生成符合最佳实践和项目约定、可用于生产环境的客户端代码，以调用 API。
Docker
有关 Docker 设置和安装，请参阅 DOCKER.md。
贡献
欢迎提交错误报告、工具请求和文档修复 — 请参阅 CONTRIBUTING.md。
此处的 MCP 工具定义和服务实现均与 Postman 内部唯一可信来源保持同步，因此无法在本仓库中合并对 src/ 下文件的更改 — 但这些更改会通过问题反馈来实现，我们也会感谢最终发布的贡献。文档和仓库工具则可直接接受拉取请求。
发现安全问题？请参阅 SECURITY.md — 请不要公开提交问题。
问题与支持
- 请参阅将 MCP 请求添加到集合，了解如何使用 Postman 执行 MCP 请求。
- 访问 Postman Community，分享你的成果、提问并获取帮助。
- 你可以连接远程和本地服务，并使用 Postman MCP Server collection 对其进行测试。
- 在 GitHub Issues 中报告错误并请求工具。请参阅 SUPPORT.md，了解哪个渠道适合你的问题。
关键词
Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI
评论
一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。