# ACE Studio MCP Server ## ACE Studio MCP Server {% hint style="warning" %} #### Stato sperimentale Il server ACE Studio MCP è attualmente in **fase sperimentale**. **Nota bene:** * Alcune funzioni e impostazioni potrebbero non essere ancora completamente implementate * Funzioni e funzionalità potrebbero cambiare * Durante l'uso potresti riscontrare bug o problemi di prestazioni * Le linee guida d'uso e i limiti di frequenza saranno pubblicati al rilascio della versione stabile Stiamo migliorando attivamente questa funzione. Se hai feedback o riscontri problemi, contattaci a [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} Il server ACE Studio MCP offre un ricco insieme di strumenti che consente agli agenti AI di navigare ed eseguire autonomamente modifiche creative. Offrendo agli agenti AI una visione completa di ogni dettaglio del tuo Progetto, permette loro di aiutarti a creare e modificare brani con maggiore velocità e libertà creativa. [Il Protocollo di Contesto del Modello](https://modelcontextprotocol.io/docs/getting-started/intro) (MCP) è uno standard aperto che consente agli assistenti AI di connettersi senza soluzione di continuità ad applicazioni esterne e origini dati. Il server ACE Studio MCP implementa questo protocollo per dare agli agenti AI accesso diretto al tuo spazio di lavoro creativo. ### Avvio rapido #### Avvia il server ACE Studio MCP 1. Apri **ACE Studio**. 2. Vai a **Preferenze → Generale → MCP Server**. 3. Scegli una modalità di Trasporto: **HTTP** o **STDIO**. > La modalità di Trasporto che selezioni qui determina come il tuo client AI si connette ad ACE Studio. Consulta le sezioni seguenti per i dettagli e la configurazione specifica del client. Scegli la configurazione appropriata in base alla modalità di Trasporto selezionata e al tuo client AI. #### Modalità HTTP trasmissibile In modalità HTTP, ACE Studio esegue un server MCP locale a un indirizzo fisso. Il tuo client AI vi si connette tramite rete. **Indirizzo del server:** `http://localhost:21572/mcp` > **Nota tecnica**: Il server ACE Studio MCP utilizza il **protocollo di trasporto HTTP trasmissibile**. Conserva questo indirizzo per il passaggio di configurazione successivo. **Claude Desktop** > ⚠ Configurare il server ACE Studio MCP in Claude Desktop richiede la modifica di un file di configurazione JSON. Se non ti senti a tuo agio con le configurazioni tecniche, ti consigliamo di provare client più facili da usare. **Passaggi di configurazione:** 1. Installa Node.js, se necessario. * Visita [nodejs.org](https://nodejs.org) e scarica la versione LTS. 2. Individua il file di configurazione di Claude Desktop. * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 3. Modifica il file di configurazione e aggiungi quanto segue: ```json { "mcpServers": { "acestudio": { "command": "npx", "args": [ "mcp-remote", "http://localhost:21572/mcp" ] } } } ``` 4. Salva il file e riavvia Claude Desktop. **Verifica la connessione:**\ Digita in Claude: ``` Per favore, controlla le informazioni del Progetto corrente di ACE Studio ``` Se Claude restituisce i dettagli del Progetto, la connessione è riuscita. **Cursor** Puoi aggiungere direttamente il server MCP a Cursor facendo clic [qui](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9). Oppure configurarlo manualmente: 1. Apri le Impostazioni di Cursor. 2. Trova la **Tools & MCP** sezione. 3. Fai clic su **Nuovo server MCP**. 4. Compila il seguente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Fai clic su **Salva**. 6. Riavvia Cursor. **Verifica la connessione:**\ Digita in Cursor Chat: ``` @acestudio Quali Tracce sono nel Progetto corrente? ``` **VS Code tramite supporto MCP nativo** Puoi aggiungere direttamente il server MCP a VS Code facendo clic su [qui](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22acestudio%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22http%3A%2F%2Flocalhost%3A21572%2Fmcp%22%7D). Oppure configurarlo manualmente: 1. Crea o modifica `.vscode/mcp.json` nel tuo workspace. 2. Aggiungi la seguente configurazione: ```json { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp" } } } ``` **VS Code tramite Cline** 1. Installa l'estensione Cline. 2. Apri le Impostazioni dell'estensione. 3. Trova la sezione di configurazione MCP Servers. 4. Aggiungi un nuovo server: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` **Altri client** Per la maggior parte dei client, utilizza queste Impostazioni di configurazione: * **Tipo di Trasporto:** HTTP trasmissibile in streaming. Alcuni client potrebbero chiamarlo `Remoto`. * **URL del server:** `http://localhost:21572/mcp` Oppure importa il server MCP con il seguente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` #### Modalità STDIO In modalità STDIO, il client AI si avvia e comunica direttamente con il server MCP di ACE Studio tramite l'Ingresso e l'output standard. È più semplice da configurare. Non è necessario avviare manualmente un server o utilizzare un indirizzo di rete. **Ottenere il comando:** 1. In ACE Studio, vai a **Preferenze → Generale → MCP Server**. 2. Imposta la modalità su **STDIO**. 3. Fai clic su **Copia comando** per copiare il comando del server negli appunti. Il comando copiato sarà simile a questo: ``` "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server" --stdio ``` Usa questo comando nei passaggi di configurazione qui sotto. {% hint style="info" %} Il percorso del comando varia in base al sistema operativo. Usa il comando esatto copiato da ACE Studio in ogni configurazione client qui sotto. {% endhint %} **Claude Desktop** STDIO è il Trasporto nativo per Claude Desktop. Non hai bisogno di strumenti aggiuntivi come `mcp-remote`. 1. Individua il file di configurazione di Claude Desktop. * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 2. Modifica il file di configurazione e aggiungi quanto segue: ```json { "mcpServers": { "acestudio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 3. Salva il file e riavvia Claude Desktop. **Verifica la connessione:**\ Digita in Claude: ``` Per favore, controlla le informazioni del Progetto corrente di ACE Studio ``` Se Claude restituisce i dettagli del Progetto, la connessione è riuscita. **Cursor** 1. Apri le Impostazioni di Cursor. 2. Trova la **Tools & MCP** sezione. 3. Fai clic su **Nuovo server MCP**. 4. Compila il seguente JSON: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 5. Fai clic su **Salva**. 6. Riavvia Cursor. **Verifica la connessione:**\ Digita in Cursor Chat: ``` @acestudio Quali Tracce sono nel Progetto corrente? ``` **VS Code tramite supporto MCP nativo** 1. Crea o modifica `.vscode/mcp.json` nel tuo workspace. 2. Aggiungi la seguente configurazione: ```json { "servers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **VS Code tramite Cline** 1. Installa l'estensione Cline. 2. Apri le Impostazioni dell'estensione. 3. Trova la sezione di configurazione MCP Servers. 4. Aggiungi un nuovo server: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **Altri client** Per la maggior parte dei client, utilizza queste Impostazioni di configurazione: * **Tipo di Trasporto:** STDIO * **Comando:** `/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server` * **Argomenti:** `--stdio` Oppure importa il server MCP con il seguente JSON: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` ### Esempi di utilizzo Una volta connesso, puoi provare i seguenti prompt per collaborare con il tuo assistente AI: #### Crea un Nuovo Progetto ``` Aiutami a creare un nuovo progetto in stile pop con BPM 120 in ACE Studio, in tonalità di Do maggiore, aggiungi una Traccia vocale principale e una Traccia di accompagnamento di violino ``` #### Genera Testo e Melodia ``` Basandoti sul tema "Ricordi d'estate in riva al mare," scrivi una sezione di ritornello di 8 battute in ACE Studio. La melodia dovrebbe essere leggera e vivace, usando una Scala pentatonica ``` #### Modifica MIDI ``` In ACE Studio, aggiungi una progressione di accordi di Piano nelle battute 9-16: Do - Lam - Fa - Sol, ogni accordo dura 2 battute ``` --- # Agent Instructions: 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: ``` GET https://docs.acestudio.ai/docs/product-wiki-it/strumenti-ai-1/ace-studio-mcp-server.md?ask= ``` The question should be specific, self-contained, and written in natural language. 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.