> 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-ko/ai-3/external-agent-access/claude-desktop-and-cowork.md).

# Claude Desktop 및 Cowork

MCP를 통해 Claude Desktop(Chat 및 Cowork)을 ACE Studio에 연결합니다.

로컬 MCP (모델 컨텍스트 프로토콜) 서버를 통해 Claude Desktop을 ACE Studio에 연결하여, Claude에서 바로 음악 프로젝트를 검사, 정리, 편집할 수 있습니다.

{% hint style="info" %}
이 가이드는 구성 방법을 안내합니다. **채팅** 와 **코워크** Claude Desktop에서.

사용 중인 경우 **코드** 모드(Claude Code)에서는 별도의 구성 설정을 사용합니다. 다음으로 이동하여 [외부 에이전트 액세스](/docs/product-wiki-ko/ai-3/external-agent-access.md) 에이전트가 자동으로 자체 구성을 수행하도록 하거나 `claude mcp add` 터미널 명령을 사용하세요.
{% endhint %}

Claude Desktop 왼쪽 상단의 모드 선택기를 사용해 모드를 전환하세요:

<figure><img src="https://2318261860-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>Claude Desktop의 모드 선택기</p></figcaption></figure>

***

### 1단계: 설정 열기

열기 **설정** 를 Claude Desktop에서:

* 왼쪽 아래 모서리에서 프로필 이름을 클릭하고 **설정**, 또는
* 앱 메뉴를 사용하세요: **Claude → 설정...** (`Cmd+,` 는 macOS에서, 또는 `Ctrl+,` (Windows에서).

{% tabs %}
{% tab title="프로필 메뉴" %}

<figure><img src="https://2318261860-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>왼쪽 아래 프로필 메뉴에서 설정에 액세스</p></figcaption></figure>
{% endtab %}

{% tab title="애플리케이션 메뉴(macOS)" %}

<figure><img src="https://2318261860-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>macOS 메뉴 막대에서 설정에 액세스</p></figcaption></figure>
{% endtab %}
{% endtabs %}

***

### 2단계: 구성 파일 열기

1. 설정 창에서 **개발자** 아래의 **데스크톱 앱** 섹션으로 이동합니다.
2. 다음을 클릭하세요 **설정 편집** 버튼.

<figure><img src="https://2318261860-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>개발자 설정에서 "설정 편집"을 클릭</p></figcaption></figure>

Claude Desktop는 시스템 파일 관리자(Finder 또는 File Explorer)를 열어 `claude_desktop_config.json` 가 선택된 상태로 표시합니다.

***

### 3단계: ACE Studio MCP 서버 추가

1. 열기 `claude_desktop_config.json` 를 아무 텍스트 편집기에서 엽니다.
2. ACE Studio에서 **환경설정 → 일반 → 외부 에이전트 접근** 를 열고 **명령 복사** 옆의 **MCP 서버 (stdio)** 을 클릭해 정확한 실행 명령을 복사하세요.
3. 다음 `acestudio` 구성을 `mcpServers`:

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

<figure><img src="https://2318261860-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> acestudio 서버가 구성된 상태로</p></figcaption></figure>

{% hint style="info" %}
**Windows 경로 이스케이프:** JSON 파일에 백슬래시를 사용해 Windows 경로를 수동으로 작성하는 경우, 각 백슬래시를 이중 백슬래시(`\\`)로 이스케이프하거나, 슬래시(`/`).
{% endhint %}

4. 파일을 저장한 다음 **Claude Desktop을 다시 시작** 하세요.

***

### 4단계: 확인하고 사용 시작

#### 1. 연결 상태 확인

열기 **설정 → 개발자** 에서 Claude Desktop을 확인하세요. 이제 **acestudio** 다음 아래에 나열된 항목이 보여야 합니다. **로컬 MCP 서버** 실행 중 상태로.

<figure><img src="https://2318261860-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>활성화된 acestudio 연결이 표시된 로컬 MCP 서버</p></figcaption></figure>

#### 2. 채팅 또는 코워크에서 활성화

에서 대화를 시작할 때 **채팅** 또는 **코워크**에서 **+ / 커넥터** 메시지 입력 상자 아래의 버튼을 클릭하고 **acestudio** 이 켜져 있는지 확인하세요. **ON**.

<figure><img src="https://2318261860-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>acestudio 커넥터가 활성화되어 있는지 확인</p></figcaption></figure>

#### 3. 프롬프트로 테스트

ACE Studio가 열려 실행 중인지 확인한 뒤, Claude에게 다음과 같이 요청하세요:

```
현재 ACE Studio 프로젝트 정보를 확인해 주세요
```

Claude는 ACE Studio에 연결해 열린 프로젝트를 검사하고, 해당 세부 정보(템포, 조표, 트랙, 클립)를 반환합니다.


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.acestudio.ai/docs/product-wiki-ko/ai-3/external-agent-access/claude-desktop-and-cowork.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.