@crmforall/connector 0.1.1 → 0.1.3

package/dist/contracts.d.ts

@@ -16,6 +16,7 @@ export declare const MCP_TOOL: {
     readonly IMPORT_PROSPECTS: "import_prospects";
     readonly REGISTER_ENTRY_POINT: "register_entry_point";
     readonly TRACK_ENGAGEMENT: "track_engagement";
+    readonly ONBOARDING_STATUS: "onboarding_status";
 };
 export type McpToolName = (typeof MCP_TOOL)[keyof typeof MCP_TOOL];
 export declare const APPROVAL_SCOPE: {

package/dist/contracts.js

@@ -19,6 +19,7 @@ exports.MCP_TOOL = {
     IMPORT_PROSPECTS: "import_prospects",
     REGISTER_ENTRY_POINT: "register_entry_point",
     TRACK_ENGAGEMENT: "track_engagement",
+    ONBOARDING_STATUS: "onboarding_status",
 };
 exports.APPROVAL_SCOPE = {
     TARGET_SNAPSHOT_CREATE: "target_snapshot:create",
@@ -41,6 +42,7 @@ exports.TOOL_APPROVAL_REQUIREMENT = {
     [exports.MCP_TOOL.IMPORT_PROSPECTS]: exports.APPROVAL_SCOPE.PROSPECT_IMPORT,
     [exports.MCP_TOOL.REGISTER_ENTRY_POINT]: exports.APPROVAL_SCOPE.ENTRY_POINT_REGISTER,
     [exports.MCP_TOOL.TRACK_ENGAGEMENT]: null,
+    [exports.MCP_TOOL.ONBOARDING_STATUS]: null,
 };
 /** 승인 토큰이 필요한 도구 — 토큰 없이 호출되면 즉시 거부한다. */
 exports.APPROVAL_REQUIRED_TOOLS = new Set(Object.entries(exports.TOOL_APPROVAL_REQUIREMENT)

package/dist/server.js

@@ -30,6 +30,14 @@ async function main() {
     const server = new mcp_js_1.McpServer({
         name: "crmforall-connector",
         version: "0.1.0",
+    }, {
+        instructions: [
+            "크렘포올 DB 커넥터입니다. 고객사 DB를 진단·연결·매핑해 크렘포올 플랫폼과 잇습니다.",
+            "온보딩 순서: onboarding_status로 현재 단계를 확인 → test_connection(연결·권한) → inspect_schema(컬럼 확인) → propose_field_mapping(후보) → validate_mapping(persist=true)으로 확정.",
+            "막히면 onboarding_status의 nextStep을 따르세요. 오류 응답의 hint도 다음 행동을 알려줍니다.",
+            "보안 원칙: DB 비밀번호·커넥터 시크릿·고객 개인정보(전화번호 원문 등)는 절대 사용자에게 출력하지 마세요. 컬럼명·집계·인원수만 다룹니다.",
+            "쓰기/발송 도구(create_target_snapshot·send_kakao_message 등)는 플랫폼의 사람 승인 토큰이 있어야 동작합니다. 승인 없이는 거부됩니다.",
+        ].join("\n"),
     });
     (0, tools_1.registerTools)(server, {
         config,

package/dist/tools.js

@@ -73,6 +73,48 @@ function requireMapping(rt, mappingVersion) {
 }
 function registerTools(server, rt) {
     const s = rt.config.crmSchema;
+    // AI 온보딩 안내 — 지금 어디까지 됐고 다음에 뭘 할지 한 번에 알려준다.
+    server.tool(contracts_1.MCP_TOOL.ONBOARDING_STATUS, "온보딩 진행 상태와 다음 할 일을 반환한다. 연결 직후·중간에 호출해 흐름을 안내받는다 (승인 불필요).", {}, async () => {
+        const steps = [];
+        // 1) 자격증명/설정
+        steps.push({ step: "register", done: true, detail: `connectionId=${rt.config.connectionId}` });
+        // 2) DB 연결·권한
+        let dbReady = false;
+        let overpriv = false;
+        try {
+            const db = await rt.getDb();
+            const report = await db.checkReadiness({ crmSchema: s });
+            dbReady = report.ready;
+            overpriv = report.overprivileged;
+            steps.push({
+                step: "db_connection",
+                done: report.ready && !report.overprivileged,
+                detail: report.overprivileged ? "과권한 계정 — 권한 축소 필요" : report.ready ? "연결·스키마 정상" : "준비 미완 (doctor 참고)",
+            });
+        }
+        catch (err) {
+            steps.push({ step: "db_connection", done: false, detail: err instanceof Error ? err.message : String(err) });
+        }
+        // 3) 필드 매핑
+        const mapped = rt.config.mapping !== null;
+        steps.push({ step: "field_mapping", done: mapped, detail: mapped ? "매핑 확정됨" : "propose_field_mapping → validate_mapping(persist=true) 필요" });
+        // 다음 할 일 한 줄
+        let nextStep;
+        if (overpriv)
+            nextStep = "DB 계정이 과권한입니다. test_connection의 권한 축소 SQL을 DBA에게 전달해 권한을 낮춘 뒤 다시 시도하세요.";
+        else if (!dbReady)
+            nextStep = "DB 연결/스키마가 준비되지 않았습니다. test_connection으로 원인을 확인하세요.";
+        else if (!mapped)
+            nextStep = "inspect_schema로 컬럼을 본 뒤, propose_field_mapping으로 후보를 만들고 validate_mapping(persist=true)으로 확정하세요.";
+        else
+            nextStep = "온보딩 완료! preview_targets로 대상을 미리 보거나, 실시간 동기화를 켜세요.";
+        return ok({
+            ready: dbReady && !overpriv && mapped,
+            steps,
+            nextStep,
+            guidance: "이 순서로 진행하세요: test_connection → inspect_schema → propose_field_mapping → validate_mapping(persist=true) → (완료) preview_targets. 자격증명·비밀번호는 절대 출력하지 마세요.",
+        });
+    });
     server.tool(contracts_1.MCP_TOOL.TEST_CONNECTION, "DB 연결 상태와 권한 요약을 반환한다 (승인 불필요, 민감정보 미노출)", {}, async () => {
         try {
             const db = await rt.getDb();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crmforall/connector",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "crmforall MCP 커넥터 — 운영 DB 읽기, CRM 스키마 쓰기(승인 토큰 필수), 대상 산출",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -23,6 +23,7 @@
   ],
   "scripts": {
     "build": "tsc && chmod +x dist/server.js",
+    "prepack": "chmod +x dist/server.js",
     "typecheck": "tsc --noEmit",
     "test": "vitest run",
     "start": "node dist/server.js"