Accesso ad agenti esterni

Collega ACE Studio ad assistenti e agenti AI tramite MCP e CLI.

Stato sperimentale

L'accesso tramite agenti esterni in ACE Studio è attualmente sperimentale e in fase di sviluppo attivo.

Nota:

• Cambiamenti incompatibili: Comandi, formati e convenzioni degli strumenti possono cambiare tra un aggiornamento e l'altro.

• Lavori in corso: Non tutte le funzionalità di ACE Studio sono ancora pienamente accessibili agli agenti.

• Aspetti da rifinire: Potresti incontrare bug, casi limite imprevisti o comportamenti innaturali mentre perfezioniamo l'interazione con gli agenti.

Se riscontri problemi o hai suggerimenti, faccelo sapere a [e-mail].

Collega assistenti e agenti AI (come Claude, ChatGPT, OpenClaw o Hermes Agent) direttamente ad ACE Studio per comprendere e modificare i tuoi progetti musicali in tempo reale.

Cosa può fare il tuo agente

Una volta connesso, un agente può ispezionare e modificare il tuo Progetto in quasi tutte le aree di ACE Studio:

• Arrangiamento e composizione — Gestisci Tracce, clip, note, Testo, accordi e la testina di riproduzione.

• Voci e Strumenti — Regola Voci per synth vocale, sorgenti sonore, livelli di coro multi-cantante e Parametri vocali (intonazione, respiro, tensione), e carica plug-in di strumenti di terze parti.

• Tempo e struttura — Imposta BPM, indicazioni di misura, marker di loop e Trasporto.

• Produzione e Strumenti AI — Attiva Aggiungi un Livello, Voce a MIDI, Separatore Stem, Miglioratore musicale e carica catene FX o preset.

• Controllo della sessione e consegna — Avvia e salva Progetti, importa Audio e MIDI ed esporta mixdown completi, Tracce Stem singole, video e altro ancora.

Ti basta descrivere in linguaggio semplice ciò che desideri, e il tuo assistente ispezionerà il Progetto e apporterà le modifiche.

---

Collegare il tuo assistente

Scegli il metodo di configurazione più adatto al tuo flusso di lavoro:

Percorso A: lascia che sia il tuo agente AI a configurarlo per te

Se usi un agente con accesso all'ambiente locale o al computer (come Claude Code, Codex, OpenClaw, oppure Hermes Agent), può configurarsi automaticamente.

Questo percorso richiede un agente in esecuzione sullo stesso computer di ACE Studio, con autorizzazioni per eseguire comandi e modificare i file di configurazione.

Il modo più rapido è direttamente da ACE Studio. Fai clic sull' icona dell'agente nell'angolo in basso a destra della finestra, scegli ChatGPT, Claude, oppure Altri agenti, e segui i tre passaggi mostrati: apri il tuo agente, copia il prompt di connessione con il pulsante Copia e invialo, quindi inizia a creare con uno dei prompt di esempio.

Lo stesso prompt di connessione è riportato qui. Copialo e incollalo nel tuo agente e premi Invia:

Connettiti per me ad ACE Studio usando acestudio-cli o MCP.

Percorsi predefiniti:
- MCP macOS: "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
- CLI macOS: "/Applications/ACE Studio.app/Contents/Helpers/acestudio-cli"
- MCP di Windows: "C:\Program Files\ACE Studio\ace-mcp-server.exe"
- CLI di Windows: "C:\Program Files\ACE Studio\acestudio-cli.exe"

Prova prima a usare la CLI e ricorda il percorso dello strumento nelle tue istruzioni/memoria. Se l'accesso alla CLI è limitato dal sandboxing o dai permessi, registra il server MCP (con il nome "ace-studio" con ambito utente/globale). Se non viene trovato nella posizione predefinita, chiedimi il percorso da Preferenze di ACE Studio → Generale → Accesso agente esterno.

Poi, installa il plugin skills/agent dal repository ufficiale di ACE Studio su https://github.com/BeatMagic/acestudio_agent_plugin. È importante che sia installato e disponibile per te, perché fornisce il know-how di cui avrai bisogno quando interagisci con ACE Studio.

Se hai bisogno di ulteriore contesto su ACE Studio e sulla sua integrazione con l'agente, consulta la documentazione su https://docs.acestudio.ai/llms.txt. Se il tuo harness non può configurarsi da solo o eseguire comandi locali, guidami attraverso i passaggi di configurazione manuale per la tua piattaforma.

---

Percorso B: Configura manualmente nel tuo harness

Se il tuo harness agente non può configurarsi automaticamente, dovrai aggiungere manualmente il server MCP di ACE Studio alla sua configurazione.

Il Protocollo di contesto del Modello (MCP) è uno standard aperto che collega gli assistenti IA alle applicazioni esterne. ACE Studio funziona come server STDIO locale, consentendo a qualsiasi client compatibile con MCP di connettersi direttamente usando il comando di avvio.

Configura tramite terminale

Se usi Claude o Codex e preferisci configurare direttamente dal terminale:

Claude

Esegui nel terminale:

macOS:

claude mcp add --scope user ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"

Windows:

claude mcp add --scope user ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe"

Codex

Esegui nel terminale:

macOS:

codex mcp add ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"

Windows:

codex mcp add ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe"

App di chat desktop

Per guide complete passo passo con procedure di configurazione:

• Claude Desktop & Cowork — Configurazione passo passo per Claude Desktop con una guida ai file di configurazione.

• ChatGPT per desktop — Configurazione passo passo per le modalità ChatGPT Work e Codex.

Altri harness e IDE (VS Code, Cursor, client personalizzati)

La maggior parte dei client MCP e degli IDE richiede gli stessi Parametri di configurazione:

• Tipo di Trasporto: STDIO (a volte indicato come "Locale" o "Comando")

• Comando: Il comando di avvio copiato da ACE Studio

• Argomenti / Ambiente: Nessuno

Per gli harness configurati tramite file JSON:

Configurazione MCP standard (Cursor, ecc.)

Usato da Cursor (~/.cursor/mcp.json oppure .cursor/mcp.json) e dalla maggior parte degli harness MCP standard:

{
  "mcpServers": {
    "ace-studio": {
      "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
    }
  }
}

VS Code (GitHub Copilot)

Aggiungi a .vscode/mcp.json nel tuo workspace del Progetto:

{
  "servers": {
    "ace-studio": {
      "type": "stdio",
      "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
    }
  }
}

Escape dei percorsi Windows in JSON: Se scrivi manualmente percorsi Windows usando backslash nei file JSON, converti ogni backslash in una doppia backslash (\\), oppure usa le barre oblique (/).

Assistenti AI basati sul browser: Il server MCP di ACE Studio viene eseguito localmente sulla tua macchina tramite STDIO. Le interfacce solo web (come ChatGPT o Claude in un browser web) non possono connettersi direttamente ai server STDIO locali. Usa invece le rispettive applicazioni desktop o i client da terminale.

Percorsi di installazione personalizzati: Se hai installato ACE Studio in una directory personalizzata, apri Preferenze → Generale → Accesso agente esterno in ACE Studio:

• Fai clic Copia comando accanto a Server MCP (stdio) per il percorso del server MCP.

• Fai clic Copia accanto a percorso del binario acestudio-cli per il percorso della CLI.

---

Verifica della connessione

Assicurati che ACE Studio sia aperto e in esecuzione, quindi chiedi al tuo assistente:

Controlla le informazioni del progetto corrente di ACE Studio

Se il tuo assistente risponde con il tempo, la tonalità e l'elenco delle tracce del tuo progetto, la configurazione è completa e pronta.

---

Esempi di prompt creativi

Ecco alcuni esempi pratici di come puoi collaborare con il tuo assistente AI in ACE Studio:

1. Produzione vocale e armonie con più cantanti

Attiva la Modalità coro sulla traccia vocale principale (Traccia 1), aggiungi due cantanti di accompagnamento
voci, amplia la diffusione stereo e riduci il loro livello di -3 dB per ottenere una ricca armonia di sottofondo.

2. Miscelazione vocale personalizzata

Crea una Voce Miscelata personalizzata sulla Traccia 2: miscela il 70% di una sorgente pop acustica calda
con il 30% di una sorgente vocale ariosa e BR., quindi assegna alla miscela il nome "Velvet Aria".

3. Accordi e bozza del brano

Nelle battute 1–8 della traccia accordi, inserisci una progressione Neo-Soul:
Ebmaj9 — G7#9 — Cm9 — F13 (2 battute ciascuno).
Poi aggiungi una traccia Piano Rhodes e una linea di basso funky seguendo le note fondamentali.

4. Accompagnamento AI ed Estrazione Audio

Dividi la Clip Audio importata sulla Traccia 1 in tracce stem di Voce, batteria, Basso e altre Tracce Stem.
Quindi esegui Voce in MIDI sullo Stem vocale estratto per creare una Traccia Sing modificabile.

5. Idee di canzoni generative e Livelli

Ascolta l'arrangiamento dalla Battuta 9 alla 25 e usa Aggiungi un Livello per generare
un Livello di accompagnamento pad di archi cinematografico abbinato al Tempo del Progetto corrente.

6. Intonazione espressiva della Voce e dinamica

Esamina le note vocali del ritornello sulla Traccia 1: ammorbidisci le transizioni di intonazione,
aumenta l'ariosità sulle note di attacco e aggiungi una sottile curva di Vibrato sulle note tenute.

7. Catene FX e consegna delle Tracce Stem

Carica un compressore per Voce vintage e un riverbero plate caldo nella catena FX della Voce principale,
quindi esporta tutte le singole Tracce come Tracce Stem in formato WAV a 24 bit/48 kHz nella cartella "Tracce Stem" sul mio Desktop.