> 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-pt/ferramentas-de-ia/ace-studio-mcp-server.md). # Servidor MCP do ACE Studio ## Servidor MCP do ACE Studio {% hint style="warning" %} #### Status experimental O Servidor MCP do ACE Studio está atualmente em **fase experimental**. **Observação:** * Alguns recursos e configurações შესაძლოა não estar totalmente implementados դեռ * Os recursos e as funcionalidades 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 comentário 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 avançado de ferramentas que permite aos agentes de IA navegar e executar edições criativas de forma autônoma. Ao fornecer aos agentes de IA uma visão abrangente de cada detalhe do seu projeto, ele permite que ajudem 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 que assistentes de IA se conectem perfeitamente a aplicações externas e fontes de dados. O servidor MCP do ACE Studio implementa esse protocolo para dar aos agentes de IA acesso direto ao seu espaço de trabalho criativo. ### Início Rápido #### Inicie o Servidor MCP do ACE Studio 1. Abra **ACE Studio**. 2. Vá para **Preferências → Geral → Servidor MCP**. 3. Escolha um modo de transporte: **HTTP** ou **STDIO**. > O modo de transporte selecionado 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 de cada cliente. Escolha a configuração apropriada com base no modo de transporte selecionado e no seu cliente de IA. #### Modo HTTP com Streaming 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 Servidor MCP do ACE Studio usa o **protocolo de transporte HTTP com Streaming**. Mantenha este endereço para a próxima etapa de configuração. **Claude Desktop** > ⚠ A configuração do Servidor MCP do ACE Studio no Claude Desktop requer a edição de um arquivo de configuração JSON. Se você não se sentir à vontade com configurações técnicas, recomendamos experimentar clientes mais fáceis de usar. **Etapas de configuração:** 1. Instale o Node.js, se necessário. * 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: ``` 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-o manualmente: 1. Abra as configurações do Cursor. 2. Localize a **Ferramentas e MCP** seção. 3. Clique **Novo Servidor MCP**. 4. Preencha o seguinte JSON: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. Clique **Salvar**. 6. Reinicie o Cursor. **Verificar conexão:**\ Digite no Chat do Cursor: ``` @acestudio Quais faixas estão no projeto atual? ``` **VS Code com 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-o manualmente: 1. Crie ou edite `.vscode/mcp.json` no seu espaço de trabalho. 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. Localize a seção de configuração de 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 com Streaming. 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. **Como obter o comando:** 1. No ACE Studio, vá para **Preferências → Geral → Servidor MCP**. 2. Defina o modo como **STDIO**. 3. Clique **Copiar comando** para copiar o comando do servidor para a área de transferência. O comando copiado terá esta 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 todas as configurações 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: ``` 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. Localize a **Ferramentas e MCP** seção. 3. Clique **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 **Salvar**. 6. Reinicie o Cursor. **Verificar conexão:**\ Digite no Chat do Cursor: ``` @acestudio Quais faixas estão no projeto atual? ``` **VS Code com suporte nativo a MCP** 1. Crie ou edite `.vscode/mcp.json` no seu espaço de trabalho. 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. Localize a seção de configuração de 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 conectar, você pode experimentar os seguintes prompts para colaborar com seu assistente de IA: #### Criar um Novo Projeto ``` Ajude-me a criar um novo projeto de 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 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 ``` --- # 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-pt/ferramentas-de-ia/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.