For the complete documentation index, see llms.txt. This page is also available as Markdown.

Acesso de Agente Externo

Conecte o ACE Studio a assistentes e agentes de IA por meio de MCP e CLI.

Estado experimental

Conecte assistentes de IA e agentes (como Claude, ChatGPT, OpenClaw ou Hermes Agent) diretamente ao ACE Studio para entender e editar os seus projetos musicais em tempo real.

O que o seu agente pode fazer

Depois de conectado, um agente pode inspecionar e editar o seu projeto em praticamente tudo o que o ACE Studio faz:

  • Arranjo e composição — Gerencie faixas, clipes, notas, letra, acordes e o cursor de reprodução.

  • Vocais e Instrumentos — Ajuste os modelos de voz (Vozes de síntese vocal), fontes sonoras, camadas de coro com vários cantores e parâmetros vocais (afinação, respiração, tensão).

  • Tempo e estrutura — Defina BPM, compassos, marcadores de loop e o Transporte.

  • Produção e Ferramentas de IA — Acione Adicionar uma Camada, Vocal para MIDI, Separador de Stems, Music Enhancer e carregue cadeias de FX ou predefinições.

  • Controlo de sessão e entrega — Inicie e guarde projetos, importe áudio e MIDI e exporte misturas finais completas, Stems individuais, vídeo e muito mais.

Basta descrever o que pretende em linguagem natural, e o seu assistente irá inspecionar o projeto e aplicar as alterações.


Ligação do seu assistente

Escolha o método de configuração que melhor se adapta ao seu fluxo de trabalho:

Caminho A: Deixe o seu agente de IA configurá-lo por si

Se utilizar um agente com ambiente local ou acesso ao computador (como Claude Code, Codex, OpenClaw, ou Hermes Agent), ele pode configurar-se automaticamente.

Este caminho requer um agente a executar no mesmo computador que o ACE Studio, com permissões para executar comandos e editar os respetivos ficheiros de configuração.

Copie e cole este prompt no seu agente e clique em Enviar:


Caminho B: Configurar manualmente no seu harness

Se o seu harness de agente não conseguir configurar-se automaticamente, terá de adicionar manualmente o servidor MCP do ACE Studio à sua configuração.

O Protocolo de Contexto de Modelo (MCP) é um padrão aberto que liga assistentes de IA a aplicações externas. O ACE Studio é executado como um servidor STDIO local, permitindo que qualquer cliente compatível com MCP se ligue diretamente usando o comando de arranque.

Configurar via terminal

Se usar Claude ou Codex e preferir configurar diretamente a partir do terminal:

Execute no seu terminal:

macOS:

Windows:

Execute no seu terminal:

macOS:

Windows:

Aplicativos de chat para desktop

Para guias completos passo a passo com instruções de configuração:

  • Claude Desktop & Cowork — Configuração passo a passo para o Claude Desktop com orientações sobre o arquivo de configuração.

  • ChatGPT para desktop — Configuração passo a passo para os modos ChatGPT Work e Codex.

Outros harnesses e IDEs (VS Code, Cursor, clientes personalizados)

A maioria dos clientes MCP e IDEs solicita os mesmos parâmetros de configuração:

  • Tipo de Transporte: STDIO (às vezes rotulado como "Local" ou "Command")

  • Comando: O comando de inicialização copiado do ACE Studio

  • Argumentos / Ambiente: Nenhum

Para harnesses configurados por meio de arquivos JSON:

Usado pelo Cursor (~/.cursor/mcp.json ou .cursor/mcp.json) e pela maioria dos harnesses MCP padrão:

Adicionar a .vscode/mcp.json no espaço de trabalho do seu projeto:

Escape de caminhos do Windows em JSON: Se você escrever manualmente caminhos do Windows usando barras invertidas em arquivos JSON, escape cada barra invertida como uma barra invertida dupla (\\), ou use barras normais (/).

Caminhos de instalação personalizados: Se você instalou o ACE Studio em um diretório personalizado, abra Preferências → Geral → Acesso de Agente Externo no ACE Studio:

  • Clique em Copiar comando ao lado de Servidor MCP (stdio) para o caminho do servidor MCP.

  • Clique em Copiar ao lado de caminho do binário acetudio-cli para o caminho da CLI.


Verificando a Conexão

Certifique-se de que o ACE Studio esteja aberto e em execução; depois, peça ao seu assistente:

Se o seu assistente responder com o Tempo do seu Projeto, a armadura de clave e a lista de Faixas, a sua configuração estará concluída e pronta.


Exemplos de Prompts Criativos

Aqui estão alguns exemplos reais de como você pode colaborar com o seu assistente de IA no ACE Studio:

1. Produção Vocal e Harmonias com vários cantores

2. Mistura personalizada de vozes

3. Acorde e Esboço da Música

4. Acompanhamento de IA e Extração de Áudio

5. Ideias de músicas gerativas e Camadas

6. Afinação Expressiva de Vocal e Dinâmica

7. Cadeias de FX e Entrega de Stems

Última atualização