AbletonMCP

Início Rápido

Três passos: instale o uv, aponte seu cliente MCP para o servidor e instale o Remote Script do Ableton.

1. Instale o uv

# macOS
brew install uv

Caso contrário, instale pelo site oficial do uv.

Aviso: Não prossiga antes de instalar o uv.

2. Adicione o servidor MCP ao seu cliente

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

uvx ableton-mcp

Aviso: Execute apenas uma instância do servidor MCP (ou no Cursor, ou no Claude Desktop), não ambos.

3. Instale o Remote Script do Ableton

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

4. Conecte

1. Abra o Ableton Live
2. Vá para Configurações/Preferências → Link, Tempo & MIDI
3. No menu suspenso Control Surface, selecione AbletonMCP
4. Defina Input e Output como None

Pronto — peça ao Claude para criar algo.

Sumário

• Início Rápido
• Recursos
• Componentes
• Instalação
  • Pré-requisitos
  • Integração com Claude for Desktop
  • Integração com Cursor
  • Instalando o Remote Script do Ableton
• Uso
  • Iniciando a Conexão
  • Usando com o Claude
  • Capacidades
  • Exemplos de Comandos
• Solução de Problemas
• Detalhes Técnicos
• Limitações e Considerações de Segurança
• Telemetria
• Junte-se à Comunidade
• Contribuindo
• Aviso Legal

Recursos

Componentes

O sistema consiste em dois componentes principais:

1. Ableton Remote Script (Ableton_Remote_Script/__init__.py) — um MIDI Remote Script para o Ableton Live que cria um servidor de sockets para receber e executar comandos
2. Servidor MCP (server.py) — um servidor Python que implementa o Model Context Protocol e se conecta ao Ableton Remote Script

Instalação

Pré-requisitos

• Ableton Live 10 ou mais recente
• Python 3.8 ou mais recente
• Gerenciador de pacotes uv

Se você estiver no Mac, instale o uv da seguinte forma:

brew install uv

Caso contrário, instale pelo site oficial do uv

Aviso: Não prossiga antes de instalar o uv.

Integração com Claude for Desktop

Assista ao vídeo de instruções de configuração

Vá para Claude → Configurações → Desenvolvedor → Editar Config → claude_desktop_config.json para incluir o seguinte:

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

Integração com Cursor

Execute o ableton-mcp sem instalá-lo permanentemente via uvx. Vá para Cursor Settings → MCP e cole isto como um comando:

uvx ableton-mcp

Aviso: Execute apenas uma instância do servidor MCP (ou no Cursor, ou no Claude Desktop), não ambos.

Integração com Claude Code

No terminal, execute:

claude mcp add AbletonMCP uvx ableton-mcp

Instalando o Remote Script do Ableton

Assista ao vídeo de instruções de configuração

Instale o Remote Script com:

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

Se você instalou o pacote com pip ou pipx, o comando está diretamente no seu PATH — basta executar ableton-mcp-install-script.

Isso copia o Remote Script correspondente para a pasta Remote Scripts da sua User Library do Ableton — o local que o Live (10.1.13+) verifica em busca de scripts de superfície de controle de terceiros. O instalador lê o local da User Library a partir do Library.cfg do Live, com fallback para o padrão (~/Music/Ableton/User Library no macOS, Documents\Ableton\User Library no Windows). Se uma versão diferente do script já estiver lá, o arquivo existente é copiado para __init__.py.bak antes de ser substituído.

Se sua User Library estiver em um local não padrão e não for detectada, aponte o instalador diretamente para ela:

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

A pasta legada Preferences/User Remote Scripts (usada para configurações de mapeamento instantâneo, não para superfícies de controle Python) não é mais o alvo por padrão; passe --legacy se precisar dela para uma versão antiga do Live.

Em seguida, reinicie o Ableton (ou selecione novamente a superfície de controle AbletonMCP) para que o Live a carregue. Execute novamente o comando após atualizar o pacote — o servidor registra um aviso quando a versão do script carregado não corresponde ao esperado.

Nota: O servidor não instala o script na inicialização. Escrever no diretório de preferências do Ableton é uma ação explícita, não um efeito colateral de iniciar um servidor.

Configuração inicial do Ableton:

1. Execute uvx --from ableton-mcp ableton-mcp-install-script
2. Abra o Ableton Live
3. Vá para Configurações/Preferências → Link, Tempo & MIDI
4. No menu suspenso Control Surface, selecione AbletonMCP
5. Defina Input e Output como None

O servidor MCP e o Remote Script compartilham um handshake de versão (get_remote_script_info). Se divergirem, as ferramentas mais recentes degradam graciosamente até o Live ser reiniciado.

Uso

Iniciando a Conexão

1. Certifique-se de que o Ableton Remote Script está carregado no Ableton Live
2. Certifique-se de que o servidor MCP está configurado no Claude Desktop ou no Cursor
3. A conexão deve ser estabelecida automaticamente quando você interagir com o Claude

Usando com o Claude

Depois que o arquivo de configuração for definido no Claude e o remote script estiver em execução no Ableton, você verá um ícone de martelo com ferramentas para o Ableton MCP.

Capacidades

• Obter informações de sessão e faixas
• Criar e modificar faixas de MIDI e áudio
• Criar arranjos musicais completos do início ao fim na Visão de Arranjo
• Criar, editar e disparar clips
• Controlar a reprodução
• Carregar instrumentos e efeitos do navegador do Ableton
• Adicionar notas a clips de MIDI
• Alterar o tempo e outros parâmetros da sessão

Exemplos de Comandos

Aqui estão alguns exemplos do que você pode pedir ao Claude:

Solução de Problemas

Detalhes Técnicos

Protocolo de Comunicação

O sistema usa um protocolo simples baseado em JSON sobre sockets TCP:

• Comandos são enviados como objetos JSON com um type e um params opcional
• Respostas são objetos JSON com um status e result ou message

Limitações e Considerações de Segurança

• Criar arranjos musicais complexos pode precisar ser dividido em etapas menores
• A ferramenta foi projetada para funcionar com os dispositivos padrão e itens do navegador do Ableton
• Sempre salve seu trabalho antes de experimentações extensas

Telemetria

Existem dois níveis, e eles têm padrões diferentes.

Telemetria anônima — ativada por padrão. Um ID de instalação aleatório, um ID de sessão por execução, quais ferramentas foram executadas, se tiveram sucesso e quanto tempo levaram. É assim que contamos usuários ativos e detectamos ferramentas quebradas. Não contém nenhum do seu conteúdo: sem prompts, sem MIDI, sem nomes de faixas ou clips, sem configurações de dispositivos.

Gravação de dataset — desativada por padrão, opt-in. Tudo com seu trabalho: prompts, notas MIDI, nomes de faixas e clips e configurações de dispositivos, que podem ser publicados como parte de um dataset aberto usado para treinar modelos de produção musical. Nada aqui é coletado a menos que você ative explicitamente.

Para ver exatamente quais dados cada nível coleta, consulte Termos e Uso de Dados.

Ativando a gravação de dataset

Defina a variável de ambiente antes de iniciar o servidor:

export ABLETON_MCP_ENABLE_DATASET=true

…ou responda à pergunta quando seu cliente a fizer. Na sua primeira chamada de ferramenta, você é perguntado uma vez — como um diálogo, se seu cliente suportar elicitação MCP, caso contrário, como uma mensagem no chat — e responder sim ativa a partir desse ponto. Sua resposta é armazenada em ~/.ableton-mcp/consent.json. Recusar, ou nunca responder, não grava nada. Se você dispensar o diálogo sem escolher, isso não é tratado como uma resposta e você pode ser perguntado novamente em uma sessão posterior.

Desativando a telemetria anônima

Defina um destes antes de iniciar o servidor MCP:

export ABLETON_MCP_DISABLE_TELEMETRY=true

Ou use qualquer uma destas alternativas:

• DISABLE_TELEMETRY=true
• MCP_DISABLE_TELEMETRY=true

Isso também desativa a gravação de dataset. ABLETON_MCP_DISABLE_DATASET=true desativa apenas a gravação de dataset e substitui qualquer permissão armazenada.

Para o Claude Desktop, adicione a variável de ambiente à sua configuração:

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

Junte-se à Comunidade

Dê feedback, inspire-se e construa em cima do MCP: Discord

Contribuindo

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

Aviso Legal

Esta é uma integração de terceiros e não foi feita pela Ableton. Feita por Siddharth.