> 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/chatgpt-for-desktop.md).

# 데스크톱용 ChatGPT

MCP를 통해 데스크톱용 ChatGPT(ChatGPT Work 및 Codex)를 ACE Studio에 연결합니다.

로컬 MCP(모델 Context Protocol) 서버를 통해 데스크톱용 ChatGPT를 ACE Studio에 연결하여 AI 작업 공간에서 직접 음악 프로젝트를 검사, 편곡 및 편집하세요.

{% hint style="warning" %}
**앱 및 모드 호환성:**

* **ChatGPT Classic은 지원되지 않습니다:** 레거시 데스크톱 앱은 로컬 STDIO MCP 서버를 지원하지 않습니다. 최신 [ChatGPT 데스크톱 앱](https://help.openai.com/en/articles/20001276-moving-to-the-new-chatgpt-desktop-app).
* **표준 Chat 모드는 로컬 MCP를 지원하지 않습니다:** 데스크톱 앱에서 표준 **채팅** 모드는 ChatGPT Web / Developer Mode를 통해 구성된 원격 HTTP 기반 플러그인 및 원격 MCP 서버에만 연결합니다. 로컬 데스크톱 애플리케이션과 통신할 수 없습니다.
* **Codex 또는 ChatGPT Work 사용:** 두 **Codex** 모드와 **ChatGPT Work** 는 로컬 컴퓨터에서 실행되며 로컬 STDIO MCP 서버를 완벽하게 지원합니다.
  {% endhint %}

***

### 권장: Codex를 통한 자동 설정

최신 ChatGPT 데스크톱 앱은 기본 환경과 MCP 구성을 다음 간에 공유하므로 **Codex** 와 **ChatGPT Work**, 설정 메뉴를 수동으로 탐색할 필요가 없습니다. Codex가 모든 것을 자동으로 구성하도록 할 수 있습니다:

1. ChatGPT 데스크톱 앱에서 왼쪽 상단 모드 선택기를 열고 다음으로 전환합니다 **Codex**.
2. 다음을 복사합니다 **자동 설정 프롬프트** 에서 [외부 에이전트 액세스](/docs/product-wiki-ko/ai-3/external-agent-access.md#path-a-let-your-ai-agent-configure-it-for-you) 를 복사하여 Codex에 전송합니다.
3. Codex가 ACE Studio 설치를 자동으로 감지하고 다음 위치에서 MCP 서버를 구성합니다 `~/.codex/config.toml`, 그리고 Codex와 ChatGPT Work 모두에서 도구를 사용할 수 있게 합니다.

<figure><img src="https://2318261860-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-bd6c9b89980a8bc1e9538fce71dee76ac0d9f710%2Fchatgpt-desktop-mode-switcher.png?alt=media" alt="Mode selector in ChatGPT for desktop showing Codex"><figcaption><p>왼쪽 상단 모드 선택기에서 Codex로 전환하여 자동 설정 실행</p></figcaption></figure>

***

### ChatGPT Work 사용

구성이 완료되면 다음에서 계속 대화하거나 **Codex** 모드로 유지하거나 다음으로 전환할 수 있습니다 **ChatGPT Work** 에서 일반적인 대화형 워크플로를 진행할 수 있습니다:

1. ChatGPT 앱에서 기본 채팅 보기로 전환합니다.
2. 창 하단의 컴포저에서 다음을 클릭합니다 **Work** 토글 버튼을 눌러 로컬 도구 및 컴퓨터 접근을 활성화합니다.
3. 다음이 표시됩니다 **ACE Studio** 가 활성화되어 음악 프로젝트를 지원할 준비가 된 것을 확인할 수 있습니다.

<figure><img src="https://2318261860-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-344f4119c65e227b3f266921317c10f6851707c0%2Fchatgpt-desktop-work-mode-toggle.png?alt=media" alt="Toggle Work mode in ChatGPT prompt bar"><figcaption><p>로컬 도구를 활성화하려면 컴포저 프롬프트 바에서 "Work"를 클릭하세요</p></figcaption></figure>

***

### 대안: 설정을 통한 수동 설정

그래픽 인터페이스를 통해 서버를 수동으로 구성하려면 다음 단계를 따르세요:

#### 1단계: 설정 열기

열기 **설정** ChatGPT에서:

* 왼쪽 하단의 프로필 아바타를 클릭하고 다음을 선택합니다 **설정**, 또는
* 앱 메뉴를 사용하세요: **ChatGPT → 설정...** (`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-c73bd2c570889b3f528a729ea60e541a1823903a%2Fchatgpt-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-727975c5c9453671b9629dcef860e0870ee1a827%2Fchatgpt-desktop-open-settings-macos.png?alt=media" alt="Open Settings from macOS app menu"><figcaption><p>macOS 메뉴 막대에서 설정에 액세스</p></figcaption></figure>
{% endtab %}
{% endtabs %}

***

#### 2단계: MCP 서버 설정 열기

1. 설정 창에서 **플러그인** 아래의 **통합** 섹션으로 이동합니다.
2. 다음을 클릭하세요 **추가** 오른쪽 상단의 버튼을 클릭하고 다음을 선택합니다 **MCP 서버 추가**.

*(다음으로 전환할 수도 있습니다 **MCP** 탭에서 이전에 추가한 서버를 확인하거나 관리할 수 있습니다.)*

<figure><img src="https://2318261860-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-32323cae32c3d154472d427b9348d229ba8d402e%2Fchatgpt-desktop-settings-plugins-add.png?alt=media" alt="Integrations Plugins settings with Add MCP Server menu"><figcaption><p>통합 → 플러그인에서 "MCP 서버 추가"를 선택하세요</p></figcaption></figure>

***

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

다음에서 **MCP 서버 추가** 대화 상자에서 서버 세부 정보를 입력합니다:

1. **이름:** Enter `ACE Studio` (또는 `acestudio`).
2. **유형:** 유지하세요 **STDIO** 선택됨 *(기본값)*.
3. **실행 명령:** ACE Studio에서 **환경설정 → 일반 → 외부 에이전트 접근**, 클릭하세요 **명령 복사** 옆의 **MCP 서버 (stdio)**, 그리고 여기에 정확한 명령을 붙여넣으세요.
4. 클릭하세요 **저장**.

<figure><img src="https://2318261860-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fsn71WYzecYYQw3KkF40b%2Fuploads%2Fgit-blob-32124bf920da85e0990584a8d8c5ea4086ee22da%2Fchatgpt-desktop-add-mcp-server.png?alt=media" alt="Add MCP Server dialog with ACE Studio STDIO configuration"><figcaption><p>MCP 서버 세부 정보를 입력하고 저장을 클릭하세요</p></figcaption></figure>

{% hint style="info" %}
**공유 Codex 구성:**\
데스크톱 UI를 통해 추가된 서버는 로컬 Codex 구성에 저장됩니다 (`~/.codex/config.toml`). 따라서 ACE Studio는 ChatGPT Work, Codex CLI 및 Codex IDE 확장에서 동시에 액세스할 수 있습니다.
{% endhint %}

***

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

1. 다음으로 전환합니다 **Codex** 모드로 전환하거나 **Work** 모드가 ChatGPT에서 활성화되어 있는지 확인합니다.
2. ACE Studio가 열려 실행 중인지 확인한 후 다음과 같이 요청하세요:

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

ChatGPT가 로컬 MCP 서버를 통해 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/chatgpt-for-desktop.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.