docuking-mcp 1.2.2 → 1.2.3

package/index.js

@@ -272,7 +272,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       },
       {
         name: 'docuking_plan',
-        description: '작업 계획 문서를 z_PlanToResult/ 폴더에 생성하거나 업데이트합니다. 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
+        description: '작업 계획 문서를 z_Plan_Result/ 폴더에 생성하거나 업데이트합니다. 작업 시작 시 계획을 작성하고, 진행하면서 결과를 upsert합니다.',
         inputSchema: {
           type: 'object',
           properties: {
@@ -413,10 +413,34 @@ zz_Coworker_*/
 - git 저장소 크기 최적화 (대용량 문서 제외)
 - DocuKing이 문서 버전 관리를 전담
 
+## AI 필수 작업 흐름 (매우 중요!)
+
+### MCP 서버 추가 시 (claude mcp add 명령 실행 후)
+1. \`claude mcp add docuking ...\` 명령 실행
+2. 사용자에게 "재시작 후 아래 명령을 다시 붙여넣으세요" 안내
+3. 재시작 후 \`docuking_init\` 실행
+
+### docuking_init 실행 후 (⚠️ 필수!)
+1. init 결과에서 \`DOCUKING_REPOS\` 값 확인
+2. **AI가 직접** \`~/.claude.json\` 파일을 Edit 도구로 수정:
+   - 해당 프로젝트의 \`mcpServers.docuking.env\`에 \`DOCUKING_REPOS\` 추가
+   - 기존 env에 추가하는 것이므로 DOCUKING_API_KEY는 유지
+3. 사용자에게 "재시작 후 push 가능" 안내
+
+**예시 (AI가 수행할 Edit):**
+\`\`\`json
+// ~/.claude.json의 해당 프로젝트 mcpServers.docuking.env
+{
+  "DOCUKING_API_KEY": "sk_xxx...",
+  "DOCUKING_REPOS": "{\\"경로\\":{\\"id\\":\\"프로젝트ID\\",\\"name\\":\\"이름\\"}}"
+}
+\`\`\`
+
 ## MCP 도구 목록
 
 ### 1. docuking_init
 프로젝트를 DocuKing에 연결합니다.
+**중요:** init 후 AI가 ~/.claude.json에 DOCUKING_REPOS를 추가해야 함!
 
 ### 2. docuking_push
 로컬 문서를 서버에 업로드합니다. Git의 add + commit + push를 한 번에 수행.
@@ -446,7 +470,7 @@ zz_Coworker_*/
 - 사용자가 "이거 기록해줘"라고 요청할 때
 
 ### 10. docuking_plan
-작업 계획을 \`z_PlanToResult/\` 폴더에 생성/업데이트합니다.
+작업 계획을 \`z_Plan_Result/\` 폴더에 생성/업데이트합니다.
 - 작업 시작 시 계획 생성
 - 진행하면서 단계별 결과 upsert
 - planId로 기존 계획 찾아서 업데이트
@@ -654,7 +678,7 @@ AI: (결정이 내려졌으므로 docuking_talk 호출)
     })
 \`\`\`
 
-**저장 위치:** \`z_Talk/YYYY/MM/YYYY-MM-DD_HHMM__제목.md\`
+**저장 위치:** \`z_DocuKing/z_Talk/YYYY/MM/YYYY-MM-DD_HHMM__제목.md\`
 
 ### 작업 계획 관리 (docuking_plan, docuking_done)
 
@@ -705,7 +729,7 @@ AI: docuking_done({
     })
 \`\`\`
 
-**저장 위치:** \`z_PlanToResult/YYYY/MM/YYYY-MM-DD_HHMM__제목__planId.md\`
+**저장 위치:** \`z_DocuKing/z_Plan_Result/YYYY/MM/YYYY-MM-DD_HHMM__제목__planId.md\`
 
 **핵심 가치:**
 - AI 세션이 끊겨도 (컴팩션, 세션 종료) 다음 AI가 계획 문서를 보고 이어서 작업 가능
@@ -930,7 +954,7 @@ MCP 설정에 다음을 추가하세요:
 💡 참여자는 ${folderName}/ 폴더에만 Push할 수 있습니다.
    오너의 문서는 Pull로 읽을 수 있지만 수정은 제안서 형태로 작성하세요.
 
-MCP 설정에 레포 매핑 추가 필요:
+⚠️ AI 필수 작업: ~/.claude.json의 docuking MCP env에 DOCUKING_REPOS 추가 필요
 "DOCUKING_REPOS": "${repoConfig}"`,
         },
       ],
@@ -953,7 +977,7 @@ MCP 설정에 레포 매핑 추가 필요:
 - "DocuKing에 올려줘" → 로컬 문서를 서버에 Push
 - "DocuKing에서 가져와" → 서버 문서를 로컬로 Pull
 
-MCP 설정에 레포 매핑 추가 필요:
+⚠️ AI 필수 작업: ~/.claude.json의 docuking MCP env에 DOCUKING_REPOS 추가 필요
 "DOCUKING_REPOS": "${repoConfig}"`,
         },
       ],
@@ -1872,8 +1896,8 @@ function generatePlanId() {
 async function handleTalk(args) {
   const { localPath, title, content, tags = [] } = args;
 
-  // z_Talk 폴더 경로
-  const talkBasePath = path.join(localPath, 'z_Talk');
+  // z_Talk 폴더 경로 (z_DocuKing 아래)
+  const talkBasePath = path.join(localPath, 'z_DocuKing', 'z_Talk');
 
   // 날짜 기반 파일명 생성
   const { fileName, yearMonth, timestamp } = generateDateFileName(title);
@@ -1926,8 +1950,8 @@ ${content}
 async function handlePlan(args) {
   const { localPath, planId, title, goal, steps = [], notes } = args;
 
-  // z_PlanToResult 폴더 경로
-  const planBasePath = path.join(localPath, 'z_PlanToResult');
+  // z_Plan_Result 폴더 경로 (z_DocuKing 아래)
+  const planBasePath = path.join(localPath, 'z_DocuKing', 'z_Plan_Result');
 
   // 기존 계획 업데이트 또는 새 계획 생성
   let targetPlanId = planId;
@@ -2077,8 +2101,8 @@ function findPlanFiles(basePath, planId) {
 async function handleDone(args) {
   const { localPath, planId, summary, artifacts = [] } = args;
 
-  // z_PlanToResult 폴더 경로
-  const planBasePath = path.join(localPath, 'z_PlanToResult');
+  // z_Plan_Result 폴더 경로 (z_DocuKing 아래)
+  const planBasePath = path.join(localPath, 'z_DocuKing', 'z_Plan_Result');
 
   // 계획 파일 찾기
   const planFiles = findPlanFiles(planBasePath, planId);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docuking-mcp",
-  "version": "1.2.2",
+  "version": "1.2.3",
   "description": "DocuKing MCP Server - AI 시대의 문서 협업 플랫폼",
   "type": "module",
   "main": "index.js",