> For the complete documentation index, see [llms.txt](https://docs.acestudio.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acestudio.ai/docs/product-wiki-it/agente-ai/external-agent-access.md). # Accesso agente esterno Collega ACE Studio ad assistenti e agenti AI tramite MCP e CLI. {% hint style="warning" %} #### 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 [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} 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. {% hint style="info" %} Questo percorso richiede un agente in esecuzione sullo stesso computer di ACE Studio, con autorizzazioni per eseguire comandi e modificare i file di configurazione. {% endhint %} 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)](https://modelcontextprotocol.io/docs/getting-started/intro) è 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: {% tabs %} {% tab title="Claude" %} Esegui nel terminale: **macOS:** ```bash claude mcp add --scope user ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" ``` **Windows:** ```cmd claude mcp add --scope user ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe" ``` {% endtab %} {% tab title="Codex" %} Esegui nel terminale: **macOS:** ```bash codex mcp add ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" ``` **Windows:** ```cmd codex mcp add ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe" ``` {% endtab %} {% endtabs %} **App di chat desktop** Per guide complete passo passo con procedure di configurazione: * [**Claude Desktop & Cowork**](/docs/product-wiki-it/agente-ai/external-agent-access/claude-desktop-and-cowork.md) — Configurazione passo passo per Claude Desktop con una guida ai file di configurazione. * [**ChatGPT per desktop**](/docs/product-wiki-it/agente-ai/external-agent-access/chatgpt-for-desktop.md) — 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: {% tabs %} {% tab title="Configurazione MCP standard (Cursor, ecc.)" %} Usato da Cursor (`~/.cursor/mcp.json` oppure `.cursor/mcp.json`) e dalla maggior parte degli harness MCP standard: ```json { "mcpServers": { "ace-studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% tab title="VS Code (GitHub Copilot)" %} Aggiungi a `.vscode/mcp.json` nel tuo workspace del Progetto: ```json { "servers": { "ace-studio": { "type": "stdio", "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% endtabs %} {% hint style="info" %} **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 (`/`). {% endhint %} {% hint style="warning" %} **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. {% endhint %} {% hint style="info" %} **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. {% endhint %} *** ### 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. ``` --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.acestudio.ai/docs/product-wiki-it/agente-ai/external-agent-access.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.