Fish Audio Docs
Руководства по интеграцииСторонние интеграции
Back to site

Настройка голосового режима MCP

Настройте Fish Audio как OpenAI-совместимую службу TTS для голосового режима и клиентов MCP, таких как Claude Code.

Подключите Fish Audio TTS к MCP голосового режима.

Голосовой режим добавляет двусторонние голосовые разговоры в Claude Code и другие клиенты MCP. Добавьте Fish Audio OpenAI-совместимую конечную точку в список служб TTS.

Настройка переменных среды

Добавьте эти значения в блок env сервера MCP:

{
  "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, чтобы сервер голосового режима перезагрузил свою среду. Начните короткий голосовой разговор, затем замените тестовый голос предпочитаемым вами Voice ID.

Если настроено несколько URL-адресов TTS, голосовой режим может последовательно пытаться использовать резервные службы. При устранении неполадок сохраняйте только https://fishaudio.org/v1.

Поиск неисправностей

  • Используется другой сервис: удалите другие записи из VOICEMODE_TTS_BASE_URLS во время тестирования.
  • Ключ API отсутствует: убедитесь, что переменная доступна для процесса, запускающего сервер MCP.
  • Неверная модель или голос: используйте идентификаторы Fish Audio вместо значений по умолчанию OpenAI.
  • 401/402: проверьте ключ и кредитный баланс API.

Сопутствующая документация