@nhnpayco-dev/mcp-devcenter 1.0.1 → 1.0.3

package/README.md

@@ -1,25 +1,29 @@
 # @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 등)에서 바로 조회·검색할 수 있게 해주는
+> AI 개발 도구(Claude·Cursor·VS Code 등)에서 바로 조회·검색할 수 있게 해주는
 > MCP(Model Context Protocol) 서버.
 
 외부 가맹점/제휴사 개발자가 PAYCO 결제 연동을 진행할 때, 가이드 페이지를 일일이 뒤지지 않고
-AI 에디터에 자연어로 물어 즉시 정확한 답을 받을 수 있게 해줍니다.
+AI 개발 도구에 자연어로 물어 즉시 정확한 답을 받을 수 있게 해줍니다.
 
-```
-"PAYCO 자동결제 빌링키 발급부터 결제까지 흐름 알려줘"
-"결제 승인 API 에 필수로 보내야 하는 파라미터가 뭐야?"
-"에러코드 4802 무슨 뜻이야?"
-"BC카드 코드값은 PAYCO 에서 어떻게 표기해?"
-```
+AI 개발 도구에 이렇게 물어보면 됩니다.
+
+- "PAYCO 자동결제 빌링키 발급부터 결제까지 흐름 알려줘"
+- "결제 승인 API 에 필수로 보내야 하는 파라미터가 뭐야?"
+- "에러코드 4802 무슨 뜻이야?"
+- "BC카드 코드값은 PAYCO 에서 어떻게 표기해?"
 
 ---
 
 ## 요구사항
 
 - **Node.js 20 LTS 이상** (`node --version` 으로 확인)
-- 지원 클라이언트: Claude Desktop · Cursor · VS Code(Continue 등) · Windsurf 등 **MCP 표준 호환 AI 에디터**
+- 지원 클라이언트: Claude Desktop · Cursor · VS Code(Continue 등) · Windsurf 등 **MCP 표준을 지원하는 AI 개발 도구**
 
 설치는 자동입니다(`npx` 가 알아서 받습니다). 별도 빌드·환경 설정 불필요.
 
@@ -83,7 +87,7 @@ AI 에디터에 자연어로 물어 즉시 정확한 답을 받을 수 있게
 | `get_guide(slug)` | 특정 카테고리 가이드 전체를 Markdown 으로 반환 |
 | `list_apis()` | 28개 카테고리 + 단계 목록 일람 |
 | `get_api_spec(category)` | 특정 카테고리(easypay, autopay …)의 API 명세·파라미터 표가 담긴 가이드 반환 |
-| `get_sample_code(slug, language?)` | 가이드 본문에서 코드 블록만 추출 (선택적으로 언어 필터링) |
+| `get_sample_code(slug, language?)` | 가이드 본문의 코드 블록(주로 요청·응답 JSON 예시)만 추출. 언어별 소스코드 샘플은 포함하지 않음 |
 | `get_error_code(code)` | API 응답코드·결제수단·은행·카드사 등 모든 코드 카테고리에서 일치 항목 조회 |
 
 ### 자동 검수 (5개)
@@ -96,57 +100,91 @@ 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`~`04`/`06` ·
+`online-etc-01`/`03`/`04` · `online-extra-02`/`03`
+(자동결제 ⑤ 결제 취소는 일반 결제 취소 API와 같아 `online-easypay-04`로 검증)
+
+**온라인 — 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,19 +192,19 @@ 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 등)
+  - REST API 25개 (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` 누락)은 검출하지 못함
 
 **제외 범위:**
 - 보안사항 확인하기 (USERTrust 루트 인증서 설치 가이드)
@@ -179,19 +217,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/dist/data/api-specs.json

@@ -1915,13 +1915,13 @@
           "name": "includePaymentMethodCodes",
           "required": false,
           "type": "List<String>",
-          "description": "가능한 [결제수단](http://wikin.nhnent.com/pages/viewpage.action?pageId=243370295) - includePaymentMethodCodes 중 가능한 결제수단 제공  : 동일한 결제수단이 excludePaymentMethodCodes 에도 포함된 경우 결제수단에서 제외 | 예: \"includePaymentMethodCodes\" : [\"31, \"01\"]"
+          "description": "가능한 결제수단(online-code 가이드의 「결제수단 코드」 참고) - includePaymentMethodCodes 중 가능한 결제수단 제공  : 동일한 결제수단이 excludePaymentMethodCodes 에도 포함된 경우 결제수단에서 제외 | 예: \"includePaymentMethodCodes\" : [\"31, \"01\"]"
         },
         {
           "name": "excludePaymentMethodCodes",
           "required": false,
           "type": "List<String>",
-          "description": "제외 할 [결제수단](http://wikin.nhnent.com/pages/viewpage.action?pageId=243370295) - 가능한 결제수단 중 excludePaymentMethodCodes 제외 | 예: \"excludePaymentMethodCodes\" : [\"31, \"01\"]"
+          "description": "제외 할 결제수단(online-code 가이드의 「결제수단 코드」 참고) - 가능한 결제수단 중 excludePaymentMethodCodes 제외 | 예: \"excludePaymentMethodCodes\" : [\"31, \"01\"]"
         },
         {
           "name": "paymentMethodOptions",
@@ -1981,7 +1981,7 @@
           "name": "paymentMethodOptions.paymentMethodCode",
           "required": true,
           "type": "String",
-          "description": "[결제수단](http://wikin.nhnent.com/pages/viewpage.action?pageId=243370295)코드 | 예: 예 : 신용카드 간편결제의 경우-> 31"
+          "description": "결제수단(online-code 가이드의 「결제수단 코드」 참고)코드 | 예: 예 : 신용카드 간편결제의 경우-> 31"
         },
         {
           "name": "paymentMethodOptions.message",
@@ -2095,6 +2095,12 @@
           "type": "string",
           "description": "사업자 등록번호, ‘-’ 문자 제거하여 전달"
         },
+        {
+          "name": "vanCorpCode",
+          "required": true,
+          "type": "string",
+          "description": "VAN사 코드"
+        },
         {
           "name": "vanPosTid",
           "required": true,
@@ -2147,8 +2153,8 @@
         }
       ],
       "param_counts": {
-        "request_total": 6,
-        "request_required": 3,
+        "request_total": 7,
+        "request_required": 4,
         "response_total": 4
       }
     },
@@ -2189,6 +2195,12 @@
           "type": "string",
           "description": "PAYCO POS 터미널 번호"
         },
+        {
+          "name": "vanCorpCode",
+          "required": true,
+          "type": "string",
+          "description": "VAN사 코드"
+        },
         {
           "name": "vanPosTid",
           "required": true,
@@ -2261,6 +2273,12 @@
           "type": "string",
           "description": "상품명. 예)아메리카노 외 1건"
         },
+        {
+          "name": "productInfoList",
+          "required": false,
+          "type": "list",
+          "description": "상품 목록"
+        },
         {
           "name": "installmentPeriod",
           "required": false,
@@ -2291,6 +2309,18 @@
           "type": "string",
           "description": "단말기 타입. 예) KIOSK, POS, CAT"
         },
+        {
+          "name": "extras",
+          "required": false,
+          "type": "object",
+          "description": "추가정보"
+        },
+        {
+          "name": "sign",
+          "required": true,
+          "type": "object",
+          "description": "van 사별 sign 정보(5만원 초과결제시 필수)"
+        },
         {
           "name": "productInfoList.productCode",
           "required": true,
@@ -2581,6 +2611,18 @@
           "type": "double",
           "description": "컵보증금"
         },
+        {
+          "name": "approvalResultList",
+          "required": false,
+          "type": "list",
+          "description": "결제 승인 시 결제수단별 정보"
+        },
+        {
+          "name": "extras",
+          "required": false,
+          "type": "object",
+          "description": "추가정보"
+        },
         {
           "name": "membershipCardNo",
           "required": false,
@@ -2599,6 +2641,12 @@
           "type": "string",
           "description": "주 오프라인 결제수단코드"
         },
+        {
+          "name": "approvalResultList.paymentMethodCode",
+          "required": false,
+          "type": "string",
+          "description": "오프라인 결제수단코드"
+        },
         {
           "name": "approvalResultList.paymentMethodName",
           "required": false,
@@ -2623,6 +2671,12 @@
           "type": "double",
           "description": "승인금액"
         },
+        {
+          "name": "approvalResultList.approvalCompanyCode",
+          "required": false,
+          "type": "string",
+          "description": "승인사코드"
+        },
         {
           "name": "approvalResultList.approvalCompanyName",
           "required": false,
@@ -2635,6 +2689,12 @@
           "type": "string",
           "description": "승인카드번호 예시) 490620******6536"
         },
+        {
+          "name": "approvalResultList.sourcePaymentMethdCode",
+          "required": false,
+          "type": "string",
+          "description": "결제수단코드"
+        },
         {
           "name": "approvalResultList.taxfreeAmount",
           "required": false,
@@ -2709,9 +2769,9 @@
         }
       ],
       "param_counts": {
-        "request_total": 61,
-        "request_required": 45,
-        "response_total": 30
+        "request_total": 65,
+        "request_required": 47,
+        "response_total": 35
       }
     },
     {
@@ -2787,6 +2847,12 @@
           "type": "string",
           "description": "PAYCO POS 터미널 번호"
         },
+        {
+          "name": "vanCorpCode",
+          "required": true,
+          "type": "string",
+          "description": "VAN사 코드"
+        },
         {
           "name": "vanPosTid",
           "required": true,
@@ -2840,13 +2906,153 @@
           "required": false,
           "type": "string",
           "description": "단말기 타입. 예) KIOSK, POS, CAT"
+        },
+        {
+          "name": "extras",
+          "required": false,
+          "type": "object",
+          "description": "추가정보"
+        },
+        {
+          "name": "sign",
+          "required": true,
+          "type": "object",
+          "description": "van 사별 sign 정보(5만원 초과결제시 필수)"
+        }
+      ],
+      "response_params": [
+        {
+          "name": "tradeNo",
+          "required": false,
+          "type": "string",
+          "description": "PG/VAN사 거래번호"
+        },
+        {
+          "name": "tradeDatetime",
+          "required": false,
+          "type": "string",
+          "description": "PG/VAN사 거래일시(yyyyMMddHHmmss)"
+        },
+        {
+          "name": "totalTaxfreeAmount",
+          "required": false,
+          "type": "double",
+          "description": "면세금액"
+        },
+        {
+          "name": "totalTaxableAmount",
+          "required": false,
+          "type": "double",
+          "description": "과세금액"
+        },
+        {
+          "name": "totalVatAmount",
+          "required": false,
+          "type": "double",
+          "description": "부가세"
+        },
+        {
+          "name": "totalServiceAmount",
+          "required": false,
+          "type": "double",
+          "description": "봉사료"
+        },
+        {
+          "name": "totalGreenDepositAmount",
+          "required": false,
+          "type": "double",
+          "description": "컵보증금"
+        },
+        {
+          "name": "cancelResultList",
+          "required": false,
+          "type": "list",
+          "description": "취소 결과 목록"
+        },
+        {
+          "name": "extras",
+          "required": false,
+          "type": "object",
+          "description": "추가정보"
+        },
+        {
+          "name": "originalPinCode",
+          "required": false,
+          "type": "string",
+          "description": "실제 결제에 사용된 OTC(협의 시 정보 전달)"
+        },
+        {
+          "name": "cancelResultList.paymentMethodCode",
+          "required": false,
+          "type": "string",
+          "description": "오프라인 결제수단코드"
+        },
+        {
+          "name": "cancelResultList.paymentMethodName",
+          "required": false,
+          "type": "string",
+          "description": "결제수단명"
+        },
+        {
+          "name": "cancelResultList.cancelAmount",
+          "required": false,
+          "type": "double",
+          "description": "취소금액"
+        },
+        {
+          "name": "cancelResultList.cancelDatetime",
+          "required": false,
+          "type": "string",
+          "description": "취소일시(yyyyMMddHHmmss)"
+        },
+        {
+          "name": "cancelResultList.sourcePaymentMethdCode",
+          "required": false,
+          "type": "string",
+          "description": "결제수단코드"
+        },
+        {
+          "name": "cancelResultList.taxfreeAmount",
+          "required": false,
+          "type": "double",
+          "description": "면세금액"
+        },
+        {
+          "name": "cancelResultList.taxableAmount",
+          "required": false,
+          "type": "double",
+          "description": "과세금액"
+        },
+        {
+          "name": "cancelResultList.vatAmount",
+          "required": false,
+          "type": "double",
+          "description": "부가세"
+        },
+        {
+          "name": "cancelResultList.serviceAmount",
+          "required": false,
+          "type": "double",
+          "description": "봉사료"
+        },
+        {
+          "name": "cancelResultList.greenDepositAmount",
+          "required": false,
+          "type": "double",
+          "description": "컵보증금"
+        },
+        {
+          "name": "cancelResultList.nocvmYN",
+          "required": false,
+          "type": "string",
+          "description": "NoCVM 거래 여부"
         }
       ],
-      "response_params": [],
       "param_counts": {
-        "request_total": 20,
-        "request_required": 12,
-        "response_total": 0
+        "request_total": 23,
+        "request_required": 14,
+        "response_total": 0,
+        "response": 21
       }
     },
     {
@@ -2906,12 +3112,30 @@
           "type": "double",
           "description": "컵보증금"
         },
+        {
+          "name": "cancelResultList",
+          "required": false,
+          "type": "list",
+          "description": "취소 결과 목록"
+        },
+        {
+          "name": "extras",
+          "required": false,
+          "type": "object",
+          "description": "추가정보"
+        },
         {
           "name": "originalPinCode",
           "required": false,
           "type": "string",
           "description": "실제 결제에 사용된 OTC(협의 시 정보 전달)"
         },
+        {
+          "name": "cancelResultList.paymentMethodCode",
+          "required": false,
+          "type": "string",
+          "description": "오프라인 결제수단코드"
+        },
         {
           "name": "cancelResultList.paymentMethodName",
           "required": false,
@@ -2930,6 +3154,12 @@
           "type": "string",
           "description": "취소일시(yyyyMMddHHmmss)"
         },
+        {
+          "name": "cancelResultList.sourcePaymentMethdCode",
+          "required": false,
+          "type": "string",
+          "description": "결제수단코드"
+        },
         {
           "name": "cancelResultList.taxfreeAmount",
           "required": false,
@@ -2970,7 +3200,7 @@
       "param_counts": {
         "request_total": 1,
         "request_required": 1,
-        "response_total": 17
+        "response_total": 21
       }
     },
     {
@@ -2980,12 +3210,6 @@
       "url": "SetPaycoData",
       "method": "DLL",
       "request_params": [
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "RegistrationNumber",
           "required": true,
@@ -3052,6 +3276,12 @@
           "type": "unknown",
           "description": "대표 상품명 입니다. 고객에게 상품정보 노출하기 위해 값을 설정해 주세요. 상품이 2건 이상인 경우 대표상품명 외 @건으로 표기해 주세요. ex) 아메리카노 외1건"
         },
+        {
+          "name": "ProductList",
+          "required": true,
+          "type": "unknown",
+          "description": "상품 상세 LIST 입니다.(시작 구분 값:0x02, 상품 구분 값:0x01, 종료 구분 값:0x03 ex) (0x02)20124(0x01)라떼(0x01)3500(0x01)2(0x01)Y(0x03)"
+        },
         {
           "name": "ProductListFieldCount",
           "required": true,
@@ -3142,12 +3372,6 @@
           "type": "unknown",
           "description": "취소거래 시 포인트 및 쿠폰 금액을 제외한 신용카드 결제금액을 설정해 주세요. ex) 500"
         },
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "MerchantCode",
           "required": false,
@@ -3160,12 +3384,6 @@
           "type": "unknown",
           "description": "PEM ex) 0"
         },
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "MerchantPosNo",
           "required": false,
@@ -3175,8 +3393,8 @@
       ],
       "response_params": [],
       "param_counts": {
-        "request_total": 32,
-        "request_required": 14,
+        "request_total": 30,
+        "request_required": 15,
         "response_total": 0
       }
     },
@@ -3187,12 +3405,6 @@
       "url": "GetPaycoData",
       "method": "DLL",
       "request_params": [
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "ResCd",
           "required": false,
@@ -3460,7 +3672,7 @@
       ],
       "response_params": [],
       "param_counts": {
-        "request_total": 45,
+        "request_total": 44,
         "request_required": 0,
         "response_total": 0
       }
@@ -5069,12 +5281,6 @@
       "url": "SetData",
       "method": "DLL",
       "request_params": [
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "registernumber",
           "required": false,
@@ -5096,7 +5302,7 @@
       ],
       "response_params": [],
       "param_counts": {
-        "request_total": 4,
+        "request_total": 3,
         "request_required": 0,
         "response_total": 0
       }
@@ -5108,12 +5314,6 @@
       "url": "SendData",
       "method": "DLL",
       "request_params": [
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "ACCEPTED",
           "required": false,
@@ -5165,7 +5365,7 @@
       ],
       "response_params": [],
       "param_counts": {
-        "request_total": 9,
+        "request_total": 8,
         "request_required": 0,
         "response_total": 0
       }

package/dist/data/guides/online-extradata.md

@@ -33,8 +33,8 @@
 |  |  |  |  |  |
 | --- | --- | --- | --- | --- |
 | **Column** | **Java Type** | **필수여부** | **Description** | **example** |
-| includePayment MethodCodes | List<String> | N | 가능한 [결제수단](http://wikin.nhnent.com/pages/viewpage.action?pageId=243370295) - includePaymentMethodCodes 중 가능한 결제수단 제공  : 동일한 결제수단이 excludePaymentMethodCodes 에도 포함된 경우 결제수단에서 제외 | "includePaymentMethodCodes" : ["31, "01"] |
-| excludePayment MethodCodes | List<String> | N | 제외 할 [결제수단](http://wikin.nhnent.com/pages/viewpage.action?pageId=243370295) - 가능한 결제수단 중 excludePaymentMethodCodes 제외 | "excludePaymentMethodCodes" : ["31, "01"] |
+| includePayment MethodCodes | List<String> | N | 가능한 결제수단(online-code 가이드의 「결제수단 코드」 참고) - includePaymentMethodCodes 중 가능한 결제수단 제공  : 동일한 결제수단이 excludePaymentMethodCodes 에도 포함된 경우 결제수단에서 제외 | "includePaymentMethodCodes" : ["31, "01"] |
+| excludePayment MethodCodes | List<String> | N | 제외 할 결제수단(online-code 가이드의 「결제수단 코드」 참고) - 가능한 결제수단 중 excludePaymentMethodCodes 제외 | "excludePaymentMethodCodes" : ["31, "01"] |
 | **paymentMetho dOptions** | List<payme ntMethodO ption> | N | 결제수단별 결제옵션 | "paymentMethodOptions" : [  {  "paymentMethodCode": "05",  "message": "핸드폰으로 결제하시면 수수료가 부과됩니다."  },  {  "paymentMethodCode": "31", "useCardList" : ["CCBC", "CCSS"]  },  {  "paymentMethodCode": "02",  "message": "추가 무통장 입금취소 시 결제 불가 합니다."  }, |
 
 시 총
@@ -66,7 +66,7 @@
 |  |  |  |  |  |
 | --- | --- | --- | --- | --- |
 | **Column** | **Java Type** | **필수여 부** | **Description** | **example** |
-| paymentMethodCode | String | Y | [결제수단](http://wikin.nhnent.com/pages/viewpage.action?pageId=243370295)코드 | 예 : 신용카드 간편결제의 경우-> 31 |
+| paymentMethodCode | String | Y | 결제수단(online-code 가이드의 「결제수단 코드」 참고)코드 | 예 : 신용카드 간편결제의 경우-> 31 |
 | message | String | N | 해당 결제수단을 선택했을 때 노출할 메시지 (결제창 내에 노출됨) |  |
 | useCardList |  | N | 사용카드 목록 | ["CCBC", "CCSS"] |
 | compositePaymentPos sibleYn | String | N | 복합결제 가능 여부 (기본값: Y) - 일반결제수단만 적용 가능(신용카드, 휴대폰, 무통장입금...) | Y |

package/dist/data/guides/online-extradata.meta.json

@@ -48,7 +48,7 @@
   ],
   "table_count": 56,
   "code_block_count": 0,
-  "text_length": 6691,
+  "text_length": 6586,
   "source_kind": "internal_docx",
   "source_filename": "PAYCO_부가정보(extraData)_v1.1.14.docx"
 }

package/dist/data/index.json

@@ -2,7 +2,7 @@
   "schema_version": "1.0",
   "source_site": "https://devcenter.payco.com",
   "scope": "PAYCO 가이드 전체 (온라인결제·자동결제·오프라인결제·오더클라우드·멤버십클라우드·결제정산대사)",
-  "generated_at": "2026-05-22T07:14:35+00:00",
+  "generated_at": "2026-10-13T02:11:44+00:00",
   "category_count": 28,
   "categories": [
     {
@@ -625,7 +625,7 @@
       ],
       "table_count": 56,
       "code_block_count": 0,
-      "text_length": 6691
+      "text_length": 6586
     },
     {
       "slug": "online-sample",

package/dist/tools.js

@@ -447,7 +447,7 @@ export function registerAllTools(server, store) {
     // 1) search_devcenter ----------------------------------------------------
     server.registerTool("search_devcenter", {
         title: "개발자센터 검색",
-        description: "PAYCO 개발자센터 가이드(온라인결제·자동결제)를 키워드로 검색. " +
+        description: "PAYCO 개발자센터 가이드 28개(온라인·오프라인·오더·멤버십·결제정산)를 키워드로 검색. " +
             "제목·섹션·본문 텍스트에서 매칭되는 가이드와 발췌를 반환.",
         inputSchema: {
             query: z.string().min(1).describe("검색어 (예: '결제 승인', 'orderProducts')"),
@@ -533,7 +533,7 @@ export function registerAllTools(server, store) {
     // 5) get_sample_code ----------------------------------------------------
     server.registerTool("get_sample_code", {
         title: "샘플 코드 조회",
-        description: "특정 가이드의 코드 블록만 추출해 반환. 가이드 슬러그와(선택적으로) 언어를 지정.",
+        description: "특정 가이드의 코드 블록(주로 요청·응답 JSON 예시)만 추출해 반환. 언어별 소스코드 샘플은 포함하지 않음.",
         inputSchema: {
             slug: z
                 .string()
@@ -541,7 +541,7 @@ export function registerAllTools(server, store) {
             language: z
                 .string()
                 .optional()
-                .describe("필터할 언어 태그 (예: json, java, javascript). 미지정 시 모든 코드 블록 반환."),
+                .describe("필터할 언어 태그. 현재 가이드 코드 블록 대부분에 언어 표시가 없어 지정해도 결과가 거의 같음. 미지정 시 모든 코드 블록 반환."),
         },
     }, async ({ slug, language }) => {
         const md = store.guides.get(slug);

package/package.json

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