> 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/claude-desktop-and-cowork.md).

# Claude Desktop e Cowork

Conecte o Claude Desktop (Chat & Cowork) ao ACE Studio via MCP.

Conecte o Claude Desktop ao ACE Studio por meio de um servidor MCP (Protocolo de Contexto de Modelo) local para inspecionar, organizar e editar seus projetos musicais diretamente no Claude.

{% hint style="info" %}
Este guia mostra como configurar **Chat** e **Cocriação** no Claude Desktop.

Se você estiver usando **Código** modo (Claude Code), ele usa configurações de acesso separadas. Acesse [Acesso Externo ao Agente](/docs/product-wiki-pt/agente-de-ia/external-agent-access.md) para permitir que o agente se configure automaticamente ou use o `claude mcp add` comando de terminal.
{% endhint %}

Alterne entre os modos usando o seletor de modo no canto superior esquerdo do Claude Desktop:

<figure><img src="https://2482672908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-88d0c92ad5382c3dc71ccacb0a5cd3cc040e4233%2Fclaude-desktop-mode-selector.png?alt=media" alt="Mode selector in Claude Desktop showing Chat, Cowork, and Code"><figcaption><p>Seletor de modo no Claude Desktop</p></figcaption></figure>

***

### Etapa 1: Abra Configurações

Abrir **Configurações** no Claude Desktop:

* Clique no nome do seu perfil no canto inferior esquerdo e selecione **Configurações**, ou
* Use o menu do aplicativo: **Claude → Configurações...** (`Cmd+,` no macOS ou `Ctrl+,` no Windows).

{% tabs %}
{% tab title="Menu de Perfil" %}

<figure><img src="https://2482672908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-4d652fee91fc0c7e6fb11371bbd0546fc561bca8%2Fclaude-desktop-open-settings-profile.png?alt=media" alt="Open Settings from user profile menu"><figcaption><p>Acesse Configurações pelo menu de perfil no canto inferior esquerdo</p></figcaption></figure>
{% endtab %}

{% tab title="Menu do Aplicativo (macOS)" %}

<figure><img src="https://2482672908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-ab2f2f30e730e3205c7bf38b278f1808efaa734f%2Fclaude-desktop-open-settings-macos.png?alt=media" alt="Open Settings from macOS app menu"><figcaption><p>Acesse Configurações pela barra de menus do macOS</p></figcaption></figure>
{% endtab %}
{% endtabs %}

***

### Etapa 2: Abrir o Arquivo de Configuração

1. Na janela Configurações, navegue até **Desenvolvedor** em **Aplicativo para desktop** seção.
2. Clique no **Editar Config** botão.

<figure><img src="https://2482672908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-429d628635458aa2260f57a684bfb2c4384fa6fb%2Fclaude-desktop-developer-edit-config.png?alt=media" alt="Developer settings tab with Edit Config button"><figcaption><p>Clique em "Editar Config" nas Configurações do Desenvolvedor</p></figcaption></figure>

O Claude Desktop abrirá o gerenciador de arquivos do seu sistema (Finder ou Explorador de Arquivos) com `claude_desktop_config.json` selecionado.

***

### Passo 3: Adicionar servidor MCP do ACE Studio

1. Abrir `claude_desktop_config.json` em qualquer Editor:
2. No ACE Studio, abra **Preferências → Geral → Acesso de Agente Externo** e clique **Copiar comando** ao lado de **Servidor MCP (stdio)** para copiar o seu comando de arranque exato.
3. Adicione o `acestudio` configuração abaixo `Servidores MCP`:

```json
{
  "mcpServers": {
    "acestudio": {
      "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
    }
  }
}
```

<figure><img src="https://2482672908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-d9c3fdd2ed7ede65689f1077697870598e262b7e%2Fclaude-desktop-config-json.png?alt=media" alt="claude_desktop_config.json configured with acestudio server"><figcaption><p><code>claude_desktop_config.json</code> com o servidor ACE Studio configurado</p></figcaption></figure>

{% hint style="info" %}
**Escape de Caminho no Windows:** 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 normais (`/`).
{% endhint %}

4. Salve o arquivo e então **reinicie completamente o Claude Desktop** completamente.

***

### Etapa 4: Verifique e Comece a Usar

#### 1. Confirme o status da conexão

Abrir **Configurações → Desenvolvedor** no Claude Desktop. Agora você deve ver **acestudio** listado em **Servidores MCP locais** com status em execução.

<figure><img src="https://2482672908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-4803e3f866334356d77d4bc233f88a64c5ac0c08%2Fclaude-desktop-mcp-connected.png?alt=media" alt="Local MCP Servers showing acestudio connected"><figcaption><p>Servidores MCP locais exibindo conexão ativa com ACE Studio</p></figcaption></figure>

#### 2. Ative no Chat ou no Cowork

Ao iniciar uma conversa em **Chat** ou **Cocriação**, clique no **+ / Conectores** botão abaixo da caixa de entrada de mensagens e certifique-se de que **acestudio** esteja ativado **LIGADO**.

<figure><img src="https://2482672908-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-1ea14dac4375044032aa43a26769238ff8c8a6b3%2Fclaude-desktop-connector-active.png?alt=media" alt="Connectors menu showing acestudio connector enabled"><figcaption><p>Certifique-se de que o conector ACE Studio esteja ativo</p></figcaption></figure>

#### 3. Teste com um prompt

Certifique-se de que o ACE Studio esteja aberto e em execução e, em seguida, peça ao Claude:

```
Por favor, verifique as informações atuais do Projeto do ACE Studio
```

Claude irá se conectar ao ACE Studio, inspecionar o projeto aberto e retornar os detalhes dele (Tempo, tonalidade, Faixas e clipes).


---

# 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/claude-desktop-and-cowork.md?ask=<question>&goal=<endgoal>
```

`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.