@portone/mcp-server 0.14.0 → 0.15.0-alpha.0

package/server/index.js

@@ -15,7 +15,7 @@ import { GraphQLClient } from "graphql-request";
 // package.json
 var package_default = {
   name: "@portone/mcp-server",
-  version: "0.14.0",
+  version: "0.15.0-alpha.0",
   description: "\uD3EC\uD2B8\uC6D0 \uC0AC\uC6A9\uC790\uB97C \uC704\uD55C MCP (Model Context Protocol) \uC11C\uBC84\uC785\uB2C8\uB2E4. \uD3EC\uD2B8\uC6D0 \uAC1C\uBC1C\uC790\uC13C\uD130, \uD5EC\uD504\uC13C\uD130 \uB4F1 \uACF5\uC2DD \uBB38\uC11C \uB0B4\uC6A9\uC744 LLM(Large Language Model)\uC5D0 \uC81C\uACF5\uD574 \uC815\uD655\uD55C \uC815\uBCF4\uB97C \uBC14\uD0D5\uC73C\uB85C \uC0AC\uC6A9\uC790\uC758 \uC5F0\uB3D9 \uBC0F \uC9C8\uC758\uB97C \uB3D5\uB3C4\uB85D \uD569\uB2C8\uB2E4.",
   main: "server/index.js",
   type: "module",
@@ -24,10 +24,10 @@ var package_default = {
   },
   scripts: {
     test: "vitest",
-    "update-docs": "node --experimental-strip-types update-docs.ts",
+    "update-docs": "node update-docs.ts",
     build: "tsup src/index.ts --outDir server --format esm",
-    "build:dxt": "node --experimental-strip-types scripts/build-dxt.ts",
-    dev: "node --experimental-strip-types src/index.ts",
+    "build:dxt": "node scripts/build-dxt.ts",
+    dev: "node src/index.ts",
     start: "node server/index.js",
     lint: "biome check .",
     format: "biome format --write .",
@@ -45,31 +45,31 @@ var package_default = {
   },
   license: "MIT OR Apache-2.0",
   dependencies: {
-    "@modelcontextprotocol/sdk": "^1.15.0",
-    "@portone/server-sdk": "^0.15.0",
-    axios: "^1.7.2",
+    "@modelcontextprotocol/sdk": "^1.20.0",
+    "@portone/server-sdk": "^0.17.0",
+    axios: "^1.12.2",
     graphql: "^16.11.0",
     "graphql-request": "^7.2.0",
     "gray-matter": "^4.0.3",
-    h3: "2.0.0-beta.1",
+    h3: "2.0.1-rc.2",
     "js-yaml": "^4.1.0",
     open: "^10.2.0",
-    "ts-pattern": "^5.7.1",
+    "ts-pattern": "^5.8.0",
     zod: "^3.25.75"
   },
-  packageManager: "pnpm@10.13.1+sha512.37ebf1a5c7a30d5fabe0c5df44ee8da4c965ca0c5af3dbab28c3a1681b70a256218d05c81c9c0dcf767ef6b8551eb5b960042b9ed4300c59242336377e01cfad",
+  packageManager: "pnpm@10.20.0+sha512.cf9998222162dd85864d0a8102e7892e7ba4ceadebbf5a31f9c2fce48dfce317a9c53b9f6464d1ef9042cba2e02ae02a9f7c143a2b438cd93c91840f0192b9dd",
   devDependencies: {
-    "@biomejs/biome": "2.0.6",
-    "@changesets/cli": "^2.29.5",
+    "@biomejs/biome": "2.2.6",
+    "@changesets/cli": "^2.29.7",
     "@types/js-yaml": "^4.0.9",
-    "@types/node": "^24.0.10",
+    "@types/node": "^22.18.10",
     tsup: "^8.5.0",
-    "type-fest": "^4.41.0",
-    typescript: "^5.8.3",
-    vitest: "^1.6.0"
+    "type-fest": "^5.1.0",
+    typescript: "^5.9.3",
+    vitest: "^3.2.4"
   },
   engines: {
-    node: ">=22.6.0"
+    node: ">=22.18.0"
   },
   files: [
     "server",
@@ -79,10 +79,7 @@ var package_default = {
     "LICENSE-MIT",
     "README.md"
   ],
-  repository: {
-    type: "git",
-    url: "https://github.com/portone-io/portone-mcp-server.git"
-  }
+  repository: "github:portone-io/mcp-server"
 };
 
 // src/loader/index.ts
@@ -1732,7 +1729,6 @@ import z11 from "zod";
 // src/tools/utils/markdown.ts
 function formatDocumentMetadata(doc) {
   const lines = [];
-  lines.push(`\uD30C\uC77C: ${doc.path}`);
   if (doc.frontmatter) {
     if (doc.frontmatter.title) {
       lines.push(`\uC81C\uBAA9: ${doc.frontmatter.title}`);
@@ -1751,40 +1747,44 @@ function formatDocumentMetadata(doc) {
 var name5 = "listPortoneDocs";
 var config5 = {
   title: "\uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uBAA9\uB85D \uC870\uD68C",
-  description: `\uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uBAA9\uB85D\uC744 \uCE74\uD14C\uACE0\uB9AC\uBCC4\uB85C \uD544\uD130\uB9C1\uD558\uC5EC \uC870\uD68C\uD569\uB2C8\uB2E4.
+  description: `\uD2B9\uC815 \uACBD\uB85C \uD558\uC704\uC5D0 \uC788\uB294 \uBAA8\uB4E0 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uBAA9\uB85D\uC744 \uD2B8\uB9AC \uD615\uD0DC\uB85C \uC870\uD68C\uD569\uB2C8\uB2E4.
 \uBAA9\uB85D\uC5D0\uB294 \uBB38\uC11C \uACBD\uB85C, \uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804 \uB4F1 \uCD95\uC57D\uB41C \uBB38\uC11C \uC815\uBCF4\uAC00 \uD3EC\uD568\uB418\uC5B4 \uC788\uC2B5\uB2C8\uB2E4.
 
 Returns:
-  \uD544\uD130\uB9C1\uB41C \uBB38\uC11C \uBAA9\uB85D (\uAC01 \uBB38\uC758 \uACBD\uB85C, \uAE38\uC774, \uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804 \uB4F1)`,
+  \uD544\uD130\uB9C1\uB41C \uBB38\uC11C \uBAA9\uB85D (\uAC01 \uBB38\uC11C\uC758 \uD30C\uC77C\uBA85, \uAE38\uC774, \uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804 \uB4F1)
+
+Note:
+  \uBB38\uC11C \uBAA9\uB85D\uC740 \uB300\uB7C9\uC758 \uB370\uC774\uD130\uC774\uBBC0\uB85C \uC0C1\uC704 \uB514\uB809\uD1A0\uB9AC\uB97C \uC870\uD68C\uD560 \uACBD\uC6B0 omitFiles\uB97C true\uB85C \uC124\uC815\uD569\uB2C8\uB2E4.`,
   inputSchema: {
-    dev_docs: z11.boolean().default(true).describe(
-      "\uAC1C\uBC1C\uC790\uB97C \uC704\uD55C \uBB38\uC11C \uD3EC\uD568 \uC5EC\uBD80 (blog/, release-notes/, help/\uB85C \uC2DC\uC791\uD558\uC9C0 \uC54A\uB294 \uBAA8\uB4E0 \uBB38\uC11C)"
+    paths: z11.string().array().default([]).describe(
+      "\uD558\uC704 \uBAA9\uB85D\uC744 \uC870\uD68C\uD560 \uACBD\uB85C\uB4E4\uC785\uB2C8\uB2E4. \uBBF8\uC785\uB825 \uC2DC \uC804\uCCB4 \uBAA9\uB85D\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4."
     ),
-    tech_blog: z11.boolean().default(false).describe("\uAE30\uC220 \uBE14\uB85C\uADF8 \uD3EC\uC2A4\uD2B8 (blog/) \uD3EC\uD568 \uC5EC\uBD80"),
-    release_notes: z11.boolean().default(false).describe("\uAC1C\uBC1C\uC790\uC13C\uD130 \uB9B4\uB9AC\uC988 \uB178\uD2B8 (release-notes/) \uD3EC\uD568 \uC5EC\uBD80"),
-    help_docs: z11.boolean().default(true).describe(
-      "\uAC1C\uBC1C\uACFC \uBB34\uAD00\uD558\uAC8C \uC11C\uBE44\uC2A4 \uAD00\uB828 \uB0B4\uC6A9\uC744 \uC77C\uBC18\uC801\uC73C\uB85C \uB2F4\uB294 \uD5EC\uD504\uC13C\uD130 \uBB38\uC11C (help/) \uD3EC\uD568 \uC5EC\uBD80"
+    onlyPaths: z11.boolean().default(false).describe(
+      "true\uC778 \uACBD\uC6B0 \uBB38\uC11C\uB97C \uC81C\uC678\uD55C \uB514\uB809\uD1A0\uB9AC \uBAA9\uB85D\uB9CC \uD45C\uC2DC\uD558\uACE0, \uB514\uB809\uD1A0\uB9AC \uD558\uC704\uC5D0 readme.md\uAC00 \uC788\uB294 \uACBD\uC6B0 \uD574\uB2F9 \uD30C\uC77C\uC758 \uC124\uBA85\uC744 \uD45C\uC2DC\uD569\uB2C8\uB2E4."
     )
   }
 };
 function init5(documents) {
-  return ({ dev_docs, help_docs, tech_blog, release_notes }) => {
+  return ({ paths, onlyPaths }) => {
     const { markdownDocs } = documents;
     const filteredDocs = [];
+    const docTree = /* @__PURE__ */ new Map();
     for (const [path, doc] of Object.entries(markdownDocs)) {
-      if (tech_blog && path.startsWith("blog/")) {
-        filteredDocs.push(doc);
-      }
-      if (release_notes && path.startsWith("release-notes/")) {
-        filteredDocs.push(doc);
-      }
-      if (help_docs && path.startsWith("help/")) {
-        filteredDocs.push(doc);
-      }
-      if (dev_docs && !["blog/", "release-notes/", "help/"].some(
-        (prefix) => path.startsWith(prefix)
-      )) {
-        filteredDocs.push(doc);
+      const isSubpath = paths.length === 0 || paths.some((searchPath) => path.startsWith(searchPath));
+      if (!isSubpath) continue;
+      filteredDocs.push(doc);
+      let treeNode = docTree;
+      const components = path.split("/");
+      if (onlyPaths) components.pop();
+      for (const pathComp of components) {
+        const child = treeNode.get(pathComp);
+        if (child) {
+          treeNode = child;
+        } else {
+          const newChild = /* @__PURE__ */ new Map();
+          treeNode.set(pathComp, newChild);
+          treeNode = newChild;
+        }
       }
     }
     if (filteredDocs.length === 0) {
@@ -1797,12 +1797,41 @@ function init5(documents) {
         ]
       };
     }
-    const formattedResult = filteredDocs.map((doc) => formatDocumentMetadata(doc)).join("\n---\n");
+    const treeLines = [];
+    for (const rootPath of Array.from(docTree.keys()).sort()) {
+      const rootNode = docTree.get(rootPath);
+      if (rootNode) formatTree(0, rootPath, rootPath, rootNode);
+    }
+    function formatTree(level, path, filename, node) {
+      const indent = "  ".repeat(level);
+      treeLines.push(`${indent}${filename}`);
+      const docs = markdownDocs[path];
+      if (docs) {
+        const metadata = formatDocumentMetadata(docs).trim();
+        if (metadata.length > 0) {
+          treeLines.push(metadata);
+        }
+      }
+      if (onlyPaths) {
+        const readme = markdownDocs[`${path}/readme.md`];
+        if (readme) {
+          const metadata = formatDocumentMetadata(readme).trim();
+          if (metadata.length > 0) {
+            treeLines.push(metadata);
+          }
+        }
+      }
+      for (const child of Array.from(node.keys()).sort()) {
+        const childNode = node.get(child);
+        if (childNode)
+          formatTree(level + 1, `${path}/${child}`, child, childNode);
+      }
+    }
     return {
       content: [
         {
           type: "text",
-          text: formattedResult
+          text: treeLines.join("\n")
         }
       ]
     };
@@ -1955,10 +1984,10 @@ __export(readDoc_exports, {
 import z14 from "zod";
 var name8 = "readPortoneDoc";
 var OutputSchema7 = z14.object({
-  content: z14.string().optional().describe("\uCC3E\uC740 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9"),
-  metadata: z14.string().optional().describe("\uCC3E\uC740 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uBA54\uD0C0 \uC815\uBCF4"),
-  url: z14.string().optional().describe("\uBB38\uC11C\uB97C \uC6F9\uC73C\uB85C \uC811\uADFC \uAC00\uB2A5\uD55C \uB9C1\uD06C")
-});
+  content: z14.string().describe("\uCC3E\uC740 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9"),
+  metadata: z14.string().describe("\uCC3E\uC740 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uBA54\uD0C0 \uC815\uBCF4"),
+  url: z14.string().describe("\uBB38\uC11C\uB97C \uC6F9\uC73C\uB85C \uC811\uADFC \uAC00\uB2A5\uD55C \uB9C1\uD06C")
+}).partial();
 var config8 = {
   title: "\uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uC77D\uAE30",
   description: `\uD3EC\uD2B8\uC6D0 \uAC1C\uBCC4 \uBB38\uC11C\uC758 \uACBD\uB85C\uB97C \uD1B5\uD574 \uD574\uB2F9 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9, \uBA54\uD0C0 \uC815\uBCF4(\uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804 \uB4F1), \uC6F9\uC73C\uB85C \uC811\uADFC \uAC00\uB2A5\uD55C \uB9C1\uD06C\uB97C \uAC00\uC838\uC635\uB2C8\uB2E4.
@@ -1968,12 +1997,14 @@ Note:
   \uADF8 \uC911 \uC6D0\uD558\uB294 \uBB38\uC11C\uC758 path\uB97C readPortoneDoc\uC5D0 \uC804\uB2EC\uD558\uC5EC \uB0B4\uC6A9\uC744 \uD655\uC778\uD560 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`,
   inputSchema: {
     path: z14.string().describe("\uC77D\uC744 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uACBD\uB85C"),
-    fields: OutputSchema7.keyof().array().describe("\uBC1B\uC744 \uD544\uB4DC \uBAA9\uB85D")
+    fields: OutputSchema7.keyof().array().describe("\uBC1B\uC744 \uD544\uB4DC \uBAA9\uB85D"),
+    startIndex: z14.number().optional().describe("\uC77D\uC5B4\uC62C \uBC94\uC704 \uC2DC\uC791 \uC778\uB371\uC2A4. \uBBF8\uC124\uC815 \uC2DC \uCC98\uC74C\uBD80\uD130 \uC77D\uC5B4\uC635\uB2C8\uB2E4."),
+    endIndex: z14.number().optional().describe("\uC77D\uC5B4\uC62C \uBC94\uC704 \uB05D \uC778\uB371\uC2A4. \uBBF8\uC124\uC815 \uC2DC \uB05D\uAE4C\uC9C0 \uC77D\uC5B4\uC635\uB2C8\uB2E4.")
   },
   outputSchema: OutputSchema7.shape
 };
 function init8(documents) {
-  return ({ path, fields }) => {
+  return ({ path, fields, startIndex, endIndex }) => {
     const { markdownDocs } = documents;
     const doc = markdownDocs[path];
     if (!doc) {
@@ -1990,7 +2021,7 @@ function init8(documents) {
     const structuredContent = filterFields(
       fields,
       {
-        content: doc.content,
+        content: doc.content.slice(startIndex, endIndex),
         metadata: formatDocumentMetadata(doc),
         url: docPathToUrl(doc.path)
       }
@@ -2207,17 +2238,13 @@ function init10(schema) {
     try {
       const pruned_data = pruneYaml(schemaData, 3);
       const yamlOutput = stringifyYaml(pruned_data);
-      const structuredContent = {
-        result: yamlOutput
-      };
       return {
         content: [
           {
             type: "text",
-            text: JSON.stringify(structuredContent, null, 2)
+            text: yamlOutput
           }
-        ],
-        structuredContent
+        ]
       };
     } catch (error) {
       return {
@@ -2509,56 +2536,71 @@ ${searchableText}`;
 }
 
 // src/tools/regexSearch.ts
-var name13 = "regex_search_portone_docs";
+var name13 = "regexSearchPortoneDocs";
 var config13 = {
   title: "\uD3EC\uD2B8\uC6D0 \uBB38\uC11C \uC815\uADDC\uD45C\uD604\uC2DD \uAC80\uC0C9",
-  description: `\uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9 \uC911 Node.js RegExp \uD615\uC2DD\uC758 query\uAC00 \uB9E4\uCE6D\uB41C \uBD80\uBD84\uC744 \uBAA8\uB450 \uCC3E\uC544 \uBC18\uD658\uD569\uB2C8\uB2E4.
+  description: `\uD2B9\uC815 \uACBD\uB85C \uD558\uC704\uC758 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uC758 \uB0B4\uC6A9 \uC911 Node.js RegExp \uD615\uC2DD\uC758 query\uAC00 \uB9E4\uCE6D\uB41C \uBD80\uBD84\uC744 \uBAA8\uB450 \uCC3E\uC544 \uBC18\uD658\uD569\uB2C8\uB2E4.
 \uC815\uADDC\uC2DD \uAE30\uBC18\uC73C\uB85C \uAD00\uB828 \uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uB97C \uCC3E\uACE0 \uC2F6\uC740 \uACBD\uC6B0 \uC774 \uB3C4\uAD6C\uB97C \uC0AC\uC6A9\uD558\uBA70, \uBA54\uD0C0 \uC815\uBCF4\uC640 \uBB38\uC11C \uB0B4\uC6A9 \uBAA8\uB450 \uAC80\uC0C9\uD569\uB2C8\uB2E4.`,
   inputSchema: {
+    paths: z19.string().array().optional().describe(
+      "\uC124\uC815 \uC2DC \uC774 \uACBD\uB85C\uB97C \uC811\uB450\uC0AC\uB85C \uAC00\uC9C0\uB294 \uBB38\uC11C\uC5D0\uC11C\uB9CC \uAC80\uC0C9\uC744 \uC218\uD589\uD569\uB2C8\uB2E4. \uC608\uB97C \uB4E4\uC5B4 OPI \uBB38\uC11C\uC758 \uACBD\uC6B0 opi/\uB97C \uC785\uB825\uD569\uB2C8\uB2E4."
+    ),
     query: z19.string().describe(`Node.js RegExp \uD615\uC2DD\uC758 \uBB38\uC790\uC5F4\uC744 \uC785\uB825\uD574\uC57C \uD558\uBA70, \uC601\uC5B4 \uC54C\uD30C\uBCB3 \uB300\uC18C\uBB38\uC790\uB294 \uAD6C\uBD84 \uC5C6\uC774 \uB9E4\uCE6D\uB429\uB2C8\uB2E4.
 \uC808\uB300 query\uC5D0 \uACF5\uBC31\uC744 \uD3EC\uD568\uC2DC\uD0A4\uC9C0 \uB9C8\uC138\uC694. \uC5EC\uB7EC \uD0A4\uC6CC\uB4DC\uB97C \uD55C \uBC88\uC5D0 \uAC80\uC0C9\uD558\uACE0 \uC2F6\uB2E4\uBA74, \uACF5\uBC31 \uB300\uC2E0 | \uC5F0\uC0B0\uC790\uB97C \uC0AC\uC6A9\uD558\uC5EC \uAD6C\uBD84\uD569\uB2C8\uB2E4.
 \uB2E8\uC5B4 \uAE00\uC790 \uC0AC\uC774\uC5D0 \uACF5\uBC31\uC774 \uC788\uB294 \uACBD\uC6B0\uB3C4 \uB9E4\uCE6D\uD558\uACE0 \uC2F6\uB2E4\uBA74, \uACF5\uBC31 \uB300\uC2E0 \\s*\uB97C \uC0AC\uC6A9\uD558\uC138\uC694.`),
-    context_size: z19.number().describe(`\uAC80\uC0C9 \uACB0\uACFC\uC758 \uCEE8\uD14D\uC2A4\uD2B8 \uD06C\uAE30\uB85C, \uBB38\uC790 \uC218\uB97C \uAE30\uC900\uC73C\uB85C \uD569\uB2C8\uB2E4.
+    contextSize: z19.number().default(0).describe(`0\uBCF4\uB2E4 \uD070 \uAC12\uC744 \uC124\uC815\uD560 \uACBD\uC6B0, \uAC80\uC0C9 \uACB0\uACFC\uC758 \uCEE8\uD14D\uC2A4\uD2B8 \uD06C\uAE30\uB85C, \uBB38\uC790 \uC218\uB97C \uAE30\uC900\uC73C\uB85C \uD569\uB2C8\uB2E4. 0 \uB610\uB294 50 \uC815\uB3C4\uB97C \uCD94\uCC9C\uD569\uB2C8\uB2E4.
 query \uB9E4\uCE58\uAC00 \uBC1C\uACAC\uB41C \uC2DC\uC791 \uC778\uB371\uC2A4\uB97C idx\uB77C\uACE0 \uD560 \uB54C,
-max(0, idx - context_size)\uBD80\uD130 min(contentLength, idx + len(query) + context_size) - 1\uAE4C\uC9C0\uC758 \uB0B4\uC6A9\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4.
+max(0, idx - contextSize)\uBD80\uD130 min(contentLength, idx + len(query) + contextSize) - 1\uAE4C\uC9C0\uC758 \uB0B4\uC6A9\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4.
 \uB2E8, \uC774\uC804 \uAC80\uC0C9\uACB0\uACFC\uC640 \uACB9\uCE58\uB294 \uCEE8\uD14D\uC2A4\uD2B8\uB294 \uBCD1\uD569\uB418\uC5B4 \uBC18\uD658\uB429\uB2C8\uB2E4.`),
-    limit: z19.number().default(5e4).describe(`\uBC18\uD658\uD560 \uCD5C\uB300 \uBB38\uC790\uC5F4 \uAE38\uC774\uC785\uB2C8\uB2E4. \uAE30\uBCF8\uAC12\uC740 50000\uC785\uB2C8\uB2E4.
-\uCD9C\uB825\uC774 \uC774 \uAE38\uC774\uB97C \uCD08\uACFC\uD558\uBA74 \uC798\uB9AC\uACE0 truncation \uBA54\uC2DC\uC9C0\uAC00 \uCD94\uAC00\uB429\uB2C8\uB2E4.`),
-    start_index: z19.number().default(0).describe(`\uACB0\uACFC \uBB38\uC790\uC5F4\uC758 \uD398\uC774\uC9C0\uB124\uC774\uC158\uC744 \uC704\uD55C \uC2DC\uC791 \uC778\uB371\uC2A4\uC785\uB2C8\uB2E4. \uAE30\uBCF8\uAC12\uC740 0\uC785\uB2C8\uB2E4.
-\uC804\uCCB4 \uACB0\uACFC \uBB38\uC790\uC5F4\uC5D0\uC11C start_index \uC704\uCE58\uBD80\uD130 limit \uAE38\uC774\uB9CC\uD07C\uC758 \uBD80\uBD84 \uBB38\uC790\uC5F4\uC744 \uBC18\uD658\uD569\uB2C8\uB2E4.
-\uB3D9\uC77C\uD55C query, context_size\uB85C \uB2E4\uB978 start_index\uB97C \uC0AC\uC6A9\uD574 \uB2E4\uC74C \uACB0\uACFC\uB97C \uC5BB\uC744 \uC218 \uC788\uC2B5\uB2C8\uB2E4.`)
+    limit: z19.number().default(1e3).describe(
+      `\uBC18\uD658\uD560 \uCD5C\uB300 \uBB38\uC790\uC5F4 \uAE38\uC774\uC785\uB2C8\uB2E4. \uCD9C\uB825\uC774 \uC774 \uAE38\uC774\uB97C \uCD08\uACFC\uD558\uBA74 \uC798\uB9AC\uACE0 truncation \uBA54\uC2DC\uC9C0\uAC00 \uCD94\uAC00\uB429\uB2C8\uB2E4.`
+    ),
+    page: z19.number().default(0).describe(
+      `\uACB0\uACFC \uBB38\uC790\uC5F4\uC758 \uD398\uC774\uC9C0\uB124\uC774\uC158\uC744 \uC704\uD55C \uC2DC\uC791 \uC778\uB371\uC2A4\uC785\uB2C8\uB2E4. \uD55C \uD398\uC774\uC9C0\uC758 \uAE00\uC790 \uC218\uB294 limit \uC785\uB2C8\uB2E4.`
+    ),
+    showMetadata: z19.boolean().default(false).describe(
+      "true\uC774\uBA74 \uBB38\uC11C\uC758 \uBA54\uD0C0\uB370\uC774\uD130(\uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804)\uC744 \uACB0\uACFC\uC5D0 \uD3EC\uD568\uD569\uB2C8\uB2E4."
+    )
   },
   outputSchema: {
     result: z19.string().describe(
-      `\uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uB97C \uCC3E\uC73C\uBA74 \uD574\uB2F9 \uBB38\uC11C\uC758 \uACBD\uB85C\uC640 \uAE38\uC774, \uC81C\uBAA9, \uC124\uBA85, \uB300\uC0C1 \uBC84\uC804\uACFC \uD568\uAED8, query\uAC00 \uB9E4\uCE6D\uB41C \uC8FC\uBCC0 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.`
+      `\uD3EC\uD2B8\uC6D0 \uBB38\uC11C\uB97C \uCC3E\uC73C\uBA74 \uD574\uB2F9 \uBB38\uC11C\uC758 \uACBD\uB85C\uC640 \uAE38\uC774, \uBA54\uD0C0\uB370\uC774\uD130, query\uAC00 \uB9E4\uCE6D\uB41C \uC8FC\uBCC0 \uCEE8\uD14D\uC2A4\uD2B8\uB97C \uBC18\uD658\uD569\uB2C8\uB2E4.`
     )
   }
 };
 function formatOccurrence(occurrence) {
+  if (occurrence.context.length === 0)
+    return `\`\`\`txt startIndex=${occurrence.startIndex} endIndex=${occurrence.endIndex}\`\`\`
+`;
   return `\`\`\`txt startIndex=${occurrence.startIndex} endIndex=${occurrence.endIndex}
 ${occurrence.context}
 \`\`\`
 `;
 }
 function init13(documents) {
-  return ({ query, context_size, start_index, limit }) => {
+  return ({ paths, query, contextSize, page, limit, showMetadata }) => {
     const { markdownDocs } = documents;
     let occurrenceCount = 0;
     let docCount = 0;
     let result = "";
+    const filteredDocs = paths == null ? markdownDocs : Object.fromEntries(
+      Object.entries(markdownDocs).filter(
+        ([path]) => paths.some((searchPath) => path.startsWith(searchPath))
+      )
+    );
     try {
-      const bm25Scores = calculateBm25Scores(query, markdownDocs);
+      const bm25Scores = calculateBm25Scores(query, filteredDocs);
       for (const [path, _score] of bm25Scores) {
         const doc = markdownDocs[path];
         const contentLen = doc.content.length;
         const occurrences = [];
         let lastContextEnd = 0;
         if (doc.frontmatter && JSON.stringify(doc.frontmatter).match(new RegExp(query, "i"))) {
-          lastContextEnd = Math.min(contentLen, context_size);
+          lastContextEnd = Math.min(contentLen, contextSize);
           occurrences.push({
             startIndex: 0,
             endIndex: lastContextEnd,
-            context: doc.content.substring(0, lastContextEnd)
+            context: contextSize === 0 ? "" : doc.content.substring(0, lastContextEnd)
           });
         }
         const regex = new RegExp(query, "gi");
@@ -2570,23 +2612,20 @@ function init13(documents) {
           }
           const idx = match7.index;
           const matchLen = match7[0].length;
-          const contextStart = Math.max(0, idx - context_size);
-          const contextEnd = Math.min(
-            contentLen,
-            idx + matchLen + context_size
-          );
+          const contextStart = Math.max(0, idx - contextSize);
+          const contextEnd = Math.min(contentLen, idx + matchLen + contextSize);
           if (contextStart < lastContextEnd) {
             const newOccurrence = {
               startIndex: occurrences[occurrences.length - 1].startIndex,
               endIndex: contextEnd,
-              context: doc.content.substring(
+              context: contextSize === 0 ? "" : doc.content.substring(
                 occurrences[occurrences.length - 1].startIndex,
                 contextEnd
               )
             };
             occurrences[occurrences.length - 1] = newOccurrence;
           } else {
-            const context = doc.content.substring(contextStart, contextEnd);
+            const context = contextSize === 0 ? "" : doc.content.substring(contextStart, contextEnd);
             occurrences.push({
               startIndex: contextStart,
               endIndex: contextEnd,
@@ -2598,9 +2637,11 @@ function init13(documents) {
         if (occurrences.length > 0) {
           docCount++;
           occurrenceCount += occurrences.length;
-          result += "---\n";
-          result += formatDocumentMetadata(doc);
-          result += "---\n";
+          result += doc.path;
+          result += "\n";
+          if (showMetadata) {
+            result += formatDocumentMetadata(doc);
+          }
           for (const occurrence of occurrences) {
             result += formatOccurrence(occurrence);
           }
@@ -2621,48 +2662,45 @@ function init13(documents) {
         let fullResult = `${docCount} documents and ${occurrenceCount} occurrences found with query '${query}'
 
 ${result}`;
-        if (start_index > 0) {
-          if (start_index >= fullResult.length) {
+        if (page > 0) {
+          const offset = page * limit;
+          if (offset >= fullResult.length) {
             return {
               content: [
                 {
                   type: "text",
-                  text: `No more results. Total result length: ${fullResult.length}`
+                  text: `No more results. Total page count: ${Math.ceil(fullResult.length / limit)}`
                 }
               ],
               isError: true
             };
           }
-          fullResult = fullResult.substring(start_index);
+          fullResult = fullResult.substring(offset);
         }
         if (fullResult.length > limit) {
           const truncationMsg = `
 
-... (output truncated due to length limit. Use start_index=${start_index + limit} for next page)`;
-          const structuredContent2 = {
+... (output truncated due to length limit. Use page: ${page + 1} for next page)`;
+          const structuredContent = {
             result: fullResult.substring(0, limit) + truncationMsg
           };
           return {
             content: [
               {
                 type: "text",
-                text: JSON.stringify(structuredContent2, null, 2)
+                text: JSON.stringify(structuredContent, null, 2)
               }
             ],
-            structuredContent: structuredContent2
+            structuredContent
           };
         }
-        const structuredContent = {
-          result: fullResult
-        };
         return {
           content: [
             {
               type: "text",
-              text: JSON.stringify(structuredContent, null, 2)
+              text: fullResult
             }
-          ],
-          structuredContent
+          ]
         };
       }
     } catch (error) {

package/assets/docs/help/admin-console/platform-settlement/content33-1.md

@@ -1,201 +0,0 @@
----
-title: 파트너 정산 자동화 서비스 가이드 2
-category: 관리자콘솔 (관리자콘솔 사용 가이드) > 파트너 정산 자동화 > 파트너 정산 자동화
-seo:
-  title: 파트너 정산 자동화 가이드
-  description: >-
-    재무, 개발 공수를 획기적으로 줄여주는 포트원의 파트너정산 자동화 서비스를 소개합니다. 간단한 API 연동과 관리자 콘솔을 통해 고객사
-    자체 개발에 드는 많은 비용과 시간의 절감이 가능합니다.
-  keywords:
-    - 관리자콘솔
-    - 파트너정산자동화
-    - 파트너정산
-tags:
-  - 공통
-  - 파트너 정산 자동화
-pgCompanies:
-  - 공통
-searchTags:
-  - 파트너계약
-  - 정산정책
-  - 할인수수료정책
-  - 할인수수료
-  - 수수료등록
-  - 추가수수료정책
-  - 수식관리
-  - 파트너관리
-  - 파트너추가
-  - 정산내역
-  - 할인분담금
-  - 할인정책
-  - 파트너분담률
-  - 하위정산
-  - 정산자동화
-  - pg지급이체
-  - 지급이체
-  - 매출정산자동화
-  - 파트너정산
-  - 파트너 정산
-  - 정산
-  - 파트너 정산 자동화
-datetime: 2025-06-18T07:47:13.455Z
----
-
-### **서비스 소개**
-
-#### **1. 요약**
-
-파트너 정산 자동화 서비스는 플랫폼, 마켓 플레이스, 커머스 사업을 위한 포트원만의 재무 서비스 모듈로 국내 최초로 개발되었습니다. 파트너에게 지급되어야 하는 정산 금액을 자동으로 계산하고 세금계산서, 송금(지급이체)까지 자동화함으로써 재무팀과, 운영팀, 개발팀 모두의 리소스를 획기적으로 절감할 수 있습니다. API 연동 및 포트원 관리자 콘솔을 통한 노코드 연동 모두 지원됩니다.
-
-#### **2. 핵심 기능**
-
-1. 개인 및 사업자 유형에 따라 다양한 정산 정책을 등록하고 관리할 수 있습니다.
-2. 파트너를 대량으로 등록하고 손쉽게 관리할 수 있습니다.
-3. 파트너별 정산 정책을 자동으로 매칭시켜서 정산 주기에 맞게 정산금을 자동으로 계산합니다.
-4. 사업자 대상 세금계산서 역발행 요청 기능을 제공합니다.
-5. 계산된 정산금을 클릭 한 번으로 송금 및 이체 처리할 수 있습니다.
-6. 가상계좌의 입출금 내역을 실시간으로 확인할 수 있습니다.
-
-#### **3. 용어 설명**
-
-- 정산 서비스 이용에 참고하실 수 있는 [용어별 설명 가이드 보러가기↗](https://developers.portone.io/platform/guides/dictionary)를 안내드립니다.
-
-### 상세 이용 가이드
-
-
-
-#### 1. 정산정책관리
-
-<Tag text="계약관리" />
-
-**자동으로 정산데이터가 생성될 수 있도록 계약을 추가해주세요.**
-
-- **중개수수료 설정**
-  - 정률 (%) / 정액 (₩) 선택하여 설정가능
-  - 부가세를 파트너에서 부담할지 설정가능
-- **정산주기 설정**
-  - 지체일 : 매출 1일, 정산 2일
-    - 매출(결제)이 발생된 이후 홀드하고 있어야 하는 기간
-  - 정산일 주기 설정
-    - 매월 / 매주 / 매일 / 매년
-    - N일 정산
-  - **기준일 설정**
-    - 전 영업일 / 후 영업일 / 달력일 중 선택가능
-  - **아이디 생성 및 메모**
-    - 아이디 생성 : 설정하신 계약에 대한 아이디를 부여합니다. 원하는 아이디로 설정하거나, 난수의 식별번호로 생성하실 수도 있습니다.
-    - 메모 : 계약에 대한 메모 설정
-
-<Tag text="할인 분담 정책" />
-
-정산 처리 시 진행하고 있는 프로모션 할인 비율을 적용할 수 있습니다.
-
-- 할인 정책 아이디 : 설정할 할인정책을 구분할 아이디를 설정해주세요.
-- 파트너 분담률 : 포인트 및 쿠폰으로 인한 할인금액에 대해서 파트너가 부담하기로 한 비율입니다.
-- 메모 등록
-
-<Tag text="추가 수수료 정책" />
-
-**정산 건에 추가 수수료가 적용될 경우 등록하신 아이디를 전달해주셔야 합니다**
-
-- 추가 수수료 아이디 : 추가하실 수수료 정책을 구분할 아이디를 설정해주세요.
-- 추가 수수료 정보 : 정률(%) / 정액(₩)
-- 부가세 분담 주체 : 파트너 부담 or 우리 회사 부담
-- 메모 등록
-
-<Tag text="계산관리" />
-
-**아래 수식은 API 호출을 통해서 사용이 가능합니다.**
-
-- 플랫폼 중개 수수료 수식
-  - 사용가능 변수: 주문금액, 결제금액, 결제금액부가세, 결제금액부가세 부담금, 할인금액, 할인부담금, 정액(정액 플랫폼 중개 수수료), 정률(정률 플랫폼 중개 수수료)
-- 할인 분담금 수식
-  - 사용가능 변수: 할인금액, 정률(할인 분담률)
-- 추가 수수료 수식
-  - 사용가능 변수: 주문금액, 결제금액, 결제금액부가세, 결제금액부가세 부담금, 할인금액, 할인부담금, 플랫폼중개수수료, 플랫폼중개수수료부가세 부담금, 정액(정액 추가 수수료), 정률(정률 추가 수수료)
-- 사용자 정의 수식
-  - 플랫폼 정책에 맞는 맞춤형 정산 수식 작성 가능
-- 수식 테스트
-  - 실제 적용 전 예상 정산금액 미리 검증 가능
-- 전체 수식 계산식
-  - 정산 금액 = 주문 금액 - 결제금액부가세 부담금 -중개 수수료- 중개수수료부가세 부담금 -추가 수수료 - 추가수수료부가세 부담금 - 할인 부담금
-
-#### 2. 파트너 관리
-
-**정산이 이루어질 파트너를 등록합니다.**
-
-
-
-<Tag text="파트너 추가" />
-
-파트너 추가 기능은 포트원 관리자콘솔에서 수동처리 및 API 호출로 가능합니다.
-
-- 정산 대상 설정
-  - 사업자 정보 및 이름을 입력합니다.
-  - 원천징수 대상자/비대상자 유형을 선택합니다.
-  - 과세 유형을 설정합니다. (일반과세, 간이과세, 면세사업자)
-- 계좌정보
-  - 정산데이터가 생성될 정산받을 대상의 계좌정보를 설정합니다.
-  - 이 때 1번에 등록한 계약 건과 연동합니다.
-  - 예금주 조회를 통한 계좌 유효성을 자동 검증합니다.
-- 사업자 검증
-  - 휴폐업 상태를 자동 조회 할 수 있습니다.
-- 국세청 연동
-  - 세금계산서 발행을 위한 국세청 연동 상태 관리 기능을 지원합니다.
-  - 국세청 연동 시 세금계산서 발행을 위해 파트너사 \[팝빌] 자동 회원가입을 진행합니다.
-- 메모등록
-  - 파트너에 대한 메모를 입력합니다.
-- 태그등록
-  - 우리 회사 내부적으로 쓰고 있는 규칙이 있다면 자유롭게 태그를 등록 그룹으로 만들어보세요. 이후에 필터 / 검색 시 활용할 수 있습니다.
-- 아이디 생성
-  - 정산 api에 사용될 아이디를 발급합니다. 원하는 아이디로 설정하거나, 난수의 식별번호로 생성하실 수 있습니다.
-- 일괄 등록 기능
-  - CSV 파일로 파트너를 대량등록 하실 수 있습니다.
-- 사용자 정의 속성 관리
-
-#### 3. 정산 상세  조회
-
-- 정산 API를 호출하여 정산일에 맞게 생성된 주문 정산, 주문 취소 정산 내역을 조회할 수 있습니다.
-- 수기로 정산 내역 조정이 필요한 경우 음수 정산 / 양수 정산 건을 생성하여 예외적인 정산 케이스를 관리할 수 있습니다.
-- 정산 상세 내역을 CSV 파일로 다운로드하여 정산 명세서를 손쉽게 작성하고 관리할 수 있습니다.
-- 수기 정산건 등록 시 즉시 정산내역 관리에 반영되어 실시간 확인이 가능합니다.
-
-
-
-#### 4. **정산 내역 관리하기**
-
-- 정산 내역 관리는 1시간마다 배치를 통해 동기화됩니다. 등록한 정산 상세 내역 중 \[정산일]이 도래한 정산 건은 자동 취합되며, 정산 내역 관리 페이지에서 조회할 수 있습니다.
-- 이미 생성된 정산 내역이 있더라도 API 혹은 콘솔의 수기 정산 기능으로 해당 정산일에 추가 정산 내역을 등록하면, 정산 금액은 합산됩니다.
-- 다만 기존의 정산 건이 지급실패/지급보류 상태로 변경된 경우, 추가 정산 내역을 등록하더라도 정산 금액은 합산되지 않고 새로운 정산 건이 별도로 생성됩니다.
-- 송금대행 일괄지급은 기존에 즉시 지급만 가능하였으나, 이번 업데이트로 즉시 지급과 예약지급을 선택 하여 지급을 실행할 수 있습니다. 내부 정책에 맞게 지급 일시를 유연하게 관리해보세요. 
-- 기본 통장메모를 일괄 설정하면 송금대행 일괄지급 시 자동으로 적용되어 반복 기입할 필요가 없습니다.
-
-
-
-#### 5. **송금대행 일괄지급**
-
-- \[정산내역 관리] 페이지에서 총 10개의 정산일자를 선택하여 원하는 정산내역을 선택하여 \[송금대행 일괄지급] 을 실행할 수 있습니다.
-- 송금대행 일괄지급 서비스를 신청하는 경우, 전용 가상계좌가 부여됩니다.
-- 예약지급과 즉시지급이 가능하며 즉시지급 선택 시 실시간으로 지급이 실행됩니다.
-
-
-
-#### 6. **일괄지급 내역 관리**
-
-- \[일괄지급 내역 관리]에서 일괄 지급 현황을 실시간으로 확인할 수 있습니다. 지급 오류를 방지하기 위해 지급은 시스템에서 차례로 진행되며, 2개 이상의 일괄지급을 동시에 진행할 수 없습니다.
-- 정보 오기입 등의 사유로 송금대행 일괄 지급 중단이 필요하신 경우 \[중단] 버튼을 이용하여 즉시 지급을 중단할 수 있습니다. 지급중단 처리는 준비완료, 진행 중 상태일 때 가능합니다.
-
-
-
-#### 7. **지급내역 관리**
-
-- 지급 내역 관리 페이지에서 진행 중인 지급 현황을 확인할 수 있습니다.
-- 지급이 실패한 경우, 실패 사유를 확인할 수 있습니다. 지급 실패 건에 대해 지급을 재시도하고자 하는 경우, \[정산 내역 관리] 페이지의 ‘지급실패’ 상태 탭에서 해당 지급 건을 확인한 뒤 새롭게 일괄지급을 실행할 수 있습니다.
-
-
-
-#### **8. 세금계산서 역발행**
-
-- 세금계산서 역발행 페이지에서 공급받는자가 공급자 대신 세금계산서를 작성하여 발행 요청할 수 있습니다.
-- 공급자는 이메일로 발행 요청을 받은 후 세금계산서 내용을 확인하고 승인 또는 거부할 수 있습니다.
-- 세금계산서를 단건으로 작성하거나 CSV 파일을 통해 일괄 등록할 수 있습니다. 이메일 재발송 기능을 통해 공급자가 이메일을 놓친 경우에도 다시 발행 요청을 보낼 수 있습니다.
-