# Datacollector Mac Windows Launcher Scripts

Date: 2026-04-25 21:09:42 KST
Project: Datacollector
Repository: `/Volumes/Data/project/Antigravity/Datacollector`

## Summary

Datacollector 실행 시 Vite 프런트엔드만 뜨고 MCP Bridge 서버가 뜨지 않아 `ERR_CONNECTION_REFUSED`가 발생할 수 있었다.  
이를 막기 위해 맥용과 윈도우용 실행 파일을 명확히 정리했다.

## Main Launchers

- macOS: `/Volumes/Data/project/Antigravity/Datacollector/run_mac.command`
- Windows: `/Volumes/Data/project/Antigravity/Datacollector/run_win.bat`

두 실행 파일 모두 아래를 수행한다.

1. 프로젝트 폴더로 이동
2. `node_modules`가 없으면 `npm install`
3. 기존 `3000`, `3002` 포트 프로세스 정리
4. MCP Bridge 서버 실행
5. Vite 앱 실행

## Compatibility Wrappers

기존 실행 파일과의 호환성을 위해 아래 파일은 메인 실행 파일로 위임하도록 단순화했다.

- `run_app.sh` -> `run_mac.command`
- `run_app.bat` -> `run_win.bat`

## Verification

실행한 검증:

```bash
bash -n run_mac.command
bash -n run_app.sh
npm run lint
```

검증 결과:

- macOS shell script 문법 통과
- TypeScript 타입체크 통과

## Operational Note

앞으로 맥에서는 `run_mac.command`, 윈도우에서는 `run_win.bat`만 실행하면 된다.  
`npm run dev` 단독 실행은 프런트엔드만 켜므로 NotebookLM, Wiki save, 인증 복구 API가 동작하지 않는다.
