Connectez le serveur MCP hébergé d’ElevenLabs à Claude Code, ChatGPT et Cursor avec une seule connexion OAuth. Obtenez les commandes exactes, l’entrée mcp.json, les URL régionales et les correctifs pour les erreurs de connexion, puis sonorisez vos scripts dans le navigateur sur PicassoIA avec ElevenLabs v3.
La plupart des tutoriels sur cette configuration vous demandent encore de coller un secret d’API dans un fichier JSON et de lancer un paquet Python appelé elevenlabs-mcp. Cette voie est une impasse. Le dépôt GitHub officiel est archivé, son propre avertissement qualifie le serveur local de déprécié, et ElevenLabs propose désormais un serveur MCP hébergé à https://api.elevenlabs.io/v1/mcp qui vous connecte par OAuth. Il n’y a aucun paquet à installer, aucun secret dans un fichier de configuration, et rien à mettre à jour quand la prochaine version sortira.
Cet article connecte ce serveur hébergé à Claude Code, ChatGPT et Cursor, avec les commandes exactes, l’entrée JSON et les correctifs pour les erreurs que les utilisateurs rencontrent réellement. Après les trois configurations, vous verrez aussi comment utiliser les mêmes voix ElevenLabs directement dans le navigateur sur PicassoIA lorsque vous avez seulement besoin d’une voix off et ne souhaitez aucune connexion.
Avant de taper la moindre commande, il est utile de comprendre pourquoi la configuration paraît si différente de ce que vous avez pu lire l’an dernier. L’ancien serveur était un programme installé sur votre propre ordinateur. Le nouveau est un service que votre assistant appelle par internet, de la même façon qu’il appelle n’importe quel autre connecteur.
| Serveur hébergé | Ancien paquet local | |
|---|---|---|
| Où il tourne | Infrastructure d’ElevenLabs | Votre machine, lancé par uvx |
| Connexion | OAuth, une seule fois, révocable à tout moment | Secret d’API dans une variable d’environnement |
| Installation | Aucune | uv plus le paquet elevenlabs-mcp |
| Maintenance | Mise à jour par ElevenLabs | Dépôt archivé, plus activement maintenu |
| Contrôle d’accès | Les administrateurs de l’espace de travail choisissent les outils autorisés | Tout ce que votre secret d’API permet |
| Où arrivent les résultats | Votre espace de travail ElevenCreative | Un dossier sur le disque, ~/Desktop par défaut |
La différence concrète apparaît la première fois que quelque chose casse. Avec le paquet local, il fallait démêler les outils Python, les problèmes de PATH et les erreurs de fichier de configuration. Avec le serveur hébergé, les seuls éléments en mouvement sont une URL et une connexion dans le navigateur.
💡 Vous utilisez déjà l’ancien paquet ? Il fonctionne toujours, donc rien ne vous oblige à changer aujourd’hui. Mais une nouvelle installation n’a aucune raison de partir de là, et les configurations ci-dessous prennent moins de temps que l’installation de
uv.
Une fois connecté, l’assistant dispose d’un ensemble d’outils qui accèdent à votre espace de travail ElevenLabs. ElevenLabs les regroupe en deux domaines, ElevenCreative pour générer des médias et ElevenAgents pour créer des agents vocaux et de chat. Concrètement, votre assistant peut :
Tout ce que vous générez arrive dans votre espace de travail ElevenCreative, où vous pouvez l’ouvrir dans Studio pour finaliser le travail. Ce détail compte plus qu’il n’y paraît : l’audio n’est pas enfermé dans une fenêtre de chat, il se trouve au même endroit que le reste de vos projets.
Il vous faut trois éléments : un compte ElevenLabs, l’un des clients pris en charge et l’URL de serveur adaptée à la région de vos données. La plupart des gens n’ont besoin que de la première URL du tableau.
| Région | URL du serveur |
|---|---|
| Par défaut | https://api.elevenlabs.io/v1/mcp |
| Résidence UE | https://api.eu.residency.elevenlabs.io/v1/mcp |
| Résidence Inde | https://api.in.residency.elevenlabs.io/v1/mcp |
| Résidence Singapour | https://api.sg.residency.elevenlabs.io/v1/mcp |
Les URL de résidence sont destinées aux espaces de travail créés avec une résidence de données isolée. Si vous n’avez jamais rencontré ce terme dans votre compte ElevenLabs, utilisez l’URL par défaut.
Deux autres points méritent une minute. D’abord, la connexion par navigateur utilise le compte ElevenLabs actif : connectez-vous donc au compte qui possède l’espace de travail que votre assistant doit toucher. Ensuite, ElevenLabs ne publie pas le coût en crédits de chaque outil sur ses pages MCP. Traitez donc vos premières exécutions comme un test, et surveillez votre consommation dans le tableau de bord avant de lancer un long lot.
Claude Code gère nativement le MCP distant, ce qui en fait la voie la plus courte des trois. Vous pouvez ajouter uniquement le serveur, ou installer le plugin qui regroupe le serveur avec des compétences prêtes à l’emploi.
Exécutez cette commande dans votre terminal, en dehors de toute session Claude Code :
claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp
Terminez ensuite la connexion depuis Claude Code :
claude./mcp pour ouvrir la liste des serveurs.Lorsque le navigateur indique que vous êtes connecté, le statut du serveur dans /mcp passe de « nécessite une authentification » à « connecté », et les outils ElevenLabs apparaissent dans la liste.
Si vous voulez plus que des outils bruts, ElevenLabs fournit un plugin qui fonctionne dans Claude Code, Cursor et OpenAI Codex. Dans Claude Code, il s’installe en deux commandes :
/plugin marketplace add elevenlabs/plugin
/plugin install elevenlabs@elevenlabs
Le plugin ajoute trois groupes de compétences à la connexion :
L’authentification reste la même : vous vous connectez par OAuth lorsque l’agent se connecte au serveur pour la première fois.
Vérifiez que le serveur est bien enregistré et opérationnel :
claude mcp list
Par défaut, claude mcp add enregistre le serveur pour le projet en cours uniquement. Ajoutez --scope user pour le rendre disponible dans tous les projets de votre machine :
claude mcp add --scope user --transport http elevenlabs https://api.elevenlabs.io/v1/mcp
Utilisez plutôt --scope project lorsqu’une équipe entière doit partager la même configuration. Cela écrit un fichier .mcp.json à la racine du projet, et comme la connexion passe par OAuth, l’entrée ne contient que l’URL.
💡 Espace de travail régional ? Remplacez l’URL par défaut par l’URL de résidence de votre région indiquée dans le tableau ci-dessus. Le reste de la commande reste identique.
Essayez tout de suite un premier prompt : « Lisez le README de ce dépôt et générez une narration de 20 secondes des étapes d’installation, d’une voix calme. » Claude Code lit le fichier, écrit le script et appelle l’outil de synthèse vocale, et l’audio finalisé apparaît dans votre espace de travail ElevenCreative.
Cursor propose deux voies, et les deux se terminent par la même invite OAuth. Choisissez la marketplace si vous voulez des compétences, ou le fichier JSON si vous voulez contrôler précisément ce qui se charge.
Ouvrez la marketplace de Cursor, recherchez le plugin ElevenLabs et installez-le. Le plugin regroupe le serveur hébergé et ses compétences, afin que votre agent de code puisse accéder à la parole, aux effets sonores, à la musique et au doublage sans configuration supplémentaire. La première fois qu’il se connecte, Cursor vous demande de vous connecter à ElevenLabs.
Pour une configuration manuelle, ajoutez le serveur à votre mcp.json. Utilisez ~/.cursor/mcp.json pour tous les projets, ou .cursor/mcp.json dans un seul dépôt :
{
"mcpServers": {
"elevenlabs": {
"url": "https://api.elevenlabs.io/v1/mcp"
}
}
}
Enregistrez le fichier et rechargez la fenêtre. Cursor vous demande de vous connecter par OAuth lors de la première connexion, et les outils ElevenLabs apparaissent ensuite dans la section MCP de vos paramètres. Remarquez ce qui manque dans le JSON : aucun command, aucun args, aucun bloc env. Un serveur distant n’a besoin que d’une URL, rien de plus.
Un bon test dans Cursor consiste à narrer une démo : « Générez une voix off pour le parcours de paiement de ce projet, deux phrases, ton amical. » Si l’agent demande une autorisation avant d’appeler l’outil, c’est la confirmation d’outil de Cursor qui fait son travail, pas une erreur.
C’est avec ChatGPT que l’ancien paquet local s’intégrait le moins bien. ChatGPT se connecte aux serveurs MCP via l’internet public, donc un programme qui tourne sur votre ordinateur portable était inaccessible sans tunnel. Un serveur hébergé supprime complètement cet obstacle.
Les noms des menus de ChatGPT changent d’une version et d’une offre à l’autre. Suivez donc la logique plutôt que les libellés exacts :
https://api.elevenlabs.io/v1/mcp et sélectionnez OAuth comme méthode d’authentification.💡 Option introuvable ? Sur les espaces de travail Business, Enterprise et Education, un administrateur doit parfois autoriser d’abord les connecteurs personnalisés, généralement via une bascule du mode développeur dans les autorisations de l’espace de travail. Sur les forfaits personnels, la disponibilité varie : vérifiez votre forfait avant de passer une heure à déboguer.
Commencez petit pour savoir si le problème vient de la connexion ou du prompt. Ces cinq exemples fonctionnent de la même façon dans ChatGPT, Claude Code et Cursor :
Si le premier prompt fonctionne, les autres suivront. S’il échoue avec un message sur les outils ou les autorisations, passez à la section suivante.
Presque tous les échecs entrent dans l’une de ces trois catégories : la connexion ne s’est jamais terminée, le compte ou la région ne correspond pas, ou une ancienne configuration fait obstacle.
Dans Claude Code, un serveur OAuth fraîchement ajouté reste à l’état « nécessite une authentification » tant que vous n’ouvrez pas /mcp, que vous ne le sélectionnez pas et que vous ne lancez pas vous-même la connexion. Il n’ouvre en général pas d’onglet de navigateur de lui-même. Dans Cursor et ChatGPT, relancez l’action de connexion et vérifiez que votre navigateur n’a pas bloqué la fenêtre contextuelle. Si un onglet s’est ouvert sur le mauvais compte ElevenLabs, déconnectez-vous dans le navigateur et recommencez le parcours.
Deux symptômes différents se cachent ici, avec des solutions différentes.
| Symptôme | Cause probable | Solution |
|---|---|---|
| La connexion fonctionne mais l’espace de travail paraît vide | URL par défaut utilisée pour un espace de travail à résidence régionale | Passez à l’URL de serveur de votre région |
| L’assistant indique qu’un outil est indisponible | L’outil est désactivé dans le client | Activez-le dans les réglages d’outils du client |
| Un outil est refusé après votre approbation | L’administrateur de l’espace de travail ne l’a pas autorisé | Demandez à un administrateur d’autoriser cet outil |
| L’assistant s’arrête pour demander avant chaque appel | La confirmation est activée | Gardez-la active pour les générations qui consomment des crédits |
L’accès est contrôlé à deux niveaux. Les autorisations OAuth d’ElevenLabs limitent ce que la connexion peut faire, et les contrôles d’outils de votre client vous permettent de désactiver certains outils ou d’exiger une confirmation avant chaque appel. Garder la confirmation activée pour tout ce qui consomme des crédits est une valeur par défaut raisonnable.
Si vous avez suivi un ancien article, une entrée qui lance uvx elevenlabs-mcp peut encore figurer dans votre configuration. Deux serveurs exposant des outils similaires font choisir l’assistant de façon imprévisible, donc supprimez l’ancien :
claude mcp remove ElevenLabs
Utilisez le nom exact que vous lui avez donné, et supprimez le bloc correspondant de claude_desktop_config.json ou de mcp.json s’il s’y trouve. Trois autres reliquats méritent d’être nettoyés :
ELEVENLABS_MCP_BASE_PATH et ELEVENLABS_MCP_OUTPUT_MODE appartiennent au paquet local et ne servent à rien sur le serveur hébergé.Tous les projets ne nécessitent pas un assistant. Si vous voulez simplement une voix off à partir d’un script fini, ElevenLabs V3 sur PicassoIA fonctionne dans le navigateur, sans connexion, sans OAuth et sans client à configurer. Il propose 25+ voix, une sortie multilingue et des réglages fins de la vitesse, du ton et du style.
en, es ou fr.| Réglage | Plage | Par défaut | Rôle |
|---|---|---|---|
| Speed | 0,25 à 4,0 | 1 | Règle le rythme de la parole |
| Style | 0,0 à 1,0 | 0 | Fait passer la diction d’une narration neutre à un ton théâtral |
| Stability | 0,0 à 1,0 | 0,5 | Garde la voix cohérente sur un long script |
| Similarity Boost | 0,0 à 1,0 | 0,75 | Maintient le rendu plus proche du profil vocal |
💡 Conseil : Pour un chapitre de livre audio ou un module de cours, augmentez Stability et laissez Style proche de zéro pour que la phrase 40 sonne comme la phrase 1. Pour une bande-annonce ou une voix de personnage, faites l’inverse.
ElevenLabs n’est pas un modèle unique, et PicassoIA en héberge plusieurs. Choisissez selon la tâche, pas selon le nom le plus récent.
| Modèle | Idéal pour |
|---|---|
| ElevenLabs V3 | Voix off expressives avec 25+ voix et contrôle du style |
| Flash v2.5 | Synthèse vocale rapide quand la vitesse prime |
| Turbo v2.5 | Voix off rapides en 32 langues |
| v2 Multilingual | Voix off en 30+ langues |
| Doublage | Traduction de vidéos en 90+ langues |
Le script lui-même peut venir d’un grand modèle de langage disponible sur la même plateforme. Rédigez-le avec Claude Sonnet 5 ou GPT 5.6 Sol, collez le résultat dans un modèle vocal, et vous obtenez une pièce narrée sans quitter le navigateur.
💡 Deux connecteurs, un seul assistant. PicassoIA propose aussi son propre connecteur pour générer des images et des vidéos depuis un chat. Utilisez-le en parallèle du connecteur ElevenLabs : un seul assistant peut sonoriser un script et l’illustrer dans la même conversation.
Une voix ne représente que la moitié d’un projet fini. Chaque vidéo a encore besoin d’une miniature, chaque podcast d’une illustration, et chaque démo de quelques scènes qui ressemblent à de vraies photographies plutôt qu’à des visuels de banques d’images sans caractère. C’est la partie que Picasso IA prend en charge en quelques secondes.
Commencez avec le modèle PicassoIA Image, ou essayez Seedream 4.5 pour une seconde version. Décrivez le sujet, la lumière et l’objectif en une phrase, par exemple « un podcasteur à un bureau en bois, lumière de fenêtre venant de la gauche, objectif 85mm, faible profondeur de champ », puis modifiez un détail à la fois et comparez les résultats. Quand une image est presque bonne mais pas tout à fait juste, PicassoIA Image Editor Pro vous permet de la retoucher au lieu de tout recommencer.
Choisissez un script que vous avez sonorisé aujourd’hui, générez trois images qui s’y rapportent et assemblez le tout. Vous pouvez parcourir tous les modèles disponibles sur picassoia.com/en/all-models et commencer à expérimenter dès maintenant.
Choisissez votre langue
