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를 탐색, 테스트하고 연결하는 가장 빠른 방법입니다. 이 컬렉션을 사용하여 다음 작업을 수행할 수 있습니다:
- 모든 구성에 걸쳐 사용 가능한 도구 목록을 찾아봅니다.
- 원격 서버에 연결하여 테스트합니다 — Full 및 Minimal.
- 로컬 서버에 연결하여 테스트합니다.
도구 구성
- Minimal — (기본값) 기본적인 Postman 작업을 위한 필수 도구만 포함합니다. 컬렉션, 워크스페이스 또는 환경과 같이 단일 Postman 요소를 수정하려는 사용자에게 이상적입니다.
- Code — 공개 및 내부 API 정의로부터 고품질의 잘 구성된 클라이언트 코드를 생성하는 도구를 포함합니다. API를 사용하거나 에이전트가 API 컨텍스트를 얻어야 하는 사용자에게 이상적입니다.
- Full — 사용 가능한 모든 Postman API 도구(100개 이상)를 포함합니다. 고급 협업 및 Postman의 Enterprise 기능에 참여하는 사용자에게 이상적입니다.
- Learn — Postman Docs에서 가이드, 튜토리얼 및 참고 콘텐츠를 검색합니다. Postman 기능을 발견하거나, API 개념을 조회하거나, 학습 리소스를 찾아야 하는 에이전트에게 이상적입니다.
인증 (Authentication)
최상의 개발자 경험과 가장 빠른 설정을 위해 원격 서버(https://mcp.postman.com)에서 OAuth를 사용하십시오. OAuth는 MCP Authorization specification을 완벽하게 준수하며 수동 API 키 설정이 필요 없습니다.
EU 원격 서버와 로컬 서버는 Postman API key 인증만 지원합니다.
빠른 시작 (Quick start)
원격 (Remote) (OAuth 호환 MCP 호스트):
MCP 호스트의 설정에 다음 URL을 추가하십시오:
minimal을 code 또는 mcp로 변경하여 Code 모드 또는 Full 모드를 사용합니다. EU 또는 API 키 인증의 경우, 헤더로 Authorization: Bearer <POSTMAN_API_KEY>를 전달하십시오.
로컬 (Local):
npx @postman/postman-mcp-server
Code 모드 또는 Full 모드를 위해 --code 또는 --full을 추가합니다. POSTMAN_API_KEY를 환경 변수로 설정하십시오.
IDE별 상세 설정 지침은 다음 표를 참조하십시오. 더 자세한 정보는 Postman MCP Server docs를 참조하십시오.
지원되는 에이전트 및 IDE (Supported agents and IDEs)
| Agent / IDE | Remote | Local |
|---|
| Claude Code | Docs | Docs |
| ... | | |
EU 지원
Postman MCP Server는 원격 및 로컬 서버에 대해 EU 리전을 지원합니다:
- 스트리밍 가능한 HTTP의 경우, 원격 서버는
https://mcp.eu.postman.com/mcp (Full), https://mcp.eu.postman.com/code, 그리고 https://mcp.eu.postman.com/minimal에서 사용할 수 있습니다.
- STDIO 공개 패키지의 경우,
--region eu 플래그를 사용하거나 POSTMAN_API_BASE_URL 환경 변수를 직접 설정하십시오.
- EU 서버에서는 OAuth가 지원되지 않습니다. EU 원격 서버는 API 키 인증만 지원합니다.
사용 사례 (Use cases)
- API 테스트 — Postman 컬렉션을 사용하여 API를 지속적으로 테스트할 수 있습니다. 로컬 서버를 사용하여 로컬 API를 테스트하십시오. 원격 서버는 워크스테이션에 대한 네트워크 액세스가 없기 때문입니다.
- 코드 동기화 (Code synchronization) — 코드를 Postman Collections 및 스펙과 동기화 상태로 유지합니다.
- 컬렉션 관리 (Collection management) — 에디터를 벗어나지 않고도 컬렉션을 생성하고 태그를 지정하며, 문서를 업데이트하고, 댓글을 추가하거나 여러 컬렉션에 걸쳐 작업을 수행할 수 있습니다.
- 워크스페이스 및 환경 관리 (Workspace and environment management) — 워크스페이스와 환경을 생성하고 환경 변수를 관리합니다.
- 자동 스펙 생성 (Automatic spec creation) — 코드에서 스펙을 생성하여 이를 사용하여 컬렉션을 생성합니다.
- 클라이언트 코드 생성 (Client code generation) — 모범 사례 및 프로젝트 규칙을 따르는 API를 소비하는, 배포 준비가 된 클라이언트 코드를 생성합니다.
Docker
Docker 설정 및 설치는 DOCKER.md를 참조하십시오.
기여 (Contributing)
버그 보고, 툴 요청, 문서 수정 등 모든 것이 환영됩니다. CONTRIBUTING.md를 확인하세요.
여기의 MCP 툴 정의와 서버 구현은 Postman의 내부 진실 공급원(internal source of truth)에서 동기화되므로, src/ 디렉토리 아래 파일에 대한 변경 사항은 이 리포지토리에서는 병합될 수 없습니다. 하지만 이슈를 통해 이러한 변경이 이루어지며, 우리는 배포되는 기여에 대해 크레딧을 부여합니다. 문서와 리포지토리 툴링은 풀 리퀘스트(pull request)를 직접 받습니다.
보안 문제를 발견했나요? SECURITY.md를 확인하세요. 공개 이슈는 열지 마세요.
질문 및 지원
키워드
Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI