Conecte Fish Audio TTS ao modo de voz MCP

O Modo de Voz adiciona conversas de voz bidirecionais para Claude Code e outros clientes MCP. Adicione o endpoint compatível com Fish Audio OpenAI à sua lista de serviços TTS.

Configurar variáveis ​​de ambiente

Adicione estes valores ao bloco env do servidor 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"
}

Alternativamente, coloque-os em ~/.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"

As variáveis ​​herdadas TTS_BASE_URL, TTS_MODEL e TTS_VOICE permanecem suportadas, mas novas configurações devem usar os nomes VOICEMODE_.

Teste e mude a voz

Reinicie o cliente MCP para que o servidor do Modo de Voz recarregue seu ambiente. Inicie uma breve conversa de voz e substitua a voz de teste pelo seu ID de voz preferido.

Quando vários URLs TTS são configurados, o Modo de Voz pode tentar serviços de fallback em sequência. Mantenha apenas https://fishaudio.org/v1 durante a solução de problemas.

Solução de problemas

• Outro serviço é usado: remova outras entradas de VOICEMODE_TTS_BASE_URLS durante o teste.
• Falta a chave API: certifique-se de que a variável esteja disponível para o processo que inicia o servidor MCP.
• Modelo ou voz inválidos: use IDs Fish Audio em vez dos padrões OpenAI.
• 401/402: verifique a chave e o saldo de crédito API.

Documentação relacionada

• Autenticação API
• OpenAI compatível com TTS
• Referência do ambiente do modo de voz