@roottale/cms-mcp 0.32.0 → 0.33.0

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @roottale/cms-mcp
 
+## 0.33.0
+
+### Minor Changes
+
+- 5dc4916: ADR-0061 P4 — 사이트 지식 projection. 고객 AI 에이전트가 사이트의 브랜드 보이스(어조·톤·화자)와 용어 규칙(금지어·교정어)을 읽을 수 있는 `getSiteKnowledge` MCP 도구 + 공개 API `GET /v1/cms/public/site-knowledge` 추가. 운영 메모·내부 SEO 임계값·내부 출처는 노출하지 않는다(platform 고정 projection 정책). docs(theme-and-settings·api-reference) 갱신.
+
+### Patch Changes
+
+- 2e6cbd0: ADR-0060 Amendment 1 (Option A) — 글의 섹션을 명시 필드로
+
+  `resolvePostCollection` 이 글의 명시 `collectionKey` 를 카테고리 slug 파생보다
+  우선 사용한다. `RoutablePost`·`CmsPostContent` 에 `collectionKey` 추가, 공개 API
+  post 페이로드에 `collection_key` 포함. 미설정/구 서버면 기존 카테고리 파생으로
+  fallback(완전 하위호환). sitemap/feed/가드/아카이브가 명시 섹션을 따른다.
+
 ## 0.32.0
 
 ### Minor Changes

package/dist/index.js

@@ -105,6 +105,7 @@ var ListPostsInput = z.object({
   cursor: z.string().optional()
 }).strict();
 var GetPostInput = z.object({ slugOrId: z.string().min(1) }).strict();
+var GetSiteKnowledgeInput = z.object({ siteId: z.string().optional() }).strict();
 var TOOL_DEFINITIONS = [
   {
     name: "listRootTaleDocs",
@@ -164,6 +165,20 @@ var TOOL_DEFINITIONS = [
       required: ["slugOrId"],
       additionalProperties: false
     }
+  },
+  {
+    name: "getSiteKnowledge",
+    description: "\uC774 RootTale \uC0AC\uC774\uD2B8\uC758 \uBE0C\uB79C\uB4DC \uBCF4\uC774\uC2A4(\uC5B4\uC870\xB7\uD1A4\xB7\uD654\uC790)\uC640 \uC6A9\uC5B4 \uADDC\uCE59(\uAE08\uC9C0\uC5B4\xB7\uAD50\uC815\uC5B4)\uC744 \uC870\uD68C\uD569\uB2C8\uB2E4 (GET /v1/cms/public/site-knowledge). \uC774 \uC0AC\uC774\uD2B8\uC5D0 \uB9DE\uB294 \uAE00\uC744 \uC4F0\uAE30 \uC804\uC5D0 \uD638\uCD9C\uD574 \uD1A4\xB7\uD45C\uD604\uC744 \uB9DE\uCD94\uC138\uC694. \uAE08\uC9C0\uC5B4\uB294 \uC4F0\uC9C0 \uB9D0\uACE0, \uAD50\uC815\uC5B4\uB294 \uAD8C\uC7A5 \uD45C\uD604\uC73C\uB85C \uBC14\uAFD4 \uC4F0\uC138\uC694. \uD658\uACBD\uBCC0\uC218 ROOTTALE_API_KEY(rtlk_cust_*)\uAC00 \uD544\uC694\uD569\uB2C8\uB2E4.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        siteId: {
+          type: "string",
+          description: "\uC0AC\uC774\uD2B8 ID (\uC120\uD0DD, \uBBF8\uC124\uC815 \uC2DC \uAE30\uBCF8 \uC0AC\uC774\uD2B8)"
+        }
+      },
+      additionalProperties: false
+    }
   }
 ];
 function requireApiKey() {
@@ -241,6 +256,14 @@ function registerTools(server2) {
             )
           );
         }
+        case "getSiteKnowledge": {
+          const input = GetSiteKnowledgeInput.parse(args);
+          const params = {};
+          if (input.siteId) params.site_id = input.siteId;
+          return jsonResponse(
+            await fetchPublicApi("/v1/cms/public/site-knowledge", params)
+          );
+        }
         default:
           throw new McpError(
             ErrorCode.InvalidParams,
@@ -256,7 +279,7 @@ function registerTools(server2) {
 }
 
 // src/server.ts
-var VERSION = true ? "0.32.0" : "dev";
+var VERSION = true ? "0.33.0" : "dev";
 var SERVER_INSTRUCTIONS = `
 roottale-cms-mcp\uB294 RootTale CMS\uB97C \uC678\uBD80 \uC0AC\uC774\uD2B8(\uC8FC\uB85C Next.js)\uC5D0 \uC5F0\uB3D9\uD558\uAE30 \uC704\uD55C
 \uD1B5\uD569 \uBB38\uC11C\xB7\uC608\uC2DC \uCF54\uB4DC\xB7\uACF5\uAC1C API \uC870\uD68C tool\uC744 \uC81C\uACF5\uD569\uB2C8\uB2E4.

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/server.ts","../src/tools.ts","../src/docs.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\n\nimport { createServer } from \"./server.js\";\n\nconst server = createServer();\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n","import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\n\nimport { registerTools } from \"./tools.js\";\n\n// tsup define 으로 빌드타임 주입 — 비번들 실행(vitest 등)에서는 \"dev\".\ndeclare const __CMS_MCP_VERSION__: string | undefined;\nconst VERSION =\n  typeof __CMS_MCP_VERSION__ === \"string\" ? __CMS_MCP_VERSION__ : \"dev\";\n\nexport const SERVER_INSTRUCTIONS = `\nroottale-cms-mcp는 RootTale CMS를 외부 사이트(주로 Next.js)에 연동하기 위한\n통합 문서·예시 코드·공개 API 조회 tool을 제공합니다.\n\n지켜야 할 규칙:\n- RootTale 연동 관련 작업은 가장 먼저 listRootTaleDocs를 호출해 문서 목록을 파악하세요.\n- 연동 코드를 작성하기 전 반드시 readRootTaleNextjsExampleCode를 호출해 예시 코드를\n  참고한 후 그 패턴을 따라 작성하세요.\n- API 키(rtlk_cust_*)는 서버 전용입니다. NEXT_PUBLIC_* 등 브라우저로 노출되는\n  환경변수에 절대 넣지 마세요.\n- 이미 학습된 내용이더라도 본 서버의 문서로 더블체크 후 작업하세요.\n`.trim();\n\nexport function createServer(): Server {\n  const server = new Server(\n    { name: \"roottale-cms\", version: VERSION },\n    { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS },\n  );\n  registerTools(server);\n  return server;\n}\n","import type { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport {\n  CallToolRequestSchema,\n  ErrorCode,\n  ListToolsRequestSchema,\n  McpError,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport { listDocs, readDoc, readNextjsExampleCode, searchDocs } from \"./docs.js\";\n\nconst DEFAULT_API_BASE = \"https://api.roottale.com\";\n\nconst ReadDocInput = z.object({ path: z.string().min(1) }).strict();\nconst SearchDocsInput = z.object({ query: z.string().min(1) }).strict();\nconst ListPostsInput = z\n  .object({\n    limit: z.number().int().min(1).max(100).optional(),\n    type: z.enum([\"post\", \"page\"]).optional(),\n    cursor: z.string().optional(),\n  })\n  .strict();\nconst GetPostInput = z.object({ slugOrId: z.string().min(1) }).strict();\n\nexport const TOOL_DEFINITIONS = [\n  {\n    name: \"listRootTaleDocs\",\n    description:\n      \"RootTale CMS 통합 문서 전체 목록(경로·제목·설명)을 반환합니다. \" +\n      \"RootTale 연동 작업을 시작하기 전 가장 먼저 호출하세요.\",\n    inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n  },\n  {\n    name: \"readRootTaleDoc\",\n    description:\n      \"RootTale CMS 통합 문서 1개를 경로로 읽습니다. \" +\n      \"경로는 listRootTaleDocs 가 반환한 path 값을 사용하세요.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", description: \"문서 경로 (예: blog.md)\" },\n      },\n      required: [\"path\"],\n      additionalProperties: false,\n    },\n  },\n  {\n    name: \"searchRootTaleDocs\",\n    description:\n      \"RootTale CMS 통합 문서 전체에서 정규식으로 검색합니다 (대소문자 무시). \" +\n      \"매치된 파일 경로·라인 번호·라인 내용을 반환합니다.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        query: { type: \"string\", description: \"정규식 패턴 (예: revalidate|webhook)\" },\n      },\n      required: [\"query\"],\n      additionalProperties: false,\n    },\n  },\n  {\n    name: \"readRootTaleNextjsExampleCode\",\n    description:\n      \"RootTale CMS를 외부 Next.js(App Router) 사이트에 연동하는 완전한 예시 코드 세트를 반환합니다 \" +\n      \"(블로그 목록/상세, 웹훅 revalidate 라우트, RSS/사이트맵, 상담문의 서버 액션 등). \" +\n      \"연동 코드를 작성하기 전 반드시 호출해 패턴을 따라 작성하세요.\",\n    inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n  },\n  {\n    name: \"listPublishedPosts\",\n    description:\n      \"연동 검증용 — RootTale 공개 CMS API(GET /v1/cms/public/posts)로 발행된 글 목록을 조회합니다. \" +\n      \"환경변수 ROOTTALE_API_KEY(rtlk_cust_*)가 필요합니다.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        limit: { type: \"number\", description: \"1-100, 기본 20\" },\n        type: { type: \"string\", enum: [\"post\", \"page\"] },\n        cursor: { type: \"string\", description: \"이전 응답의 next_cursor\" },\n      },\n      additionalProperties: false,\n    },\n  },\n  {\n    name: \"getPublishedPost\",\n    description:\n      \"연동 검증용 — RootTale 공개 CMS API(GET /v1/cms/public/posts/:identifier)로 발행된 글 1개를 \" +\n      \"slug 또는 UUID로 조회합니다. 환경변수 ROOTTALE_API_KEY(rtlk_cust_*)가 필요합니다.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        slugOrId: { type: \"string\", description: \"글 slug 또는 UUID\" },\n      },\n      required: [\"slugOrId\"],\n      additionalProperties: false,\n    },\n  },\n] as const;\n\nfunction requireApiKey(): { apiKey: string; baseUrl: string } {\n  const apiKey = process.env.ROOTTALE_API_KEY;\n  if (!apiKey) {\n    throw new McpError(\n      ErrorCode.InvalidRequest,\n      \"ROOTTALE_API_KEY 환경변수가 없습니다. MCP 서버 설정의 env에 \" +\n        \"rtlk_cust_* 키를 추가하세요 (발급: 어드민 설정 > 사이트 연결 키).\",\n    );\n  }\n  const baseUrl = (process.env.ROOTTALE_API_BASE ?? DEFAULT_API_BASE).replace(/\\/+$/, \"\");\n  return { apiKey, baseUrl };\n}\n\nasync function fetchPublicApi(pathname: string, params?: Record<string, string>): Promise<unknown> {\n  const { apiKey, baseUrl } = requireApiKey();\n  const url = new URL(`${baseUrl}${pathname}`);\n  for (const [key, value] of Object.entries(params ?? {})) {\n    url.searchParams.set(key, value);\n  }\n  const response = await fetch(url, {\n    headers: { authorization: `Bearer ${apiKey}` },\n  });\n  const body = await response.text();\n  if (!response.ok) {\n    throw new Error(`RootTale API ${response.status}: ${body.slice(0, 500)}`);\n  }\n  return JSON.parse(body);\n}\n\nfunction textResponse(text: string) {\n  return { content: [{ type: \"text\" as const, text }] };\n}\n\nfunction jsonResponse(value: unknown) {\n  return textResponse(JSON.stringify(value, null, 2));\n}\n\nexport function registerTools(server: Server): void {\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: TOOL_DEFINITIONS.map((t) => ({ ...t })),\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const args = (request.params.arguments ?? {}) as Record<string, unknown>;\n    try {\n      switch (request.params.name) {\n        case \"listRootTaleDocs\":\n          return jsonResponse(await listDocs());\n        case \"readRootTaleDoc\": {\n          const input = ReadDocInput.parse(args);\n          const content = await readDoc(input.path);\n          if (content === null) {\n            throw new McpError(\n              ErrorCode.InvalidParams,\n              `문서를 찾을 수 없습니다: ${input.path} — listRootTaleDocs로 경로를 확인하세요.`,\n            );\n          }\n          return textResponse(content);\n        }\n        case \"searchRootTaleDocs\": {\n          const input = SearchDocsInput.parse(args);\n          return jsonResponse(await searchDocs(input.query));\n        }\n        case \"readRootTaleNextjsExampleCode\":\n          return textResponse(await readNextjsExampleCode());\n        case \"listPublishedPosts\": {\n          const input = ListPostsInput.parse(args);\n          const params: Record<string, string> = {};\n          if (input.limit) params.limit = String(input.limit);\n          if (input.type) params.type = input.type;\n          if (input.cursor) params.cursor = input.cursor;\n          return jsonResponse(await fetchPublicApi(\"/v1/cms/public/posts\", params));\n        }\n        case \"getPublishedPost\": {\n          const input = GetPostInput.parse(args);\n          return jsonResponse(\n            await fetchPublicApi(\n              `/v1/cms/public/posts/${encodeURIComponent(input.slugOrId)}`,\n            ),\n          );\n        }\n        default:\n          throw new McpError(\n            ErrorCode.InvalidParams,\n            `Unknown RootTale tool: ${request.params.name}`,\n          );\n      }\n    } catch (error) {\n      if (error instanceof McpError) throw error;\n      const message = error instanceof Error ? error.message : String(error);\n      return { isError: true, content: [{ type: \"text\" as const, text: message }] };\n    }\n  });\n}\n","/**\n * 패키지에 번들된 통합 문서(`docs/`)·예시 코드(`examples/`) 로더.\n *\n * dist/index.js 와 src/docs.ts 모두 패키지 루트에서 한 단계 아래이므로\n * `..` 상대 경로 해석이 빌드 전후 동일하다. npm publish 시 `files` 에\n * docs/, examples/ 가 포함되어 npx 환경에서도 같은 구조로 설치된다.\n */\nimport { readdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PKG_ROOT = fileURLToPath(new URL(\"..\", import.meta.url));\nconst DOCS_ROOT = path.join(PKG_ROOT, \"docs\");\nconst EXAMPLES_ROOT = path.join(PKG_ROOT, \"examples\");\n\nexport interface DocEntry {\n  /** docs/ 기준 상대 경로 (예: \"blog.md\"). */\n  path: string;\n  title: string;\n  description: string;\n}\n\ninterface Frontmatter {\n  title: string;\n  description: string;\n}\n\n/** `---\\ntitle: ...\\ndescription: ...\\n---` 형태의 단순 frontmatter 파서. */\nexport function parseFrontmatter(markdown: string): Frontmatter {\n  const result: Frontmatter = { title: \"\", description: \"\" };\n  const match = markdown.match(/^---\\n([\\s\\S]*?)\\n---/);\n  if (!match) return result;\n  for (const line of match[1].split(\"\\n\")) {\n    const idx = line.indexOf(\":\");\n    if (idx === -1) continue;\n    const key = line.slice(0, idx).trim();\n    const value = line.slice(idx + 1).trim();\n    if (key === \"title\") result.title = value;\n    if (key === \"description\") result.description = value;\n  }\n  return result;\n}\n\nasync function walkFiles(root: string, dir = root): Promise<string[]> {\n  const entries = await readdir(dir, { withFileTypes: true });\n  const files: string[] = [];\n  for (const entry of entries) {\n    const full = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      files.push(...(await walkFiles(root, full)));\n    } else {\n      files.push(path.relative(root, full));\n    }\n  }\n  return files.sort();\n}\n\nexport async function listDocs(): Promise<DocEntry[]> {\n  const files = (await walkFiles(DOCS_ROOT)).filter((f) => f.endsWith(\".md\"));\n  return Promise.all(\n    files.map(async (rel) => {\n      const content = await readFile(path.join(DOCS_ROOT, rel), \"utf8\");\n      const fm = parseFrontmatter(content);\n      return { path: rel, title: fm.title || rel, description: fm.description };\n    }),\n  );\n}\n\n/** 경로 탈출(../) 방지 후 단일 문서 읽기. 없으면 null. */\nexport async function readDoc(relPath: string): Promise<string | null> {\n  const resolved = path.resolve(DOCS_ROOT, relPath);\n  if (!resolved.startsWith(DOCS_ROOT + path.sep)) return null;\n  try {\n    return await readFile(resolved, \"utf8\");\n  } catch {\n    return null;\n  }\n}\n\nexport interface SearchMatch {\n  path: string;\n  line: number;\n  text: string;\n}\n\n/** 모든 문서에 대해 정규식 검색 (대소문자 무시). 매치 라인을 반환. */\nexport async function searchDocs(query: string): Promise<SearchMatch[]> {\n  const regex = new RegExp(query, \"i\");\n  const matches: SearchMatch[] = [];\n  for (const doc of await listDocs()) {\n    const content = await readDoc(doc.path);\n    if (!content) continue;\n    content.split(\"\\n\").forEach((text, idx) => {\n      if (regex.test(text)) {\n        matches.push({ path: doc.path, line: idx + 1, text: text.trim() });\n      }\n    });\n  }\n  return matches;\n}\n\n/**\n * Next.js 통합 예시 코드 전체를 `--- FILE: <path> ---` 헤더로 이어붙여 반환.\n * 파일 수가 적어(통합 1세트) 한 번에 주는 쪽이 에이전트 왕복을 줄인다.\n */\nexport async function readNextjsExampleCode(): Promise<string> {\n  const root = path.join(EXAMPLES_ROOT, \"nextjs\");\n  const files = await walkFiles(root);\n  const sections = await Promise.all(\n    files.map(async (rel) => {\n      const content = await readFile(path.join(root, rel), \"utf8\");\n      return `--- FILE: ${rel} ---\\n${content}`;\n    }),\n  );\n  return sections.join(\"\\n\\n\");\n}\n"],"mappings":"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","names":["server","server"]}
+{"version":3,"sources":["../src/index.ts","../src/server.ts","../src/tools.ts","../src/docs.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { StdioServerTransport } from \"@modelcontextprotocol/sdk/server/stdio.js\";\n\nimport { createServer } from \"./server.js\";\n\nconst server = createServer();\nconst transport = new StdioServerTransport();\nawait server.connect(transport);\n","import { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\n\nimport { registerTools } from \"./tools.js\";\n\n// tsup define 으로 빌드타임 주입 — 비번들 실행(vitest 등)에서는 \"dev\".\ndeclare const __CMS_MCP_VERSION__: string | undefined;\nconst VERSION =\n  typeof __CMS_MCP_VERSION__ === \"string\" ? __CMS_MCP_VERSION__ : \"dev\";\n\nexport const SERVER_INSTRUCTIONS = `\nroottale-cms-mcp는 RootTale CMS를 외부 사이트(주로 Next.js)에 연동하기 위한\n통합 문서·예시 코드·공개 API 조회 tool을 제공합니다.\n\n지켜야 할 규칙:\n- RootTale 연동 관련 작업은 가장 먼저 listRootTaleDocs를 호출해 문서 목록을 파악하세요.\n- 연동 코드를 작성하기 전 반드시 readRootTaleNextjsExampleCode를 호출해 예시 코드를\n  참고한 후 그 패턴을 따라 작성하세요.\n- API 키(rtlk_cust_*)는 서버 전용입니다. NEXT_PUBLIC_* 등 브라우저로 노출되는\n  환경변수에 절대 넣지 마세요.\n- 이미 학습된 내용이더라도 본 서버의 문서로 더블체크 후 작업하세요.\n`.trim();\n\nexport function createServer(): Server {\n  const server = new Server(\n    { name: \"roottale-cms\", version: VERSION },\n    { capabilities: { tools: {} }, instructions: SERVER_INSTRUCTIONS },\n  );\n  registerTools(server);\n  return server;\n}\n","import type { Server } from \"@modelcontextprotocol/sdk/server/index.js\";\nimport {\n  CallToolRequestSchema,\n  ErrorCode,\n  ListToolsRequestSchema,\n  McpError,\n} from \"@modelcontextprotocol/sdk/types.js\";\nimport { z } from \"zod\";\n\nimport { listDocs, readDoc, readNextjsExampleCode, searchDocs } from \"./docs.js\";\n\nconst DEFAULT_API_BASE = \"https://api.roottale.com\";\n\nconst ReadDocInput = z.object({ path: z.string().min(1) }).strict();\nconst SearchDocsInput = z.object({ query: z.string().min(1) }).strict();\nconst ListPostsInput = z\n  .object({\n    limit: z.number().int().min(1).max(100).optional(),\n    type: z.enum([\"post\", \"page\"]).optional(),\n    cursor: z.string().optional(),\n  })\n  .strict();\nconst GetPostInput = z.object({ slugOrId: z.string().min(1) }).strict();\nconst GetSiteKnowledgeInput = z\n  .object({ siteId: z.string().optional() })\n  .strict();\n\nexport const TOOL_DEFINITIONS = [\n  {\n    name: \"listRootTaleDocs\",\n    description:\n      \"RootTale CMS 통합 문서 전체 목록(경로·제목·설명)을 반환합니다. \" +\n      \"RootTale 연동 작업을 시작하기 전 가장 먼저 호출하세요.\",\n    inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n  },\n  {\n    name: \"readRootTaleDoc\",\n    description:\n      \"RootTale CMS 통합 문서 1개를 경로로 읽습니다. \" +\n      \"경로는 listRootTaleDocs 가 반환한 path 값을 사용하세요.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        path: { type: \"string\", description: \"문서 경로 (예: blog.md)\" },\n      },\n      required: [\"path\"],\n      additionalProperties: false,\n    },\n  },\n  {\n    name: \"searchRootTaleDocs\",\n    description:\n      \"RootTale CMS 통합 문서 전체에서 정규식으로 검색합니다 (대소문자 무시). \" +\n      \"매치된 파일 경로·라인 번호·라인 내용을 반환합니다.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        query: { type: \"string\", description: \"정규식 패턴 (예: revalidate|webhook)\" },\n      },\n      required: [\"query\"],\n      additionalProperties: false,\n    },\n  },\n  {\n    name: \"readRootTaleNextjsExampleCode\",\n    description:\n      \"RootTale CMS를 외부 Next.js(App Router) 사이트에 연동하는 완전한 예시 코드 세트를 반환합니다 \" +\n      \"(블로그 목록/상세, 웹훅 revalidate 라우트, RSS/사이트맵, 상담문의 서버 액션 등). \" +\n      \"연동 코드를 작성하기 전 반드시 호출해 패턴을 따라 작성하세요.\",\n    inputSchema: { type: \"object\", properties: {}, additionalProperties: false },\n  },\n  {\n    name: \"listPublishedPosts\",\n    description:\n      \"연동 검증용 — RootTale 공개 CMS API(GET /v1/cms/public/posts)로 발행된 글 목록을 조회합니다. \" +\n      \"환경변수 ROOTTALE_API_KEY(rtlk_cust_*)가 필요합니다.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        limit: { type: \"number\", description: \"1-100, 기본 20\" },\n        type: { type: \"string\", enum: [\"post\", \"page\"] },\n        cursor: { type: \"string\", description: \"이전 응답의 next_cursor\" },\n      },\n      additionalProperties: false,\n    },\n  },\n  {\n    name: \"getPublishedPost\",\n    description:\n      \"연동 검증용 — RootTale 공개 CMS API(GET /v1/cms/public/posts/:identifier)로 발행된 글 1개를 \" +\n      \"slug 또는 UUID로 조회합니다. 환경변수 ROOTTALE_API_KEY(rtlk_cust_*)가 필요합니다.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        slugOrId: { type: \"string\", description: \"글 slug 또는 UUID\" },\n      },\n      required: [\"slugOrId\"],\n      additionalProperties: false,\n    },\n  },\n  {\n    name: \"getSiteKnowledge\",\n    description:\n      \"이 RootTale 사이트의 브랜드 보이스(어조·톤·화자)와 용어 규칙(금지어·교정어)을 조회합니다 \" +\n      \"(GET /v1/cms/public/site-knowledge). 이 사이트에 맞는 글을 쓰기 전에 호출해 톤·표현을 맞추세요. \" +\n      \"금지어는 쓰지 말고, 교정어는 권장 표현으로 바꿔 쓰세요. 환경변수 ROOTTALE_API_KEY(rtlk_cust_*)가 필요합니다.\",\n    inputSchema: {\n      type: \"object\",\n      properties: {\n        siteId: {\n          type: \"string\",\n          description: \"사이트 ID (선택, 미설정 시 기본 사이트)\",\n        },\n      },\n      additionalProperties: false,\n    },\n  },\n] as const;\n\nfunction requireApiKey(): { apiKey: string; baseUrl: string } {\n  const apiKey = process.env.ROOTTALE_API_KEY;\n  if (!apiKey) {\n    throw new McpError(\n      ErrorCode.InvalidRequest,\n      \"ROOTTALE_API_KEY 환경변수가 없습니다. MCP 서버 설정의 env에 \" +\n        \"rtlk_cust_* 키를 추가하세요 (발급: 어드민 설정 > 사이트 연결 키).\",\n    );\n  }\n  const baseUrl = (process.env.ROOTTALE_API_BASE ?? DEFAULT_API_BASE).replace(/\\/+$/, \"\");\n  return { apiKey, baseUrl };\n}\n\nasync function fetchPublicApi(pathname: string, params?: Record<string, string>): Promise<unknown> {\n  const { apiKey, baseUrl } = requireApiKey();\n  const url = new URL(`${baseUrl}${pathname}`);\n  for (const [key, value] of Object.entries(params ?? {})) {\n    url.searchParams.set(key, value);\n  }\n  const response = await fetch(url, {\n    headers: { authorization: `Bearer ${apiKey}` },\n  });\n  const body = await response.text();\n  if (!response.ok) {\n    throw new Error(`RootTale API ${response.status}: ${body.slice(0, 500)}`);\n  }\n  return JSON.parse(body);\n}\n\nfunction textResponse(text: string) {\n  return { content: [{ type: \"text\" as const, text }] };\n}\n\nfunction jsonResponse(value: unknown) {\n  return textResponse(JSON.stringify(value, null, 2));\n}\n\nexport function registerTools(server: Server): void {\n  server.setRequestHandler(ListToolsRequestSchema, async () => ({\n    tools: TOOL_DEFINITIONS.map((t) => ({ ...t })),\n  }));\n\n  server.setRequestHandler(CallToolRequestSchema, async (request) => {\n    const args = (request.params.arguments ?? {}) as Record<string, unknown>;\n    try {\n      switch (request.params.name) {\n        case \"listRootTaleDocs\":\n          return jsonResponse(await listDocs());\n        case \"readRootTaleDoc\": {\n          const input = ReadDocInput.parse(args);\n          const content = await readDoc(input.path);\n          if (content === null) {\n            throw new McpError(\n              ErrorCode.InvalidParams,\n              `문서를 찾을 수 없습니다: ${input.path} — listRootTaleDocs로 경로를 확인하세요.`,\n            );\n          }\n          return textResponse(content);\n        }\n        case \"searchRootTaleDocs\": {\n          const input = SearchDocsInput.parse(args);\n          return jsonResponse(await searchDocs(input.query));\n        }\n        case \"readRootTaleNextjsExampleCode\":\n          return textResponse(await readNextjsExampleCode());\n        case \"listPublishedPosts\": {\n          const input = ListPostsInput.parse(args);\n          const params: Record<string, string> = {};\n          if (input.limit) params.limit = String(input.limit);\n          if (input.type) params.type = input.type;\n          if (input.cursor) params.cursor = input.cursor;\n          return jsonResponse(await fetchPublicApi(\"/v1/cms/public/posts\", params));\n        }\n        case \"getPublishedPost\": {\n          const input = GetPostInput.parse(args);\n          return jsonResponse(\n            await fetchPublicApi(\n              `/v1/cms/public/posts/${encodeURIComponent(input.slugOrId)}`,\n            ),\n          );\n        }\n        case \"getSiteKnowledge\": {\n          const input = GetSiteKnowledgeInput.parse(args);\n          const params: Record<string, string> = {};\n          if (input.siteId) params.site_id = input.siteId;\n          return jsonResponse(\n            await fetchPublicApi(\"/v1/cms/public/site-knowledge\", params),\n          );\n        }\n        default:\n          throw new McpError(\n            ErrorCode.InvalidParams,\n            `Unknown RootTale tool: ${request.params.name}`,\n          );\n      }\n    } catch (error) {\n      if (error instanceof McpError) throw error;\n      const message = error instanceof Error ? error.message : String(error);\n      return { isError: true, content: [{ type: \"text\" as const, text: message }] };\n    }\n  });\n}\n","/**\n * 패키지에 번들된 통합 문서(`docs/`)·예시 코드(`examples/`) 로더.\n *\n * dist/index.js 와 src/docs.ts 모두 패키지 루트에서 한 단계 아래이므로\n * `..` 상대 경로 해석이 빌드 전후 동일하다. npm publish 시 `files` 에\n * docs/, examples/ 가 포함되어 npx 환경에서도 같은 구조로 설치된다.\n */\nimport { readdir, readFile } from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\n\nconst PKG_ROOT = fileURLToPath(new URL(\"..\", import.meta.url));\nconst DOCS_ROOT = path.join(PKG_ROOT, \"docs\");\nconst EXAMPLES_ROOT = path.join(PKG_ROOT, \"examples\");\n\nexport interface DocEntry {\n  /** docs/ 기준 상대 경로 (예: \"blog.md\"). */\n  path: string;\n  title: string;\n  description: string;\n}\n\ninterface Frontmatter {\n  title: string;\n  description: string;\n}\n\n/** `---\\ntitle: ...\\ndescription: ...\\n---` 형태의 단순 frontmatter 파서. */\nexport function parseFrontmatter(markdown: string): Frontmatter {\n  const result: Frontmatter = { title: \"\", description: \"\" };\n  const match = markdown.match(/^---\\n([\\s\\S]*?)\\n---/);\n  if (!match) return result;\n  for (const line of match[1].split(\"\\n\")) {\n    const idx = line.indexOf(\":\");\n    if (idx === -1) continue;\n    const key = line.slice(0, idx).trim();\n    const value = line.slice(idx + 1).trim();\n    if (key === \"title\") result.title = value;\n    if (key === \"description\") result.description = value;\n  }\n  return result;\n}\n\nasync function walkFiles(root: string, dir = root): Promise<string[]> {\n  const entries = await readdir(dir, { withFileTypes: true });\n  const files: string[] = [];\n  for (const entry of entries) {\n    const full = path.join(dir, entry.name);\n    if (entry.isDirectory()) {\n      files.push(...(await walkFiles(root, full)));\n    } else {\n      files.push(path.relative(root, full));\n    }\n  }\n  return files.sort();\n}\n\nexport async function listDocs(): Promise<DocEntry[]> {\n  const files = (await walkFiles(DOCS_ROOT)).filter((f) => f.endsWith(\".md\"));\n  return Promise.all(\n    files.map(async (rel) => {\n      const content = await readFile(path.join(DOCS_ROOT, rel), \"utf8\");\n      const fm = parseFrontmatter(content);\n      return { path: rel, title: fm.title || rel, description: fm.description };\n    }),\n  );\n}\n\n/** 경로 탈출(../) 방지 후 단일 문서 읽기. 없으면 null. */\nexport async function readDoc(relPath: string): Promise<string | null> {\n  const resolved = path.resolve(DOCS_ROOT, relPath);\n  if (!resolved.startsWith(DOCS_ROOT + path.sep)) return null;\n  try {\n    return await readFile(resolved, \"utf8\");\n  } catch {\n    return null;\n  }\n}\n\nexport interface SearchMatch {\n  path: string;\n  line: number;\n  text: string;\n}\n\n/** 모든 문서에 대해 정규식 검색 (대소문자 무시). 매치 라인을 반환. */\nexport async function searchDocs(query: string): Promise<SearchMatch[]> {\n  const regex = new RegExp(query, \"i\");\n  const matches: SearchMatch[] = [];\n  for (const doc of await listDocs()) {\n    const content = await readDoc(doc.path);\n    if (!content) continue;\n    content.split(\"\\n\").forEach((text, idx) => {\n      if (regex.test(text)) {\n        matches.push({ path: doc.path, line: idx + 1, text: text.trim() });\n      }\n    });\n  }\n  return matches;\n}\n\n/**\n * Next.js 통합 예시 코드 전체를 `--- FILE: <path> ---` 헤더로 이어붙여 반환.\n * 파일 수가 적어(통합 1세트) 한 번에 주는 쪽이 에이전트 왕복을 줄인다.\n */\nexport async function readNextjsExampleCode(): Promise<string> {\n  const root = path.join(EXAMPLES_ROOT, \"nextjs\");\n  const files = await walkFiles(root);\n  const sections = await Promise.all(\n    files.map(async (rel) => {\n      const content = await readFile(path.join(root, rel), \"utf8\");\n      return `--- FILE: ${rel} ---\\n${content}`;\n    }),\n  );\n  return sections.join(\"\\n\\n\");\n}\n"],"mappings":";;;AACA,SAAS,4BAA4B;;;ACDrC,SAAS,cAAc;;;ACCvB;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AACP,SAAS,SAAS;;;ACAlB,SAAS,SAAS,gBAAgB;AAClC,OAAO,UAAU;AACjB,SAAS,qBAAqB;AAE9B,IAAM,WAAW,cAAc,IAAI,IAAI,MAAM,YAAY,GAAG,CAAC;AAC7D,IAAM,YAAY,KAAK,KAAK,UAAU,MAAM;AAC5C,IAAM,gBAAgB,KAAK,KAAK,UAAU,UAAU;AAe7C,SAAS,iBAAiB,UAA+B;AAC9D,QAAM,SAAsB,EAAE,OAAO,IAAI,aAAa,GAAG;AACzD,QAAM,QAAQ,SAAS,MAAM,uBAAuB;AACpD,MAAI,CAAC,MAAO,QAAO;AACnB,aAAW,QAAQ,MAAM,CAAC,EAAE,MAAM,IAAI,GAAG;AACvC,UAAM,MAAM,KAAK,QAAQ,GAAG;AAC5B,QAAI,QAAQ,GAAI;AAChB,UAAM,MAAM,KAAK,MAAM,GAAG,GAAG,EAAE,KAAK;AACpC,UAAM,QAAQ,KAAK,MAAM,MAAM,CAAC,EAAE,KAAK;AACvC,QAAI,QAAQ,QAAS,QAAO,QAAQ;AACpC,QAAI,QAAQ,cAAe,QAAO,cAAc;AAAA,EAClD;AACA,SAAO;AACT;AAEA,eAAe,UAAU,MAAc,MAAM,MAAyB;AACpE,QAAM,UAAU,MAAM,QAAQ,KAAK,EAAE,eAAe,KAAK,CAAC;AAC1D,QAAM,QAAkB,CAAC;AACzB,aAAW,SAAS,SAAS;AAC3B,UAAM,OAAO,KAAK,KAAK,KAAK,MAAM,IAAI;AACtC,QAAI,MAAM,YAAY,GAAG;AACvB,YAAM,KAAK,GAAI,MAAM,UAAU,MAAM,IAAI,CAAE;AAAA,IAC7C,OAAO;AACL,YAAM,KAAK,KAAK,SAAS,MAAM,IAAI,CAAC;AAAA,IACtC;AAAA,EACF;AACA,SAAO,MAAM,KAAK;AACpB;AAEA,eAAsB,WAAgC;AACpD,QAAM,SAAS,MAAM,UAAU,SAAS,GAAG,OAAO,CAAC,MAAM,EAAE,SAAS,KAAK,CAAC;AAC1E,SAAO,QAAQ;AAAA,IACb,MAAM,IAAI,OAAO,QAAQ;AACvB,YAAM,UAAU,MAAM,SAAS,KAAK,KAAK,WAAW,GAAG,GAAG,MAAM;AAChE,YAAM,KAAK,iBAAiB,OAAO;AACnC,aAAO,EAAE,MAAM,KAAK,OAAO,GAAG,SAAS,KAAK,aAAa,GAAG,YAAY;AAAA,IAC1E,CAAC;AAAA,EACH;AACF;AAGA,eAAsB,QAAQ,SAAyC;AACrE,QAAM,WAAW,KAAK,QAAQ,WAAW,OAAO;AAChD,MAAI,CAAC,SAAS,WAAW,YAAY,KAAK,GAAG,EAAG,QAAO;AACvD,MAAI;AACF,WAAO,MAAM,SAAS,UAAU,MAAM;AAAA,EACxC,QAAQ;AACN,WAAO;AAAA,EACT;AACF;AASA,eAAsB,WAAW,OAAuC;AACtE,QAAM,QAAQ,IAAI,OAAO,OAAO,GAAG;AACnC,QAAM,UAAyB,CAAC;AAChC,aAAW,OAAO,MAAM,SAAS,GAAG;AAClC,UAAM,UAAU,MAAM,QAAQ,IAAI,IAAI;AACtC,QAAI,CAAC,QAAS;AACd,YAAQ,MAAM,IAAI,EAAE,QAAQ,CAAC,MAAM,QAAQ;AACzC,UAAI,MAAM,KAAK,IAAI,GAAG;AACpB,gBAAQ,KAAK,EAAE,MAAM,IAAI,MAAM,MAAM,MAAM,GAAG,MAAM,KAAK,KAAK,EAAE,CAAC;AAAA,MACnE;AAAA,IACF,CAAC;AAAA,EACH;AACA,SAAO;AACT;AAMA,eAAsB,wBAAyC;AAC7D,QAAM,OAAO,KAAK,KAAK,eAAe,QAAQ;AAC9C,QAAM,QAAQ,MAAM,UAAU,IAAI;AAClC,QAAM,WAAW,MAAM,QAAQ;AAAA,IAC7B,MAAM,IAAI,OAAO,QAAQ;AACvB,YAAM,UAAU,MAAM,SAAS,KAAK,KAAK,MAAM,GAAG,GAAG,MAAM;AAC3D,aAAO,aAAa,GAAG;AAAA,EAAS,OAAO;AAAA,IACzC,CAAC;AAAA,EACH;AACA,SAAO,SAAS,KAAK,MAAM;AAC7B;;;ADxGA,IAAM,mBAAmB;AAEzB,IAAM,eAAe,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO;AAClE,IAAM,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO;AACtE,IAAM,iBAAiB,EACpB,OAAO;AAAA,EACN,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACjD,MAAM,EAAE,KAAK,CAAC,QAAQ,MAAM,CAAC,EAAE,SAAS;AAAA,EACxC,QAAQ,EAAE,OAAO,EAAE,SAAS;AAC9B,CAAC,EACA,OAAO;AACV,IAAM,eAAe,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,CAAC,EAAE,OAAO;AACtE,IAAM,wBAAwB,EAC3B,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,EACxC,OAAO;AAEH,IAAM,mBAAmB;AAAA,EAC9B;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IAEF,aAAa,EAAE,MAAM,UAAU,YAAY,CAAC,GAAG,sBAAsB,MAAM;AAAA,EAC7E;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IAEF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,MAAM,EAAE,MAAM,UAAU,aAAa,8CAAqB;AAAA,MAC5D;AAAA,MACA,UAAU,CAAC,MAAM;AAAA,MACjB,sBAAsB;AAAA,IACxB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IAEF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,OAAO,EAAE,MAAM,UAAU,aAAa,+DAAiC;AAAA,MACzE;AAAA,MACA,UAAU,CAAC,OAAO;AAAA,MAClB,sBAAsB;AAAA,IACxB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IAGF,aAAa,EAAE,MAAM,UAAU,YAAY,CAAC,GAAG,sBAAsB,MAAM;AAAA,EAC7E;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IAEF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,OAAO,EAAE,MAAM,UAAU,aAAa,yBAAe;AAAA,QACrD,MAAM,EAAE,MAAM,UAAU,MAAM,CAAC,QAAQ,MAAM,EAAE;AAAA,QAC/C,QAAQ,EAAE,MAAM,UAAU,aAAa,8CAAqB;AAAA,MAC9D;AAAA,MACA,sBAAsB;AAAA,IACxB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IAEF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,UAAU,EAAE,MAAM,UAAU,aAAa,gCAAiB;AAAA,MAC5D;AAAA,MACA,UAAU,CAAC,UAAU;AAAA,MACrB,sBAAsB;AAAA,IACxB;AAAA,EACF;AAAA,EACA;AAAA,IACE,MAAM;AAAA,IACN,aACE;AAAA,IAGF,aAAa;AAAA,MACX,MAAM;AAAA,MACN,YAAY;AAAA,QACV,QAAQ;AAAA,UACN,MAAM;AAAA,UACN,aAAa;AAAA,QACf;AAAA,MACF;AAAA,MACA,sBAAsB;AAAA,IACxB;AAAA,EACF;AACF;AAEA,SAAS,gBAAqD;AAC5D,QAAM,SAAS,QAAQ,IAAI;AAC3B,MAAI,CAAC,QAAQ;AACX,UAAM,IAAI;AAAA,MACR,UAAU;AAAA,MACV;AAAA,IAEF;AAAA,EACF;AACA,QAAM,WAAW,QAAQ,IAAI,qBAAqB,kBAAkB,QAAQ,QAAQ,EAAE;AACtF,SAAO,EAAE,QAAQ,QAAQ;AAC3B;AAEA,eAAe,eAAe,UAAkB,QAAmD;AACjG,QAAM,EAAE,QAAQ,QAAQ,IAAI,cAAc;AAC1C,QAAM,MAAM,IAAI,IAAI,GAAG,OAAO,GAAG,QAAQ,EAAE;AAC3C,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,UAAU,CAAC,CAAC,GAAG;AACvD,QAAI,aAAa,IAAI,KAAK,KAAK;AAAA,EACjC;AACA,QAAM,WAAW,MAAM,MAAM,KAAK;AAAA,IAChC,SAAS,EAAE,eAAe,UAAU,MAAM,GAAG;AAAA,EAC/C,CAAC;AACD,QAAM,OAAO,MAAM,SAAS,KAAK;AACjC,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,IAAI,MAAM,gBAAgB,SAAS,MAAM,KAAK,KAAK,MAAM,GAAG,GAAG,CAAC,EAAE;AAAA,EAC1E;AACA,SAAO,KAAK,MAAM,IAAI;AACxB;AAEA,SAAS,aAAa,MAAc;AAClC,SAAO,EAAE,SAAS,CAAC,EAAE,MAAM,QAAiB,KAAK,CAAC,EAAE;AACtD;AAEA,SAAS,aAAa,OAAgB;AACpC,SAAO,aAAa,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;AACpD;AAEO,SAAS,cAAcA,SAAsB;AAClD,EAAAA,QAAO,kBAAkB,wBAAwB,aAAa;AAAA,IAC5D,OAAO,iBAAiB,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE;AAAA,EAC/C,EAAE;AAEF,EAAAA,QAAO,kBAAkB,uBAAuB,OAAO,YAAY;AACjE,UAAM,OAAQ,QAAQ,OAAO,aAAa,CAAC;AAC3C,QAAI;AACF,cAAQ,QAAQ,OAAO,MAAM;AAAA,QAC3B,KAAK;AACH,iBAAO,aAAa,MAAM,SAAS,CAAC;AAAA,QACtC,KAAK,mBAAmB;AACtB,gBAAM,QAAQ,aAAa,MAAM,IAAI;AACrC,gBAAM,UAAU,MAAM,QAAQ,MAAM,IAAI;AACxC,cAAI,YAAY,MAAM;AACpB,kBAAM,IAAI;AAAA,cACR,UAAU;AAAA,cACV,oEAAkB,MAAM,IAAI;AAAA,YAC9B;AAAA,UACF;AACA,iBAAO,aAAa,OAAO;AAAA,QAC7B;AAAA,QACA,KAAK,sBAAsB;AACzB,gBAAM,QAAQ,gBAAgB,MAAM,IAAI;AACxC,iBAAO,aAAa,MAAM,WAAW,MAAM,KAAK,CAAC;AAAA,QACnD;AAAA,QACA,KAAK;AACH,iBAAO,aAAa,MAAM,sBAAsB,CAAC;AAAA,QACnD,KAAK,sBAAsB;AACzB,gBAAM,QAAQ,eAAe,MAAM,IAAI;AACvC,gBAAM,SAAiC,CAAC;AACxC,cAAI,MAAM,MAAO,QAAO,QAAQ,OAAO,MAAM,KAAK;AAClD,cAAI,MAAM,KAAM,QAAO,OAAO,MAAM;AACpC,cAAI,MAAM,OAAQ,QAAO,SAAS,MAAM;AACxC,iBAAO,aAAa,MAAM,eAAe,wBAAwB,MAAM,CAAC;AAAA,QAC1E;AAAA,QACA,KAAK,oBAAoB;AACvB,gBAAM,QAAQ,aAAa,MAAM,IAAI;AACrC,iBAAO;AAAA,YACL,MAAM;AAAA,cACJ,wBAAwB,mBAAmB,MAAM,QAAQ,CAAC;AAAA,YAC5D;AAAA,UACF;AAAA,QACF;AAAA,QACA,KAAK,oBAAoB;AACvB,gBAAM,QAAQ,sBAAsB,MAAM,IAAI;AAC9C,gBAAM,SAAiC,CAAC;AACxC,cAAI,MAAM,OAAQ,QAAO,UAAU,MAAM;AACzC,iBAAO;AAAA,YACL,MAAM,eAAe,iCAAiC,MAAM;AAAA,UAC9D;AAAA,QACF;AAAA,QACA;AACE,gBAAM,IAAI;AAAA,YACR,UAAU;AAAA,YACV,0BAA0B,QAAQ,OAAO,IAAI;AAAA,UAC/C;AAAA,MACJ;AAAA,IACF,SAAS,OAAO;AACd,UAAI,iBAAiB,SAAU,OAAM;AACrC,YAAM,UAAU,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACrE,aAAO,EAAE,SAAS,MAAM,SAAS,CAAC,EAAE,MAAM,QAAiB,MAAM,QAAQ,CAAC,EAAE;AAAA,IAC9E;AAAA,EACF,CAAC;AACH;;;ADtNA,IAAM,UACJ,OAA0C,WAAsB;AAE3D,IAAM,sBAAsB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWjC,KAAK;AAEA,SAAS,eAAuB;AACrC,QAAMC,UAAS,IAAI;AAAA,IACjB,EAAE,MAAM,gBAAgB,SAAS,QAAQ;AAAA,IACzC,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,GAAG,cAAc,oBAAoB;AAAA,EACnE;AACA,gBAAcA,OAAM;AACpB,SAAOA;AACT;;;ADxBA,IAAM,SAAS,aAAa;AAC5B,IAAM,YAAY,IAAI,qBAAqB;AAC3C,MAAM,OAAO,QAAQ,SAAS;","names":["server","server"]}

package/docs/api-reference.md

@@ -99,6 +99,19 @@ fallback 네비를 렌더하세요 (`menus.md` 참고).
   "updated_at": null }
 ```
 
+## GET /v1/cms/public/site-knowledge
+
+사이트 지식 — 브랜드 보이스(어조·톤·화자) + 용어 규칙(금지어·교정어). AI
+에이전트가 이 사이트에 맞는 글을 쓸 때 참고. 운영 메모·내부 SEO 임계값·내부
+출처는 노출 안 함 (theme-and-settings.md 참고).
+
+```json
+{ "tenant_id": "…", "site_id": "…",
+  "brand": { "voice": "", "tone": "", "persona": "" },
+  "lexicon": { "forbidden_words": [], "preferred_terms": [{ "from": "유저", "to": "사용자" }] },
+  "updated_at": null }
+```
+
 ## GET /v1/cms/public/business-profile
 
 비즈니스 프로필 (로컬 SEO) — 어드민 "운영 > 비즈니스 프로필" 저장값.

package/docs/collections.md

@@ -188,6 +188,27 @@ export default createPostOgImage(
 ]
 ```
 
+## 명시 섹션 — `collection_key` (권장)
+
+공개 API의 글(post) 응답에는 글이 속한 섹션을 직접 가리키는 **`collection_key`**
+필드가 포함됩니다. 어드민 글쓰기에서 "어디에 올릴까요?"로 고른 섹션이 이 값으로
+저장됩니다. `cms-client`의 `CmsPostContent.collectionKey`로 받습니다.
+
+`resolvePostCollection(post, collections)`는 **`collectionKey`가 있으면 그것을
+우선** 사용하고(일치하는 섹션이 있을 때), 없으면 기존처럼 글의 카테고리 slug로
+섹션을 파생합니다. 즉:
+
+- 신규 글: `collectionKey`로 섹션이 명확히 결정됩니다(카테고리는 순수 "주제"로만 쓰임).
+- 구 글/구 서버: `collection_key`가 없으므로 카테고리 파생으로 **그대로 동작**(하위호환).
+
+```ts
+// 소비자 코드는 동일 — resolver가 collectionKey 를 우선 사용.
+const c = resolvePostCollection(post, collections);
+```
+
+> 마이그레이션 중에는 두 방식이 공존합니다. `collection_key`가 채워진 글은 카테고리와
+> 무관하게 그 섹션으로 라우팅되고, 비어 있는 글은 카테고리로 판정됩니다.
+
 ## slug 변경과 301
 
 글의 slug(`/{slug}` 부분)는 글 편집 화면에서 바꿉니다. 바꾼 뒤 옛 slug로 들어오면 `postRedirectPath`로

package/docs/theme-and-settings.md

@@ -87,3 +87,37 @@ const config = await fetchAnalyticsConfig({
 
 `enabled: true`인 태그만 렌더링하세요. 태그 ID는 어드민에서 변경될 수
 있으므로 하드코딩하지 말고 본 API로 조회하는 것을 권장합니다.
+
+## 사이트 지식 — 브랜드 보이스 (AI 에이전트용)
+
+이 사이트의 **브랜드 보이스**(어조·톤·화자)와 **용어 규칙**(금지어·교정어)을
+반환합니다. 고객 측 AI 에이전트가 이 사이트에 맞는 글을 쓰기 전에 조회해
+톤·표현을 맞추는 용도입니다. RootTale 어드민의 **설정 > 블로그 > 지식 규칙**에서
+저장한 값이며, 운영 메모·내부 SEO 임계값·내부 출처 목록은 노출되지 않습니다.
+
+MCP 도구 `getSiteKnowledge` 로 조회하거나 공개 API 를 직접 호출합니다.
+
+```http
+GET /v1/cms/public/site-knowledge
+Authorization: Bearer rtlk_cust_***
+```
+
+```jsonc
+{
+  "tenant_id": "…",
+  "site_id": "…",
+  "brand": { "voice": "존댓말, 쉬운 말", "tone": "차분하고 신뢰감 있게", "persona": "세무 상담이 처음인 사장님 대상" },
+  "lexicon": {
+    "forbidden_words": ["대박", "100% 보장"],
+    "preferred_terms": [{ "from": "유저", "to": "사용자" }]
+  },
+  "updated_at": "2026-06-24T…Z"
+}
+```
+
+AI 에이전트 활용 규칙:
+
+- `brand` 의 어조·톤·화자를 글의 문체에 반영하세요.
+- `forbidden_words` 의 표현은 본문에 쓰지 마세요.
+- `preferred_terms` 는 `from` 표현 대신 `to` 표현을 쓰세요.
+- 값은 어드민에서 바뀔 수 있으니 하드코딩하지 말고 본 API 로 조회하세요.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@roottale/cms-mcp",
-  "version": "0.32.0",
+  "version": "0.33.0",
   "type": "module",
   "description": "RootTale CMS integration MCP server — bundled integration docs, Next.js example code, and public API lookup tools. Run with: npx @roottale/cms-mcp",
   "bin": {