docuking-mcp 1.2.1 → 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가 계획 문서를 보고 이어서 작업 가능
@@ -885,24 +909,62 @@ MCP 설정에 다음을 추가하세요:
     };
   }
 
-  // z_DocuKing 폴더 생성 (항상 새로 만듦)
-  const folderName = 'z_DocuKing';
-  const docuKingPath = path.join(localPath, folderName);
+  // Co-worker 권한은 API Key 형식에서 판단 (sk_xxx_cw_이름_)
+  const coworkerMatch = API_KEY.match(/^sk_[a-f0-9]+_cw_([^_]+)_/);
+  const isCoworker = !!coworkerMatch;
+  const coworkerName = coworkerMatch ? coworkerMatch[1] : null;
 
-  if (!fs.existsSync(docuKingPath)) {
-    fs.mkdirSync(docuKingPath, { recursive: true });
+  // 폴더 생성: 코워커는 zz_Coworker_{이름}/, 오너는 z_DocuKing/
+  let folderName;
+  let workingPath;
+
+  if (isCoworker) {
+    folderName = `zz_Coworker_${coworkerName}`;
+    workingPath = path.join(localPath, folderName);
+  } else {
+    folderName = 'z_DocuKing';
+    workingPath = path.join(localPath, folderName);
+  }
+
+  if (!fs.existsSync(workingPath)) {
+    fs.mkdirSync(workingPath, { recursive: true });
   }
 
   // JSON 이스케이프 처리
   const escapedPath = localPath.replace(/\\/g, '\\\\');
   const repoConfig = `{\\"${escapedPath}\\":{\\"id\\":\\"${projectId}\\",\\"name\\":\\"${projectName}\\"}}`;
 
-  // 연결 완료 안내
-  return {
-    content: [
-      {
-        type: 'text',
-        text: `DocuKing 연결 완료!
+  // 연결 완료 안내 (오너/코워커에 따라 다른 메시지)
+  if (isCoworker) {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `DocuKing 연결 완료! (참여자)
+
+📁 프로젝트: ${projectName}
+📂 ${folderName}/ 폴더가 생성되었습니다.
+👤 참여자: ${coworkerName}
+
+참여자 사용법:
+- "DocuKing에서 가져와" → 오너의 문서를 z_DocuKing/에 Pull
+- ${folderName}/ 폴더에 문서 작성
+- "DocuKing에 올려줘" → 내 문서를 서버에 Push
+
+💡 참여자는 ${folderName}/ 폴더에만 Push할 수 있습니다.
+   오너의 문서는 Pull로 읽을 수 있지만 수정은 제안서 형태로 작성하세요.
+
+⚠️ AI 필수 작업: ~/.claude.json의 docuking MCP env에 DOCUKING_REPOS 추가 필요
+"DOCUKING_REPOS": "${repoConfig}"`,
+        },
+      ],
+    };
+  } else {
+    return {
+      content: [
+        {
+          type: 'text',
+          text: `DocuKing 연결 완료!
 
 📁 프로젝트: ${projectName}
 📂 z_DocuKing/ 폴더가 생성되었습니다.
@@ -915,11 +977,12 @@ MCP 설정에 다음을 추가하세요:
 - "DocuKing에 올려줘" → 로컬 문서를 서버에 Push
 - "DocuKing에서 가져와" → 서버 문서를 로컬로 Pull
 
-MCP 설정에 레포 매핑 추가 필요:
+⚠️ AI 필수 작업: ~/.claude.json의 docuking MCP env에 DOCUKING_REPOS 추가 필요
 "DOCUKING_REPOS": "${repoConfig}"`,
-      },
-    ],
-  };
+        },
+      ],
+    };
+  }
 }
 
 // docuking_push 구현
@@ -1833,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);
@@ -1887,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;
@@ -2038,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.1",
+  "version": "1.2.3",
   "description": "DocuKing MCP Server - AI 시대의 문서 협업 플랫폼",
   "type": "module",
   "main": "index.js",