Fish Audio Docs
Guides d'intégrationIntégrations tierces
Back to site

Configuration MCP du mode vocal

Configurez Fish Audio en tant que service TTS compatible OpenAI pour les clients en mode vocal et MCP tels que Claude Code.

Connectez Fish Audio TTS au mode vocal MCP

Le mode vocal ajoute des conversations vocales bidirectionnelles à Claude Code et à d'autres clients MCP. Ajoutez le point de terminaison compatible Fish Audio OpenAI à sa liste de services TTS.

Configurer les variables d'environnement

Ajoutez ces valeurs au bloc env du serveur 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"
}

Vous pouvez également les placer dans ~/.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"

Les anciennes variables TTS_BASE_URL, TTS_MODEL et TTS_VOICE restent prises en charge, mais les nouvelles configurations doivent utiliser les noms VOICEMODE_.

Testez et changez la voix

Redémarrez le client MCP pour que le serveur Voice Mode recharge son environnement. Démarrez une courte conversation vocale, puis remplacez la voix de test par votre [ID vocal] préféré (/fr/docs/api-reference/voices/list).

Lorsque plusieurs URL TTS sont configurées, le mode vocal peut essayer les services de secours en séquence. Conservez uniquement https://fishaudio.org/v1 pendant le dépannage.

Dépannage

  • Un autre service est utilisé : supprimez les autres entrées de VOICEMODE_TTS_BASE_URLS pendant les tests.
  • La clé API est manquante : assurez-vous que la variable est disponible pour le processus qui démarre le serveur MCP.
  • Modèle ou voix non valide : utilisez les identifiants Fish Audio plutôt que les valeurs par défaut OpenAI.
  • 401/402 : vérifiez la clé et le solde créditeur API.

Documentation associée