══════════════════════════════════════════════════════
  K-System MCP - 빠른 시작 (Quick Start)
══════════════════════════════════════════════════════

이 폴더가 어떻게 만들어졌나요?
  https://aitwin.flextudio.com/client/install.bat 을 임의의 폴더에
  받아 더블 클릭하면 본 폴더(C:\ksystem-mcp)가 자동 생성됩니다.
  (Mac/수동 설치는 INSTALL.txt 참고)

──────────────────────────────────────────────────────
[이 폴더의 파일들]
──────────────────────────────────────────────────────

  launcher.cjs     시작점 — 매 실행 시 자동 업데이트 확인 후 본체 실행
  ksystem-mcp.cjs  MCP 서버 본체 (ERP 분석·실행 도구)
  setup.cjs        최초 인증(이메일 OTP·기기 등록) + DB 연결 테스트
  config.json      DB 접속 정보 (브라우저 관리 화면이 관리 — 직접 편집 X)
  auth.json        인증 토큰 (시스템 자동 관리 — 건드리지 않음)
  version.txt      현재 버전
  .claude/skills/  Claude 자동 적용 업무 가이드
  logs/            로컬 실행 로그

  ※ config.json / auth.json / logs 는 자동 업데이트 시에도 보존됩니다.

──────────────────────────────────────────────────────
[1] Claude Code 첫 실행
──────────────────────────────────────────────────────

  cmd(명령 프롬프트)에서:
      cd C:\ksystem-mcp
      claude

  처음이면 로그인 선택이 나옵니다 — ★ 반드시 1번(claude.ai 구독) 선택.
  브라우저 로그인 완료 후 cmd로 돌아와 메시지를 입력합니다.

──────────────────────────────────────────────────────
[2] K-System MCP 도구 사용 확인
──────────────────────────────────────────────────────

  Claude 안에서:
      /mcp

  ksystem 항목이 "✓ Connected" 면 정상.
  만약 "Failed to connect" 면 cmd에서:
      node setup.cjs      ← 이 폴더에서 실행
  → 회사 이메일 입력 → 받은 6자리 코드 입력
  → 자동으로 열리는 브라우저 관리 화면에서 DB 정보 입력 → 연결 테스트 → 저장

  ⛔ config.json 을 직접 편집하거나 Claude에게 편집을 시키지 마세요 (차단됨).
     DB 정보는 위 관리 화면으로만 넣습니다. 비밀번호는 암호화 저장되며,
     프롬프트에 비밀번호를 입력하면 안 됩니다.

  ※ 도구 권한 확인 창은 자동 설정됩니다 (v0.5.6+).
     처음 1~2회 세션 이후에는 묻지 않습니다.

──────────────────────────────────────────────────────
[3] 첫 명령어 예시
──────────────────────────────────────────────────────

  Claude 안에서 자연어로 입력하면 자동으로 ksystem 도구가 호출됩니다.

  "이번 달 수주 현황 보여줘"
  "거래처등록 화면 분석해줘"
  "EnvSeq 6504 가 뭐야?"
  "수주입력 화면 테스트해줘"

──────────────────────────────────────────────────────
[4] 업데이트
──────────────────────────────────────────────────────

  자동입니다 — launcher가 Claude 시작 시마다 최신 버전을 확인·적용합니다.
  Claude 를 재시작하기만 하면 됩니다. 별도 작업 불필요.

  응급 복구(파일 깨짐 등): install.bat 을 다시 받아 더블 클릭
      https://aitwin.flextudio.com/client/install.bat

──────────────────────────────────────────────────────
[5] 문제가 생기면
──────────────────────────────────────────────────────

  Claude 안에서:
      "이슈 리포트 해줘"

  → 자동으로 로그·환경 정보를 수집해 개발팀에 전송됩니다.

  DB 변경·전환, 사전 설치(Node.js/Git/Claude Code), 문제 해결은
  INSTALL.txt 참조.
