> 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/agente-de-ia/external-agent-access.md). # Acesso a Agentes Externos Conecte o ACE Studio a assistentes e agentes de IA por meio de MCP e CLI. {% hint style="warning" %} #### Estado experimental O acesso de agentes externos no ACE Studio é atualmente experimental e está em desenvolvimento ativo. **Tenha em atenção:** * **Alterações incompatíveis:** Os comandos das ferramentas, os formatos e as convenções podem mudar entre atualizações. * **Em desenvolvimento:** Ainda nem todas as funcionalidades do ACE Studio estão totalmente acessíveis aos agentes. * **Aspetos por afinar:** Poderá encontrar bugs, casos-limite inesperados ou um comportamento pouco natural à medida que refinamos as interações com agentes. Se encontrar problemas ou tiver sugestões, contacte-nos em [**support@acestudio.ai**](mailto:support@acestudio.ai). {% endhint %} Ligue assistentes e agentes de IA (como Claude, ChatGPT, OpenClaw ou Hermes Agent) diretamente ao ACE Studio para compreender e editar os seus projetos musicais em tempo real. ### O que o seu agente pode fazer Depois de ligado, um agente pode inspecionar e editar o seu Projeto em quase tudo o que o ACE Studio faz: * **Arranjo e Composição** — Gerir Faixas, clipes, notas, Letra, acordes e o cursor de reprodução. * **Vocais e Instrumentos** — Ajustar Vozes de síntese vocal, fontes sonoras, camadas de Coro com vários cantores e Parâmetros de Vocal (pitch, Respiração, Tensão), e carregar plug-ins de instrumentos de terceiros. * **Tempo e Estrutura** — Definir BPM, fórmulas de compasso, marcadores de Loop e Transporte. * **Produção e Ferramentas de IA** — Acionar Adicionar uma Camada, Vocal para MIDI, Separador de Stems, Music Enhancer e carregar cadeias de FX ou predefinições. * **Controlo de sessão e entrega** — Iniciar e guardar projetos, importar Áudio e MIDI e exportar mixdowns completos, Stems individuais, vídeo e muito mais. Basta descrever o que pretende em linguagem simples, e o seu assistente inspecionará o Projeto e fará as alterações. *** ### Ligar o seu assistente Escolha o método de configuração que melhor se adapta ao seu fluxo de trabalho: #### Caminho A: deixe o seu agente de IA configurar tudo por si Se usar um agente com acesso ao ambiente local ou ao computador (como **Claude Code**, **Codex**, **OpenClaw**, ou **Hermes Agent**), ele pode configurar-se automaticamente. {% hint style="info" %} Este caminho requer um agente a correr no mesmo computador que o ACE Studio, com permissões para executar comandos e editar os seus ficheiros de configuração. {% endhint %} A forma mais rápida é a partir do próprio ACE Studio. Clique no **ícone do agente** no canto inferior direito da janela, escolha **ChatGPT**, **Claude**, ou **Outros agentes**, e siga os três passos apresentados: abra o seu agente, copie o prompt de ligação com o botão **Copiar** e envie-o; depois comece a criar com um dos prompts de exemplo. O mesmo prompt de ligação é reproduzido aqui. Copie-o e cole-o no seu agente e prima Enviar: ``` Ligue-se ao ACE Studio por mim usando acestudio-cli ou MCP. Localizações predefinidas: - macOS MCP: "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" - macOS CLI: "/Applications/ACE Studio.app/Contents/Helpers/acestudio-cli" - Windows MCP: "C:\\Program Files\\ACE Studio\\ace-mcp-server.exe" - Windows CLI: "C:\\Program Files\\ACE Studio\\acestudio-cli.exe" Tente usar primeiro a CLI e lembre-se do caminho da ferramenta nas suas instruções/memória. Se o acesso à CLI for restringido por sandboxing ou permissões, registre o servidor MCP (sob o nome "ace-studio" com escopo de usuário/global). Se não for encontrado no local padrão, peça-me o caminho em Preferências do ACE Studio → Geral → Acesso do Agente Externo. Em seguida, instale o plugin de skills/agente a partir do repositório oficial do ACE Studio em https://github.com/BeatMagic/acestudio_agent_plugin. É importante que ele esteja instalado e disponível para você, pois fornece o conhecimento de que você precisará ao interagir com o ACE Studio. Se você precisar de mais contexto sobre o ACE Studio e sua integração de agente, consulte a documentação em https://docs.acestudio.ai/llms.txt. Se o seu harness não conseguir se configurar ou executar comandos locais, por favor, me oriente pelos passos de configuração manual para a sua plataforma. ``` *** #### Caminho B: Configure manualmente no seu harness Se o seu harness de agente não puder se configurar automaticamente, você precisará adicionar manualmente o servidor MCP do ACE Studio à sua configuração. [O Protocolo de Contexto de Modelo (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) é um padrão aberto que conecta assistentes de IA a aplicações externas. O ACE Studio executa como um servidor STDIO local, permitindo que qualquer cliente compatível com MCP se conecte diretamente usando o comando de inicialização. **Configure via Terminal** Se você usa Claude ou Codex e prefere configurar diretamente a partir do seu terminal: {% tabs %} {% tab title="Claude" %} Execute no seu terminal: **macOS:** ```bash claude mcp add --scope user ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" ``` **Windows:** ```cmd claude mcp add --scope user ace-studio -- "C:\\Program Files\\ACE Studio\\ace-mcp-server.exe" ``` {% endtab %} {% tab title="Codex" %} Execute no seu terminal: **macOS:** ```bash codex mcp add ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" ``` **Windows:** ```cmd codex mcp add ace-studio -- "C:\\Program Files\\ACE Studio\\ace-mcp-server.exe" ``` {% endtab %} {% endtabs %} **Aplicativos de chat para desktop** Para guias completos, passo a passo, com orientações de configuração: * [**Claude Desktop & Cowork**](/docs/product-wiki-pt/agente-de-ia/external-agent-access/claude-desktop-and-cowork.md) — Configuração passo a passo para o Claude Desktop com orientações pelo arquivo de configuração. * [**ChatGPT para desktop**](/docs/product-wiki-pt/agente-de-ia/external-agent-access/chatgpt-for-desktop.md) — Configuração passo a passo para os modos ChatGPT Work e Codex. **Outros harnesses e IDEs (VS Code, Cursor, clientes personalizados)** A maioria dos clientes MCP e IDEs solicita os mesmos parâmetros de configuração: * **Tipo de transporte:** STDIO (às vezes rotulado como "Local" ou "Command") * **Comando:** O comando de inicialização copiado do ACE Studio * **Argumentos / Ambiente:** Nenhum Para harnesses configurados por meio de arquivos JSON: {% tabs %} {% tab title="Configuração padrão de MCP (Cursor etc.)" %} Usado pelo Cursor (`~/.cursor/mcp.json` ou `.cursor/mcp.json`) e pela maioria dos harnesses MCP padrão: ```json { "mcpServers": { "ace-studio": { "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% tab title="VS Code (GitHub Copilot)" %} Adicione a `.vscode/mcp.json` no workspace do seu projeto: ```json { "servers": { "ace-studio": { "type": "stdio", "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server" } } } ``` {% endtab %} {% endtabs %} {% hint style="info" %} **Escape de caminhos do Windows em JSON:** Se você escrever manualmente caminhos do Windows usando barras invertidas em arquivos JSON, escape cada barra invertida como uma barra invertida dupla (`\\`), ou use barras inclinadas (`/`). {% endhint %} {% hint style="warning" %} **Assistentes de IA baseados no navegador:**\ O servidor MCP do ACE Studio é executado localmente na sua máquina via STDIO. Interfaces apenas web (como ChatGPT ou Claude num navegador web) não conseguem ligar-se diretamente a servidores STDIO locais. Utilize antes as respetivas aplicações de ambiente de trabalho ou clientes de terminal. {% endhint %} {% hint style="info" %} **Caminhos de instalação personalizados:** Se instalou o ACE Studio num diretório personalizado, abra **Preferências → Geral → Acesso ao Agente Externo** no ACE Studio: * Clique em **Copiar comando** ao lado de **Servidor MCP (stdio)** para o caminho do servidor MCP. * Clique em **Copiar** ao lado de **caminho do binário acestudio-cli** para o caminho da CLI. {% endhint %} *** ### Verificando a conexão Certifique-se de que o ACE Studio esteja aberto e em execução e, em seguida, peça ao seu assistente: ``` Por favor, verifique as informações atuais do Projeto do ACE Studio ``` Se o seu assistente responder com o Tempo, a armadura de clave e a lista de Faixas do seu Projeto, sua configuração estará concluída e pronta. *** ### Exemplos de prompts criativos Aqui estão alguns exemplos reais de como pode colaborar com o seu assistente de IA no ACE Studio: #### 1. Produção Vocal e Harmonias com Vários Cantores ``` Ative o Modo de coro na faixa vocal principal (Faixa 1) e adicione dois cantores de apoio vozes, aumente o Espalhar estéreo e reduza o nível delas em -3 dB para obter uma harmonia de fundo envolvente. ``` #### 2. Mistura de vozes personalizada ``` Crie uma Voz Misturada personalizada na Faixa 2: misture 70% de uma base de pop acústico quente com 30% de uma base de voz arejada e Soprado e, em seguida, dê à mistura o nome "Velvet Ar". ``` #### 3. Acordes e Esboço de Canção ``` Nos Compassos 1–8 da Faixa de Acordes, insira uma progressão Neo-Soul: Ebmaj9 — G7#9 — Cm9 — F13 (2 Compassos cada). Em seguida, adicione uma faixa de Piano Rhodes e uma linha de baixo groovada seguindo as notas fundamentais. ``` #### 4. Acompanhamento por IA e Extração de Áudio ``` Divida o Clipe de Áudio importado na Faixa 1 em Vocal, bateria, baixo e outros Stems. Em seguida, execute Vocal para MIDI no Stem vocal extraído para criar uma Faixa Sing editável. ``` #### 5. Ideias gerativas de música e camadas ``` Ouça o arranjo do Compasso 9 ao 25 e use Adicionar uma Camada para gerar uma camada de acompanhamento com pad de cordas cinematográfico correspondente no Tempo atual do Projeto. ``` #### 6. Afinação Expressiva do Vocal e Dinâmica ``` Inspecione as notas vocais do refrão na Faixa 1: suavize as transições de afinação, aumente a soprosidade nas notas de entrada e adicione uma curva sutil de Vibrato nas notas sustentadas. ``` #### 7. Cadeias de FX e Entrega de Stem ``` Carregue um compressor Vocal vintage e uma reverb de placa quente na cadeia de FX do Vocal principal, depois exporte todas as Faixas individuais como stems WAV de 24 bits/48 kHz para uma pasta "Stems" na minha Área de Trabalho. ``` --- # 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/agente-de-ia/external-agent-access.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.