AgentSkillsCN

postman-knowledge

Postman 概念与 MCP 工具使用指南。在使用 Postman MCP 工具时加载此内容，助您更明智地选择工具并制定相应的解决方案。

SKILL.md
--- frontmatter
name: postman-knowledge
description: Postman concepts and MCP tool guidance. Loaded when working with Postman MCP tools to make better decisions about tool selection and workarounds.
user-invocable: false

Postman Knowledge

Reference for Postman concepts and MCP tool selection. Use this context when working with Postman MCP tools to make better decisions.

Core Concepts

  • •Collection: A group of API requests organized in folders. The primary unit of work in Postman. Contains requests, examples, tests, and documentation.
  • •Environment: Key-value pairs (variables) scoped to a context (dev, staging, prod). Used to swap base URLs, auth tokens, and config without changing requests.
  • •Workspace: Container for collections, environments, and specs. Can be personal, team, or public.
  • •Spec (Spec Hub): An OpenAPI or AsyncAPI definition stored in Postman. Can generate collections and stay synced.
  • •Request: A single API call definition (method, URL, headers, body, tests).
  • •Response: A saved example response for a request. Used by mock servers and documentation.
  • •Folder: A grouping within a collection, typically by resource (e.g., "Users", "Orders").
  • •Tags: Labels on collections for categorization and search.
  • •Monitor: A scheduled collection runner that checks API health.
  • •Mock Server: A fake API that serves example responses from a collection.

Decision Guide

GoalApproach
Push code changes to PostmanCreate/update spec in Spec Hub, then sync to collection
Consume a Postman APIRead collection + generate client code
Find an APISearch workspace collections, then drill into details
Test an APIRun collection with runCollection
Create a fake API for frontendCreate mock server from collection with examples
Document an APIAnalyze collection completeness, fill gaps, optionally publish
Audit API securityRun security checks against spec or collection

MCP Tool Selection

Workspace operations: getWorkspaces, getWorkspace, createWorkspace Collection CRUD: getCollections, getCollection, createCollection, putCollection, patchCollection, deleteCollection Request/Response: getCollectionRequest, createCollectionRequest, updateCollectionRequest, getCollectionResponse, createCollectionResponse, updateCollectionResponse Folder management: getCollectionFolder, createCollectionFolder, updateCollectionFolder Spec Hub: getAllSpecs, getSpec, createSpec, getSpecDefinition, updateSpecFile, getSpecFiles Sync: generateCollection, syncCollectionWithSpec, syncSpecWithCollection Environments: getEnvironments, getEnvironment, createEnvironment, putEnvironment Mocks: getMocks, getMock, createMock, publishMock, unpublishMock Tests: runCollection Docs: publishDocumentation, unpublishDocumentation Search: searchPostmanElements (public network only), getTaggedEntities User: getAuthenticatedUser

See mcp-limitations.md in this skill folder for known limitations and workarounds.