whisper-windows-mcp 2.2.2 → 2.3.0

package/PRIVACY.ko.md

@@ -1,135 +1,192 @@
-# 개인 정보 아키텍처 — whisper-windows-mcp
-
-이 문서는 어떤 데이터가 머신에 남아 있고 어떤 데이터가 머신을 떠나는지, 그리고 규제 대상 또는 민감한 콘텐츠에 대해 도구를 어떻게 설정하는지 설명합니다.
-
----
-
-## 핵심 보장
-
-whisper-windows-mcp는 로컬 우선 아키텍처를 기반으로 구축되었습니다. **음성 및 동영상 파일은 절대 머신을 떠나지 않습니다.** 전사는 whisper.cpp를 사용하여 전적으로 로컬 하드웨어에서 실행됩니다 — 전사 자체에 클라우드 서비스, 인터넷 연결, API 호출은 필요하지 않습니다.
-
-이 보장은 미디어 파일에 대해 무조건적으로 적용됩니다.
-
----
-
-## 항상 로컬에 남아 있는 데이터
-
-| 데이터 | 머신을 떠나는가 |
-|---|---|
-| 음성 파일 | ❌ 절대 아님 |
-| 동영상 파일 | ❌ 절대 아님 |
-| Whisper 모델 파일 | ❌ 절대 아님 |
-| 임시 WAV 변환 파일 | ❌ 절대 아님 (전사 후 삭제) |
-| 배치 상태 및 작업 파일 | ❌ 절대 아님 |
-| 디스크의 전사본 `.txt` / `.srt` 파일 | ❌ 절대 아님 |
-
----
-
-## 기본 동작으로 머신을 떠날 수 있는 데이터
-
-도구 응답에 전사 텍스트가 포함되면 해당 텍스트는 Claude Desktop으로 반환되고 Anthropic의 API에서 처리됩니다. 이는 표준 MCP 동작입니다 — 텍스트는 로컬 MCP 서버에서 네트워크를 통해 Claude의 모델로 전송됩니다.
-
-| 데이터 | 머신을 떠나는가 |
-|---|---|
-| 도구 응답에 인라인으로 반환된 전사 텍스트 | ✅ 기본값으로 예 |
-| Claude에 파일로 직접 업로드된 전사 텍스트 | ✅ 예 (MCP 외부) |
-
-이 격차는 도구의 "데이터가 머신을 떠나지 않는다"는 보장과 Claude에 전사본 읽기, 요약 또는 분석을 요청할 때의 실제 데이터 흐름 사이에 존재합니다. YouTube 동영상, 팟캐스트, 스트리밍 녹화 같은 공개 콘텐츠를 전사하는 대부분의 사용자는 이 구분의 영향을 받지 않습니다.
-
-개인적이거나 기밀이거나 규제 대상인 녹음을 처리하는 사용자에게는 이 구분이 중요합니다.
-
----
-
-## 개인 정보 모드 (계획 중 — 아직 미구현)
-
-향후 릴리스에서 `WHISPER_PRIVACY_MODE` 환경 변수가 계획되어 있습니다. 활성화 시:
-
-- 모든 도구 응답은 메타데이터만 반환합니다: 파일명, 재생 시간, 단어 수, 완료 상태
-- 어떤 도구 응답에도 전사 텍스트가 포함되지 않습니다
-- Claude는 전사 내용을 어떤 형태로도 읽거나 분석하거나 중계할 수 없습니다
-- 전사본은 디스크의 로컬 `.txt` 파일로만 존재합니다
-
-이 모드는 전사 콘텐츠가 어떤 상황에서도 로컬 환경을 떠나서는 안 되는 법률, 의료, 재정, 기업 배포를 위해 설계되었습니다.
-
-**계획된 설정:**
-
-```json
-{
-  "mcpServers": {
-    "whisper": {
-      "command": "npx",
-      "args": ["-y", "whisper-windows-mcp"],
-      "env": {
-        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
-        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
-        "WHISPER_PRIVACY_MODE": "true"
-      }
-    }
-  }
-}
-```
-
-이 기능이 출시될 때까지: Claude의 API를 통해 전송하지 않고 전사 콘텐츠를 분석해야 하는 경우, 로컬 텍스트 편집기나 처리 도구에서 직접 `.txt` 파일을 여세요.
-
----
-
-## 규제 산업 안내
-
-다음은 일반적인 정보에 불과합니다. 이 도구의 작성자는 법률 전문가가 아닙니다. 사용자는 적용 가능한 법률 및 규정 준수에 대한 단독 책임을 집니다. 규제 대상 콘텐츠를 전사하기 전에 불확실한 경우 자격을 갖춘 법률 전문가와 상담하세요.
-
-### HIPAA (미국 — 의료)
-의료 제공자, 보험사 및 그들의 비즈니스 어소시에이트는 비즈니스 어소시에이트 계약(BAA) 없이 보호 건강 정보(PHI)를 무허가 제3자에게 전송하는 것이 금지됩니다. Anthropic은 Claude 소비자 API 사용에 대해 HIPAA BAA를 제공하지 않습니다.
-
-**영향을 받는 사용 사례:** 환자 상담, 임상 메모, 치료 세션, 보험 청구 통화, 병원 행정 녹음.
-
-**현재 권장 사항:** 규정을 준수하는 처리 체계를 조직이 수립하지 않은 한 환자 음성을 전사한 다음 Claude에 전사본 요약이나 분석을 요청하지 마세요. `WHISPER_PRIVACY_MODE`를 사용할 수 있게 되면 사용하세요.
-
-### GDPR (EU/EEA)
-EU 거주자의 개인 데이터는 명시적 동의 및 처리에 대한 합법적 근거 없이 제3자 처리자에게 전송될 수 없습니다. 이름, 위치 또는 식별 정보가 포함된 전사 텍스트는 GDPR에 따른 개인 데이터에 해당합니다.
-
-**영향을 받는 사용 사례:** 인터뷰, 회의, 콜센터 녹음, EU 거주자가 관련된 법적 절차.
-
-**현재 권장 사항:** EU 거주자 개인 데이터가 포함된 전사본을 Claude에 업로드하는 것이 귀하의 역할과 처리 목적에 따라 GDPR에 영향을 미칠 수 있음을 유의하세요.
-
-### 변호사-의뢰인 특권 (미국, 영국, 호주 및 대부분의 보통법 관할권)
-변호사와 의뢰인 간의 통신은 법적으로 특권이 부여됩니다. 무허가 제3자에게 공개하면 특권이 포기될 수 있습니다. 상업적 AI API에서 처리될 때 변호사-의뢰인 통신을 보호하는 확립된 법적 선례가 없습니다.
-
-**영향을 받는 사용 사례:** 법적 진술, 의뢰인 상담, 내부 전략 녹음, 증인 인터뷰.
-
-**현재 권장 사항:** 특권 있는 통신을 전사하는 변호사는 특권에 대한 영향에 대한 독립적인 법률 검토 없이 Claude 분석을 위해 해당 전사본을 업로드해서는 안 됩니다.
-
-### FERPA (미국 — 교육)
-학생의 교육 기록은 보호됩니다. 학교와 대학은 동의 없이 제3자에게 식별 가능한 학생 정보를 공개할 수 없습니다.
-
-**영향을 받는 사용 사례:** 녹화된 강의, 학생 상담 세션, 학문적 청문회, IEP 회의.
-
-### SOX (미국 — 상장 기업)
-상장 기업의 재정 통신은 기록 보관 및 기밀 유지 요건의 적용을 받습니다. 중요한 비공개 정보(MNPI)는 선택적으로 공개될 수 없습니다.
-
-**영향을 받는 사용 사례:** 실적 발표 녹음, 이사회 회의 전사본, 투자자 통신, 내부 재정 전략 논의.
-
-### PCI-DSS
-결제 카드 데이터는 안전하지 않은 환경에서 저장하거나 전송할 수 없습니다. 거래 중 카드 번호의 음성 녹음은 범위 내에 포함됩니다.
-
-**영향을 받는 사용 사례:** 콜센터 녹음, 결제 처리가 포함된 고객 서비스 통화.
-
-### 영업 비밀 / NDA 보호
-기밀 비즈니스 정보, 독점 공식, 미발표 제품 세부 정보, 인사 정보는 계약 또는 법률에 의해 보호될 수 있습니다.
-
-**영향을 받는 사용 사례:** 기업 전략 회의, R&D 논의, M&A 실사 통화, HR 절차.
-
----
-
-## Claude에 전사 파일 직접 업로드
-
-MCP 도구 외부에서 `.txt` 전사 파일을 Claude에 파일 첨부로 직접 업로드하면 MCP 서버에 가시성이 없으며 어떤 개인 정보 제어도 적용할 수 없습니다.
-
-전사본을 Claude에 직접 업로드하는 것은 오디오 콘텐츠를 Anthropic에 보내는 것과 동일합니다. 개인 정보 모드나 향후 MCP 수준의 보호는 직접 파일 업로드에는 적용되지 않습니다.
-
-규제 대상 콘텐츠를 처리하는 사용자는 전사본을 Claude에 직접 업로드해서는 안 됩니다. 규제 대상 콘텐츠의 유일한 안전한 분석 경로는 콘텐츠를 외부로 전송하지 않는 로컬 처리 도구입니다.
-
----
-
-## 개인 정보 우려 사항 보고
-
-여기에 나열되지 않은 개인 정보 문제나 아키텍처 격차를 발견하면 공개 이슈를 열지 말고 GitHub의 비공개 취약점 보고를 사용하세요. 보고 지침은 [SECURITY.md](SECURITY.md)를 참고하세요.
+# 개인 정보 아키텍처 — whisper-windows-mcp
+
+이 문서는 어떤 데이터가 머신에 남아 있고 어떤 데이터가 머신을 떠나는지, 그리고 규제 대상 또는 민감한 콘텐츠에 대해 도구를 어떻게 설정하는지 설명합니다.
+
+---
+
+## 핵심 보장
+
+whisper-windows-mcp는 로컬 우선 아키텍처를 기반으로 구축되었습니다. **음성 및 동영상 파일은 절대 머신을 떠나지 않습니다.** 전사는 whisper.cpp를 사용하여 전적으로 로컬 하드웨어에서 실행됩니다 — 전사 자체에 클라우드 서비스, 인터넷 연결, API 호출은 필요하지 않습니다.
+
+이 보장은 미디어 파일에 대해 무조건적으로 적용됩니다.
+
+---
+
+## 항상 로컬에 남아 있는 데이터
+
+| 데이터 | 머신을 떠나는가 |
+|---|---|
+| 음성 파일 | ❌ 절대 아님 |
+| 동영상 파일 | ❌ 절대 아님 |
+| Whisper 모델 파일 | ❌ 절대 아님 |
+| 임시 WAV 변환 파일 | ❌ 절대 아님 (전사 후 삭제) |
+| 배치 상태 및 작업 파일 | ❌ 절대 아님 |
+| 디스크의 전사본 `.txt` / `.srt` / `.vtt` 파일 | ❌ 절대 아님 |
+
+---
+
+## 기본 모드에서 머신을 떠날 수 있는 데이터
+
+도구 응답에 전사 텍스트가 포함되면 해당 텍스트는 Claude Desktop으로 반환되고 Anthropic의 API에서 처리됩니다. 이는 표준 MCP 동작입니다 — 텍스트는 로컬 MCP 서버에서 네트워크를 통해 Claude의 모델로 전송됩니다.
+
+| 데이터 | 머신을 떠나는가 |
+|---|---|
+| 도구 응답에 인라인으로 반환된 전사 텍스트 | ✅ 기본 모드에서 예 |
+| Claude에 파일로 직접 업로드된 전사 텍스트 | ✅ 예 (MCP 외부 — 개인 정보 제어 적용 불가) |
+
+이 격차는 도구의 "데이터가 머신을 떠나지 않는다"는 보장과 Claude에 전사본 읽기, 요약 또는 분석을 요청할 때의 실제 데이터 흐름 사이에 존재합니다. YouTube 동영상, 팟캐스트, 스트리밍 녹화 같은 공개 콘텐츠를 전사하는 대부분의 사용자는 이 구분의 영향을 받지 않습니다.
+
+개인적이거나 기밀이거나 규제 대상인 녹음을 처리하는 사용자에게는 이 구분이 중요합니다.
+
+---
+
+## 개인 정보 모드
+
+`WHISPER_PRIVACY_MODE`는 모든 도구 응답을 메타데이터만으로 제한합니다. 활성화 시:
+
+- 모든 도구 응답은 파일명, 단어 수, 저장 경로, 완료 상태만 반환합니다
+- 어떤 도구 응답에도 전사 텍스트가 포함되지 않습니다
+- Claude는 전사 내용을 어떤 형태로도 읽거나 분석하거나 중계할 수 없습니다
+- 전사본은 디스크의 로컬 파일로만 존재합니다
+
+개인 정보 모드는 전사 콘텐츠가 어떤 상황에서도 로컬 환경을 떠나서는 안 되는 법률, 의료, 재정, 기업 배포를 위해 설계되었습니다.
+
+### 전역 설정 (환경 변수)
+
+`claude_desktop_config.json`에서 설정:
+
+```json
+{
+  "mcpServers": {
+    "whisper": {
+      "command": "npx",
+      "args": ["-y", "whisper-windows-mcp"],
+      "env": {
+        "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
+        "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
+        "WHISPER_PRIVACY_MODE": "true"
+      }
+    }
+  }
+}
+```
+
+적용하려면 Claude Desktop을 재시작해야 합니다.
+
+### 호출별 설정 (재시작 불필요)
+
+전사 도구에 `privacy_mode=true`를 직접 전달:
+
+- *"이 파일을 개인 정보 모드로 전사해줘"*
+- *"이 폴더에서 배치를 시작해줘, privacy_mode=true"*
+- *"job_123의 진행 상황 확인해줘, privacy_mode=true"*
+
+호출별 파라미터는 전역 환경 변수를 양방향으로 재정의합니다. `WHISPER_PRIVACY_MODE=true`가 전역으로 설정되어 있어도 단일 호출에 대해 `privacy_mode=false`를 전달하여 비활성화할 수 있습니다.
+
+### 개인 정보 모드 게이트 동작
+
+개인 정보 모드가 활성화된 경우 **모든 작업 전에** 확인 공개가 표시됩니다. 이것은 의도된 동작입니다 — 규정 준수에는 세션당 한 번이 아닌 각 처리 이벤트 전에 사전 동의가 필요합니다.
+
+공개 텍스트는 의도적으로 매번 동일합니다. 반복이 핵심입니다: 민감한 콘텐츠를 처리하는 경우 각 작업을 명시적으로 확인해야 합니다.
+
+`start_batch`에서 개인 정보 모드 사용 시: 배치 시작 전에 확인 한 번이 필요합니다. 이후 모든 파일이 무인으로 처리됩니다. 어떤 시점에서도 전사 텍스트가 반환되지 않습니다 — 배치 진행 메타데이터만 반환됩니다.
+
+---
+
+## 동의 게이트 (기본 모드)
+
+개인 정보 모드가 활성화되지 않은 경우 세션에서 처음으로 전사 텍스트가 Claude의 API에 반환되기 전에 일회성 세션 공개가 표시됩니다.
+
+공개에는 다음이 포함됩니다:
+- 전사 텍스트가 Anthropic의 API에 전송된다는 사실
+- 콘텐츠에 적용될 수 있는 규제 프레임워크
+- 필요한 경우 개인 정보 모드를 활성화하는 방법
+- 민감하지 않은 콘텐츠에 대해 게이트를 영구적으로 억제하는 방법
+
+확인 후 해당 세션의 나머지 동안 게이트가 다시 실행되지 않습니다. Claude Desktop을 재시작하면 세션이 초기화되고 다음 전사본 반환 호출 시 게이트가 다시 실행됩니다.
+
+**백그라운드 작업의 경우:** 동의 게이트는 `transcribe_audio` 호출 시가 아닌 `check_progress` 완료 시 실행됩니다. 호출 시점에는 전사 텍스트가 아직 존재하지 않습니다 — 게이트는 전사 텍스트가 처음 API에 반환되는 순간 실행됩니다.
+
+### 게이트 영구 억제
+
+민감하지 않은 콘텐츠를 정기적으로 전사하며 더 이상 알림이 필요하지 않은 경우 설정에서 다음을 설정하세요:
+
+```json
+"WHISPER_CONSENT_ACKNOWLEDGED": "true"
+```
+
+개인 정보 모드가 활성화된 경우 이 설정은 효과가 없습니다. 개인 정보 모드는 이 설정과 관계없이 항상 실행되는 자체 작업별 게이트를 사용합니다.
+
+---
+
+## 데이터 흐름 요약
+
+| 모드 | 음성 | 전사 텍스트 | 확인 필요 |
+|---|---|---|---|
+| 기본 모드 | 로컬 전용 | Anthropic API로 전송 | 세션당 한 번 (동의 게이트) |
+| 개인 정보 모드 (환경 변수) | 로컬 전용 | 전송되지 않음 | 모든 작업 전 |
+| 개인 정보 모드 (호출별) | 로컬 전용 | 이 호출에서 전송되지 않음 | 이 작업 전 |
+| `WHISPER_CONSENT_ACKNOWLEDGED=true` | 로컬 전용 | Anthropic API로 전송 | 없음 (억제됨) |
+
+---
+
+## Claude에 전사 파일 직접 업로드
+
+MCP 도구 외부에서 `.txt` 전사 파일을 Claude에 파일 첨부로 직접 업로드하면 MCP 서버에 가시성이 없으며 어떤 개인 정보 제어도 적용할 수 없습니다.
+
+전사본을 Claude에 직접 업로드하는 것은 오디오 콘텐츠를 Anthropic에 보내는 것과 동일합니다. 개인 정보 모드 및 모든 MCP 수준의 보호는 직접 파일 업로드에 의해 완전히 우회됩니다.
+
+규제 대상 콘텐츠를 처리하는 사용자는 전사본을 Claude에 직접 업로드해서는 안 됩니다. 규제 대상 콘텐츠의 유일한 안전한 분석 경로는 콘텐츠를 외부로 전송하지 않는 로컬 처리 도구입니다.
+
+---
+
+## 규제 산업 안내
+
+다음은 일반적인 정보에 불과합니다. 이 도구의 작성자는 법률 전문가가 아닙니다. 사용자는 적용 가능한 법률 및 규정 준수에 대한 단독 책임을 집니다. 규제 대상 콘텐츠를 전사하기 전에 불확실한 경우 자격을 갖춘 법률 전문가와 상담하세요.
+
+### HIPAA (미국 — 의료)
+의료 제공자, 보험사 및 그들의 비즈니스 어소시에이트는 비즈니스 어소시에이트 계약(BAA) 없이 보호 건강 정보(PHI)를 무허가 제3자에게 전송하는 것이 금지됩니다. Anthropic은 Claude 소비자 API 사용에 대해 HIPAA BAA를 제공하지 않습니다.
+
+**영향을 받는 사용 사례:** 환자 상담, 임상 메모, 치료 세션, 보험 청구 통화, 병원 행정 녹음.
+
+**권장 사항:** 환자 음성을 전사하기 전에 `WHISPER_PRIVACY_MODE=true`를 활성화하세요. 세션 중에 비활성화하지 마세요.
+
+### GDPR (EU/EEA)
+EU 거주자의 개인 데이터는 명시적 동의 및 처리에 대한 합법적 근거 없이 제3자 처리자에게 전송될 수 없습니다. 이름, 위치 또는 식별 정보가 포함된 전사 텍스트는 GDPR에 따른 개인 데이터에 해당합니다.
+
+**영향을 받는 사용 사례:** 인터뷰, 회의, 콜센터 녹음, EU 거주자가 관련된 법적 절차.
+
+**권장 사항:** EU/EEA 거주자의 개인 데이터가 포함될 수 있는 녹음에 대해 개인 정보 모드를 활성화하세요.
+
+### 변호사-의뢰인 특권 (미국, 영국, 호주 및 대부분의 보통법 관할권)
+변호사와 의뢰인 간의 통신은 법적으로 특권이 부여됩니다. 무허가 제3자에게 공개하면 특권이 포기될 수 있습니다. 상업적 AI API에서 처리될 때 변호사-의뢰인 통신을 보호하는 확립된 법적 선례가 없습니다.
+
+**영향을 받는 사용 사례:** 법적 진술, 의뢰인 상담, 내부 전략 녹음, 증인 인터뷰.
+
+**권장 사항:** 특권 있는 통신을 전사하는 변호사는 개인 정보 모드를 활성화해야 합니다. 분석을 위해 비활성화하지 마세요 — 특권 있는 콘텐츠에는 로컬 텍스트 편집기나 처리 도구를 사용하세요.
+
+### FERPA (미국 — 교육)
+학생의 교육 기록은 보호됩니다. 학교와 대학은 동의 없이 제3자에게 식별 가능한 학생 정보를 공개할 수 없습니다.
+
+**영향을 받는 사용 사례:** 녹화된 강의, 학생 상담 세션, 학문적 청문회, IEP 회의.
+
+### SOX (미국 — 상장 기업)
+상장 기업의 재정 통신은 기록 보관 및 기밀 유지 요건의 적용을 받습니다. 중요한 비공개 정보(MNPI)는 선택적으로 공개될 수 없습니다.
+
+**영향을 받는 사용 사례:** 실적 발표 녹음, 이사회 회의 전사본, 투자자 통신, 내부 재정 전략 논의.
+
+### PCI-DSS
+결제 카드 데이터는 안전하지 않은 환경에서 저장하거나 전송할 수 없습니다. 거래 중 카드 번호의 음성 녹음은 범위 내에 포함됩니다.
+
+**영향을 받는 사용 사례:** 콜센터 녹음, 결제 처리가 포함된 고객 서비스 통화.
+
+### 영업 비밀 / NDA 보호
+기밀 비즈니스 정보, 독점 공식, 미발표 제품 세부 정보, 인사 정보는 계약 또는 법률에 의해 보호될 수 있습니다.
+
+**영향을 받는 사용 사례:** 기업 전략 회의, R&D 논의, M&A 실사 통화, HR 절차.
+
+---
+
+## 개인 정보 우려 사항 보고
+
+여기에 나열되지 않은 개인 정보 문제나 아키텍처 격차를 발견하면 공개 이슈를 열지 말고 GitHub의 비공개 취약점 보고를 사용하세요. 보고 지침은 [SECURITY.md](SECURITY.md)를 참고하세요.