AbletonMCP

Inicio rápido

Tres pasos: instala uv, apunta tu cliente MCP al servidor, instala el Remote Script de Ableton.

1. Instala uv

# macOS
brew install uv

De lo contrario, instálalo desde el sitio web oficial de uv.

Advertencia: No continúes antes de instalar uv.

2. Agrega el servidor MCP a tu cliente

{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": [
                "ableton-mcp"
            ]
        }
    }
}

uvx ableton-mcp

Advertencia: Ejecuta solo una instancia del servidor MCP (ya sea en Cursor o Claude Desktop), no ambas.

3. Instala el Remote Script de Ableton

uvx --from ableton-mcp ableton-mcp-install-script
uvx --from ableton-mcp ableton-mcp-install-script --list-targets   # preview target folders first

4. Conecta

1. Inicia Ableton Live
2. Ve a Configuración/Preferencias → Link, Tempo y MIDI
3. En el menú desplegable Control Surface, selecciona AbletonMCP
4. Configura Input y Output en None

Eso es todo: pídele a Claude que construya algo.

Tabla de contenidos

• Inicio rápido
• Características
• Componentes
• Instalación
  • Requisitos previos
  • Integración con Claude for Desktop
  • Integración con Cursor
  • Instalación del Remote Script de Ableton
• Uso
  • Iniciar la conexión
  • Uso con Claude
  • Capacidades
  • Comandos de ejemplo
• Solución de problemas
• Detalles técnicos
• Limitaciones y consideraciones de seguridad
• Telemetría
• Únete a la comunidad
• Contribuciones
• Aviso legal

Características

Componentes

El sistema consta de dos componentes principales:

1. Remote Script de Ableton (Ableton_Remote_Script/__init__.py) — un Remote Script MIDI para Ableton Live que crea un servidor de sockets para recibir y ejecutar comandos
2. Servidor MCP (server.py) — un servidor Python que implementa el Model Context Protocol y se conecta al Remote Script de Ableton

Instalación

Requisitos previos

• Ableton Live 10 o más reciente
• Python 3.8 o más reciente
• uv gestor de paquetes

Si estás en Mac, instala uv de la siguiente manera:

brew install uv

De lo contrario, instálalo desde el sitio web oficial de uv

Advertencia: No continúes antes de instalar uv.

Integración con Claude for Desktop

Sigue el video de instrucciones de configuración

Ve a Claude → Configuración → Desarrollador → Editar configuración → claude_desktop_config.json para incluir lo siguiente:

{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": [
                "ableton-mcp"
            ]
        }
    }
}

Integración con Cursor

Ejecuta ableton-mcp sin instalarlo permanentemente a través de uvx. Ve a Configuración de Cursor → MCP y pega esto como un comando:

uvx ableton-mcp

Advertencia: Ejecuta solo una instancia del servidor MCP (ya sea en Cursor o Claude Desktop), no ambas.

Integración con Claude Code

En la terminal, ejecuta:

claude mcp add AbletonMCP uvx ableton-mcp

Instalación del Remote Script de Ableton

Sigue el video de instrucciones de configuración

Instala el Remote Script con:

uvx --from ableton-mcp ableton-mcp-install-script
uvx --from ableton-mcp ableton-mcp-install-script --list-targets   # preview target folders first

Si instalaste el paquete con pip o pipx, el comando está directamente en tu PATH — solo ejecuta ableton-mcp-install-script.

Esto copia el Remote Script correspondiente a la carpeta Remote Scripts de tu User Library de Ableton — la ubicación que Live (10.1.13+) escanea para scripts de superficies de control de terceros. El instalador lee la ubicación de la User Library desde el Library.cfg de Live, con respaldo a la predeterminada (~/Music/Ableton/User Library en macOS, Documents\Ableton\User Library en Windows). Si ya hay una versión diferente del script, el archivo existente se respalda en __init__.py.bak antes de ser reemplazado.

Si tu User Library está en una ubicación no estándar y no se detecta, apunta el instalador directamente a ella:

uvx --from ableton-mcp ableton-mcp-install-script --target "/path/to/User Library/Remote Scripts"

La carpeta heredada Preferences/User Remote Scripts (usada para configuraciones de mapeo instantáneo, no para superficies de control Python) ya no es el objetivo por defecto; pasa --legacy si la necesitas para una versión antigua de Live.

Luego reinicia Ableton (o vuelve a seleccionar la superficie de control AbletonMCP) para que Live lo cargue. Vuelve a ejecutar el comando después de actualizar el paquete — el servidor registra una advertencia cuando la versión del script cargado no coincide con la esperada.

Nota: El servidor no instala el script al iniciar. Escribir en el directorio de preferencias de Ableton es una acción explícita, no un efecto secundario de iniciar un servidor.

Configuración inicial de Ableton:

1. Ejecuta uvx --from ableton-mcp ableton-mcp-install-script
2. Inicia Ableton Live
3. Ve a Configuración/Preferencias → Link, Tempo y MIDI
4. En el menú desplegable Control Surface, selecciona AbletonMCP
5. Configura Input y Output en None

El servidor MCP y el Remote Script comparten un protocolo de versión (get_remote_script_info). Si divergen, las herramientas más nuevas se degradan con elegancia hasta que se reinicie Live.

Uso

Iniciar la conexión

1. Asegúrate de que el Remote Script de Ableton esté cargado en Ableton Live
2. Asegúrate de que el servidor MCP esté configurado en Claude Desktop o Cursor
3. La conexión debería establecerse automáticamente cuando interactúes con Claude

Uso con Claude

Una vez que el archivo de configuración esté establecido en Claude y el Remote Script esté ejecutándose en Ableton, verás un ícono de martillo con herramientas para el Ableton MCP.

Capacidades

• Obtener información de sesión y pistas
• Crear y modificar pistas MIDI y de audio
• Crear arreglos completos de canciones de principio a fin en la vista de arreglos
• Crear, editar y disparar clips
• Controlar la reproducción
• Cargar instrumentos y efectos desde el navegador de Ableton
• Agregar notas a clips MIDI
• Cambiar el tempo y otros parámetros de sesión

Comandos de ejemplo

Aquí hay algunos ejemplos de lo que puedes pedirle a Claude:

Solución de problemas

Detalles técnicos

Protocolo de comunicación

El sistema usa un protocolo simple basado en JSON sobre sockets TCP:

• Comandos se envían como objetos JSON con un type y un params opcional
• Respuestas son objetos JSON con un status y result o message

Limitaciones y consideraciones de seguridad

• Crear arreglos musicales complejos podría necesitar dividirse en pasos más pequeños
• La herramienta está diseñada para funcionar con los dispositivos y elementos del navegador predeterminados de Ableton
• Siempre guarda tu trabajo antes de experimentar extensivamente

Telemetría

Hay dos niveles, y tienen diferentes valores predeterminados.

Telemetría anónima — activada por defecto. Un ID de instalación aleatorio, un ID de sesión por ejecución, qué herramientas se ejecutaron, si tuvieron éxito y cuánto tardaron. Esto es lo que cuenta usuarios activos y detecta herramientas rotas. No contiene nada de tu contenido: sin indicaciones, sin MIDI, sin nombres de pistas o clips, sin configuraciones de dispositivos.

Grabación de conjuntos de datos — desactivada por defecto, opcional. Todo lo que contiene tu trabajo: indicaciones, notas MIDI, nombres de pistas y clips, y configuraciones de dispositivos, que pueden publicarse como parte de un conjunto de datos abierto utilizado para entrenar modelos de producción musical. Nada de esto se recopila a menos que lo actives explícitamente.

Para ver exactamente qué datos recopila cada nivel, consulta Términos y uso de datos.

Activar la grabación de conjuntos de datos

Configura la variable de entorno antes de iniciar el servidor:

export ABLETON_MCP_ENABLE_DATASET=true

…o responde la pregunta cuando tu cliente la haga. En tu primera llamada a una herramienta se te pregunta una vez — como un diálogo si tu cliente admite la elicitación MCP, de lo contrario como un mensaje en el chat — y responder sí la activa desde ese punto. Tu respuesta se almacena en ~/.ableton-mcp/consent.json. Rechazar, o nunca responder, no graba nada. Si descartas el diálogo sin elegir, eso no se trata como una respuesta y es posible que se te pregunte nuevamente en una sesión posterior.

Desactivar la telemetría anónima

Configura una de estas antes de iniciar el servidor MCP:

export ABLETON_MCP_DISABLE_TELEMETRY=true

O usa cualquiera de estas alternativas:

• DISABLE_TELEMETRY=true
• MCP_DISABLE_TELEMETRY=true

Esto también desactiva la grabación de conjuntos de datos. ABLETON_MCP_DISABLE_DATASET=true desactiva solo la grabación de conjuntos de datos y anula cualquier permiso almacenado.

Para Claude Desktop, agrega la variable de entorno a tu configuración:

{
    "mcpServers": {
        "AbletonMCP": {
            "command": "uvx",
            "args": ["ableton-mcp"],
            "env": {
                "ABLETON_MCP_DISABLE_TELEMETRY": "true"
            }
        }
    }
}

Únete a la comunidad

Da tu opinión, inspírate y construye sobre el MCP: Discord

Contribuciones

¡Las contribuciones son bienvenidas! No dudes en enviar un Pull Request.

Aviso legal

Esta es una integración de terceros y no está hecha por Ableton. Hecha por Siddharth.