@nhnpayco-dev/mcp-devcenter 1.0.3 → 1.1.0

package/README.md

@@ -94,10 +94,10 @@ AI 개발 도구에 이렇게 물어보면 됩니다.
 
 | 도구 이름 | 설명 |
 |---|---|
-| `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개 시트**: 검수요약 / 항목별 상세 / 공통검수체크리스트 |
+| `validate_payload(api, payload)` | API 요청 페이로드 JSON을 검증 — (1) 필수 누락 / 명세 외 파라미터 / 타입 불일치 + (2) 자동 체크리스트(개인정보(멤버십 제외)·URL 인코딩·공백·금액 합산·enum·날짜 형식·returnUrl) + (3) 수동 확인 항목 |
+| `export_validation_excel(path?, clearAfter?)` | 누적된 검수 결과를 xlsx로 추출. **3개 시트**: 검수요약 / 항목별 상세 / 공통검수체크리스트. 다운로드 폴더에만 저장하며(`path`는 파일 이름으로만 사용), 같은 이름이 있으면 덮어쓰지 않고 번호를 붙임 |
 | `clear_validation_buffer()` | 누적된 검수 결과를 모두 초기화 (새 세션 시작 시) |
 
 ### 검증 도구 사용 예시 (외부 제휴사 시점)
@@ -158,13 +158,13 @@ AI 개발 도구에 이렇게 물어보면 됩니다.
 **calculate** — 결제/정산 대사
 `calculate`
 
-🆕 표시는 PAYCO 개발자센터에는 없는 사내 문서 기반 가이드입니다.
+🆕 표시는 PAYCO 개발자센터에 게시되지 않은 가이드입니다.
 
-### 자동 검증 가능한 API 슬러그 (35개)
+### 자동 검증 가능한 API 슬러그 (34개)
 
 **온라인 — reserve / 승인 / 취소**
 `online-easypay-01`~`04` · `online-autopay-01`~`04`/`06` ·
-`online-etc-01`/`03`/`04` · `online-extra-02`/`03`
+`online-etc-01`/`03`/`04` · `online-extra-03`
 (자동결제 ⑤ 결제 취소는 일반 결제 취소 API와 같아 `online-easypay-04`로 검증)
 
 **온라인 — reserve 변형 (합성)**
@@ -192,12 +192,12 @@ VMEM (DLL) `membership-vmem-execasyncapproval` · `-execcomplete` · `-execcance
 
 본 패키지에 포함된 가이드 정보:
 - [PAYCO 개발자센터](https://devcenter.payco.com)의 **연동하기 > 온라인/오프라인/오더/멤버십** 전 섹션 + **결제/정산 대사**
-- 사내 문서 기반 가이드 2종: 오프라인 POS **인증승인형 연동 가이드**, **부가정보(extraData) 명세**
+- 개발자센터 미게시 가이드 2종: 오프라인 POS **인증승인형 연동 가이드**, **부가정보(extraData) 명세**
 
-- 가이드 본문 카테고리: **28개** (devcenter 크롤 26개 + 사내 문서 2개)
+- 가이드 본문 카테고리: **28개** (devcenter 크롤 26개 + 개발자센터 미게시 문서 2개)
 - 에러코드/코드값 표 항목: **500+ 개** (4개 root 의 API 응답코드, 결제수단, 카드사, 은행, VAN사, 결제수단 코드 등 통합)
-- 자동 검증 가능한 API 명세: **35개**
-  - REST API 25개 (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`)
 

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",

package/dist/data/guides/offline-authapi.md

@@ -1,6 +1,6 @@
 # PAYCO 오프라인 POS 인증승인형 연동 가이드
 
-> **원본:** PAYCO_오프라인POS_인증승인형연동가이드_v1.0.1.0.docx (사내 배포 문서)
+> **원본:** PAYCO_오프라인POS_인증승인형연동가이드_v1.0.1.0.docx (개발자센터 미게시 문서)
 > **카테고리:** `offline-authapi`
 > **연동 방식:** 가맹점 단말이 결제 인증·승인을 직접 수행하는 인증승인형
 > **API 5종:** POS 인증 / 결제 인증 / 결제 승인 / 결제취소 / 망취소

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

@@ -1,6 +1,6 @@
 # PAYCO 부가정보(extraData) 명세
 
-> **원본:** PAYCO_부가정보(extraData)_v1.1.14.docx (사내 배포 문서)
+> **원본:** PAYCO_부가정보(extraData)_v1.1.14.docx (개발자센터 미게시 문서)
 > **카테고리:** `online-extradata`
 > **용도:** 온라인결제 주문예약 API의 extraData 파라미터(JSON String) 내부 구조 정의
 > **사용 위치:** online-easypay-01 (reserve), online-autopay-01, online-easypay-nonmember/checkout/ordersheet 등 reserve 계열 API

package/dist/data/index.json

@@ -2,7 +2,7 @@
   "schema_version": "1.0",
   "source_site": "https://devcenter.payco.com",
   "scope": "PAYCO 가이드 전체 (온라인결제·자동결제·오프라인결제·오더클라우드·멤버십클라우드·결제정산대사)",
-  "generated_at": "2026-10-13T02:11:44+00:00",
+  "generated_at": "2026-10-14T04:35:38+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",

package/dist/excel.js

@@ -1,9 +1,9 @@
 // 검수 결과 → xlsx 변환.
 // 3 시트: 검수요약 / 항목별 상세 / 공통검수체크리스트
 // 양식 참조: data/samples/payco_nonmember_checklist.xlsx (Arial 10pt, 진남색 헤더)
-import { mkdir } from "node:fs/promises";
+import { mkdir, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
-import { dirname, join, resolve, isAbsolute } from "node:path";
+import { join } from "node:path";
 import ExcelJS from "exceljs";
 import { CHECKLISTS, SERVICE_LABELS } from "./tools.js";
 // ── 디자인 토큰 ──────────────────────────────────────────────
@@ -30,21 +30,49 @@ const STATUS_LABEL = {
     manual: "⬜ 수동확인",
 };
 // ── 경로/파일명 ──────────────────────────────────────────────
-export function defaultOutputPath() {
+// 저장 위치는 항상 다운로드 폴더로 고정한다. 경로는 AI 가 정해 넘기므로
+// 다른 폴더 저장·폴더 생성·기존 파일 덮어쓰기를 허용하지 않는다.
+export function downloadsDir() {
+    return join(homedir(), "Downloads");
+}
+function defaultFileName() {
     const now = new Date();
     const pad = (n) => String(n).padStart(2, "0");
     const stamp = `${now.getFullYear()}${pad(now.getMonth() + 1)}${pad(now.getDate())}` +
         `-${pad(now.getHours())}${pad(now.getMinutes())}${pad(now.getSeconds())}`;
-    return join(homedir(), "Downloads", `payco-validation-${stamp}.xlsx`);
+    return `payco-validation-${stamp}.xlsx`;
+}
+/** 요청 경로에서 파일명만 남긴다. 폴더 부분이 있었으면 relocated=true. */
+function toFileName(userPath) {
+    const raw = userPath?.trim() ?? "";
+    if (!raw)
+        return { name: defaultFileName(), relocated: false };
+    const parts = raw.split(/[\\/]/);
+    const relocated = parts.length > 1;
+    let name = parts[parts.length - 1]
+        .replace(/[<>:"|?*\u0000-\u001f]/g, "_")
+        .replace(/[. ]+$/, "");
+    if (!name || name === "..")
+        name = defaultFileName();
+    if (!name.toLowerCase().endsWith(".xlsx"))
+        name = `${name}.xlsx`;
+    return { name, relocated };
 }
-async function ensureOutputPath(userPath) {
-    let p = userPath?.trim() || defaultOutputPath();
-    if (!isAbsolute(p))
-        p = resolve(p);
-    if (!p.toLowerCase().endsWith(".xlsx"))
-        p = `${p}.xlsx`;
-    await mkdir(dirname(p), { recursive: true });
-    return p;
+/** 같은 이름이 있으면 ' (2)', ' (3)' … 을 붙여 새 파일로 쓴다(덮어쓰기 금지). */
+async function writeNoOverwrite(dir, name, data) {
+    const base = name.slice(0, -".xlsx".length);
+    for (let i = 1; i < 1000; i++) {
+        const p = join(dir, i === 1 ? name : `${base} (${i}).xlsx`);
+        try {
+            await writeFile(p, data, { flag: "wx" });
+            return p;
+        }
+        catch (e) {
+            if (e.code !== "EEXIST")
+                throw e;
+        }
+    }
+    throw new Error(`같은 이름의 파일이 너무 많습니다: ${name}`);
 }
 // ── 공통 헬퍼 ────────────────────────────────────────────────
 function fillSolid(argb) {
@@ -313,8 +341,16 @@ export async function exportValidationToExcel(records, userPath) {
     buildSummarySheet(wb, records);
     buildDetailSheet(wb, records);
     buildChecklistSheet(wb, records);
-    const outPath = await ensureOutputPath(userPath);
-    await wb.xlsx.writeFile(outPath);
+    const dir = downloadsDir();
+    await mkdir(dir, { recursive: true }); // 다운로드 폴더만 없으면 만든다
+    const { name, relocated } = toFileName(userPath);
+    const data = Buffer.from(await wb.xlsx.writeBuffer());
+    const outPath = await writeNoOverwrite(dir, name, data);
+    const notes = [];
+    if (relocated)
+        notes.push("요청한 위치 대신 다운로드 폴더에 저장했습니다(다운로드 폴더에만 저장 가능).");
+    if (!outPath.endsWith(name))
+        notes.push(`같은 이름의 파일이 있어 새 이름으로 저장했습니다(기존 파일은 그대로 둠).`);
     const detailRows = records.reduce((sum, r) => sum + r.specIssues.length + r.checklistRuns.length, 0);
-    return { path: outPath, recordCount: records.length, rowCount: detailRows };
+    return { path: outPath, recordCount: records.length, rowCount: detailRows, notes };
 }

package/dist/index.js

@@ -8,6 +8,12 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { loadDataStore } from "./data.js";
 import { registerAllTools } from "./tools.js";
+/** MCP initialize 응답의 instructions. 클라이언트가 연결 시점에 받아 세션 내내 참고한다.
+ *  검색 결과와 무관하게 항상 지킬 규칙만 둔다(세션마다 점유하므로 짧게).
+ *  근거: online-start·offline-start 「PAYCO 통신 방화벽 OPEN」, online-easypay orderSheetUrl. */
+const SERVER_INSTRUCTIONS = `PAYCO 연동 코드를 생성할 때 문서 검색 결과와 무관하게 항상 지킬 것:
+- PAYCO API(주문 예약, 결제 승인·취소 등)는 방화벽에 IP를 등록한 가맹점 서버에서만 정상 처리됩니다. 브라우저나 모바일 앱에서 직접 호출하는 코드를 만들지 마세요.
+- 브라우저는 가맹점 서버가 주문 예약 API로 받은 결제창 URL(orderSheetUrl)을 여는 역할만 합니다.`;
 /** package.json 의 version 을 그대로 사용한다.
  *  하드코딩하면 배포 버전과 어긋난다(1.0.0 배포본이 0.2.0 으로 보고된 전례). */
 async function packageVersion() {
@@ -29,7 +35,7 @@ async function main() {
     const server = new McpServer({
         name: "payco-mcp-devcenter",
         version,
-    });
+    }, { instructions: SERVER_INSTRUCTIONS });
     registerAllTools(server, store);
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/dist/tools.js

@@ -189,15 +189,19 @@ function makeDateYmdCheck(field, allowFull = false) {
             : { pass: false, message: `${allowFull ? "YYYYMMDD(8자리) 또는 YYYYMMDDHHmmss(14자리)" : "YYYYMMDD(8자리)"} 필요. 현재: '${val}'` };
     };
 }
+// -- 개인정보 체크 항목 --
+// 온라인 검수 가이드 「Request 파라미터에 개인정보가 유입되지는 않는지」 기반.
+// 온라인·오프라인·오더 요청에는 개인정보 칸이 없어 실수 검출용으로 적용한다.
+// 멤버십은 적립 대상 휴대폰번호·회원카드번호 등이 정상 요청값이라 적용하지 않는다.
+const ITEM_PII = {
+    id: "common-pii",
+    category: "보안",
+    title: "개인정보 파라미터 미포함",
+    detail: "주민번호·카드번호·전화번호 등 개인정보가 request 파라미터에 유입되지 않아야 함",
+    autoCheck: autoCheckPii,
+};
 // -- 공통 체크 항목 --
 const ITEMS_COMMON = [
-    {
-        id: "common-pii",
-        category: "보안",
-        title: "개인정보 파라미터 미포함",
-        detail: "주민번호·카드번호·전화번호 등 개인정보가 request 파라미터에 유입되지 않아야 함",
-        autoCheck: autoCheckPii,
-    },
     {
         id: "common-encoding",
         category: "기타",
@@ -227,6 +231,7 @@ const ITEMS_COMMON = [
 ];
 // -- 온라인결제 체크리스트 --
 const CHECKLIST_ONLINE = [
+    ITEM_PII,
     ...ITEMS_COMMON,
     { id: "online-firewall", category: "사전준비", title: "PAYCO 방화벽 등록 완료" },
     { id: "online-merchant-code", category: "사전준비", title: "PAYCO 가맹점 코드 발급 완료" },
@@ -307,6 +312,7 @@ const CHECKLIST_ONLINE = [
 ];
 // -- 오프라인결제 체크리스트 --
 const CHECKLIST_OFFLINE = [
+    ITEM_PII,
     ...ITEMS_COMMON,
     { id: "offline-btn", category: "결제노출", title: "단말기에 PAYCO 결제 버튼 정상 노출 (디자인 가이드 준수)" },
     { id: "offline-receipt", category: "공통", title: "영수증 필요 정보 정상 노출" },
@@ -340,6 +346,7 @@ const CHECKLIST_OFFLINE = [
 ];
 // -- 오더클라우드 체크리스트 --
 const CHECKLIST_ORDER = [
+    ITEM_PII,
     ...ITEMS_COMMON,
     { id: "order-receipt", category: "공통", title: "영수증 필요 정보 정상 노출" },
     { id: "order-sales", category: "매출처리", title: "주문 수락 시 POS 단말기에 매출 정상 등록" },
@@ -444,6 +451,16 @@ function groupByCategory(items) {
 export function registerAllTools(server, store) {
     const slugs = store.index.categories.map((c) => c.slug);
     const slugList = slugs.join(", ");
+    // 가이드 참고 링크: index.json 의 실제 주소를 쓴다(주소를 조립하면 ?id= 가 없어 개발자센터에서 열리지 않음).
+    // 개발자센터에 없는 문서(internal://)는 주소 대신 MCP 안에서 여는 방법을 안내한다.
+    const guideLink = (slug) => {
+        const url = store.index.categories.find((c) => c.slug === slug)?.url;
+        if (!url)
+            return `get_guide('${slug}')`;
+        return url.startsWith("internal://")
+            ? `개발자센터 미게시 문서 (전체 내용: get_guide('${slug}'))`
+            : url;
+    };
     // 1) search_devcenter ----------------------------------------------------
     server.registerTool("search_devcenter", {
         title: "개발자센터 검색",
@@ -462,7 +479,7 @@ export function registerAllTools(server, store) {
             const snippets = snippetLines(md, query, 5);
             if (titleHit || snippets.length > 0) {
                 let block = `## [${cat.slug}] ${cat.title}\n`;
-                block += `   ${cat.url}\n`;
+                block += `   ${guideLink(cat.slug)}\n`;
                 if (snippets.length > 0) {
                     for (const s of snippets)
                         block += `   > ${s}\n`;
@@ -503,7 +520,7 @@ export function registerAllTools(server, store) {
         lines.push("");
         for (const cat of store.index.categories) {
             lines.push(`## [${cat.slug}] ${cat.title}`);
-            lines.push(`   ${cat.url}`);
+            lines.push(`   ${guideLink(cat.slug)}`);
             if (cat.sections.length > 0) {
                 for (const s of cat.sections) {
                     lines.push(`   - ${s.label}`);
@@ -587,7 +604,7 @@ export function registerAllTools(server, store) {
                 .describe("서비스 유형: online(온라인결제) | offline(오프라인결제) | order(오더클라우드) | membership(멤버십 클라우드)"),
         },
     }, async ({ service }) => {
-        const checklist = CHECKLISTS[service] ?? ITEMS_COMMON;
+        const checklist = CHECKLISTS[service] ?? [ITEM_PII, ...ITEMS_COMMON];
         const label = SERVICE_LABELS[service] ?? service;
         const autoItems = checklist.filter((c) => c.autoCheck);
         const manualItems = checklist.filter((c) => !c.autoCheck);
@@ -624,7 +641,7 @@ export function registerAllTools(server, store) {
             lines.push("");
         }
         const checkGuideSlug = `${service}-check`;
-        lines.push(`> 상세 검수 가이드: get_guide('${checkGuideSlug}') 또는 https://devcenter.payco.com/guide/${service}/check`);
+        lines.push(`> 상세 검수 가이드: get_guide('${checkGuideSlug}') 또는 ${guideLink(checkGuideSlug)}`);
         return text(lines.join("\n"));
     });
     // 8) validate_payload ---------------------------------------------------
@@ -699,7 +716,7 @@ export function registerAllTools(server, store) {
         }
         // --- 체크리스트 실행 ---
         const service = serviceOf(api);
-        const checklist = CHECKLISTS[service] ?? ITEMS_COMMON;
+        const checklist = CHECKLISTS[service] ?? [ITEM_PII, ...ITEMS_COMMON];
         const serviceLabel = SERVICE_LABELS[service] ?? service;
         const runResults = checklist.map((item) => ({
             item,
@@ -825,7 +842,7 @@ export function registerAllTools(server, store) {
             lines.push("## API 명세 검증 ✓ — 이상 없음");
         }
         lines.push("");
-        lines.push(`참고 가이드: https://devcenter.payco.com/guide/${spec.guide.replace(/-/g, "/")}`);
+        lines.push(`참고 가이드: ${guideLink(spec.guide)}`);
         lines.push("");
         lines.push("---");
         lines.push(`📊 **검수 결과 누적**: ${bufferSize()}건 — 검수가 끝났다면 사용자에게 **\"엑셀로 추출할까요?\"** 라고 물어보고, 원하면 \`export_validation_excel\` 도구를 호출하세요.`);
@@ -843,7 +860,8 @@ export function registerAllTools(server, store) {
             path: z
                 .string()
                 .optional()
-                .describe("저장할 파일 경로(절대 경로 권장). 미지정 시 %USERPROFILE%/Downloads/payco-validation-{timestamp}.xlsx 에 저장."),
+                .describe("저장할 파일 이름(선택, 예: '검수결과'). 항상 사용자의 다운로드 폴더에 저장되며 폴더 경로는 무시된다. " +
+                "같은 이름이 있으면 덮어쓰지 않고 ' (2)' 를 붙인다. 미지정 시 payco-validation-{timestamp}.xlsx."),
             clearAfter: z
                 .boolean()
                 .optional()
@@ -855,7 +873,7 @@ export function registerAllTools(server, store) {
             return notFound("누적된 검수 결과가 없습니다. 먼저 validate_payload 로 1건 이상 검수를 수행하세요.");
         }
         try {
-            const { path: outPath, recordCount, rowCount } = await exportValidationToExcel(records, path);
+            const { path: outPath, recordCount, rowCount, notes } = await exportValidationToExcel(records, path);
             const cleared = clearAfter ? clearAllRecords() : 0;
             const lines = [];
             lines.push(`✅ 엑셀 추출 완료`);
@@ -864,6 +882,8 @@ export function registerAllTools(server, store) {
             lines.push(`- 포함 검수 건수: ${recordCount}건`);
             lines.push(`- 항목별 상세 행 수: ${rowCount}행`);
             lines.push(`- 시트: 검수요약 / 항목별 상세 / 공통검수체크리스트 (3개)`);
+            for (const n of notes)
+                lines.push(`- 안내: ${n}`);
             if (clearAfter) {
                 lines.push(`- 추출 후 버퍼 초기화: ${cleared}건 삭제됨`);
             }
@@ -871,7 +891,7 @@ export function registerAllTools(server, store) {
                 lines.push(`- 누적 버퍼 유지 (다음 검수 결과도 동일 버퍼에 누적됨)`);
             }
             lines.push("");
-            lines.push("Windows 탐색기에서 위 경로를 열어 결과를 확인하세요.");
+            lines.push("다운로드 폴더에서 위 파일을 열어 결과를 확인하세요.");
             return text(lines.join("\n"));
         }
         catch (e) {
@@ -891,7 +911,8 @@ export function registerAllTools(server, store) {
     server.registerTool("get_error_code", {
         title: "에러코드/코드값 조회",
         description: "PAYCO 코드정리 표에서 특정 코드 값을 조회. API 응답코드(1000, 4802...), " +
-            "결제수단/주문유형/카드사/은행코드 등 모든 코드 카테고리를 한번에 검색.",
+            "결제수단/주문유형/카드사/은행코드 등 모든 코드 카테고리를 한번에 검색. " +
+            "같은 코드가 서비스마다 다른 뜻일 수 있으므로 결과의 [서비스 > 코드표] 표시로 구분해 답할 것.",
         inputSchema: {
             code: z
                 .string()
@@ -899,11 +920,13 @@ export function registerAllTools(server, store) {
                 .describe("조회할 코드 (예: '1000', 'CHECKOUT', 'CCBC', '02')"),
         },
     }, async ({ code }) => {
+        // 같은 코드가 서비스마다 다른 뜻일 수 있어(예: 1001 온라인/오프라인) 서비스명을 함께 표시
+        const where = (cat) => `${SERVICE_LABELS[cat.root] ?? cat.root} > ${cat.title}`;
         const hits = [];
         for (const cat of store.errorCodes.categories) {
             const found = cat.items.find((it) => it.code === code);
             if (found) {
-                hits.push(`[${cat.title}] ${found.code} = ${found.description}`);
+                hits.push(`[${where(cat)}] ${found.code} = ${found.description}`);
             }
         }
         if (hits.length === 0) {
@@ -911,7 +934,7 @@ export function registerAllTools(server, store) {
             for (const cat of store.errorCodes.categories) {
                 for (const it of cat.items) {
                     if (it.code.startsWith(code) || it.description.includes(code)) {
-                        partial.push(`[${cat.title}] ${it.code} = ${it.description}`);
+                        partial.push(`[${where(cat)}] ${it.code} = ${it.description}`);
                         if (partial.length >= 10)
                             break;
                     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nhnpayco-dev/mcp-devcenter",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "PAYCO 개발자센터 가이드 전체(온라인·오프라인·오더·멤버십·결제정산) 를 AI 개발 도구에서 바로 조회·검색할 수 있게 해주는 MCP 서버 (PAYCO Developer Center integration guide MCP server for Claude, Cursor and AI agents)",
   "type": "module",
   "bin": {
@@ -64,5 +64,8 @@
   "homepage": "https://devcenter.payco.com",
   "bugs": {
     "email": "dl_payco_ts@nhn.com"
+  },
+  "overrides": {
+    "uuid": "^11.1.1"
   }
 }