Inicio rápido con Claude Desktop

1. Obtén tu clave API de ElevenLabs. Hay un nivel gratuito con 10k créditos al mes.
2. Instala uv (gestor de paquetes de Python), instala con curl -LsSf https://astral.sh/uv/install.sh | sh o consulta el repositorio deuv para métodos de instalación adicionales.
3. Vaya a Claude > Settings > Developer > Edit Config > claude_desktop_config.json para incluir lo siguiente:

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

Si utiliza Windows, tendrá que activar el "Modo desarrollador" en Claude Desktop para poder utilizar el servidor MCP. Haga clic en "Ayuda" en el menú hamburguesa de la parte superior izquierda y seleccione "Activar modo desarrollador".

Otros clientes MCP

Para otros clientes como Cursor y Windsurf, ejecute

1. pip install elevenlabs-mcp
2. python -m elevenlabs_mcp --api-key={{PUT_YOUR_API_KEY_HERE}} --print para obtener la configuración. Péguela en el directorio de configuración apropiado especificado por su cliente MCP.

Y ya está. Tu cliente MCP ya puede interactuar con ElevenLabs a través de estas herramientas:

Ejemplo de uso

⚠️ Advertencia: Se necesitan créditos ElevenLabs para utilizar estas herramientas.

Prueba a preguntarle a Claude:

• "Crear un agente de IA que hable como un detective de cine negro y pueda responder preguntas sobre películas clásicas"
• "Genera tres variaciones de voz para un personaje de dragón sabio y antiguo, luego elegiré mi voz favorita para añadirla a mi biblioteca de voces"
• "Convertir esta grabación de mi voz para que suene como un caballero medieval"
• "Crear un paisaje sonoro de una tormenta eléctrica en una densa jungla con animales reaccionando al clima"
• "Convierte este discurso en texto, identifica a los diferentes hablantes y luego vuelve a convertirlo utilizando voces únicas para cada persona"

Funciones opcionales

Puede añadir la variable de entorno ELEVENLABS_MCP_BASE_PATH al archivo claude_desktop_config.json para especificar la ruta base que debe buscar el servidor MCP y los archivos de salida especificados con rutas relativas.

Contribución a

Si quieres contribuir o ejecutar desde el código fuente:

1. Clona el repositorio:

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

2. Cree un entorno virtual e instale las dependencias utilizando uv:

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

3. Copia .env.example a .env y añade tu clave API de ElevenLabs:

cp .env.example .env # Edita .env y añade tu clave API

4. Ejecuta las pruebas para asegurarte de que todo funciona:

./scripts/test.sh # O con opciones ./scripts/test.sh --verbose --fail-fast

5. Instale el servidor en Claude Desktop: mcp install elevenlabs_mcp/server.py

6. Depurar y probar localmente con MCP Inspector: mcp dev elevenlabs_mcp/server.py

Solución de problemas

Los registros cuando se ejecuta con Claude Desktop se pueden encontrar en:

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

Tiempos de espera al utilizar ciertas herramientas

Ciertas operaciones de la API de ElevenLabs, como el diseño de voz y el aislamiento de audio, pueden tardar mucho tiempo en resolverse. Al utilizar el inspector MCP en modo de desarrollo, es posible que se produzcan errores de tiempo de espera a pesar de que la herramienta haya completado la tarea prevista.

Esto no debería ocurrir cuando se utiliza un cliente como Claude.

MCP ElevenLabs: spawn uvx ENOENT

Si te encuentras con el error "MCP ElevenLabs: spawn uvx ENOENT", confirma su ruta absoluta ejecutando este comando en tu terminal:

which uvx

Una vez obtenida la ruta absoluta (por ejemplo, /usr/local/bin/uvx), actualice su configuración para utilizar esa ruta (por ejemplo, "command": "/usr/local/bin/uvx"). Esto garantiza que se haga referencia al ejecutable correcto.