用途:通过 Postman MCP Server 在编辑器内完成 API 全生命周期管理,涵盖工作区、集合、规范、环境、Mock 与监控等 111+ 工具。
主要能力:将 OpenAPI 规范同步为集合、生成类型化客户端代码、运行集合测试、创建 Mock 服务器、生成并发布 API 文档、执行 OWASP 安全审计,以及发现和搜索 API。
使用方式:先调用 getAuthenticatedUser 检查连接。若失败,在 https://postman.postman.co/settings/me/api-keys 生成以 PMAK- 开头的 API Key,设置环境变量 export POSTMAN_API_KEY=PMAK-your-key-here(可写入 ~/.zshrc 或 ~/.bashrc 持久化),再验证连接并列出工作区与集合数量。按用户意图路由到对应工作流参考文件(同步集合、生成客户端、发现 API、运行测试、创建 Mock、API 文档、安全审计),按需加载;多步请求可串联工作流。仅在单点更新或用户明确要求时直接使用 mcp__postman__* 工具。
适用场景:规范与集合同步、SDK 生成、API 测试、前端 Mock、文档发布与安全审计。
限制:部分功能可能需付费 Postman 计划,核心操作各计划可用;getWorkspaces/getCollection 全量模式可能返回 300KB+ 负载,存在异步 HTTP 202 轮询、计划受限的标签工具、仅聚合的 runCollection、仅公开的 searchPostmanElements 等已知行为;异步操作 30 秒无进展需提示用户检查 Postman 应用。错误处理涵盖未配置 MCP、401、网络超时、集合缺失或为空、无效规范与计划限制。