Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope Process
C:\Project\docagent-gw-mcp\install.ps1

claude mcp add docagent-gw --scope user `
  -e DOCAGENT_BE_URL=https://ai.gtp.or.kr/Docagent `
  -e DOCAGENT_USERNAME=<BE계정> `
  -e DOCAGENT_PASSWORD=<BE비밀번호> `
  -- node C:\Project\docagent-gw-mcp\server.mjs

**주의**: 위의 `<BE계정>`, `<BE비밀번호>`를 실제 값으로 바꾸세요.

## 등록 후

- 어느 Claude Code 세션에서든 `/mcp`로 MCP 상태 확인 가능.
- 자동으로 도구 7개 로드 (`gw_search`, `gw_read`, `gw_fetch`, `gw_rag_search`, `gw_sync`, `gw_sync_status`, `gw_status`).

## 도구 검색 전략

| 도구 | 용도 | 예시 |
|---|---|---|
| **`gw_search`** | 제목·기안자·기간 검색 | "2024년 보고서 찾아줘", "홍길동이 기안한 문서" |
| **`gw_rag_search`** (우선!) | 본문 내용·개념 검색 | "조직 개편 관련 규정", "출장비 청구 기준" |

→ **내용 기반 검색은 `gw_rag_search` 우선**. `gw_search`는 제목 검색.

## 보안

- **BE 비밀번호가 `~/.claude.json`에 평문 저장됨** (안전 범위: 본인 Windows 계정 홈 디렉토리).
  이는 BE 계정 비밀번호이지 그룹웨어 비밀번호가 아닙니다 (그룹웨어 creds는 BE DB에 Fernet 암호화).
- **공용 PC에서 사용 금지** — 로그아웃 후 `~/.claude.json` 확인 필수.
- 향후 Windows Credential Manager 연동 예정 (v2).

## 문제 해결

### "BE가 꺼져 있음" 오류

```powershell
cd C:\Project\Docagent  # BE가 있는 원본 repo
# 또는 원격 BE 사용 시: DOCAGENT_BE_URL을 https://ai.gtp.or.kr/Docagent 로 변경
docker compose up -d