Claude Code에서 Whisperr 사용하기

이 페이지는 Anthropic의 터미널 앱인 Claude Code에 Whisperr를 추가하는 방법을 설명합니다. 연결한 뒤 무엇을 할 수 있는지는 MCP 연동 개요를 참고하세요. Claude 데스크톱 앱을 쓰시나요? Claude Desktop을 확인하세요.

시작하기 전에

터미널에 붙여넣고 Enter 키를 누릅니다. 아래와 같은 모양입니다(키와 주소는 페이지에서 이미 채워져 있습니다):
```
claude mcp add --scope user --transport http whisperr https://prod-whisperr-mcp.fly.dev/mcp --header "Authorization: Bearer wsk_live_…"
```
연결되었는지 확인합니다:
```
claude mcp list
```
목록에 whisperr가 연결된 상태로 보여야 합니다. Claude Code 안에서 /mcp를 입력해도 같은 내용이 표시되며, Whisperr의 도구 6개를 볼 수 있습니다.

--scope user를 쓰면 명령어를 실행한 폴더에서만이 아니라 어디서든 Whisperr를 사용할 수 있습니다.

claude mcp add는 이미 있는 항목을 덮어쓰지 않습니다. 이전 항목을 먼저 삭제한 뒤 새 명령어를 실행하세요. 키를 발급하면 페이지에 두 명령어가 모두 표시됩니다.

claude mcp remove --scope user whisperr

claude로 Claude Code를 시작한 다음, 평소 말하듯이 요청해 보세요:

요청	결과
"내 Whisperr 대화 목록 보여 줘"	저장된 대화가 링크와 함께 표시됩니다
"가장 최근 대화를 읽고 요약해 줘"	Claude가 전사와 번역을 읽은 뒤 요약합니다
"회의 링크에 영어와 일본어로 Whisperr 봇을 보내 줘"	봇이 입장하고 Claude가 실시간 전사 링크를 알려 줍니다. 회의에 로비가 있으면 "Whisperr Bot"의 입장을 허용하세요
"봇이 회의에 들어왔어?"	대기실에 있는지, 회의 중인지, 종료되었는지 알려 줍니다
"봇 멈춰 줘"	봇이 회의에서 나갑니다
"그 회의 전사 읽어 줘"	회의가 끝나고 몇 분 뒤, 방금 녹음한 전사를 읽어 줍니다

Claude Code는 Whisperr 도구를 쓰기 전에 먼저 묻습니다. 매번 승인하거나, 믿을 수 있다면 항상 허용하도록 선택하세요.

팁

요금제에서는 한 번에 봇 하나만 실행할 수 있습니다. 한도에 도달했다는 메시지가 나오면 Claude에게 실행 중인 봇을 먼저 멈추라고 하세요.

다시 발급 (명령어를 잃어버렸거나 키가 유출되었을 수 있을 때): MCP 연동에서 키 다시 발급을 클릭합니다. 이전 키는 즉시 사용할 수 없게 됩니다. 삭제 명령어를 실행한 다음 새 추가 명령어를 실행하세요.
Claude Code 연결 해제: claude mcp remove --scope user whisperr를 실행합니다.

주의

명령어에는 키가 들어 있으므로 셸 기록에도 키가 남습니다. 터미널 기록을 공유하거나, 명령어를 채팅에 붙여넣거나 스크린샷에 담지 마세요. 그런 일이 있었다면 키를 다시 발급하세요.

증상	해결 방법
`claude mcp list`에 `whisperr`가 없음	추가 명령어를 다시 실행하세요. 이름이 이미 있다는 메시지가 나오면 삭제 명령어를 먼저 실행하세요.
"Invalid or expired API key"	키가 다시 발급되었거나 폐기되었습니다. MCP 연동에서 키 다시 발급을 클릭한 뒤 삭제하고 다시 추가하세요.
"subscription_required"	봇을 보내려면 활성 구독이 필요합니다. 대화 읽기는 구독 없이도 됩니다.
"concurrency_limit"	이미 봇 하나가 회의에 참가 중입니다. 먼저 봇을 멈추세요.
봇이 입장하지 않음	회의 링크를 확인하고 로비가 있는지 살펴보세요. 호스트가 "Whisperr Bot"의 입장을 허용해야 합니다.

더 자세한 내용은 MCP 연동 개요를 참고하세요.