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 서버
Postman MCP 서버는 Model Context Protocol (MCP)을 구현하여 AI 에이전트 및 코딩 어시스턴트(Claude Code, Cursor, VS Code Copilot, GitHub Copilot CLI, Gemini CLI 포함)를 Postman 워크스페이스, 컬렉션, 스펙, 환경에 직접 연결합니다.
Postman은 이 서버를 npm 패키지로도 제공합니다.
에이전트별 설정이 포함된 전체 설치 가이드는 Postman의 MCP 서버 제품 페이지를 참조하세요.
Postman MCP 서버 컬렉션
Postman MCP 서버 컬렉션은 Postman MCP 서버를 탐색, 테스트, 연결하는 가장 빠른 방법입니다. 다음 용도로 사용할 수 있습니다:
도구 구성
- Minimal — (기본값) 기본 Postman 작업에 필요한 필수 도구만 포함합니다. 컬렉션, 워크스페이스, 환경 등 단일 Postman 요소를 수정하려는 사용자에게 적합합니다.
- Code — 공개 및 내부 API 정의에서 고품질의 체계적인 클라이언트 코드를 생성하는 도구를 포함합니다. API를 사용하거나 에이전트에 API 컨텍스트를 제공해야 하는 사용자에게 적합합니다.
- Full — 사용 가능한 모든 Postman API 도구(100개 이상)를 포함합니다. 고급 협업 및 Postman의 엔터프라이즈 기능을 활용하는 사용자에게 적합합니다.
- Learn — Postman 문서에서 가이드, 튜토리얼, 참조 콘텐츠를 검색합니다. Postman 기능을 발견하거나, API 개념을 조회하거나, 학습 리소스를 찾아야 하는 에이전트에게 적합합니다.
인증
최상의 개발자 경험과 가장 빠른 설정을 위해 원격 서버에서 OAuth를 사용하세요 (https://mcp.postman.com). OAuth는 MCP 인증 사양을 완전히 준수하며 수동 API 키 구성이 필요하지 않습니다.
EU 원격 서버와 로컬 서버는 Postman API 키 인증만 지원합니다.
빠른 시작
원격 (OAuth 호환 MCP 호스트):
MCP 호스트 구성에 다음 URL을 추가하세요:
https://mcp.postman.com/minimal
Code 또는 Full 모드로 변경하려면 /minimal을 /code 또는 /mcp로 변경하세요. EU 또는 API 키 인증의 경우 Authorization: Bearer <POSTMAN_API_KEY>을 헤더로 전달하세요.
로컬:
npx @postman/postman-mcp-server
Code 또는 Full 모드로 변경하려면 --code 또는 --full을 추가하세요. POSTMAN_API_KEY을 환경 변수로 설정하세요.
IDE별 설정 지침은 다음 표를 참조하세요. 자세한 내용은 Postman MCP 서버 문서를 참조하세요.
지원되는 에이전트 및 IDE
| 에이전트 / IDE | 원격 | 로컬 |
|---|---|---|
| Claude Code | 문서 | 문서 |
| Claude Desktop | 문서 | 문서 |
| Cursor | 문서 | 문서 |
| VS Code | 문서 | 문서 |
| Codex | 문서 | 문서 |
| Antigravity CLI | 문서 | 문서 |
| GitHub Copilot CLI | 문서 | 문서 |
| Kiro | 문서 | 문서 |
| Docker | — | 문서 |
EU 지원
Postman MCP 서버는 원격 및 로컬 서버 모두에 대해 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 키 인증만 지원합니다.
사용 사례
- API 테스트 — Postman 컬렉션을 사용하여 API를 지속적으로 테스트합니다. 원격 서버는 워크스테이션에 네트워크로 접근할 수 없으므로 로컬 API를 테스트하려면 로컬 서버를 사용하세요.
- 코드 동기화 — Postman 컬렉션 및 스펙과 코드를 동기화 상태로 유지합니다.
- 컬렉션 관리 — 에디터를 벗어나지 않고 컬렉션을 생성 및 태그 지정하고, 문서를 업데이트하고, 댓글을 추가하거나 여러 컬렉션에 걸쳐 작업을 수행합니다.
- 워크스페이스 및 환경 관리 — 워크스페이스와 환경을 생성하고 환경 변수를 관리합니다.
- 자동 스펙 생성 — 코드에서 스펙을 생성하고 이를 사용하여 컬렉션을 생성합니다.
- 클라이언트 코드 생성 — 모범 사례와 프로젝트 규칙을 따르는 API를 사용하는 프로덕션 준비 클라이언트 코드를 생성합니다.
Docker
Docker 설정 및 설치에 대한 자세한 내용은 DOCKER.md를 참조하세요.
기여
버그 보고, 도구 요청, 문서 수정은 모두 환영합니다 — CONTRIBUTING.md를 참조하세요.
여기의 MCP 도구 정의와 서버 구현은 Postman의 내부 소스에서 동기화되므로 src/ 아래의 파일 변경은 이 저장소에서 병합할 수 없습니다. 그러나 이슈를 통해 변경이 이루어지며, 출시된 기여에 대해 크레딧을 제공합니다. 문서 및 저장소 도구는 풀 리퀘스트를 직접 수락합니다.
보안 문제를 발견하셨나요? SECURITY.md를 참조하세요 — 공개 이슈를 열지 마세요.
질문 및 지원
- MCP 요청을 컬렉션에 추가를 참조하여 Postman으로 MCP 요청을 수행하는 방법을 알아보세요.
- Postman 커뮤니티를 방문하여 만든 것을 공유하고, 질문하고, 도움을 받으세요.
- Postman MCP 서버 컬렉션을 사용하여 원격 및 로컬 서버 모두에 연결하고 테스트할 수 있습니다.
- GitHub 이슈에서 버그를 보고하고 도구를 요청하세요. 어떤 채널이 질문에 적합한지 SUPPORT.md를 참조하세요.
키워드
Model Context Protocol · MCP Server · Postman · AI Agents · Claude Code · Cursor · VS Code · Specifications · REST API · API Testing · TypeScript · OpenAPI