remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Provides access to the Postman API, enabling comprehensive management of Postman collections, environments, APIs, and other Postman resources, with features like CRUD operations for collections, folder management, request management, environment management, API management, schema support, and authentication capabilities
Postman MCP 서버
Postman API에 대한 액세스를 제공하는 MCP 서버입니다. 기능은 공식 OpenAPI 사양을 기반으로 합니다. 자세한 내용은 Postman API 문서를 참조하세요.
이 프로젝트는 Anthropic의 모델 컨텍스트 프로토콜(MCP) 이니셔티브의 일부입니다. 자세한 내용은 MCP GitHub 저장소 와 Anthropic 블로그 의 공지 사항을 참조하세요.
[!경고] 이 프로젝트는 현재 개발 중입니다. 주의해서 사용하시고 중대한 변경이 있을 수 있습니다.
[!NOTE] AI 생성 코드입니다. Claude 3.5 Sonnet(2024년 10월 22일)과 함께 Cline v2.2.2를 사용했습니다. 이 코드 생성 방법에 대한 자세한 내용과 프롬프트는 docs/README.md를 참조하세요.
개요
Postman MCP 서버는 Postman API와 통합된 TypeScript 기반 MCP 서버로, Postman 컬렉션, 환경 및 API에 대한 포괄적인 관리를 제공합니다.
특징
컬렉션
- CRUD 작업 : Postman 컬렉션을 생성, 검색, 업데이트 및 삭제합니다.
- 폴더 관리 : 컬렉션 내의 폴더로 요청을 구성합니다.
- 요청 관리 : 컬렉션 내에서 요청을 추가, 업데이트, 삭제합니다.
- 응답 관리 : 요청과 관련된 응답을 관리합니다.
- 버전 관리 : 컬렉션에 대한 변경 사항을 포크, 병합, 풀합니다.
- 댓글 : 컬렉션에 댓글을 추가하고 관리합니다.
환경
- 환경 관리 : 다양한 설정에 대한 환경을 만들고 검색합니다.
- CRUD 작업 : 환경 생성, 업데이트, 삭제에 대한 전체 지원.
아피스
- API 관리 : API를 생성, 검색, 업데이트, 삭제합니다.
- 스키마 지원 : 다중 파일 지원을 통해 API 스키마를 관리합니다.
- 태그 지정 : API에 대한 태그를 추가하고 관리합니다.
- 댓글 : API에 대한 댓글을 추가하고 관리합니다.
인증 및 권한 부여
- API 키 인증 : API 키를 사용하여 액세스를 보호합니다.
- 역할 기반 액세스 제어 : 작업 공간 및 컬렉션 수준에서 권한을 관리합니다.
- 작업 공간 권한 : 작업 공간에 대한 특정 권한을 정의합니다.
추가 기능
- 개인 API 네트워크 : 개인 API 네트워크 내의 요소와 폴더를 관리합니다.
- 웹후크 : 사용자 정의 페이로드로 컬렉션을 트리거하는 웹후크를 만듭니다.
- 엔터프라이즈 기능 : 엔터프라이즈 환경을 위한 고급 역할 제어 및 SCIM 지원.
설치
Smithery를 통해 설치
Smithery를 통해 Claude Desktop에 Postman MCP 서버를 자동으로 설치하려면:
지엑스피1
필수 조건
- Node.js가 설치되었습니다.
단계
- 저장소를 복제합니다.Copy
- 종속성 설치:Copy
- 서버를 빌드하세요:Copy
- 자동 재빌드를 사용하여 개발 모드에서 실행:Copy
용법
API 키 설정
- API 키 생성
- Postman 계정 설정 방문
- "API 키 생성"을 클릭하세요
- 키를 안전하게 보관하세요. 다시 표시되지 않습니다.
- API 키 구성
POSTMAN_API_KEY로 환경에 키를 추가합니다.- Claude Desktop 또는 Cline의 경우 구성 파일에 포함합니다(아래 구성 예시 참조).
- API 키를 버전 제어에 커밋하지 마십시오.
- 액세스 확인
- API 키는 권한이 있는 모든 Postman 리소스에 대한 액세스를 제공합니다.
- 간단한 쿼리(예: 작업 공간 나열)를 실행하여 액세스를 테스트합니다.
[!NOTE] Postman API 컬렉션을 직접 사용하는 경우 API 키를
postman-api-key컬렉션 변수로 저장합니다.
Claude Desktop 사용
Claude Desktop과 함께 사용하려면 서버 구성을 추가하세요.
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - 윈도우:
%APPDATA%/Claude/claude_desktop_config.json
[!중요] 이 공급자를 업데이트하는 경우, 입력 스키마에서 API 변경 사항을 적용하려면 Claude를 다시 시작해야 합니다(예: MCP 서버의 ToolDefinition 요소가 변경된 경우). Claude는 시작 시 도구 정의를 캐시하기 때문입니다.
구성 예
클라인 사용
동일한 예제 구성을 사용하여 Cline MCP 서버 구성에 서버 구성을 추가합니다.
구성 예
위의 클로드와 동일함.
Zed를 사용하여
아직 작동하도록 하려고 노력 중입니다. Zed 문서 를 보니 확장 기능이 필요한 것 같습니다( 이 문제 #21455도 마찬가지입니다 ).
선적 서류 비치
공식 Postman API 문서는 Postman Public Workspace 에서 확인할 수 있습니다.
프로젝트 개요
Postman API 참조 및 요약
이 프로젝트에서는 Claude 모델과 Cline 확장을 활용하여 OpenAPI 사양을 TypeScript 코드로 변환하고, MCP 서버 내에서 유형 안전성과 통합을 강화합니다.
이 GitHub 프로젝트에는 Postman 플랫폼을 프로그래밍 방식으로 활용하는 방법에 대한 자세한 지침을 제공하는 API 참조 문서가 포함되어 있습니다. 로컬 개발을 위한 Collection SDK와 클라우드 플랫폼 통합을 위한 Postman API를 모두 다룹니다. 주요 내용으로는 인증 메커니즘, 속도 제한, 그리고 작업 공간, 컬렉션, 환경, 모의 서버, 모니터 등 모든 API 엔드포인트에 대한 심층적인 설명이 포함됩니다. 또한, 원활한 API 상호작용을 위한 필수 구성 요소와 빠른 시작 지침을 제공합니다.
docs/api/summaries 디렉터리에는 Postman API에 대한 포괄적인 마크다운 요약이 포함되어 있습니다. 이 문서는 MCP 서버의 기능을 검증하고 보장하는 데 필수적인 API 엔드포인트, 요청/응답 형식 및 구현 세부 정보를 간략하게 설명합니다. 문서 구조 및 구현 전략에 대한 개요는 API 요약 README를 참조하십시오.
Claude를 사용하여 OpenAPI 사양을 TypeScript 코드로 변환
MCP 서버 구축
MCP 서버 핸들러 구현에 대한 자세한 사양은 핸들러 문서를 참조하세요. 여기에는 URI 형식, 프롬프트 요구 사항 및 리소스 처리 패턴이 포함됩니다. 이 가이드는 MCP 서버 내에서 Postman API 기능을 통합하고 개선하는 개발자에게 매우 중요합니다.
이론적 해석
Postman 도구용 MCP 래퍼는 구조와 안전성이 매우 중요한 복잡한 다단계 작업을 위한 AI 상호작용 계층으로 주로 적합합니다. 그러나 CLI 또는 API를 직접 사용하는 간단한 작업에는 과도하게 설계될 수 있습니다. MCP 래퍼는 다음과 같은 경우에 가장 큰 가치를 제공합니다.
- 복잡한 작업
- 여러 컬렉션 관리
- 환경 조정
- 포괄적인 보고서 생성
- AI 기반 자동화
- 자동화된 테스트 워크플로
- API 문서 유지 관리
- 환경 관리
- 오류에 민감한 작업
- 중요 API 테스트
- 프로덕션 배포
- 규정 준수 확인
다음의 경우 가치가 떨어집니다.
- 간단한 작업
- 기본 컬렉션 실행
- 단일 API 호출
- 빠른 환경 점검
- 직접 CLI 사용
- 개발자 중심 운영
- 로컬 테스트
- 빠른 반복
개발
종속성 설치:
서버를 빌드하세요:
자동 재빌드를 사용한 개발의 경우:
디버깅
MCP 서버는 stdio를 통해 통신하므로 디버깅이 어려울 수 있습니다. 패키지 스크립트로 제공되는 MCP Inspector를 사용하는 것이 좋습니다.
Inspector는 브라우저에서 디버깅 도구에 액세스할 수 있는 URL( http://localhost:5173) 을 제공합니다. 연결하기 전에 POSTMAN_API_KEY를 추가해야 합니다. 시작하려면 "도구"로 이동하세요.
다른 MCP 서버
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.