Démarrage rapide avec Claude Desktop

1. Obtenez votre clé API auprès d'ElevenLabs. Il y a un niveau gratuit avec 10k crédits par mois.
2. Installez uv (gestionnaire de paquets Python), installez avec curl -LsSf https://astral.sh/uv/install.sh | sh ou consultez le repouv pour d'autres méthodes d'installation.
3. Allez dans Claude > Settings > Developer > Edit Config > claude_desktop_config.json pour inclure ce qui suit :

{ "mcpServers" : { "ElevenLabs" : { "command" : "uvx", "args" : ["elevenlabs-mcp"], "env" : { "ELEVENLABS_API_KEY" : "<insert-your-api-key-here>" } } } }

Si vous utilisez Windows, vous devrez activer le "Developer Mode" dans Claude Desktop pour utiliser le serveur MCP. Cliquez sur "Aide" dans le menu hamburger en haut à gauche et sélectionnez "Activer le mode développeur".

Autres clients MCP

Pour d'autres clients comme Cursor et Windsurf, exécutez :

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print pour obtenir la configuration. Collez-la dans le répertoire de configuration approprié spécifié par votre client MCP.

Le tour est joué. Votre client MCP peut maintenant interagir avec ElevenLabs par le biais de ces outils :

Exemple d'utilisation

⚠️ Avertissement : Des crédits ElevenLabs sont nécessaires pour utiliser ces outils.

Essayez de demander à Claude :

• "Créez un agent d'intelligence artificielle qui parle comme un détective de film noir et qui peut répondre à des questions sur les films classiques
• "Générer trois variations de voix pour un personnage de dragon sage et ancien, puis je choisirai ma voix préférée pour l'ajouter à ma bibliothèque de voix"
• "Convertir cet enregistrement de ma voix pour qu'elle ressemble à celle d'un chevalier médiéval
• "Créer un paysage sonore d'un orage dans une jungle dense avec des animaux réagissant aux conditions météorologiques
• "Transformer ce discours en texte, identifier les différents locuteurs, puis le reconvertir en utilisant des voix uniques pour chaque personne

Fonctions optionnelles

Vous pouvez ajouter la variable d'environnement ELEVENLABS_MCP_BASE_PATH au fichier claude_desktop_config.json pour spécifier le chemin de base que le serveur MCP doit rechercher et les fichiers de sortie spécifiés avec des chemins relatifs.

Contribuer

Si vous souhaitez contribuer ou exécuter à partir des sources :

1. Clonez le dépôt :

git clone https://github.com/elevenlabs/elevenlabs-mcp cd elevenlabs-mcp

2. Créez un environnement virtuel et installez les dépendances à l'aide de uv:

uv venv source .venv/bin/activate uv pip install -e ".[dev]"

3. Copiez .env.example dans .env et ajoutez votre clé API ElevenLabs :

cp .env.example .env # Modifiez .env et ajoutez votre clé API

4. Exécutez les tests pour vous assurer que tout fonctionne :

./scripts/test.sh # Ou avec les options ./scripts/test.sh --verbose --fail-fast

5. Installer le serveur dans Claude Desktop : mcp install elevenlabs_mcp/server.py

6. Déboguer et tester localement avec MCP Inspector : mcp dev elevenlabs_mcp/server.py

Résolution des problèmes

Les journaux lors de l'exécution avec Claude Desktop peuvent être trouvés à l'adresse suivante :

• Windows: %APPDATA%\Claude\logs\mcp-server-elevenlabs.log
• macOS: ~/Library/Logs/Claude/mcp-server-elevenlabs.log

Délais d'attente lors de l'utilisation de certains outils

Certaines opérations de l'API ElevenLabs, comme la conception vocale et l'isolation audio, peuvent prendre beaucoup de temps à résoudre. Lorsque vous utilisez l'inspecteur MCP en mode dev, vous pouvez obtenir des erreurs de dépassement de délai bien que l'outil ait terminé sa tâche.

Cela ne devrait pas se produire lors de l'utilisation d'un client comme Claude.

MCP ElevenLabs : spawn uvx ENOENT

Si vous rencontrez l'erreur "MCP ElevenLabs : spawn uvx ENOENT", confirmez son chemin absolu en lançant cette commande dans votre terminal :

which uvx

Une fois que vous avez obtenu le chemin absolu (par exemple, /usr/local/bin/uvx), mettez à jour votre configuration pour utiliser ce chemin (par exemple, "command" : "/usr/local/bin/uvx"). Cela permet de s'assurer que l'exécutable correct est référencé.