@nhnpayco-dev/mcp-devcenter 1.0.2 → 1.0.4

package/README.md

@@ -5,13 +5,13 @@
 [![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 개발 도구에 자연어로 물어 즉시 정확한 답을 받을 수 있게 해줍니다.
 
-AI 에디터에 이렇게 물어보면 됩니다.
+AI 개발 도구에 이렇게 물어보면 됩니다.
 
 - "PAYCO 자동결제 빌링키 발급부터 결제까지 흐름 알려줘"
 - "결제 승인 API 에 필수로 보내야 하는 파라미터가 뭐야?"
@@ -23,7 +23,7 @@ AI 에디터에 이렇게 물어보면 됩니다.
 ## 요구사항
 
 - **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` 가 알아서 받습니다). 별도 빌드·환경 설정 불필요.
 
@@ -87,14 +87,14 @@ 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개)
 
 | 도구 이름 | 설명 |
 |---|---|
-| `list_validatable_apis()` | 자동 검증 가능한 API 슬러그 35개 목록 (URL·메서드·파라미터 수 포함) |
+| `list_validatable_apis()` | 자동 검증 가능한 API 슬러그 34개 목록 (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개 시트**: 검수요약 / 항목별 상세 / 공통검수체크리스트 |
@@ -160,11 +160,12 @@ AI 에디터에 이렇게 물어보면 됩니다.
 
 🆕 표시는 PAYCO 개발자센터에는 없는 사내 문서 기반 가이드입니다.
 
-### 자동 검증 가능한 API 슬러그 (35개)
+### 자동 검증 가능한 API 슬러그 (34개)
 
 **온라인 — reserve / 승인 / 취소**
-`online-easypay-01`~`04` · `online-autopay-01`~`06` ·
-`online-etc-01`/`03`/`04` · `online-extra-02`/`03`
+`online-easypay-01`~`04` · `online-autopay-01`~`04`/`06` ·
+`online-etc-01`/`03`/`04` · `online-extra-03`
+(자동결제 ⑤ 결제 취소는 일반 결제 취소 API와 같아 `online-easypay-04`로 검증)
 
 **온라인 — reserve 변형 (합성)**
 `online-easypay-nonmember` (비회원결제) · `online-easypay-checkout` (바로구매) ·
@@ -195,15 +196,15 @@ VMEM (DLL) `membership-vmem-execasyncapproval` · `-execcomplete` · `-execcance
 
 - 가이드 본문 카테고리: **28개** (devcenter 크롤 26개 + 사내 문서 2개)
 - 에러코드/코드값 표 항목: **500+ 개** (4개 root 의 API 응답코드, 결제수단, 카드사, 은행, VAN사, 결제수단 코드 등 통합)
-- 자동 검증 가능한 API 명세: **35개**
-  - REST API 27개 (easypay/autopay/etc/extra/offline-api/authapi 등)
+- 자동 검증 가능한 API 명세: **34개**
+  - REST API 24개 (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 루트 인증서 설치 가이드)

package/dist/data/api-specs.json

@@ -1,6 +1,6 @@
 {
   "source": "PAYCO 개발자센터 가이드 markdown 본문에서 자동 추출 + 변형 합성",
-  "api_count": 35,
+  "api_count": 34,
   "apis": [
     {
       "slug": "online-easypay-01",
@@ -1857,26 +1857,12 @@
         "response_total": 3
       }
     },
-    {
-      "slug": "online-extra-02",
-      "guide": "online-extra",
-      "title": "iOS 앱 스킴(App Url Scheme) 추가하기",
-      "url": "/outseller/payment/approval/getDetailForVerify",
-      "method": "POST",
-      "request_params": [],
-      "response_params": [],
-      "param_counts": {
-        "request_total": 0,
-        "request_required": 0,
-        "response_total": 0
-      }
-    },
     {
       "slug": "online-extra-03",
       "guide": "online-extra",
       "title": "결제상세조회 API - REQUEST",
-      "url": null,
-      "method": null,
+      "url": "/outseller/payment/approval/getDetailForVerify",
+      "method": "POST",
       "request_params": [
         {
           "name": "sellerKey",
@@ -1915,13 +1901,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 +1967,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 +2081,12 @@
           "type": "string",
           "description": "사업자 등록번호, ‘-’ 문자 제거하여 전달"
         },
+        {
+          "name": "vanCorpCode",
+          "required": true,
+          "type": "string",
+          "description": "VAN사 코드"
+        },
         {
           "name": "vanPosTid",
           "required": true,
@@ -2147,8 +2139,8 @@
         }
       ],
       "param_counts": {
-        "request_total": 6,
-        "request_required": 3,
+        "request_total": 7,
+        "request_required": 4,
         "response_total": 4
       }
     },
@@ -2189,6 +2181,12 @@
           "type": "string",
           "description": "PAYCO POS 터미널 번호"
         },
+        {
+          "name": "vanCorpCode",
+          "required": true,
+          "type": "string",
+          "description": "VAN사 코드"
+        },
         {
           "name": "vanPosTid",
           "required": true,
@@ -2261,6 +2259,12 @@
           "type": "string",
           "description": "상품명. 예)아메리카노 외 1건"
         },
+        {
+          "name": "productInfoList",
+          "required": false,
+          "type": "list",
+          "description": "상품 목록"
+        },
         {
           "name": "installmentPeriod",
           "required": false,
@@ -2291,6 +2295,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 +2597,18 @@
           "type": "double",
           "description": "컵보증금"
         },
+        {
+          "name": "approvalResultList",
+          "required": false,
+          "type": "list",
+          "description": "결제 승인 시 결제수단별 정보"
+        },
+        {
+          "name": "extras",
+          "required": false,
+          "type": "object",
+          "description": "추가정보"
+        },
         {
           "name": "membershipCardNo",
           "required": false,
@@ -2599,6 +2627,12 @@
           "type": "string",
           "description": "주 오프라인 결제수단코드"
         },
+        {
+          "name": "approvalResultList.paymentMethodCode",
+          "required": false,
+          "type": "string",
+          "description": "오프라인 결제수단코드"
+        },
         {
           "name": "approvalResultList.paymentMethodName",
           "required": false,
@@ -2623,6 +2657,12 @@
           "type": "double",
           "description": "승인금액"
         },
+        {
+          "name": "approvalResultList.approvalCompanyCode",
+          "required": false,
+          "type": "string",
+          "description": "승인사코드"
+        },
         {
           "name": "approvalResultList.approvalCompanyName",
           "required": false,
@@ -2635,6 +2675,12 @@
           "type": "string",
           "description": "승인카드번호 예시) 490620******6536"
         },
+        {
+          "name": "approvalResultList.sourcePaymentMethdCode",
+          "required": false,
+          "type": "string",
+          "description": "결제수단코드"
+        },
         {
           "name": "approvalResultList.taxfreeAmount",
           "required": false,
@@ -2709,9 +2755,9 @@
         }
       ],
       "param_counts": {
-        "request_total": 61,
-        "request_required": 45,
-        "response_total": 30
+        "request_total": 65,
+        "request_required": 47,
+        "response_total": 35
       }
     },
     {
@@ -2787,6 +2833,12 @@
           "type": "string",
           "description": "PAYCO POS 터미널 번호"
         },
+        {
+          "name": "vanCorpCode",
+          "required": true,
+          "type": "string",
+          "description": "VAN사 코드"
+        },
         {
           "name": "vanPosTid",
           "required": true,
@@ -2840,13 +2892,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 +3098,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 +3140,12 @@
           "type": "string",
           "description": "취소일시(yyyyMMddHHmmss)"
         },
+        {
+          "name": "cancelResultList.sourcePaymentMethdCode",
+          "required": false,
+          "type": "string",
+          "description": "결제수단코드"
+        },
         {
           "name": "cancelResultList.taxfreeAmount",
           "required": false,
@@ -2970,7 +3186,7 @@
       "param_counts": {
         "request_total": 1,
         "request_required": 1,
-        "response_total": 17
+        "response_total": 21
       }
     },
     {
@@ -2980,12 +3196,6 @@
       "url": "SetPaycoData",
       "method": "DLL",
       "request_params": [
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "RegistrationNumber",
           "required": true,
@@ -3052,6 +3262,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 +3358,6 @@
           "type": "unknown",
           "description": "취소거래 시 포인트 및 쿠폰 금액을 제외한 신용카드 결제금액을 설정해 주세요. ex) 500"
         },
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "MerchantCode",
           "required": false,
@@ -3160,12 +3370,6 @@
           "type": "unknown",
           "description": "PEM ex) 0"
         },
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "MerchantPosNo",
           "required": false,
@@ -3175,8 +3379,8 @@
       ],
       "response_params": [],
       "param_counts": {
-        "request_total": 32,
-        "request_required": 14,
+        "request_total": 30,
+        "request_required": 15,
         "response_total": 0
       }
     },
@@ -3187,12 +3391,6 @@
       "url": "GetPaycoData",
       "method": "DLL",
       "request_params": [
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "ResCd",
           "required": false,
@@ -3460,7 +3658,7 @@
       ],
       "response_params": [],
       "param_counts": {
-        "request_total": 45,
+        "request_total": 44,
         "request_required": 0,
         "response_total": 0
       }
@@ -5069,12 +5267,6 @@
       "url": "SetData",
       "method": "DLL",
       "request_params": [
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "registernumber",
           "required": false,
@@ -5096,7 +5288,7 @@
       ],
       "response_params": [],
       "param_counts": {
-        "request_total": 4,
+        "request_total": 3,
         "request_required": 0,
         "response_total": 0
       }
@@ -5108,12 +5300,6 @@
       "url": "SendData",
       "method": "DLL",
       "request_params": [
-        {
-          "name": "KEY",
-          "required": false,
-          "type": "unknown",
-          "description": "설명"
-        },
         {
           "name": "ACCEPTED",
           "required": false,
@@ -5165,7 +5351,7 @@
       ],
       "response_params": [],
       "param_counts": {
-        "request_total": 9,
+        "request_total": 8,
         "request_required": 0,
         "response_total": 0
       }

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

@@ -165,26 +165,16 @@ PAYCO App 결제 연동 시 유의 해야 될 내용을 확인 해보세요.
 
 ### 영수증
 
-가맹점 및 고객용 영수증을 확인할 수 있어요.  
- API 외에 [PAYCO 파트너센터](https://demo-partner.payco.com/) 에서도 확인이 가능합니다.
+고객 영수증을 보여줄 수 있어요.  
+ 영수증 조회를 위해서는 PAYCO 로그인이 필요하며, 이용자 본인인 경우에만 조회할 수 있습니다.
 
 앱 스킴 리스트
 
 |  |  |
 | --- | --- |
-| 가맹점용 | /seller/receipt/{sellerKey}/{sellerOrderReferenceKey}/{orderNo} 설명: /seller/receipt/{가맹점키}/{외부가맹점주문번호}/{PAYCO주문번호} |
-| 고객용 | /outseller/receipt/{orderNo} 설명: /outseller/receipt/{PAYCO주문번호} |
+| URL | /outseller/receipt/{orderNo} * orderNo: PAYCO 주문번호 |
+| Method | GET |
 
-- 가맹점용 URL은 PAYCO 로그인 없이 조회 가능하지만 고객용 URL은 이용자 본인인 경우만 조회 가능합니다. (※ PAYCO 로그인 필요)  
- - 영수증 형식을 지정하여 노출하는 경우 ‘receiptKind’ 파라미터를 추가하여 호출합니다.  
-  
- ▶ 신용카드 매출전표: URL?receiptKind=card  
- ▶ 온라인 영수증: URL?receiptKind=online  
- ▶ 가맹점용 Sample URL: https://bill.payco.com/seller/receipt/DEMO_REAL/mallseq1639976172184/202112202536599429  
- ▶ 고객용 Sample URL: https://bill.payco.com/outseller/receipt/202112202536599429
-
-- ##### 가맹점용 영수증
-
-  ![매출전표](/img/@receipt_card.068bf10e.png)  
-    
-  ![온라인 영수증](/img/@receipt_online.fa201aa0.png)
+영수증 형식을 지정하려는 경우 "receiptKind" 파라미터를 추가하여 호출합니다.  
+ - 신용카드 매출전표: URL?receiptKind=card  
+ - 온라인 영수증: URL?receiptKind=online

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

@@ -31,5 +31,5 @@
   ],
   "table_count": 5,
   "code_block_count": 3,
-  "text_length": 4548
+  "text_length": 4151
 }

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-13T07:16:43+00:00",
   "category_count": 28,
   "categories": [
     {
@@ -589,7 +589,7 @@
       ],
       "table_count": 5,
       "code_block_count": 3,
-      "text_length": 4548
+      "text_length": 4151
     },
     {
       "slug": "online-extradata",
@@ -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.2",
-  "description": "PAYCO 개발자센터 가이드 전체(온라인·오프라인·오더·멤버십·결제정산) 를 AI 에디터에서 바로 조회·검색할 수 있게 해주는 MCP 서버 (PAYCO Developer Center integration guide MCP server for Claude, Cursor and AI agents)",
+  "version": "1.0.4",
+  "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"