# ACE Studio MCP Server ## ACE Studio MCP Server {% hint style="warning" %} #### Status experimental O ACE Studio MCP Server está atualmente em **fase experimental**. **Observe:** * Alguns recursos e configurações ainda podem não estar totalmente implementados * Os recursos e a funcionalidade podem mudar * Você pode encontrar bugs ou problemas de desempenho durante o uso * As diretrizes de uso e os limites de taxa serão publicados quando a versão estável for lançada Estamos aprimorando ativamente este recurso. Se você tiver algum feedback ou encontrar problemas, entre em contato conosco em [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} O servidor MCP do ACE Studio oferece um conjunto robusto de ferramentas que permite aos agentes de IA navegar de forma autônoma e executar edições criativas. Ao fornecer aos agentes de IA uma visão abrangente de todos os detalhes do seu Projeto, ele os capacita a ajudar você a criar e editar músicas com mais rapidez e liberdade criativa. [O Protocolo de Contexto de Modelo](https://modelcontextprotocol.io/docs/getting-started/intro) (MCP) é um padrão aberto que permite aos assistentes de IA conectar-se perfeitamente a aplicativos externos e fontes de dados. O servidor MCP do ACE Studio implementa esse protocolo para dar aos agentes de IA acesso direto ao seu ambiente criativo. ### Início rápido #### Inicie o ACE Studio MCP Server 1. Abrir **ACE Studio**. 2. Acesse **Configurações → Geral → Servidor MCP**. 3. Escolha um modo de transporte: **HTTP** ou **STDIO**. > O modo de transporte escolhido aqui determina como seu cliente de IA se conecta ao ACE Studio. Consulte as seções abaixo para obter detalhes e configurações específicas do cliente. Escolha a configuração apropriada com base no modo de transporte selecionado e no seu cliente de IA. #### Modo HTTP transmissível No modo HTTP, o ACE Studio executa um servidor MCP local em um endereço fixo. Seu cliente de IA se conecta a ele pela rede. **Endereço do servidor:** `http://localhost:21572/mcp` > **Nota técnica**: O ACE Studio MCP Server usa o **protocolo de transporte HTTP transmissível**. Guarde este endereço para a próxima etapa de configuração. **Claude Desktop** > ⚠ Configurar o ACE Studio MCP Server no Claude Desktop requer editar um arquivo de configuração JSON. Se você não se sentir confortável com configuração técnica, recomendamos experimentar clientes mais intuitivos. **Etapas de configuração:** 1. Instale o Node.js, se necessário. * Acesse [nodejs.org](https://nodejs.org) e baixe a versão LTS. 2. Localize o arquivo de configuração do Claude Desktop. * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 3. Edite o arquivo de configuração e adicione o seguinte: ```json { "mcpServers": { "acestudio": { "command": "npx", "args": [ "mcp-remote", "http://localhost:21572/mcp" ] } } } ``` 4. Salve o arquivo e reinicie o Claude Desktop. **Verificar conexão:**\ Digite no Claude: ``` Por favor, verifique as informações do Projeto atual do ACE Studio ``` Se o Claude retornar os detalhes do Projeto, a conexão foi bem-sucedida. **Cursor** Você pode adicionar diretamente o servidor MCP ao Cursor clicando [aqui](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9). Ou configure manualmente: 1. Abra as Configurações do Cursor. 2. Encontre a seção **Ferramentas e MCP** . 3. Clique em **Novo Servidor MCP**. 4. Preencha o seguinte JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Clique em **Salvar**. 6. Reinicie o Cursor. **Verificar conexão:**\ Digite no Cursor Chat: ``` @acestudio Quais Faixas estão no Projeto atual? ``` **VS Code via suporte nativo a MCP** Você pode adicionar diretamente o servidor MCP ao VS Code clicando [aqui](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). Ou configure manualmente: 1. Criar ou editar `.vscode/mcp.json` no seu workspace. 2. Adicione a seguinte configuração: ```json { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp" } } } ``` **VS Code via Cline** 1. Instale a extensão Cline. 2. Abra as configurações da extensão. 3. Encontre a seção de configuração dos Servidores MCP. 4. Adicione um novo servidor: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` **Outros Clientes** Para a maioria dos clientes, use estas configurações: * **Tipo de Transporte:** HTTP transmissível. Alguns clientes podem chamar isso de `Remoto`. * **URL do servidor:** `http://localhost:21572/mcp` Ou importe o servidor MCP com o seguinte JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` #### Modo STDIO No modo STDIO, seu cliente de IA inicia e se comunica diretamente com o servidor MCP do ACE Studio por meio da entrada e saída padrão. Isso é mais simples de configurar. Você não precisa iniciar um servidor manualmente nem usar um endereço de rede. **Obtendo o comando:** 1. No ACE Studio, vá para **Configurações → Geral → Servidor MCP**. 2. Defina o modo como **STDIO**. 3. Clique em **Copiar comando** para copiar o comando do servidor para a área de transferência. O comando copiado terá a seguinte aparência: ``` "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server" --stdio ``` Use este comando nas etapas de configuração abaixo. {% hint style="info" %} O caminho do comando varia conforme o sistema operacional. Use o comando exato copiado do ACE Studio em cada configuração de cliente abaixo. {% endhint %} **Claude Desktop** STDIO é o transporte nativo do Claude Desktop. Você não precisa de ferramentas extras como `mcp-remote`. 1. Localize o arquivo de configuração do Claude Desktop. * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json` * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json` 2. Edite o arquivo de configuração e adicione o seguinte: ```json { "mcpServers": { "acestudio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 3. Salve o arquivo e reinicie o Claude Desktop. **Verificar conexão:**\ Digite no Claude: ``` Por favor, verifique as informações do Projeto atual do ACE Studio ``` Se o Claude retornar os detalhes do Projeto, a conexão foi bem-sucedida. **Cursor** 1. Abra as Configurações do Cursor. 2. Encontre a seção **Ferramentas e MCP** . 3. Clique em **Novo Servidor MCP**. 4. Preencha o seguinte JSON: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` 5. Clique em **Salvar**. 6. Reinicie o Cursor. **Verificar conexão:**\ Digite no Cursor Chat: ``` @acestudio Quais Faixas estão no Projeto atual? ``` **VS Code via suporte nativo a MCP** 1. Criar ou editar `.vscode/mcp.json` no seu workspace. 2. Adicione a seguinte configuração: ```json { "servers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **VS Code via Cline** 1. Instale a extensão Cline. 2. Abra as configurações da extensão. 3. Encontre a seção de configuração dos Servidores MCP. 4. Adicione um novo servidor: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` **Outros Clientes** Para a maioria dos clientes, use estas configurações: * **Tipo de Transporte:** STDIO * **Comando:** `/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server` * **Argumentos:** `--stdio` Ou importe o servidor MCP com o seguinte JSON: ```json { "mcpServers": { "ACE-Studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server", "args": ["--stdio"] } } } ``` ### Exemplos de uso Depois de conectado, você pode experimentar os prompts a seguir para colaborar com seu assistente de IA: #### Criar um Novo Projeto ``` Me ajude a criar um novo Projeto no estilo pop com BPM 120 no ACE Studio, em Dó maior, adicione uma faixa Vocal principal e uma faixa de acompanhamento de violino ``` #### Gerar Letra e Melodia ``` Com base no tema "Memórias de verão à beira-mar", escreva uma seção de refrão de 8 Compassos no ACE Studio. A melodia deve ser leve e vibrante, usando uma Escala pentatônica ``` #### Editar MIDI ``` No ACE Studio, adicione uma progressão de Acorde de piano nos Compassos 9-16: Dó - Lam - Fá - Sol, cada Acorde durando 2 Compassos ``` --- # 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-pt/ferramentas-de-ia/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.