Postman API

chính thức

Một máy chủ MCP để tương tác với Postman API, yêu cầu một khóa API.

GitHub
317
Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với Postman API MCP?

  • Quản lý bộ sưu tập — Yêu cầu trợ lý của bạn tạo, gắn thẻ hoặc cập nhật các bộ sưu tập Postman và tài liệu của chúng trực tiếp từ trình soạn thảo của bạn.
  • Tạo mã client — Yêu cầu tạo mã client sẵn sàng cho sản xuất từ các định nghĩa API của bạn, tuân theo các phương pháp tốt nhất và quy ước dự án.
  • Tạo đặc tả từ mã — Nhờ trợ lý của bạn tạo đặc tả API từ cơ sở mã của bạn và chuyển chúng thành các bộ sưu tập Postman.
  • Quản lý môi trường — Hướng dẫn trợ lý của bạn tạo không gian làm việc và môi trường, đồng thời quản lý các biến môi trường mà không cần rời khỏi IDE của bạn.
  • Chạy kiểm thử API — Sử dụng máy chủ cục bộ để liên tục kiểm thử API của bạn với các bộ sưu tập Postman, bao gồm cả các điểm cuối cục bộ.

Máy chủ MCP được lưu trữ

npx add-mcp 'https://mcp.postman.com/minimal'

Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác

Tài liệu

Máy chủ MCP Postman

Máy chủ MCP Postman triển khai Giao thức Ngữ cảnh Mô hình (MCP) để kết nối các tác nhân AI và trợ lý lập trình — bao gồm Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI và Gemini CLI — trực tiếp đến các không gian làm việc, bộ sưu tập, đặc tả và môi trường Postman của bạn.

Postman cũng cung cấp máy chủ này dưới dạng gói npm.

Để xem hướng dẫn cài đặt đầy đủ với cấu hình riêng cho từng tác nhân, hãy xem trang sản phẩm Máy chủ MCP của Postman.

Bộ sưu tập Máy chủ MCP Postman

Bộ sưu tập Máy chủ MCP Postman là cách nhanh nhất để khám phá, kiểm thử và kết nối với Máy chủ MCP Postman. Sử dụng bộ sưu tập này để:

Cấu hình công cụ

  • Tối thiểu — (Mặc định) Chỉ bao gồm các công cụ thiết yếu cho các thao tác Postman cơ bản. Lý tưởng cho người dùng muốn sửa đổi một thành phần Postman duy nhất, chẳng hạn như bộ sưu tập, không gian làm việc hoặc môi trường.
  • Mã — Bao gồm các công cụ để tạo mã máy khách chất lượng cao, có tổ chức tốt từ các định nghĩa API công khai và nội bộ. Lý tưởng cho người dùng cần tiêu thụ API hoặc cung cấp ngữ cảnh API cho các tác nhân của họ.
  • Đầy đủ — Bao gồm tất cả các công cụ API Postman khả dụng (hơn 100 công cụ). Lý tưởng cho người dùng tham gia cộng tác nâng cao và các tính năng Doanh nghiệp của Postman.
  • Học tập — Tìm kiếm Tài liệu Postman để tìm hướng dẫn, bài viết và nội dung tham khảo. Lý tưởng cho các tác nhân cần khám phá các tính năng Postman, tra cứu khái niệm API hoặc tìm tài nguyên học tập.

Xác thực

Để có trải nghiệm nhà phát triển tốt nhất và thiết lập nhanh nhất, hãy sử dụng OAuth trên máy chủ từ xa (https://mcp.postman.com). OAuth tuân thủ đầy đủ đặc tả Ủy quyền MCP và không yêu cầu cấu hình khóa API thủ công.

Máy chủ từ xa EU và máy chủ cục bộ chỉ hỗ trợ xác thực bằng khóa API Postman.

Bắt đầu nhanh

Từ xa (bất kỳ máy chủ MCP nào tương thích OAuth):

Thêm URL này vào cấu hình máy chủ MCP của bạn:

https://mcp.postman.com/minimal

Thay đổi /minimal thành /code hoặc /mcp cho chế độ Mã hoặc Đầy đủ. Đối với xác thực EU hoặc khóa API, hãy truyền Authorization: Bearer <POSTMAN_API_KEY> dưới dạng tiêu đề.

Cục bộ:

npx @postman/postman-mcp-server

Thêm --code hoặc --full cho chế độ Mã hoặc Đầy đủ. Đặt POSTMAN_API_KEY làm biến môi trường.

Để biết hướng dẫn thiết lập riêng cho từng IDE, hãy xem bảng sau. Để biết thêm thông tin, hãy xem tài liệu Máy chủ MCP Postman.

Các tác nhân và IDE được hỗ trợ

Tác nhân / IDETừ xaCục bộ
Claude CodeTài liệuTài liệu
Claude DesktopTài liệuTài liệu
CursorTài liệuTài liệu
VS CodeTài liệuTài liệu
CodexTài liệuTài liệu
Antigravity CLITài liệuTài liệu
GitHub Copilot CLITài liệuTài liệu
KiroTài liệuTài liệu
Docker—Tài liệu

Hỗ trợ EU

Máy chủ MCP Postman hỗ trợ khu vực EU cho máy chủ từ xa và cục bộ:

  • Đối với HTTP có thể truyền phát, máy chủ từ xa khả dụng tại https://mcp.eu.postman.com/mcp (Đầy đủ), https://mcp.eu.postman.com/code và https://mcp.eu.postman.com/minimal.
  • Đối với gói công khai STDIO, hãy sử dụng cờ --region eu hoặc đặt trực tiếp biến môi trường POSTMAN_API_BASE_URL.
  • OAuth không được hỗ trợ cho máy chủ EU. Máy chủ từ xa EU chỉ hỗ trợ xác thực bằng khóa API.

Các trường hợp sử dụng

  • Kiểm thử API — Liên tục kiểm thử API của bạn bằng bộ sưu tập Postman. Sử dụng máy chủ cục bộ để kiểm thử API cục bộ, vì máy chủ từ xa sẽ không có quyền truy cập mạng vào máy trạm của bạn.
  • Đồng bộ mã — Giữ mã của bạn đồng bộ với Bộ sưu tập Postman và đặc tả của bạn.
  • Quản lý bộ sưu tập — Tạo và gắn thẻ bộ sưu tập, cập nhật tài liệu, thêm nhận xét hoặc thực hiện các thao tác trên nhiều bộ sưu tập mà không cần rời khỏi trình soạn thảo của bạn.
  • Quản lý không gian làm việc và môi trường — Tạo không gian làm việc và môi trường, đồng thời quản lý biến môi trường.
  • Tạo đặc tả tự động — Tạo đặc tả từ mã của bạn và sử dụng chúng để tạo bộ sưu tập.
  • Tạo mã máy khách — Tạo mã máy khách sẵn sàng cho sản xuất, tiêu thụ API theo các phương pháp hay nhất và quy ước dự án.

Docker

Để biết cách thiết lập và cài đặt Docker, hãy xem DOCKER.md.

Đóng góp

Báo cáo lỗi, yêu cầu công cụ và sửa tài liệu đều được hoan nghênh — xem CONTRIBUTING.md.

Các định nghĩa công cụ MCP và triển khai máy chủ tại đây được đồng bộ từ nguồn dữ liệu nội bộ của Postman, vì vậy các thay đổi đối với tệp trong src/ không thể được hợp nhất trong kho lưu trữ này — nhưng các vấn đề chính là cách những thay đổi đó được thực hiện, và chúng tôi ghi nhận các đóng góp được phát hành. Tài liệu và công cụ kho lưu trữ chấp nhận trực tiếp các yêu cầu kéo.

Phát hiện vấn đề bảo mật? Xem SECURITY.md — vui lòng không mở vấn đề công khai.

Câu hỏi và hỗ trợ

Từ khóa

Giao thức Ngữ cảnh Mô hình · Máy chủ MCP · Postman · Tác nhân AI · Claude Code · Cursor · VS Code · Đặc tả · REST API · Kiểm thử API · TypeScript · OpenAPI