# 롱텀 코파일럿 — 빠른 시작 (베타)

`longtermcare.or.kr` 업무 AI 에이전트 (장기요양 기관 담당자용 CLI/MCP).

본 zip 패키지에는 `auth-bridge` 바이너리와 4개의 tarball(`@ltc/types`, `@ltc/core`, `@ltc/cli`, `@ltc/mcp`)이 동봉됩니다. Node.js 22 이상 설치 후 `npm install -g` 한 줄로 `ltc` CLI를 즉시 사용할 수 있습니다.

---

## 5분 설치 (6 step)

### ① 압축 해제

압축 해제 후 임의의 디렉토리에 `auth-bridge-<os>-<arch>` 바이너리를 배치합니다.

```bash
# 예 (macOS arm64)
unzip ltc-darwin-arm64.zip -d ~/ltc-bridge
chmod +x ~/ltc-bridge/auth-bridge-darwin-arm64
```

### ② ltc CLI 설치 (Node.js 22 필요)

Node.js 22 이상이 없다면 먼저 설치하세요:

- **Windows / macOS**: https://nodejs.org/ko 에서 LTS 22.x 다운로드
- **macOS (Homebrew)**: `brew install node@22`
- **Linux**: `nvm install 22` 또는 `sudo apt-get install nodejs` (v22 저장소 추가 후)

Node.js 준비 후, zip 압축을 해제한 디렉토리 안에서:

```bash
# macOS / Linux (wildcard로 동봉된 tarball 자동 매칭 — 버전 수동 입력 불필요)
npm install -g ./ltc-types-*.tgz ./ltc-core-*.tgz ./ltc-mcp-*.tgz ./ltc-cli-*.tgz
```

```powershell
# Windows PowerShell (wildcard 미지원 — 본 zip의 실제 파일명을 그대로 사용)
ls *.tgz   # 동봉된 tarball 파일명 확인
npm install -g .\ltc-types-<버전>.tgz .\ltc-core-<버전>.tgz .\ltc-mcp-<버전>.tgz .\ltc-cli-<버전>.tgz
```

권한 에러(`EACCES`/`EPERM`) 발생 시:
- **macOS/Linux**: `sudo` 추가
- **Windows**: PowerShell을 "관리자 권한으로 실행"

설치 검증:

```bash
ltc --version
# → ltc 0.0.10.2 (auth-bridge 0.0.10.2-darwin-arm64)   같은 형식 출력
```

### ③ `LTC_AUTH_BRIDGE_BIN` 환경변수 설정

`ltc` CLI가 본 바이너리를 찾을 수 있도록 절대경로를 지정합니다.

```bash
# bash/zsh (macOS, Linux)
export LTC_AUTH_BRIDGE_BIN="$HOME/ltc-bridge/auth-bridge-darwin-arm64"

# PowerShell (Windows)
$env:LTC_AUTH_BRIDGE_BIN = "C:\ltc-bridge\auth-bridge-windows-amd64.exe"
```

영구 설정은 `~/.zshrc` / `~/.bashrc` / PowerShell 프로필에 추가하세요.

### ④ `ltc doctor` — 환경 진단

```bash
ltc doctor
```

`auth-bridge` 경로 + Keychain 접근 + 인증서 디렉토리 상태를 점검합니다.

### ⑤ `ltc setup` — 인증서·기관기호 등록 (대화형)

기관 인증서(`signCert.der`, `signPri.key`)를 미리 준비해 둔 디렉토리 안에 두고, 인자 없이 `ltc setup`을 실행하면 4개 질문이 순서대로 표시됩니다. 비밀번호는 OS Keychain에만 저장됩니다 (평문 저장 0건).

```bash
ltc setup
? 인증서 디렉토리 경로 (Enter=기본값 사용, 수정 시 Backspace): ~/ltc-bridge/<기관명>
? 인증서 비밀번호: ************
? 기관기호 (10~11자리 숫자): 21165000216
? 기관 유형 코드: B01   (방문요양)
✓ 로그인 테스트 성공
```

> 경로 입력은 `~/ltc-bridge/<기관명>` (모든 OS) 또는 `C:\ltc-bridge\<기관명>` (Windows 절대경로) 모두 가능합니다. `~/`는 본인 홈 디렉터리로 자동 확장됩니다.

### ⑥ `ltc mcp install` — MCP 클라이언트 등록 (선택)

Claude Desktop / Claude Code / Codex / Cursor에 1줄 등록합니다.

```bash
ltc mcp install --target claude-desktop
# 또는: --target claude-code | codex-cli | cursor | manual
```

v0.0.7부터 zip 동봉 `ltc-mcp-*.tgz`가 함께 글로벌 설치되므로 모든 target이 정상 동작합니다. repo clone은 불필요합니다.

---

## 무결성 검증 (선택)

본 zip의 SHA256은 GitHub Releases의 `SHA256SUMS.txt`로 검증할 수 있습니다.

```bash
shasum -a 256 ltc-darwin-arm64.zip
# 결과 ↔ SHA256SUMS.txt 라인 일치 확인
```

---

## 보안 / 라이선스

- 비밀번호: OS Keychain (`@napi-rs/keyring`) 만 사용. 파일/로그 평문 저장 0건.
- 인증서 파일: 본 패키지 외부(`~/ltc-bridge/<기관명>/` 권장)에 0700/0600 권한으로 보관.
- 라이선스: 동봉된 `LICENSE` (Proprietary) 참조.

---

## Trouble-shooting

- MCP가 작동 안 하면 config의 `env.LTC_AUTH_BRIDGE_BIN` 필드가 auth-bridge 바이너리 절대경로로 설정되어 있는지 확인하세요 (`ltc mcp install --target claude-desktop` 실행 시 자동 주입).
- Windows MS Store Claude Desktop 사용자: `ltc mcp install --target claude-desktop` 명령이 MS Store 경로를 자동 탐지합니다. 자세한 내용은 `docs/BEGINNER-GUIDE.md` Q8-1 참조.

---

## 문의

- GitHub Issues: https://github.com/keenwind85/longterm-copilot/issues
- 공식 문서: 본 zip 외부 `docs/INSTALL.md` (정식 게시 후 안내)
