> 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/strumenti-ai-1/ace-studio-mcp-server.md). # ACE Studio MCP Server ## Server MCP di ACE Studio {% hint style="warning" %} #### Stato sperimentale Il server MCP di ACE Studio è attualmente in **fase sperimentale**. **Nota:** * Alcune funzionalità e Impostazioni potrebbero non essere ancora completamente implementate * Le funzionalità e le caratteristiche potrebbero cambiare * Potresti riscontrare bug o problemi di prestazioni durante l'uso * Le linee guida d'uso e i limiti di utilizzo saranno pubblicati quando verrà rilasciata la versione stabile Stiamo migliorando attivamente questa funzionalità. Se hai feedback o riscontri problemi, contattaci a [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} Il server MCP di ACE Studio offre un ricco set di strumenti che consente agli agenti AI di navigare ed eseguire autonomamente modifiche creative. Fornendo 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à con applicazioni esterne e origini dati. Il server MCP di ACE Studio implementa questo protocollo per dare agli agenti AI accesso diretto al tuo spazio di lavoro creativo. ### Guida rapida #### Avvia il server MCP di ACE Studio 1. Apri **ACE Studio**. 2. Vai a **Preferenze → Generale → Server MCP**. 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 per client. Scegli la configurazione appropriata in base alla modalità di Trasporto selezionata e al tuo client AI. #### Modalità HTTP streamable 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 MCP di ACE Studio utilizza il **protocollo di trasporto HTTP streamable**. Conserva questo indirizzo per il passaggio successivo della configurazione. **Claude Desktop** > ⚠ Configurare il server MCP di ACE Studio in Claude Desktop richiede la modifica di un file di configurazione JSON. Se non ti senti a tuo agio con la configurazione tecnica, ti consigliamo di provare client più intuitivi. **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: ``` Controlla le informazioni sul 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 **Tools & MCP** la sezione. 3. Fai clic **Nuovo server MCP**. 4. Compila il seguente JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Fai clic **Salva**. 6. Riavvia Cursor. **Verifica la connessione:**\ Digita in Cursor Chat: ``` @acestudio Quali Tracce sono nel Progetto corrente? ``` **VS Code tramite il supporto MCP nativo** Puoi aggiungere direttamente il server MCP a VS Code facendo clic [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` nella tua area di lavoro. 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, usa queste Impostazioni di configurazione: * **Tipo di Trasporto:** HTTP streamable. 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 tuo client AI avvia e comunica con il server MCP di ACE Studio direttamente tramite ingresso e output standard. È più semplice da configurare. Non è necessario avviare manualmente un server o usare un indirizzo di rete. **Ottenere il comando:** 1. In ACE Studio, vai a **Preferenze → Generale → Server MCP**. 2. Imposta la modalità su **STDIO**. 3. Fai clic **Copia comando** per copiare il comando del server negli appunti. Il comando copiato apparirà così: ``` "/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: ``` Controlla le informazioni sul Progetto corrente di ACE Studio ``` Se Claude restituisce i dettagli del Progetto, la connessione è riuscita. **Cursor** 1. Apri le Impostazioni di Cursor. 2. Trova **Tools & MCP** la sezione. 3. Fai clic **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 **Salva**. 6. Riavvia Cursor. **Verifica la connessione:**\ Digita in Cursor Chat: ``` @acestudio Quali Tracce sono nel Progetto corrente? ``` **VS Code tramite il supporto MCP nativo** 1. Crea o modifica `.vscode/mcp.json` nella tua area di lavoro. 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, usa 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 Do maggiore, aggiungi una Traccia Voce solista e una Traccia di accompagnamento di violino ``` #### Genera Testo e Melodia ``` Basato sul tema "Ricordi estivi 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 per Piano nelle Battute 9-16: C - Am - F - G, ogni Accordo dura 2 Battute ``` --- # 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/strumenti-ai-1/ace-studio-mcp-server.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.