Kitta Audio TTS를 음성 모드 MCP에 연결합니다.

음성 모드는 Claude Code 및 기타 MCP 클라이언트에 양방향 음성 대화를 추가합니다. Kitta Audio OpenAI 호환 엔드포인트를 TTS 서비스 목록에 추가합니다.

환경 변수 구성

MCP 서버의 env 블록에 다음 값을 추가합니다.

{
  "OPENAI_API_KEY": "YOUR_API_KEY",
  "VOICEMODE_TTS_BASE_URLS": "https://fishaudio.org/v1",
  "VOICEMODE_TTS_MODEL": "fishaudio-s21pro-flash",
  "VOICEMODE_TTS_VOICE": "00a1b221-6137-4b73-ad62-b0cbce134167"
}

또는 ~/.voicemode/voicemode.env에 넣으십시오.

export OPENAI_API_KEY="YOUR_API_KEY"
export VOICEMODE_TTS_BASE_URLS="https://fishaudio.org/v1"
export VOICEMODE_TTS_MODEL="fishaudio-s21pro-flash"
export VOICEMODE_TTS_VOICE="00a1b221-6137-4b73-ad62-b0cbce134167"

레거시 TTS_BASE_URL, TTS_MODEL 및 TTS_VOICE 변수는 계속 지원되지만 새 구성에서는 VOICEMODE_ 이름을 사용해야 합니다.

음성 테스트 및 변경

음성 모드 서버가 해당 환경을 다시 로드하도록 MCP 클라이언트를 다시 시작합니다. 짧은 음성 대화를 시작한 후 테스트 음성을 원하는 음성 ID로 바꾸세요.

여러 개의 TTS URL이 구성되면 음성 모드에서 대체 서비스를 순차적으로 시도할 수 있습니다. 문제를 해결하는 동안 https://fishaudio.org/v1만 유지하세요.

문제 해결

• 다른 서비스가 사용됩니다: 테스트 중에 VOICEMODE_TTS_BASE_URLS에서 다른 항목을 제거합니다.
• API 키가 누락되었습니다: MCP 서버를 시작하는 프로세스에서 변수를 사용할 수 있는지 확인하세요.
• 잘못된 모델 또는 음성: 기본값인 OpenAI 대신 Kitta Audio ID를 사용하세요.
• 401/402: 키와 API 크레딧 잔액을 확인하세요.

관련 문서

• API 인증
• OpenAI-호환 TTS
• 음성모드 환경 참고