@nhnpayco-dev/mcp-devcenter 1.0.1 → 1.0.2

package/README.md

@@ -1,5 +1,9 @@
 # @nhnpayco-dev/mcp-devcenter
 
+[![npm version](https://img.shields.io/npm/v/@nhnpayco-dev/mcp-devcenter.svg)](https://www.npmjs.com/package/@nhnpayco-dev/mcp-devcenter)
+![license](https://img.shields.io/npm/l/@nhnpayco-dev/mcp-devcenter.svg)
+[![node](https://img.shields.io/node/v/@nhnpayco-dev/mcp-devcenter.svg)](https://nodejs.org)
+
 > PAYCO 개발자센터 가이드(온라인결제·자동결제·오프라인결제·오더클라우드·멤버십클라우드·결제정산대사)를
 > AI 에디터(Claude·Cursor·VS Code 등)에서 바로 조회·검색할 수 있게 해주는
 > MCP(Model Context Protocol) 서버.
@@ -7,12 +11,12 @@
 외부 가맹점/제휴사 개발자가 PAYCO 결제 연동을 진행할 때, 가이드 페이지를 일일이 뒤지지 않고
 AI 에디터에 자연어로 물어 즉시 정확한 답을 받을 수 있게 해줍니다.
 
-```
-"PAYCO 자동결제 빌링키 발급부터 결제까지 흐름 알려줘"
-"결제 승인 API 에 필수로 보내야 하는 파라미터가 뭐야?"
-"에러코드 4802 무슨 뜻이야?"
-"BC카드 코드값은 PAYCO 에서 어떻게 표기해?"
-```
+AI 에디터에 이렇게 물어보면 됩니다.
+
+- "PAYCO 자동결제 빌링키 발급부터 결제까지 흐름 알려줘"
+- "결제 승인 API 에 필수로 보내야 하는 파라미터가 뭐야?"
+- "에러코드 4802 무슨 뜻이야?"
+- "BC카드 코드값은 PAYCO 에서 어떻게 표기해?"
 
 ---
 
@@ -96,57 +100,90 @@ AI 에디터에 자연어로 물어 즉시 정확한 답을 받을 수 있게
 | `export_validation_excel(path?, clearAfter?)` | 누적된 검수 결과를 xlsx로 추출. **3개 시트**: 검수요약 / 항목별 상세 / 공통검수체크리스트 |
 | `clear_validation_buffer()` | 누적된 검수 결과를 모두 초기화 (새 세션 시작 시) |
 
-**검증 도구 사용 예시 (외부 제휴사 시점):**
+### 검증 도구 사용 예시 (외부 제휴사 시점)
+
+**① 페이로드를 붙여넣고 검수를 요청합니다.**
+
+> 이 페이로드 검수해줘. API는 `online-easypay-01`.
 
+```json
+{
+  "sellerKey": "S0FSJE",
+  "sellerOrderReferenceKey": "ORD-001",
+  "totalPaymentAmt": "15000",
+  "orderMethod": "EASYPAY"
+}
 ```
-사용자> 이 페이로드 검수해줘. API는 online-easypay-01.
-        {"sellerKey":"S0FSJE", "sellerOrderReferenceKey":"ORD-001",
-         "totalPaymentAmt": "15000", "orderMethod":"EASYPAY", ...}
 
-→ # ✗ FAIL — online-easypay-01
-   [POST] /outseller/order/reserve  |  주문 예약 API로 결제창 호출하기
-   서비스: 온라인결제  |  자동실패 1개
+**② 검수 결과가 돌아옵니다.**
 
-   ## 검수 체크리스트 — 온라인결제 (22개)
-   ✓ 개인정보 파라미터 미포함 / ✓ orderMethod 유효값 / ⬜ PAYCO 방화벽 등록 / ...
+> **✗ FAIL — online-easypay-01**
+> `[POST] /outseller/order/reserve` · 주문 예약 API로 결제창 호출하기
+> 서비스: 온라인결제 · 자동실패 1개
+>
+> **검수 체크리스트 — 온라인결제 (22개)**
+> ✓ 개인정보 파라미터 미포함 · ✓ orderMethod 유효값 · ⬜ PAYCO 방화벽 등록 · …
+>
+> **API 명세 문제 (1개)**
+> ✗ `totalPaymentAmt` — 명세 `number` / 실제 `string`
 
-   ## API 명세 문제 (1개)
-   ✗ totalPaymentAmt: 명세 'number' / 실제 'string'
+**③ 엑셀로 추출합니다.**
 
-사용자> 엑셀로 추출해줘.
-→ ✅ ~/Downloads/payco-validation-20260522-180000.xlsx 생성 완료
-   - 시트: 검수요약 / 항목별 상세 / 공통검수체크리스트
-```
+> 엑셀로 추출해줘.
+
+> ✅ `~/Downloads/payco-validation-20260522-180000.xlsx` 생성 완료
+> 시트: 검수요약 / 항목별 상세 / 공통검수체크리스트
 
 ⚠️ **운영 로그(실제 카드번호·주민번호·고객 연락처 포함)는 그대로 붙여넣지 말 것.**
 테스트 환경 로그 또는 마스킹된 로그를 사용하세요. 본 MCP 서버는 입력을 검증만 하고 저장하지 않지만,
 검증 단계에서 Claude/Cursor 등 AI 측으로 텍스트가 전달됩니다.
 
-사용 가능한 카테고리 슬러그 (28개):
+### 사용 가능한 카테고리 슬러그 (28개)
 
-| Root | 카테고리 |
-|---|---|
-| **online** (온라인 결제) | `online-start`, `online-easypay`, `online-autopay`, `online-etc`, `online-extra`, `online-extradata` 🆕, `online-code`, `online-check`, `online-sample` |
-| **offline** (오프라인 결제) | `offline-start`, `offline-vcat`, `offline-api`, `offline-authapi` 🆕, `offline-code`, `offline-check`, `offline-sample` |
-| **order** (오더 클라우드) | `order-start`, `order-vorder`, `order-code`, `order-check`, `order-sample` |
-| **membership** (멤버십 클라우드) | `membership-start`, `membership-vmem`, `membership-api`, `membership-code`, `membership-check`, `membership-sample` |
-| **calculate** | `calculate` (결제/정산 대사) |
+**online** — 온라인 결제
+`online-start` · `online-easypay` · `online-autopay` · `online-etc` · `online-extra` ·
+`online-extradata` 🆕 · `online-code` · `online-check` · `online-sample`
+
+**offline** — 오프라인 결제
+`offline-start` · `offline-vcat` · `offline-api` · `offline-authapi` 🆕 ·
+`offline-code` · `offline-check` · `offline-sample`
+
+**order** — 오더 클라우드
+`order-start` · `order-vorder` · `order-code` · `order-check` · `order-sample`
 
-🆕 표시는 PAYCO 개발자센터에는 없는 사내 docx 기반 가이드입니다.
+**membership** — 멤버십 클라우드
+`membership-start` · `membership-vmem` · `membership-api` ·
+`membership-code` · `membership-check` · `membership-sample`
+
+**calculate** — 결제/정산 대사
+`calculate`
+
+🆕 표시는 PAYCO 개발자센터에는 없는 사내 문서 기반 가이드입니다.
 
 ### 자동 검증 가능한 API 슬러그 (35개)
 
-| 카테고리 | 슬러그 |
-|---|---|
-| 온라인 reserve/승인/취소 | `online-easypay-01`~`04`, `online-autopay-01`~`06`, `online-etc-01`/`03`/`04`, `online-extra-02`/`03` |
-| 온라인 reserve 변형 (합성) | `online-easypay-nonmember`(비회원결제), `online-easypay-checkout`(바로구매), `online-easypay-ordersheet`(주문서결제) |
-| 부가정보 스키마 | `online-extradata` (reserve API의 extraData JSON 내부 26개 필드) |
-| 오프라인 심플형 | `offline-api-02`~`05` |
-| 오프라인 인증승인형 🆕 | `offline-authapi-posauth`, `-auth`, `-approval`, `-cancel`, `-netcancel` |
-| 오프라인 VCAT (DLL) | `offline-vcat-setpaycodata`, `-getpaycodata` |
-| 오더 VORDER (DLL) | `order-vorder-setdata`, `-senddata` |
-| 멤버십 API | `membership-api-05` |
-| 멤버십 VMEM (DLL) | `membership-vmem-execasyncapproval`, `-execcomplete`, `-execcancel` |
+**온라인 — reserve / 승인 / 취소**
+`online-easypay-01`~`04` · `online-autopay-01`~`06` ·
+`online-etc-01`/`03`/`04` · `online-extra-02`/`03`
+
+**온라인 — reserve 변형 (합성)**
+`online-easypay-nonmember` (비회원결제) · `online-easypay-checkout` (바로구매) ·
+`online-easypay-ordersheet` (주문서결제)
+
+**부가정보 스키마**
+`online-extradata` — reserve API 의 extraData JSON 내부 26개 필드
+
+**오프라인**
+심플형 `offline-api-02`~`05`
+인증승인형 🆕 `offline-authapi-posauth` · `-auth` · `-approval` · `-cancel` · `-netcancel`
+VCAT (DLL) `offline-vcat-setpaycodata` · `-getpaycodata`
+
+**오더**
+VORDER (DLL) `order-vorder-setdata` · `-senddata`
+
+**멤버십**
+API `membership-api-05`
+VMEM (DLL) `membership-vmem-execasyncapproval` · `-execcomplete` · `-execcancel`
 
 ---
 
@@ -154,9 +191,9 @@ AI 에디터에 자연어로 물어 즉시 정확한 답을 받을 수 있게
 
 본 패키지에 포함된 가이드 정보:
 - [PAYCO 개발자센터](https://devcenter.payco.com)의 **연동하기 > 온라인/오프라인/오더/멤버십** 전 섹션 + **결제/정산 대사**
-- 사내 docx 기반 가이드 2종: 오프라인 POS **인증승인형 연동 가이드**, **부가정보(extraData) 명세**
+- 사내 문서 기반 가이드 2종: 오프라인 POS **인증승인형 연동 가이드**, **부가정보(extraData) 명세**
 
-- 가이드 본문 카테고리: **28개** (devcenter 크롤 26개 + 사내 docx 2개)
+- 가이드 본문 카테고리: **28개** (devcenter 크롤 26개 + 사내 문서 2개)
 - 에러코드/코드값 표 항목: **500+ 개** (4개 root 의 API 응답코드, 결제수단, 카드사, 은행, VAN사, 결제수단 코드 등 통합)
 - 자동 검증 가능한 API 명세: **35개**
   - REST API 27개 (easypay/autopay/etc/extra/offline-api/authapi 등)
@@ -179,19 +216,19 @@ AI 에디터에 자연어로 물어 즉시 정확한 답을 받을 수 있게
 PAYCO 개발자센터가 갱신될 경우 본 패키지도 주기적으로 재배포됩니다.
 항상 최신을 받으려면 설정에서 `@latest` 태그를 유지하세요.
 
-특정 시점에 고정하고 싶다면 `@0.0.1` 같이 버전을 명시할 수 있습니다.
+특정 시점에 고정하고 싶다면 `@1.0.1` 같이 버전을 명시할 수 있습니다.
 
 ---
 
 ## 문의 / 이슈
 
 - PAYCO 가이드 자체 문의: <dl_payco_ts@nhn.com>
-- 본 MCP 서버 동작 문의: (TBD — 사내 협의 후 공식 채널 안내 예정)
+- 본 MCP 서버 동작 문의: <dl_payco_ts@nhn.com>
 
 ---
 
 ## 라이선스 / 출처
 
+- 라이선스: **MIT** (패키지에 포함된 `LICENSE` 파일 참조)
 - 가이드 본문 원본 저작권: NHN PAYCO Corp.
 - 패키지 형태로 가공·배포: PAYCO 개발팀
-- 라이선스: TBD (사내 협의 진행 중)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhnpayco-dev/mcp-devcenter",
-  "version": "1.0.1",
+  "version": "1.0.2",
   "description": "PAYCO 개발자센터 가이드 전체(온라인·오프라인·오더·멤버십·결제정산) 를 AI 에디터에서 바로 조회·검색할 수 있게 해주는 MCP 서버 (PAYCO Developer Center integration guide MCP server for Claude, Cursor and AI agents)",
   "type": "module",
   "bin": {