# Servidor MCP do ACE Studio {% hint style="warning" %} ### Estado Experimental O ACE Studio MCP Server está atualmente em **fase experimental**. **Por favor, note:** * Algumas funcionalidades e configurações podem não estar totalmente implementadas ainda * Recursos e funcionalidades podem mudar * Você pode encontrar bugs ou problemas de desempenho durante o uso * Diretrizes de uso e limites de taxa serão publicadas quando a versão estável for lançada Estamos melhorando ativamente este recurso. Se tiver feedback ou encontrar problemas, entre em contato conosco em [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} O servidor ACE Studio MCP oferece um conjunto avançado de ferramentas que permite que agentes de IA naveguem e executem edições criativas de forma autônoma. Ao fornecer aos agentes de IA uma visão abrangente de cada detalhe do seu projeto, ele os capacita a ajudar na criação e edição de músicas com maior velocidade e liberdade criativa. [O Model Context Protocol ](https://modelcontextprotocol.io/docs/getting-started/intro)(MCP) é um padrão aberto que permite que assistentes de IA se conectem perfeitamente a aplicações e fontes de dados externas. O servidor ACE Studio MCP implementa este protocolo para dar aos agentes de IA acesso direto ao seu espaço de trabalho criativo. ## Início Rápido ### Inicie o ACE Studio MCP Server 1. Abra o **ACE Studio 2.0** 2. Nas preferências, marque **Geral → MCP Server** **Endereço do servidor:** `http://localhost:21572/mcp` > **Nota técnica**: O ACE Studio MCP Server usa o **protocolo de transporte Streamable HTTP**. Guarde este endereço para a próxima etapa de configuração. ### Conecte o MCP Server ao seu cliente de IA Escolha o método de configuração apropriado com base no seu cliente de IA: #### **Claude Desktop** > ⚠ Configurar o ACE Studio MCP Server no Claude Desktop requer editar um arquivo de configuração JSON. Se você não estiver à vontade com configuração técnica, recomendamos tentar clientes mais fáceis de usar. **Etapas de configuração:** 1. Instale o Node.js (se ainda não estiver instalado) * Visite [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 ACE Studio atual ``` Se o Claude retornar detalhes do projeto, a conexão foi bem-sucedida! *** #### **Cursor** Você pode adicionar diretamente o MCP server 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 "Tools & MCP" 3. Clique em "New MCP Server" 4. Preencha o seguinte JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Clique em "Save" 6. Reinicie o Cursor **Verificar conexão:**\ Digite no Cursor Chat: ``` @acestudio What tracks are in the current project? ``` *** #### **VS Code (via Native MCP support)** Você pode adicionar diretamente o MCP server 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. Instale a extensão Cline ou Roo Cline 2. Abra as configurações da extensão 3. Encontre a seção de configuração MCP Servers 4. Adicione um novo servidor: ```json "mcp": { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp", "headers": {} } } } ``` *** #### **VS Code (via Cline / Roo Code)** 1. Instale a extensão Cline ou Roo Code 2. Abra as configurações da extensão 3. Encontre a seção de configuração MCP Servers 4. Adicione um novo servidor: {% 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 %} *** #### **Outros clientes / chatbot de IA** Para a maioria dos clientes**,** use estas configurações de configuração: * **Tipo de transporte:** Streamable HTTP (alguns clientes podem chamar isso de "Remote") * **URL do servidor:** `http://localhost:21572/mcp` Ou importe o MCP server pelo seguinte JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` {% hint style="info" %} Nota: o ACE Studio requer transporte Streamable HTTP e não suporta o protocolo legado HTTP + SSE nem o MCP versão 2024-11-05. {% endhint %} ## Exemplos de uso Uma vez conectado, você pode tentar os seguintes prompts para colaborar com seu assistente de IA: #### Criar um Novo Projeto ``` Ajude-me a criar um novo projeto estilo pop com BPM 120 no ACE Studio, em Dó maior, adicione uma faixa de 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 animada, usando uma escala pentatônica ``` #### Editar MIDI 
No ACE Studio, adicione uma progressão de acordes de piano nos compassos 9-16:
C - Am - F - G, cada acorde com duração de 2 compassos