Conecta el servidor MCP alojado de ElevenLabs a Claude Code, ChatGPT y Cursor con un solo inicio de sesión OAuth. Obtén los comandos exactos, la entrada de mcp.json, las URL por región y las soluciones a los errores de inicio de sesión. Después, pon voz a tus guiones en el navegador de PicassoIA con ElevenLabs v3.
La mayoría de los tutoriales de esta configuración todavía te dicen que pegues un secreto de API en un archivo JSON y que lances un paquete de Python llamado elevenlabs-mcp. Esa ruta no lleva a ninguna parte. El repositorio oficial de GitHub está archivado, su propio aviso califica el servidor local de obsoleto, y ElevenLabs ahora ofrece un servidor MCP alojado en https://api.elevenlabs.io/v1/mcp que inicia sesión con OAuth. No hay ningún paquete que instalar, ningún secreto guardado en un archivo de configuración y nada que actualizar cuando salga la próxima versión.
Este artículo conecta ese servidor alojado a Claude Code, ChatGPT y Cursor, con los comandos exactos, la entrada JSON y las soluciones a los errores que la gente realmente encuentra. Tras las tres configuraciones, verás también cómo usar las mismas voces de ElevenLabs directamente en el navegador de PicassoIA cuando solo necesitas una locución y no quieres ninguna conexión.
Antes de escribir un solo comando, conviene saber por qué la configuración es tan distinta de lo que pudiste leer el año pasado. El servidor antiguo era un programa en tu propio equipo. El nuevo es un servicio al que tu asistente llama por internet, igual que llama a cualquier otro conector.
| Servidor alojado | Antiguo paquete local | |
|---|---|---|
| Dónde se ejecuta | Infraestructura de ElevenLabs | Tu equipo, iniciado con uvx |
| Inicio de sesión | OAuth una sola vez, revocable en cualquier momento | Secreto de API en una variable de entorno |
| Instalación | Nada | uv más el paquete elevenlabs-mcp |
| Mantenimiento | Actualizado por ElevenLabs | Repositorio archivado, ya no se mantiene activamente |
| Control de acceso | Los administradores del espacio de trabajo eligen qué herramientas puede usar | Lo que permita tu secreto de API |
| Dónde quedan los resultados | Tu espacio de trabajo de ElevenCreative | Una carpeta en el disco, ~/Desktop por defecto |
La diferencia práctica se nota la primera vez que algo falla. Con el paquete local, tenías que resolver problemas de herramientas de Python, de PATH y errores en el archivo de configuración. Con el servidor alojado, las únicas partes que pueden fallar son una URL y un inicio de sesión en el navegador.
💡 ¿Ya usas el paquete antiguo? Sigue funcionando, así que nada te obliga a cambiar hoy. Pero una configuración nueva no tiene motivos para empezar ahí, y las configuraciones de abajo llevan menos tiempo que instalar
uv.
Una vez conectado, el asistente obtiene un conjunto de herramientas que accede a tu espacio de trabajo de ElevenLabs. ElevenLabs las agrupa en dos áreas, ElevenCreative para generar contenido multimedia y ElevenAgents para crear agentes de voz y de chat. En términos sencillos, tu asistente puede:
Todo lo que generas acaba en tu espacio de trabajo de ElevenCreative, donde puedes abrirlo en Studio para terminar el trabajo. Ese detalle importa más de lo que parece: el audio no queda atrapado en una ventana de chat, sino que está en el mismo sitio que el resto de tus proyectos.
Necesitas tres cosas: una cuenta de ElevenLabs, uno de los clientes compatibles y la URL correcta del servidor para tu región de datos. La mayoría solo necesita la primera URL de la tabla.
| Región | URL del servidor |
|---|---|
| Predeterminado | https://api.elevenlabs.io/v1/mcp |
| Residencia en la UE | https://api.eu.residency.elevenlabs.io/v1/mcp |
| Residencia en India | https://api.in.residency.elevenlabs.io/v1/mcp |
| Residencia en Singapur | https://api.sg.residency.elevenlabs.io/v1/mcp |
Las URL de residencia están pensadas para espacios de trabajo creados con residencia de datos aislada. Si nunca has oído ese término en tu cuenta de ElevenLabs, usa la URL predeterminada.
Hay otras dos cosas que merecen un minuto. Primero, el inicio de sesión en el navegador toma la cuenta de ElevenLabs que esté activa, así que inicia sesión con la cuenta que es propietaria del espacio de trabajo que quieres que tu asistente use. Segundo, ElevenLabs no publica el costo en créditos de cada herramienta en sus páginas de MCP, así que trata tus primeras ejecuciones como una prueba y vigila tu consumo en el panel antes de lanzar un lote largo.
Claude Code habla MCP remoto de forma nativa, lo que lo convierte en el camino más corto de los tres. Puedes añadir solo el servidor o instalar el plugin que incluye el servidor con skills ya preparadas.
Ejecuta esto en tu terminal, fuera de cualquier sesión de Claude Code:
claude mcp add --transport http elevenlabs https://api.elevenlabs.io/v1/mcp
Después, termina el inicio de sesión desde dentro de Claude Code:
claude./mcp para abrir la lista de servidores.Cuando el navegador confirme que estás conectado, el estado del servidor en /mcp pasa de necesitar autenticación a conectado, y las herramientas de ElevenLabs aparecen en la lista.
Si quieres algo más que herramientas sueltas, ElevenLabs ofrece un plugin que funciona en Claude Code, Cursor y OpenAI Codex. En Claude Code se instala con dos comandos:
/plugin marketplace add elevenlabs/plugin
/plugin install elevenlabs@elevenlabs
El plugin añade tres grupos de skills sobre la conexión:
La autenticación sigue igual: inicias sesión con OAuth cuando el agente se conecta al servidor por primera vez.
Comprueba que el servidor se haya registrado y que funciona bien:
claude mcp list
Por defecto, claude mcp add guarda el servidor solo para el proyecto actual. Añade --scope user para que esté disponible en todos los proyectos de tu equipo:
claude mcp add --scope user --transport http elevenlabs https://api.elevenlabs.io/v1/mcp
Usa --scope project en su lugar cuando todo un equipo deba compartir la misma configuración. Eso escribe un archivo .mcp.json en la raíz del proyecto y, como el inicio de sesión se hace con OAuth, la entrada solo contiene la URL.
💡 ¿Espacio de trabajo regional? Sustituye la URL predeterminada por la URL de residencia de tu región de la tabla de arriba. El resto del comando sigue igual.
Prueba un primer prompt ya: "Lee el README de este repo y genera una narración de 20 segundos de los pasos de instalación con una voz tranquila." Claude Code lee el archivo, escribe el guion y llama a la herramienta de voz, y el audio terminado aparece en tu espacio de trabajo de ElevenCreative.
Cursor ofrece dos caminos, y ambos terminan con el mismo aviso de OAuth. Elige el marketplace si quieres las skills, o el archivo JSON si quieres control total sobre lo que se carga.
Abre el marketplace de Cursor, busca el plugin de ElevenLabs e instálalo. El plugin reúne el servidor alojado y sus skills, de modo que tu agente de programación puede acceder a voz, efectos de sonido, música y doblaje sin configuración adicional. La primera vez que se conecta, Cursor te pide que inicies sesión en ElevenLabs.
Para una configuración manual, añade el servidor a tu mcp.json. Usa ~/.cursor/mcp.json para todos los proyectos, o .cursor/mcp.json dentro de un solo repositorio:
{
"mcpServers": {
"elevenlabs": {
"url": "https://api.elevenlabs.io/v1/mcp"
}
}
}
Guarda el archivo y recarga la ventana. Cursor te pide que inicies sesión con OAuth la primera vez que se conecta, y las herramientas de ElevenLabs aparecen después en la sección MCP de tus ajustes. Fíjate en lo que falta en el JSON: no hay command, ni args, ni bloque env. Un servidor remoto necesita una URL y nada más.
Una buena prueba en Cursor es una narración para una demo: "Genera una locución para el flujo de pago de este proyecto, dos frases, tono amable." Si el agente te pide permiso antes de llamar a la herramienta, es la confirmación de herramientas de Cursor haciendo su trabajo, no un error.
ChatGPT es donde peor encajaba el antiguo paquete local. ChatGPT se conecta a servidores MCP a través de internet público, así que un programa que se ejecuta en tu equipo portátil quedaba fuera de alcance sin un túnel. Un servidor alojado elimina ese obstáculo por completo.
Los nombres de los menús de ChatGPT cambian entre versiones y planes, así que sigue la lógica en lugar de las etiquetas exactas:
https://api.elevenlabs.io/v1/mcp y selecciona OAuth como método de autenticación.💡 ¿No aparece la opción? En espacios de trabajo Business, Enterprise y Education, un administrador puede tener que permitir primero los conectores personalizados, normalmente con un interruptor de modo desarrollador en los permisos del espacio de trabajo. En los planes personales, la disponibilidad varía, así que revisa tu plan antes de dedicar una hora a depurar.
Empieza con algo pequeño para saber si el fallo está en la conexión o en el prompt. Estos cinco funcionan igual en ChatGPT, Claude Code y Cursor:
Si el primer prompt funciona, los demás también. Si falla con un mensaje sobre herramientas o permisos, ve a la siguiente sección.
Casi todos los fallos caen en uno de tres grupos: el inicio de sesión nunca se terminó, la cuenta o la región no coinciden, o una configuración antigua sigue interfiriendo.
En Claude Code, un servidor OAuth recién añadido se queda en estado de necesitar autenticación hasta que abres /mcp, lo seleccionas e inicias el inicio de sesión tú mismo. Normalmente no abre una pestaña del navegador por su cuenta. En Cursor y ChatGPT, vuelve a intentar la conexión y comprueba que el navegador no haya bloqueado la ventana emergente. Si se abrió una pestaña con la cuenta de ElevenLabs equivocada, cierra la sesión en el navegador y repite el proceso.
Aquí se esconden dos síntomas distintos, y tienen soluciones diferentes.
| Síntoma | Causa probable | Solución |
|---|---|---|
| El inicio de sesión funciona, pero el espacio de trabajo parece vacío | Se usa la URL predeterminada en un espacio de trabajo con residencia | Cambia a la URL del servidor de tu región |
| El asistente dice que una herramienta no está disponible | La herramienta está desactivada en el cliente | Actívala en los ajustes de herramientas del cliente |
| Se rechaza una herramienta después de aprobarla | El administrador del espacio de trabajo no la permitió | Pide a un administrador que autorice esa herramienta |
| El asistente se detiene a preguntar antes de cada llamada | La confirmación está activada | Déjala activada para generaciones que gasten créditos |
El acceso se controla en dos capas. Los permisos OAuth de ElevenLabs limitan lo que la conexión puede hacer, y los controles de herramientas de tu cliente te permiten desactivar herramientas concretas o exigir confirmación antes de cada llamada. Mantener la confirmación activada para todo lo que gaste créditos es una opción sensata por defecto.
Si seguiste una publicación antigua, es posible que en tu configuración siga existiendo una entrada que lance uvx elevenlabs-mcp. Dos servidores que exponen herramientas parecidas hacen que el asistente elija de forma impredecible, así que elimina el antiguo:
claude mcp remove ElevenLabs
Usa el nombre exacto que le diste y borra el bloque correspondiente de claude_desktop_config.json o mcp.json si está allí. Hay otros tres restos que conviene limpiar:
ELEVENLABS_MCP_BASE_PATH y ELEVENLABS_MCP_OUTPUT_MODE pertenecen al paquete local y no hacen nada en el servidor alojado.No todos los trabajos necesitan un asistente de por medio. Si lo único que quieres es una locución a partir de un guion terminado, ElevenLabs V3 en PicassoIA funciona en el navegador sin ninguna conexión, sin OAuth y sin cliente que configurar. Ofrece más de 25 voces, salida multilingüe y controles finos de velocidad, tono y estilo.
en, es o fr.| Control | Rango | Predeterminado | Qué hace |
|---|---|---|---|
| Speed | 0.25 a 4.0 | 1 | Define el ritmo de la voz |
| Style | 0.0 a 1.0 | 0 | Lleva la narración de plana a teatral |
| Stability | 0.0 a 1.0 | 0.5 | Mantiene la voz constante a lo largo de un guion largo |
| Similarity Boost | 0.0 a 1.0 | 0.75 | Acerca más el resultado al perfil de voz |
💡 Consejo: Para un capítulo de audiolibro o un módulo de curso, sube Stability y deja Style cerca de cero para que la frase 40 suene igual que la 1. Para un tráiler o una voz de personaje, haz lo contrario.
ElevenLabs no es un único modelo, y PicassoIA aloja varios. Elige según el trabajo, no según el nombre más nuevo.
| Modelo | Ideal para |
|---|---|
| ElevenLabs V3 | Locuciones expresivas con más de 25 voces y control de estilo |
| Flash v2.5 | Texto a voz rápido cuando la velocidad importa más |
| Turbo v2.5 | Locuciones rápidas en 32 idiomas |
| v2 Multilingual | Locuciones en más de 30 idiomas |
| Dubbing | Traducir videos a más de 90 idiomas |
El guion en sí puede salir de un modelo de lenguaje de la misma plataforma. Redáctalo con Claude Sonnet 5 o GPT 5.6 Sol, pega el resultado en un modelo de voz y tendrás una pieza narrada sin salir del navegador.
💡 Dos conectores, un solo asistente. PicassoIA también ofrece su propio conector para generar imágenes y videos desde un chat. Úsalo junto con el conector de ElevenLabs y un único asistente puede poner voz a un guion e ilustrarlo en la misma conversación.
La voz es solo la mitad de una pieza terminada. Cada video necesita todavía una miniatura, cada podcast necesita una portada y cada demo necesita algunas escenas que parezcan fotografías reales en lugar de material de stock desordenado. Esa es la parte que Picasso IA resuelve en segundos.
Empieza con el modelo PicassoIA Image, o prueba Seedream 4.5 para una segunda versión. Describe el sujeto, la luz y la lente en una frase, por ejemplo "un podcaster en un escritorio de madera, luz de ventana desde la izquierda, objetivo de 85 mm, profundidad de campo reducida", y después cambia un detalle cada vez y compara los resultados. Cuando una imagen está cerca pero no del todo bien, PicassoIA Image Editor Pro te permite editarla en lugar de empezar de cero.
Elige un guion que hayas locutado hoy, genera tres imágenes que lo acompañen y reúne el conjunto. Puedes explorar todos los modelos disponibles en picassoia.com/en/all-models y empezar a experimentar ahora mismo.
Elige tu idioma
