用途:为使用 Postman MCP 工具的场景提供概念参考与工具选择建议,帮助在操作 Postman 时做出更合适的决策。
主要能力:解释 Postman 核心概念,包括 Collection(请求分组,主要工作单元,含请求、示例、测试与文档)、Environment(按 dev/staging/prod 等上下文划分的键值变量,用于切换 base URL、认证令牌与配置)、Workspace(集合、环境与规范的容器,可为个人、团队或公开)、Spec Hub(存储的 OpenAPI 或 AsyncAPI 定义,可生成集合并保持同步)、Request、Response、Folder、Tags、Monitor、Mock Server。
决策指南:将代码变更推送到 Postman 时,先在 Spec Hub 创建或更新规范再同步到集合;消费 Postman API 时读取集合并生成客户端代码;查找 API 用 searchPostmanElements 再深入细节;测试 API 用 runCollection 运行集合;为前端创建假 API 时从含示例的集合创建 mock server;编写文档时分析集合完整性、补齐缺口并可选发布;审计 API 安全时对规范或集合运行安全检查;学习功能用法用 searchLearningCenter(Full 模式)。
MCP 工具选择:涵盖工作区操作(getWorkspaces、getWorkspace、createWorkspace)、集合 CRUD、请求与响应管理、文件夹管理、Spec Hub、同步(generateCollection、syncCollectionWithSpec、syncSpecWithCollection)、环境、Mock、测试(runCollection)、文档发布、搜索(searchPostmanElements、getTaggedEntities)、Learning Center(searchLearningCenter,仅 Full 模式)以及 getAuthenticatedUser。
限制:已知限制与变通方案见该技能文件夹中的 mcp-limitations.md;资料未提供具体限制内容、收费、价格与平台信息。