Accesso ad agenti esterni

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

Stato sperimentale

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

Nota:

• Modifiche incompatibili: I comandi degli strumenti, i formati e le convenzioni possono cambiare tra un aggiornamento e l'altro.

• In lavorazione: Non tutte le funzionalità di ACE Studio sono ancora completamente accessibili agli agenti.

• Aspetti ancora da rifinire: Potresti incontrare bug, casi limite imprevisti o comportamenti innaturali mentre perfezioniamo le interazioni degli agenti.

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

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

Cosa può fare il tuo agente

Una volta connesso, un agente può ispezionare e modificare il tuo Progetto in gran parte di ciò che fa 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).

• Tempi e struttura — Imposta BPM, frazioni di tempo, marcatori di Loop e Trasporto.

• Produzione e Strumenti AI — Attiva Aggiungi un Livello, Voce to MIDI, Separatore Stem, Music Enhancer, 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 individuali, video e altro ancora.

Basta descrivere ciò che desideri in linguaggio naturale, e il tuo assistente esaminerà 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 il tuo agente AI lo configuri per te

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

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

Copia e incolla questo prompt nel tuo agente e premi Invia:

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

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

Prova a usare prima 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 dalle Preferenze di ACE Studio → Generale → Accesso agente esterno.

Se hai bisogno di ulteriore contesto su ACE Studio e sull'integrazione dell'agente, consulta la documentazione all'indirizzo https://docs.acestudio.ai/llms.txt. Se il tuo harness non riesce a configurarsi da solo o a 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 dell'agente non può configurarsi automaticamente, dovrai aggiungere manualmente il server MCP di ACE Studio alla sua configurazione.

Il Modello Context Protocol (MCP) è uno standard aperto che connette 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 per passo con procedura di configurazione:

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

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

Altri ambienti 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 ambienti configurati tramite file JSON:

Configurazione MCP standard (Cursor, ecc.)

Usato da Cursor (~/.cursor/mcp.json o .cursor/mcp.json) e dalla maggior parte degli ambienti 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 workspace del tuo 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 con le barre rovesciate nei file JSON, esegui l'escape di ogni barra rovesciata come doppia barra rovesciata (\\), oppure usa 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 agenti esterni in ACE Studio:

• Fai clic Copia il 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 ed in esecuzione, poi chiedi al tuo assistente:

Controlla le informazioni correnti del Progetto ACE Studio

Se il tuo assistente risponde con il Tempo del tuo Progetto, l'armatura di chiave e l'elenco delle Tracce, la configurazione è completa e pronta.

---

Esempi di prompt creativi

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

1. Produzione vocale e armonie multi-cantante

Attiva la Modalità coro sulla traccia vocale principale (Traccia 1), aggiungi due cantanti di accompagnamento
voci, amplia la diffusione stereo e abbassa 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 un seed pop acustico caldo
con il 30% di un seed vocale arioso e soffiato, quindi assegna alla miscela il nome "Velvet Aria".

3. Accordi e bozza del brano

Nelle battute 1–8 della traccia degli accordi, inserisci una progressione Neo-Soul:
Ebmaj9 — G7#9 — Cm9 — F13 (2 battute ciascuno).
Quindi aggiungi una traccia di piano Rhodes e una linea di basso groove che segua le note fondamentali.

4. Accompagnamento AI e Estrazione Audio

Dividi la Clip Audio importata sulla Traccia 1 in Voce, batteria, basso e altre Tracce Stem.
Quindi esegui Voce a MIDI sulla Stem vocale estratta per creare una Traccia Sing modificabile.

5. Idee generative per brani e livelli

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

6. Intonazione espressiva della Voce e dinamica

Esamina le note vocali del ritornello sulla Traccia 1: smussa le transizioni di intonazione,
aumenta la soffiatura sulle note di attacco e aggiungi una curva Vibrato sottile sulle note tenute.

7. Catene FX e consegna delle Tracce Stem

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