@nhnpayco-dev/mcp-devcenter 1.1.0 → 1.2.0

package/README.md

@@ -22,7 +22,7 @@ AI 개발 도구에 이렇게 물어보면 됩니다.
 
 ## 요구사항
 
-- **Node.js 20 LTS 이상** (`node --version` 으로 확인)
+- **Node.js 최신 LTS 버전** (`node --version` 으로 확인, [nodejs.org](https://nodejs.org/)에 표시된 최신 LTS 버전보다 낮으면 업데이트)
 - 지원 클라이언트: Claude Desktop · Cursor · VS Code(Continue 등) · Windsurf 등 **MCP 표준을 지원하는 AI 개발 도구**
 
 설치는 자동입니다(`npx` 가 알아서 받습니다). 별도 빌드·환경 설정 불필요.
@@ -94,7 +94,7 @@ AI 개발 도구에 이렇게 물어보면 됩니다.
 
 | 도구 이름 | 설명 |
 |---|---|
-| `list_validatable_apis()` | 자동 검증 가능한 API 슬러그 34개 목록 (URL·메서드·파라미터 수 포함) |
+| `list_validatable_apis()` | 자동 검증 가능한 API 슬러그 41개 목록 (URL·메서드·파라미터 수 포함) |
 | `get_checklist(service)` | 서비스별 사전 검수 체크리스트(자동 + 수동 항목). service: `online`/`offline`/`order`/`membership` |
 | `validate_payload(api, payload)` | API 요청 페이로드 JSON을 검증 — (1) 필수 누락 / 명세 외 파라미터 / 타입 불일치 + (2) 자동 체크리스트(개인정보(멤버십 제외)·URL 인코딩·공백·금액 합산·enum·날짜 형식·returnUrl) + (3) 수동 확인 항목 |
 | `export_validation_excel(path?, clearAfter?)` | 누적된 검수 결과를 xlsx로 추출. **3개 시트**: 검수요약 / 항목별 상세 / 공통검수체크리스트. 다운로드 폴더에만 저장하며(`path`는 파일 이름으로만 사용), 같은 이름이 있으면 덮어쓰지 않고 번호를 붙임 |
@@ -119,7 +119,7 @@ AI 개발 도구에 이렇게 물어보면 됩니다.
 
 > **✗ FAIL — online-easypay-01**
 > `[POST] /outseller/order/reserve` · 주문 예약 API로 결제창 호출하기
-> 서비스: 온라인결제 · 자동실패 1개
+> 서비스: 온라인결제 · 수정 필요 1개
 >
 > **검수 체크리스트 — 온라인결제 (22개)**
 > ✓ 개인정보 파라미터 미포함 · ✓ orderMethod 유효값 · ⬜ PAYCO 방화벽 등록 · …
@@ -160,7 +160,7 @@ AI 개발 도구에 이렇게 물어보면 됩니다.
 
 🆕 표시는 PAYCO 개발자센터에 게시되지 않은 가이드입니다.
 
-### 자동 검증 가능한 API 슬러그 (34개)
+### 자동 검증 가능한 API 슬러그 (41개)
 
 **온라인 — reserve / 승인 / 취소**
 `online-easypay-01`~`04` · `online-autopay-01`~`04`/`06` ·
@@ -183,7 +183,7 @@ VCAT (DLL) `offline-vcat-setpaycodata` · `-getpaycodata`
 VORDER (DLL) `order-vorder-setdata` · `-senddata`
 
 **멤버십**
-API `membership-api-05`
+API `membership-api-05-01`~`08` (POS 등록, 회원 조회, 사용가능 멤버십 조회, 쿠폰 사용 예약, 적립포인트 사용 예약, 주문승인, 주문완료, 주문취소)
 VMEM (DLL) `membership-vmem-execasyncapproval` · `-execcomplete` · `-execcancel`
 
 ---
@@ -196,15 +196,21 @@ VMEM (DLL) `membership-vmem-execasyncapproval` · `-execcomplete` · `-execcance
 
 - 가이드 본문 카테고리: **28개** (devcenter 크롤 26개 + 개발자센터 미게시 문서 2개)
 - 에러코드/코드값 표 항목: **500+ 개** (4개 root 의 API 응답코드, 결제수단, 카드사, 은행, VAN사, 결제수단 코드 등 통합)
-- 자동 검증 가능한 API 명세: **34개**
-  - REST API 24개 (easypay/autopay/etc/extra/offline-api/authapi 등)
+- 자동 검증 가능한 API 명세: **41개**
+  - REST API 31개 (easypay/autopay/etc/extra/offline-api/authapi 등)
   - DLL 함수 7개 (offline-vcat, order-vorder, membership-vmem)
   - 합성 변형 슬러그 3개 (`online-easypay-nonmember`/`-checkout`/`-ordersheet`)
 
 **검증 가이드 사항 (자동 검증 한계):**
 - 조건부 필수 파라미터 (예: `extraData.appUrl` — iOS App 호출 시에만 필수)는 단순 "필수"로 표시될 수 있음
 - `returnUrl` 등 URL 검사는 prefix(`http://`/`https://`)만 확인. URL 내부 공백·인코딩 오류는 감지 불가
-- 배열 안 객체의 필수값은 원소 하나라도 값이 있으면 통과로 처리. 원소별 누락(예: 두 번째 원소의 `id` 누락)은 검출하지 못함
+
+**검사 방식:**
+- `extraData`는 JSON 문자열로 보내야 하며, 문자열을 풀어 안쪽 항목(필수값, 날짜 형식)까지 검사함. 객체로 보내면 타입 오류로 표시
+- 배열은 원소마다 검사하고 위치를 표시함 (예: `orderProducts[1].productId`)
+- 하위 필수 항목은 상위 항목을 보냈을 때만 검사함 (예: `sign`을 보내지 않으면 `sign` 하위 항목은 검사하지 않음)
+- `sign` 하위 항목은 `vanCorpCode`에 해당하는 VAN사 항목만 필수로 검사함
+- 숫자 항목은 숫자 또는 숫자 형태의 문자열(예: `"67300"`)을 모두 허용함. 값이 `null`인 항목은 보내지 않은 것으로 봄
 
 **제외 범위:**
 - 보안사항 확인하기 (USERTrust 루트 인증서 설치 가이드)