# Server MCP di ACE Studio {% hint style="warning" %} ### Stato Sperimentale Il server ACE Studio MCP è attualmente in **fase sperimentale**. **Si prega di notare:** * Alcune funzionalità e impostazioni potrebbero non essere ancora completamente implementate * Le funzionalità e il comportamento potrebbero cambiare * Potresti incontrare bug o problemi di prestazioni durante l'utilizzo * Linee guida d'uso e limiti di velocità 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 set di strumenti che permette agli agenti AI di navigare ed eseguire modifiche creative in modo autonomo. Fornendo agli agenti AI una visibilità completa di ogni dettaglio del tuo progetto, li abilita ad assisterti nella creazione e modifica di brani con maggiore rapidità e libertà creativa. [Il Model Context Protocol ](https://modelcontextprotocol.io/docs/getting-started/intro)(MCP) è uno standard aperto che consente agli assistenti AI di connettersi senza soluzione di continuità ad applicazioni e sorgenti dati esterne. Il server ACE Studio MCP implementa questo protocollo per dare agli agenti AI accesso diretto al tuo spazio di lavoro creativo. ## Guida rapida ### Avvia il server ACE Studio MCP 1. Apri il **ACE Studio 2.0** 2. Dalle preferenze, abilita **Generale → MCP Server** **Indirizzo Server:** `http://localhost:21572/mcp` > **Nota tecnica**: Il server ACE Studio MCP utilizza il **protocollo di trasporto Streamable HTTP**. Conserva questo indirizzo per il passo di configurazione successivo. ### Collega il Server MCP al tuo client AI Scegli il metodo di configurazione appropriato in base al tuo client AI: #### **Claude Desktop** > ⚠ La configurazione del server ACE Studio MCP in Claude Desktop richiede la modifica di un file di configurazione JSON. Se non ti senti a tuo agio con configurazioni tecniche, consigliamo di provare client più user-friendly. **Passaggi di configurazione:** 1. Installa Node.js (se non è già installato) * 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 verifica le informazioni del progetto ACE Studio corrente ``` Se Claude restituisce i dettagli del progetto, la connessione è avvenuta con successo! *** #### **Cursor** Puoi aggiungere direttamente il server MCP a Cursor cliccando [qui](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9). Oppure configura manualmente: 1. Apri le impostazioni di Cursor 2. Trova la sezione "Tools & MCP" 3. Clicca su "New MCP Server" 4. Compila il seguente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Clicca "Save" 6. Riavvia Cursor **Verifica la connessione:**\ Digita in Cursor Chat: ``` @acestudio What tracks are in the current project? ``` *** #### **VS Code (via Native MCP support)** Puoi aggiungere direttamente il server MCP a VS Code cliccando [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 configura manualmente: 1. Installa l'estensione Cline o Roo Cline 2. Apri le impostazioni dell'estensione 3. Trova la sezione di configurazione MCP Servers 4. Aggiungi un nuovo server: ```json "mcp": { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp", "headers": {} } } } ``` *** #### **VS Code (via Cline / Roo Code)** 1. Installa l'estensione Cline o Roo Code 2. Apri le impostazioni dell'estensione 3. Trova la sezione di configurazione MCP Servers 4. Aggiungi un nuovo server: {% tabs %} {% tab title="Cline" %} ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` {% endtab %} {% tab title="Roo Code" %} ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamable-http", "headers": {} } } } ``` {% endtab %} {% endtabs %} *** #### **Altri client / AI Chat bot** Per la maggior parte dei client**,** usa queste impostazioni di configurazione: * **Tipo di trasporto:** Streamable HTTP (alcuni client potrebbero chiamarlo "Remote") * **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": {} } } } ``` {% hint style="info" %} Nota: ACE Studio richiede il trasporto Streamable HTTP e non supporta il protocollo legacy HTTP + SSE né la versione MCP 2024-11-05. {% endhint %} ## Esempi d'uso 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 Do maggiore, aggiungi una Traccia vocale principale e una Traccia di accompagnamento violino ``` #### Genera testo e melodia ``` Basandoti sul tema "Ricordi d'estate 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 per pianoforte nelle battute 9-16:
C - Am - F - G, ogni accordo dura 2 battute