whisper-windows-mcp 2.2.1 → 2.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (52) hide show
  1. package/COMMERCIAL-LICENSE.md +58 -0
  2. package/LICENSE +40 -21
  3. package/PRIVACY.es.md +192 -135
  4. package/PRIVACY.id.md +192 -135
  5. package/PRIVACY.ja.md +192 -135
  6. package/PRIVACY.ko.md +192 -135
  7. package/PRIVACY.md +192 -135
  8. package/PRIVACY.pl.md +192 -0
  9. package/PRIVACY.pt-BR.md +192 -135
  10. package/PRIVACY.ro.md +192 -0
  11. package/PRIVACY.uk.md +192 -135
  12. package/PRIVACY.vi.md +192 -135
  13. package/README.es.md +419 -393
  14. package/README.id.md +430 -393
  15. package/README.ja.md +430 -402
  16. package/README.ko.md +419 -393
  17. package/README.md +430 -393
  18. package/README.pl.md +430 -0
  19. package/README.pt-BR.md +419 -393
  20. package/README.ro.md +430 -0
  21. package/README.uk.md +430 -393
  22. package/README.vi.md +419 -393
  23. package/ROADMAP.es.md +262 -192
  24. package/ROADMAP.id.md +262 -290
  25. package/ROADMAP.ja.md +262 -302
  26. package/ROADMAP.ko.md +262 -287
  27. package/ROADMAP.pl.md +258 -0
  28. package/ROADMAP.pt-BR.md +262 -287
  29. package/ROADMAP.ro.md +258 -0
  30. package/ROADMAP.uk.md +258 -291
  31. package/ROADMAP.vi.md +262 -287
  32. package/SECURITY.es.md +64 -47
  33. package/SECURITY.id.md +64 -47
  34. package/SECURITY.ja.md +64 -47
  35. package/SECURITY.ko.md +64 -47
  36. package/SECURITY.md +21 -4
  37. package/SECURITY.pl.md +64 -0
  38. package/SECURITY.pt-BR.md +64 -47
  39. package/SECURITY.ro.md +64 -0
  40. package/SECURITY.uk.md +64 -47
  41. package/SECURITY.vi.md +64 -47
  42. package/TROUBLESHOOTING.es.md +309 -323
  43. package/TROUBLESHOOTING.id.md +333 -323
  44. package/TROUBLESHOOTING.ja.md +399 -286
  45. package/TROUBLESHOOTING.ko.md +309 -323
  46. package/TROUBLESHOOTING.pl.md +355 -0
  47. package/TROUBLESHOOTING.pt-BR.md +309 -323
  48. package/TROUBLESHOOTING.ro.md +355 -0
  49. package/TROUBLESHOOTING.uk.md +369 -323
  50. package/TROUBLESHOOTING.vi.md +309 -323
  51. package/dist/index.js +591 -216
  52. package/package.json +45 -45
package/PRIVACY.md CHANGED
@@ -1,135 +1,192 @@
1
- # Privacy Architecture — whisper-windows-mcp
2
-
3
- This document describes what data stays on your machine, what data leaves your machine, and how to configure the tool for regulated or sensitive content.
4
-
5
- ---
6
-
7
- ## The core guarantee
8
-
9
- whisper-windows-mcp is built on a local-first architecture. **Audio and video files never leave your machine.** Transcription runs entirely on your hardware using whisper.cpp — no cloud service, no internet connection, no API call is involved in the transcription itself.
10
-
11
- This guarantee is unconditional for media files.
12
-
13
- ---
14
-
15
- ## What data stays local (always)
16
-
17
- | Data | Leaves machine? |
18
- |---|---|
19
- | Audio files | ❌ Never |
20
- | Video files | ❌ Never |
21
- | Whisper model files | ❌ Never |
22
- | Temp WAV conversion files | ❌ Never (deleted after transcription) |
23
- | Batch state and job files | ❌ Never |
24
- | Transcript `.txt` / `.srt` files on disk | ❌ Never |
25
-
26
- ---
27
-
28
- ## What data may leave your machine (default behavior)
29
-
30
- When a tool response includes transcript text, that text is returned to Claude Desktop and processed by Anthropic's API. This is standard MCP behavior — the text travels from the local MCP server to Claude's model over the network.
31
-
32
- | Data | Leaves machine? |
33
- |---|---|
34
- | Transcript text returned inline in tool responses | ✅ Yes, by default |
35
- | Transcript text uploaded directly to Claude as a file | ✅ Yes (outside MCP entirely) |
36
-
37
- This gap exists between the tool's "no data leaves your machine" guarantee and the actual behavior when you ask Claude to read, summarize, or analyze a transcript. Most users — those transcribing public content like YouTube videos, podcasts, or streaming recordings — are unaffected by this distinction.
38
-
39
- For users handling private, confidential, or regulated recordings, this distinction matters.
40
-
41
- ---
42
-
43
- ## Privacy Mode (planned — not yet implemented)
44
-
45
- A `WHISPER_PRIVACY_MODE` environment variable is planned for a future release. When enabled:
46
-
47
- - All tool responses return only metadata: filename, duration, word count, completion status
48
- - No transcript text is included in any tool response
49
- - Claude cannot read, analyze, or relay transcript content in any form
50
- - Transcripts exist only as local `.txt` files on disk
51
-
52
- This mode is designed for legal, medical, financial, and corporate deployments where transcript content must not leave the local environment under any circumstances.
53
-
54
- **Planned configuration:**
55
-
56
- ```json
57
- {
58
- "mcpServers": {
59
- "whisper": {
60
- "command": "npx",
61
- "args": ["-y", "whisper-windows-mcp"],
62
- "env": {
63
- "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
64
- "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
65
- "WHISPER_PRIVACY_MODE": "true"
66
- }
67
- }
68
- }
69
- }
70
- ```
71
-
72
- Until this feature ships: if you need to analyze transcript content without transmitting it to Claude's API, open the `.txt` file directly in a local text editor or processing tool.
73
-
74
- ---
75
-
76
- ## Regulated industry guidance
77
-
78
- The following is general information only. The authors of this tool are not lawyers. Users bear sole responsibility for compliance with applicable laws and regulations. When in doubt, consult qualified legal counsel before transcribing regulated content.
79
-
80
- ### HIPAA (USA — healthcare)
81
- Medical providers, insurers, and their business associates are prohibited from transmitting Protected Health Information (PHI) to unauthorized third parties without a Business Associate Agreement (BAA). Anthropic does not offer a HIPAA BAA for Claude consumer API usage.
82
-
83
- **Affected use cases:** Patient consultations, clinical notes, therapy sessions, insurance claim calls, hospital administrative recordings.
84
-
85
- **Current recommendation:** Do not transcribe patient audio and then ask Claude to summarize or analyze the transcript unless your organization has established a compliant processing arrangement. Use `WHISPER_PRIVACY_MODE` when it becomes available.
86
-
87
- ### GDPR (EU/EEA)
88
- Personal data of EU residents cannot be transferred to third-party processors without explicit consent and a lawful basis for processing. Transcript text containing names, locations, or any identifying information constitutes personal data under GDPR.
89
-
90
- **Affected use cases:** Interviews, meetings, call center recordings, court proceedings involving EU residents.
91
-
92
- **Current recommendation:** Be aware that uploading transcripts containing EU resident personal data to Claude may have GDPR implications depending on your role and processing purpose.
93
-
94
- ### Attorney-Client Privilege (USA, UK, AU, and most common law jurisdictions)
95
- Communications between attorneys and clients are legally privileged. Disclosure to unauthorized third parties may waive privilege. There is no established legal precedent protecting attorney-client communications when processed by commercial AI APIs.
96
-
97
- **Affected use cases:** Legal depositions, client consultations, internal strategy recordings, witness interviews.
98
-
99
- **Current recommendation:** Attorneys transcribing privileged communications should not upload those transcripts to Claude for analysis without independent legal review of the privilege implications.
100
-
101
- ### FERPA (USA — education)
102
- Educational records of students are protected. Schools and universities cannot disclose identifiable student information to third parties without consent.
103
-
104
- **Affected use cases:** Recorded lectures, student counseling sessions, academic hearings, IEP meetings.
105
-
106
- ### SOX (USA — publicly traded companies)
107
- Financial communications of public companies are subject to record-keeping and confidentiality requirements. Material non-public information (MNPI) cannot be selectively disclosed.
108
-
109
- **Affected use cases:** Earnings call recordings, board meeting transcripts, investor communications, internal financial strategy discussions.
110
-
111
- ### PCI-DSS
112
- Payment card data cannot be stored or transmitted in unsecured environments. Voice recordings of card numbers during transactions are in scope.
113
-
114
- **Affected use cases:** Call center recordings, customer service calls involving payment processing.
115
-
116
- ### Trade Secret / NDA Protections
117
- Confidential business information, proprietary formulas, unreleased product details, and personnel information may be protected by contract or law.
118
-
119
- **Affected use cases:** Corporate strategy meetings, R&D discussions, M&A due diligence calls, HR proceedings.
120
-
121
- ---
122
-
123
- ## Uploading transcript files directly to Claude
124
-
125
- When you upload a `.txt` transcript file directly to Claude as a file attachment — outside the MCP tool entirely — the MCP server has no visibility and cannot apply any privacy controls.
126
-
127
- Uploading a transcript directly to Claude is equivalent to sending the audio content to Anthropic. No privacy mode or future MCP-level protection will apply to direct file uploads.
128
-
129
- Users handling regulated content must not upload transcripts directly to Claude. The only safe analysis path for regulated content is local processing tools that do not transmit content externally.
130
-
131
- ---
132
-
133
- ## Reporting privacy concerns
134
-
135
- If you identify a privacy issue or an architectural gap not covered here, please use GitHub's private vulnerability reporting rather than opening a public issue. See [SECURITY.md](SECURITY.md) for reporting instructions.
1
+ # Privacy Architecture — whisper-windows-mcp
2
+
3
+ This document describes what data stays on your machine, what data leaves your machine, and how to configure the tool for regulated or sensitive content.
4
+
5
+ ---
6
+
7
+ ## The core guarantee
8
+
9
+ whisper-windows-mcp is built on a local-first architecture. **Audio and video files never leave your machine.** Transcription runs entirely on your hardware using whisper.cpp — no cloud service, no internet connection, no API call is involved in the transcription itself.
10
+
11
+ This guarantee is unconditional for media files.
12
+
13
+ ---
14
+
15
+ ## What data stays local (always)
16
+
17
+ | Data | Leaves machine? |
18
+ |---|---|
19
+ | Audio files | ❌ Never |
20
+ | Video files | ❌ Never |
21
+ | Whisper model files | ❌ Never |
22
+ | Temp WAV conversion files | ❌ Never (deleted after transcription) |
23
+ | Batch state and job files | ❌ Never |
24
+ | Transcript `.txt` / `.srt` / `.vtt` files on disk | ❌ Never |
25
+
26
+ ---
27
+
28
+ ## What data may leave your machine (standard mode)
29
+
30
+ When a tool response includes transcript text, that text is returned to Claude Desktop and processed by Anthropic's API. This is standard MCP behavior — the text travels from the local MCP server to Claude's model over the network.
31
+
32
+ | Data | Leaves machine? |
33
+ |---|---|
34
+ | Transcript text returned inline in tool responses | ✅ Yes, in standard mode |
35
+ | Transcript text uploaded directly to Claude as a file | ✅ Yes (outside MCP entirely — no privacy control applies) |
36
+
37
+ This gap exists between the tool's "no data leaves your machine" guarantee and the actual behavior when you ask Claude to read, summarize, or analyze a transcript. Most users — those transcribing public content like YouTube videos, podcasts, or streaming recordings — are unaffected by this distinction.
38
+
39
+ For users handling private, confidential, or regulated recordings, this distinction matters.
40
+
41
+ ---
42
+
43
+ ## Privacy Mode
44
+
45
+ `WHISPER_PRIVACY_MODE` restricts all tool responses to metadata only. When active:
46
+
47
+ - Tool responses return only: filename, word count, save path, completion status
48
+ - No transcript text is included in any tool response, ever
49
+ - Claude cannot read, analyze, or relay transcript content in any form
50
+ - Transcripts exist only as local files on disk
51
+
52
+ Privacy mode is designed for legal, medical, financial, and corporate deployments where transcript content must not leave the local environment under any circumstances.
53
+
54
+ ### Enabling globally (env var)
55
+
56
+ Set in `claude_desktop_config.json`:
57
+
58
+ ```json
59
+ {
60
+ "mcpServers": {
61
+ "whisper": {
62
+ "command": "npx",
63
+ "args": ["-y", "whisper-windows-mcp"],
64
+ "env": {
65
+ "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
66
+ "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
67
+ "WHISPER_PRIVACY_MODE": "true"
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+
74
+ Requires a Claude Desktop restart to take effect.
75
+
76
+ ### Enabling per-call (no restart required)
77
+
78
+ Pass `privacy_mode=true` directly to any transcription tool:
79
+
80
+ - *"Transcribe this file in privacy mode"*
81
+ - *"Start a batch on this folder, privacy_mode=true"*
82
+ - *"Check progress on job_123, privacy_mode=true"*
83
+
84
+ The per-call parameter overrides the global env var in either direction. Pass `privacy_mode=false` to disable for a single call even when `WHISPER_PRIVACY_MODE=true` globally.
85
+
86
+ ### Privacy mode gate behavior
87
+
88
+ When privacy mode is active, a confirmation disclosure is shown **before every operation**. This is intentional — regulatory compliance requires informed consent before each processing event, not just once per session.
89
+
90
+ The disclosure text is identical every time by design. The repetition is the point: if you are handling sensitive content, you should be confirming each operation explicitly.
91
+
92
+ For `start_batch` with privacy mode: one confirmation is required before the batch starts. All files then process unattended. No transcript text is returned at any point — only batch progress metadata.
93
+
94
+ ---
95
+
96
+ ## Consent Gate (standard mode)
97
+
98
+ When privacy mode is not active, a one-time session disclosure is shown before any transcript text is returned to Claude's API for the first time in a session.
99
+
100
+ The disclosure covers:
101
+ - That transcript text will be transmitted to Anthropic's API
102
+ - The regulatory frameworks that may apply to your content
103
+ - How to enable privacy mode if needed
104
+ - How to suppress the gate permanently for non-sensitive content
105
+
106
+ After you confirm, the gate does not fire again for the rest of the session. Claude Desktop restart resets the session and the gate fires again on the next transcript-returning call.
107
+
108
+ **For background jobs:** the consent gate fires at `check_progress` completion, not at `transcribe_audio` call time. At call time, no transcript text exists yet — there is nothing to gate. The gate fires the moment transcript text would first be returned to the API.
109
+
110
+ ### Skipping the gate permanently
111
+
112
+ If you regularly transcribe non-sensitive content and no longer need the reminder, set in your config:
113
+
114
+ ```json
115
+ "WHISPER_CONSENT_ACKNOWLEDGED": "true"
116
+ ```
117
+
118
+ This has no effect when privacy mode is active. Privacy mode uses its own per-operation gate that always fires regardless of this setting.
119
+
120
+ ---
121
+
122
+ ## Data flow summary
123
+
124
+ | Mode | Audio | Transcript text | Confirmation required |
125
+ |---|---|---|---|
126
+ | Standard | Local only | Sent to Anthropic API | Once per session (consent gate) |
127
+ | Privacy mode (env var) | Local only | Never transmitted | Before every operation |
128
+ | Privacy mode (per-call) | Local only | Never for this call | Before this operation |
129
+ | `WHISPER_CONSENT_ACKNOWLEDGED=true` | Local only | Sent to Anthropic API | Never (skipped) |
130
+
131
+ ---
132
+
133
+ ## Uploading transcript files directly to Claude
134
+
135
+ When you upload a `.txt` transcript file directly to Claude as a file attachment — outside the MCP tool entirely — the MCP server has no visibility and cannot apply any privacy controls.
136
+
137
+ Uploading a transcript directly to Claude is equivalent to sending the audio content to Anthropic. Privacy mode and all MCP-level protections are bypassed entirely by direct file uploads.
138
+
139
+ Users handling regulated content must not upload transcripts directly to Claude. The only safe analysis path for regulated content is local processing tools that do not transmit content externally.
140
+
141
+ ---
142
+
143
+ ## Regulated industry guidance
144
+
145
+ The following is general information only. The authors of this tool are not lawyers. Users bear sole responsibility for compliance with applicable laws and regulations. When in doubt, consult qualified legal counsel before transcribing regulated content.
146
+
147
+ ### HIPAA (USA — healthcare)
148
+ Medical providers, insurers, and their business associates are prohibited from transmitting Protected Health Information (PHI) to unauthorized third parties without a Business Associate Agreement (BAA). Anthropic does not offer a HIPAA BAA for Claude consumer API usage.
149
+
150
+ **Affected use cases:** Patient consultations, clinical notes, therapy sessions, insurance claim calls, hospital administrative recordings.
151
+
152
+ **Recommendation:** Enable `WHISPER_PRIVACY_MODE=true` before transcribing any patient audio. Do not disable it mid-session.
153
+
154
+ ### GDPR (EU/EEA)
155
+ Personal data of EU residents cannot be transferred to third-party processors without explicit consent and a lawful basis for processing. Transcript text containing names, locations, or any identifying information constitutes personal data under GDPR.
156
+
157
+ **Affected use cases:** Interviews, meetings, call center recordings, court proceedings involving EU residents.
158
+
159
+ **Recommendation:** Enable privacy mode for any recording that may contain personal data of EU/EEA residents.
160
+
161
+ ### Attorney-Client Privilege (USA, UK, AU, and most common law jurisdictions)
162
+ Communications between attorneys and clients are legally privileged. Disclosure to unauthorized third parties may waive privilege. There is no established legal precedent protecting attorney-client communications when processed by commercial AI APIs.
163
+
164
+ **Affected use cases:** Legal depositions, client consultations, internal strategy recordings, witness interviews.
165
+
166
+ **Recommendation:** Attorneys transcribing privileged communications should enable privacy mode. Do not disable it for analysis — use local text editors or processing tools for privileged content.
167
+
168
+ ### FERPA (USA — education)
169
+ Educational records of students are protected. Schools and universities cannot disclose identifiable student information to third parties without consent.
170
+
171
+ **Affected use cases:** Recorded lectures, student counseling sessions, academic hearings, IEP meetings.
172
+
173
+ ### SOX (USA — publicly traded companies)
174
+ Financial communications of public companies are subject to record-keeping and confidentiality requirements. Material non-public information (MNPI) cannot be selectively disclosed.
175
+
176
+ **Affected use cases:** Earnings call recordings, board meeting transcripts, investor communications, internal financial strategy discussions.
177
+
178
+ ### PCI-DSS
179
+ Payment card data cannot be stored or transmitted in unsecured environments. Voice recordings of card numbers during transactions are in scope.
180
+
181
+ **Affected use cases:** Call center recordings, customer service calls involving payment processing.
182
+
183
+ ### Trade Secret / NDA Protections
184
+ Confidential business information, proprietary formulas, unreleased product details, and personnel information may be protected by contract or law.
185
+
186
+ **Affected use cases:** Corporate strategy meetings, R&D discussions, M&A due diligence calls, HR proceedings.
187
+
188
+ ---
189
+
190
+ ## Reporting privacy concerns
191
+
192
+ If you identify a privacy issue or an architectural gap not covered here, please use GitHub's private vulnerability reporting rather than opening a public issue. See [SECURITY.md](SECURITY.md) for reporting instructions.
package/PRIVACY.pl.md ADDED
@@ -0,0 +1,192 @@
1
+ # Architektura prywatności — whisper-windows-mcp
2
+
3
+ Ten dokument opisuje, jakie dane pozostają na twoim komputerze, jakie dane go opuszczają i jak skonfigurować narzędzie dla treści regulowanych lub wrażliwych.
4
+
5
+ ---
6
+
7
+ ## Podstawowa gwarancja
8
+
9
+ whisper-windows-mcp jest zbudowany na architekturze lokalnej. **Pliki audio i wideo nigdy nie opuszczają twojego komputera.** Transkrypcja przebiega całkowicie na twoim sprzęcie przy użyciu whisper.cpp — żadna usługa w chmurze, połączenie internetowe ani wywołanie API nie są zaangażowane w samą transkrypcję.
10
+
11
+ Ta gwarancja jest bezwarunkowa dla plików multimedialnych.
12
+
13
+ ---
14
+
15
+ ## Dane, które zawsze pozostają lokalnie
16
+
17
+ | Dane | Opuszcza komputer? |
18
+ |---|---|
19
+ | Pliki audio | ❌ Nigdy |
20
+ | Pliki wideo | ❌ Nigdy |
21
+ | Pliki modeli Whisper | ❌ Nigdy |
22
+ | Tymczasowe pliki WAV konwersji | ❌ Nigdy (usuwane po transkrypcji) |
23
+ | Pliki stanu partii i zadań | ❌ Nigdy |
24
+ | Pliki transkrypcji `.txt` / `.srt` / `.vtt` na dysku | ❌ Nigdy |
25
+
26
+ ---
27
+
28
+ ## Dane, które mogą opuścić komputer (tryb standardowy)
29
+
30
+ Gdy odpowiedź narzędzia zawiera tekst transkrypcji, tekst ten jest zwracany do Claude Desktop i przetwarzany przez API Anthropic. Jest to standardowe zachowanie MCP — tekst podróżuje z lokalnego serwera MCP do modelu Claude przez sieć.
31
+
32
+ | Dane | Opuszcza komputer? |
33
+ |---|---|
34
+ | Tekst transkrypcji zwracany inline w odpowiedziach narzędzi | ✅ Tak, w trybie standardowym |
35
+ | Tekst transkrypcji przesłany bezpośrednio do Claude jako plik | ✅ Tak (poza MCP — żadna kontrola prywatności nie ma zastosowania) |
36
+
37
+ Ta luka istnieje między gwarancją narzędzia "żadne dane nie opuszczają twojego komputera" a rzeczywistym zachowaniem, gdy prosisz Claude o odczytanie, podsumowanie lub analizę transkrypcji. Większość użytkowników — transkrybujących publiczne treści, takie jak filmy z YouTube, podcasty lub nagrania streamów — nie jest dotknięta tym rozróżnieniem.
38
+
39
+ Dla użytkowników obsługujących prywatne, poufne lub regulowane nagrania to rozróżnienie ma znaczenie.
40
+
41
+ ---
42
+
43
+ ## Tryb prywatności
44
+
45
+ `WHISPER_PRIVACY_MODE` ogranicza wszystkie odpowiedzi narzędzi tylko do metadanych. Po włączeniu:
46
+
47
+ - Odpowiedzi narzędzi zwracają tylko: nazwę pliku, liczbę słów, ścieżkę zapisu, status ukończenia
48
+ - Żaden tekst transkrypcji nie jest uwzględniany w żadnej odpowiedzi narzędzia
49
+ - Claude nie może odczytywać, analizować ani przekazywać treści transkrypcji w żadnej formie
50
+ - Transkrypcje istnieją tylko jako lokalne pliki na dysku
51
+
52
+ Tryb prywatności jest przeznaczony dla wdrożeń prawnych, medycznych, finansowych i korporacyjnych, gdzie treść transkrypcji nie może opuścić środowiska lokalnego w żadnych okolicznościach.
53
+
54
+ ### Globalne włączenie (zmienna środowiskowa)
55
+
56
+ Ustaw w `claude_desktop_config.json`:
57
+
58
+ ```json
59
+ {
60
+ "mcpServers": {
61
+ "whisper": {
62
+ "command": "npx",
63
+ "args": ["-y", "whisper-windows-mcp"],
64
+ "env": {
65
+ "WHISPER_CLI_PATH": "C:\\whisper\\Release\\whisper-cli.exe",
66
+ "WHISPER_MODEL": "C:\\whisper\\models\\ggml-large-v3.bin",
67
+ "WHISPER_PRIVACY_MODE": "true"
68
+ }
69
+ }
70
+ }
71
+ }
72
+ ```
73
+
74
+ Wymaga restartu Claude Desktop, aby wejść w życie.
75
+
76
+ ### Włączenie dla pojedynczego wywołania (bez restartu)
77
+
78
+ Przekaż `privacy_mode=true` bezpośrednio do dowolnego narzędzia transkrypcji:
79
+
80
+ - *"Transkrybuj ten plik w trybie prywatności"*
81
+ - *"Rozpocznij partię w tym folderze, privacy_mode=true"*
82
+ - *"Sprawdź postęp zadania job_123, privacy_mode=true"*
83
+
84
+ Parametr dla pojedynczego wywołania zastępuje globalną zmienną środowiskową w obu kierunkach. Przekaż `privacy_mode=false`, aby wyłączyć dla jednego wywołania, nawet gdy `WHISPER_PRIVACY_MODE=true` globalnie.
85
+
86
+ ### Zachowanie bramy trybu prywatności
87
+
88
+ Gdy tryb prywatności jest aktywny, potwierdzenie ujawnienia jest wyświetlane **przed każdą operacją**. Jest to celowe — zgodność z przepisami wymaga świadomej zgody przed każdym zdarzeniem przetwarzania, a nie tylko raz na sesję.
89
+
90
+ Tekst ujawnienia jest identyczny za każdym razem z projektu. Powtórzenie jest istotą: jeśli obsługujesz wrażliwe treści, powinieneś jawnie potwierdzać każdą operację.
91
+
92
+ Dla `start_batch` z trybem prywatności: przed rozpoczęciem partii wymagane jest jedno potwierdzenie. Następnie wszystkie pliki są przetwarzane bez nadzoru. Tekst transkrypcji nie jest zwracany w żadnym momencie — tylko metadane postępu partii.
93
+
94
+ ---
95
+
96
+ ## Brama zgody (tryb standardowy)
97
+
98
+ Gdy tryb prywatności nie jest aktywny, jednorazowe ujawnienie dla sesji jest wyświetlane przed pierwszym zwróceniem tekstu transkrypcji do API Claude w sesji.
99
+
100
+ Ujawnienie obejmuje:
101
+ - Że tekst transkrypcji zostanie przesłany do API Anthropic
102
+ - Ramy regulacyjne, które mogą mieć zastosowanie do twoich treści
103
+ - Jak włączyć tryb prywatności w razie potrzeby
104
+ - Jak trwale pominąć bramę dla treści niepoufnych
105
+
106
+ Po potwierdzeniu brama nie uruchamia się ponownie przez resztę sesji. Restart Claude Desktop resetuje sesję i brama uruchamia się ponownie przy następnym wywołaniu zwracającym transkrypcję.
107
+
108
+ **Dla zadań w tle:** brama zgody uruchamia się przy ukończeniu `check_progress`, a nie przy wywołaniu `transcribe_audio`. W momencie wywołania tekst transkrypcji jeszcze nie istnieje — nie ma czego blokować. Brama uruchamia się w momencie, gdy tekst transkrypcji byłby po raz pierwszy zwrócony do API.
109
+
110
+ ### Trwałe pomijanie bramy
111
+
112
+ Jeśli regularnie transkrybujesz treści niepoufne i nie potrzebujesz już przypomnienia, ustaw w konfiguracji:
113
+
114
+ ```json
115
+ "WHISPER_CONSENT_ACKNOWLEDGED": "true"
116
+ ```
117
+
118
+ Nie ma to żadnego efektu, gdy tryb prywatności jest aktywny. Tryb prywatności używa własnej bramy per operację, która zawsze uruchamia się niezależnie od tego ustawienia.
119
+
120
+ ---
121
+
122
+ ## Podsumowanie przepływu danych
123
+
124
+ | Tryb | Audio | Tekst transkrypcji | Wymagane potwierdzenie |
125
+ |---|---|---|---|
126
+ | Standardowy | Tylko lokalnie | Wysyłany do API Anthropic | Raz na sesję (brama zgody) |
127
+ | Tryb prywatności (zm. środow.) | Tylko lokalnie | Nigdy nie przesyłany | Przed każdą operacją |
128
+ | Tryb prywatności (jedn. wywołanie) | Tylko lokalnie | Nie dla tego wywołania | Przed tą operacją |
129
+ | `WHISPER_CONSENT_ACKNOWLEDGED=true` | Tylko lokalnie | Wysyłany do API Anthropic | Nigdy (pominięte) |
130
+
131
+ ---
132
+
133
+ ## Przesyłanie plików transkrypcji bezpośrednio do Claude
134
+
135
+ Gdy przesyłasz plik transkrypcji `.txt` bezpośrednio do Claude jako załącznik — całkowicie poza narzędziem MCP — serwer MCP nie ma wglądu i nie może zastosować żadnych kontroli prywatności.
136
+
137
+ Przesłanie transkrypcji bezpośrednio do Claude jest równoznaczne z wysłaniem treści audio do Anthropic. Tryb prywatności i wszystkie zabezpieczenia na poziomie MCP są całkowicie omijane przez bezpośrednie przesyłanie plików.
138
+
139
+ Użytkownicy obsługujący treści regulowane nie powinni przesyłać transkrypcji bezpośrednio do Claude. Jedyną bezpieczną ścieżką analizy treści regulowanych są lokalne narzędzia do przetwarzania, które nie przesyłają treści na zewnątrz.
140
+
141
+ ---
142
+
143
+ ## Wskazówki dla regulowanych branż
144
+
145
+ Poniższe informacje mają charakter wyłącznie ogólny. Autorzy tego narzędzia nie są prawnikami. Użytkownicy ponoszą wyłączną odpowiedzialność za przestrzeganie obowiązujących przepisów prawa i regulacji. W razie wątpliwości skonsultuj się z wykwalifikowanym prawnikiem przed transkrypcją regulowanych treści.
146
+
147
+ ### HIPAA (USA — opieka zdrowotna)
148
+ Świadczeniodawcy opieki zdrowotnej, ubezpieczyciele i ich partnerzy biznesowi mają zakaz przesyłania Chronionych Informacji Zdrowotnych (PHI) do nieautoryzowanych stron trzecich bez Umowy Partnera Biznesowego (BAA). Anthropic nie oferuje HIPAA BAA dla korzystania z konsumenckiego API Claude.
149
+
150
+ **Dotyczy przypadków użycia:** Konsultacje pacjentów, notatki kliniczne, sesje terapeutyczne, połączenia dotyczące roszczeń ubezpieczeniowych, administracyjne nagrania szpitalne.
151
+
152
+ **Zalecenie:** Włącz `WHISPER_PRIVACY_MODE=true` przed transkrypcją jakiegokolwiek audio pacjentów. Nie wyłączaj w trakcie sesji.
153
+
154
+ ### RODO (UE/EOG)
155
+ Dane osobowe rezydentów UE nie mogą być przekazywane podmiotom przetwarzającym będącym stronami trzecimi bez wyraźnej zgody i podstawy prawnej przetwarzania. Tekst transkrypcji zawierający imiona, lokalizacje lub jakiekolwiek dane identyfikacyjne stanowi dane osobowe zgodnie z RODO.
156
+
157
+ **Dotyczy przypadków użycia:** Wywiady, spotkania, nagrania call center, postępowania sądowe z udziałem rezydentów UE.
158
+
159
+ **Zalecenie:** Włącz tryb prywatności dla każdego nagrania, które może zawierać dane osobowe rezydentów UE/EOG.
160
+
161
+ ### Tajemnica adwokacka (USA, Wielka Brytania, Australia i większość jurysdykcji common law)
162
+ Komunikacja między adwokatami a klientami jest prawnie chroniona. Ujawnienie nieautoryzowanym stronom trzecim może znieść tę ochronę. Nie ma ugruntowanego precedensu prawnego chroniącego komunikację adwokacką przetwarzaną przez komercyjne API AI.
163
+
164
+ **Dotyczy przypadków użycia:** Zeznania prawne, konsultacje z klientami, wewnętrzne nagrania strategiczne, wywiady ze świadkami.
165
+
166
+ **Zalecenie:** Adwokaci transkrybujący chronioną komunikację powinni włączyć tryb prywatności. Nie wyłączaj do analizy — używaj lokalnych edytorów tekstu lub narzędzi do przetwarzania dla chronionych treści.
167
+
168
+ ### FERPA (USA — edukacja)
169
+ Dokumentacja edukacyjna uczniów jest chroniona. Szkoły i uczelnie nie mogą ujawniać możliwych do zidentyfikowania informacji o uczniach stronom trzecim bez zgody.
170
+
171
+ **Dotyczy przypadków użycia:** Nagrane wykłady, sesje doradcze dla studentów, przesłuchania akademickie, spotkania IEP.
172
+
173
+ ### SOX (USA — spółki publiczne)
174
+ Komunikacja finansowa spółek publicznych podlega wymogom dotyczącym przechowywania dokumentacji i poufności. Istotne informacje niepubliczne (MNPI) nie mogą być ujawniane selektywnie.
175
+
176
+ **Dotyczy przypadków użycia:** Nagrania konferencji wynikowych, protokoły posiedzeń zarządu, komunikacja z inwestorami, wewnętrzne dyskusje strategii finansowej.
177
+
178
+ ### PCI-DSS
179
+ Dane kart płatniczych nie mogą być przechowywane ani przesyłane w niezabezpieczonych środowiskach. Nagrania głosowe numerów kart podczas transakcji są objęte zakresem.
180
+
181
+ **Dotyczy przypadków użycia:** Nagrania call center, rozmowy obsługi klienta dotyczące przetwarzania płatności.
182
+
183
+ ### Ochrona tajemnicy handlowej / NDA
184
+ Poufne informacje biznesowe, zastrzeżone formuły, szczegóły nieopublikowanych produktów i informacje personalne mogą być chronione umową lub prawem.
185
+
186
+ **Dotyczy przypadków użycia:** Spotkania dotyczące strategii korporacyjnej, dyskusje R&D, rozmowy due diligence M&A, postępowania HR.
187
+
188
+ ---
189
+
190
+ ## Zgłaszanie problemów z prywatnością
191
+
192
+ Jeśli zidentyfikujesz problem z prywatnością lub lukę architektoniczną nieomówioną tutaj, użyj prywatnego raportowania podatności GitHub zamiast otwierania publicznego zgłoszenia. Instrukcje raportowania znajdziesz w [SECURITY.md](SECURITY.md).