Postman API
官方一個用於與 Postman API 互動的 MCP 伺服器，需要 API 金鑰。
你可以用 Postman API MCP 做什麼？
- 管理集合 — 直接從您的編輯器要求助理建立、標記或更新 Postman 集合及其文件。
- 生成客戶端程式碼 — 從您的 API 定義中請求符合最佳實踐和專案慣例的生產就緒客戶端程式碼。
- 從程式碼建立規格 — 讓您的助理從您的程式碼庫生成 API 規格，並將其轉換為 Postman 集合。
- 管理環境 — 指示您的助理建立工作區和環境，並在無需離開 IDE 的情況下管理環境變數。
- 執行 API 測試 — 使用本機伺服器持續針對您的 Postman 集合測試您的 API，包括本機端點。
託管 MCP 伺服器
npx add-mcp 'https://mcp.postman.com/minimal'可安裝到 Claude Code、Codex、Cursor 等客戶端
文件
Postman MCP Server
Postman MCP Server 實作了 Model Context Protocol (MCP)，將 AI 代理與程式設計助手（包括 Claude Code、Cursor、VS Code Copilot、GitHub Copilot CLI 和 Gemini CLI）直接連接到您的 Postman 工作區、集合、規格和環境。
Postman 也以 npm 套件 的形式提供此伺服器。
如需包含代理程式特定設定的完整安裝指南，請參閱 Postman 的 MCP Server 產品頁面。
Postman MCP Server 集合
Postman MCP Server 集合 是探索、測試和連接到 Postman MCP Server 最快速的方式。您可以使用它來：
工具設定
- 精簡（Minimal） — （預設）僅包含基本 Postman 操作所需的基本工具。適合想要修改單一 Postman 元素（例如集合、工作區或環境）的使用者。
- 程式碼（Code） — 包含從公開和內部 API 定義產生高品質、組織良好的用戶端程式碼的工具。適合需要消費 API 或將 API 上下文提供給代理程式的使用者。
- 完整（Full） — 包含所有可用的 Postman API 工具（100+ 工具）。適合需要進階協作和 Postman 企業版功能的使用者。
- 學習（Learn） — 搜尋 Postman Docs 中的指南、教學課程和參考內容。適合需要探索 Postman 功能、查詢 API 概念或尋找學習資源的代理程式。
驗證
為了獲得最佳的開發者體驗和最快速的設定，請在遠端伺服器上使用 OAuth（https://mcp.postman.com）。OAuth 完全符合 MCP Authorization 規範，且不需要手動設定 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 Server 文件。
支援的代理程式和 IDE
| 代理程式 / IDE | 遠端 | 本機 |
|---|---|---|
| Claude Code | 文件 | 文件 |
| Claude Desktop | 文件 | 文件 |
| Cursor | 文件 | 文件 |
| VS Code | 文件 | 文件 |
| Codex | 文件 | 文件 |
| Antigravity CLI | 文件 | 文件 |
| GitHub Copilot CLI | 文件 | 文件 |
| Kiro | 文件 | 文件 |
| Docker | — | 文件 |
歐盟支援
Postman MCP Server 支援遠端和本機伺服器的歐盟區域：
- 對於 streamable HTTP，遠端伺服器可在
https://mcp.eu.postman.com/mcp（完整）、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/ 下檔案的變更無法在此
儲存庫中合併 — 但問題是這些變更的促成方式，我們會對已發布的
貢獻給予肯定。文件和儲存庫工具直接接受 pull request。
發現安全性問題？請參閱 SECURITY.md — 請勿開啟公開 問題。
問題與支援
- 參閱 將您的 MCP 請求新增到您的集合 以了解如何使用 Postman 執行 MCP 請求。
- 造訪 Postman Community 分享您建置的內容、提出問題並獲得協助。
- 您可以使用 Postman MCP Server 集合 連接到遠端和本機伺服器並進行測試。
- 在 GitHub Issues 中回報錯誤和請求工具。請參閱 SUPPORT.md 以了解哪個管道適合您的問題。
關鍵字
Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI