> 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-zh/ai-zhi-neng-ti/external-agent-access/chatgpt-for-desktop.md).

# 桌面版 ChatGPT

通过 MCP 将桌面版 ChatGPT（ChatGPT Work & Codex）连接到 ACE Studio。

通过本地 MCP（模型上下文协议）服务器将桌面版 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).
* **标准聊天模式不支持本地 MCP：** 在桌面应用中，标准 **聊天** 模式仅连接基于远程 HTTP 的插件，以及通过 ChatGPT Web / 开发者模式配置的远程 MCP 服务器。它无法与本地桌面应用通信。
* **使用 Codex 或 ChatGPT Work：** 两种 **Codex** 模式和 **ChatGPT Work** 均在你的本地计算机上运行，并全面支持本地 STDIO MCP 服务器。
  {% endhint %}

***

### 推荐：通过 Codex 自动设置

由于现代 ChatGPT 桌面应用会在以下各项之间共享其底层环境和 MCP 配置 **Codex** 和 **ChatGPT Work**，因此无需手动浏览设置菜单。你可以让 Codex 自动为你完成全部配置：

1. 在 ChatGPT 桌面应用中，打开左上角的模式选择器并切换至 **Codex**.
2. 复制 **自动设置提示词** 中的内容 [外部代理访问](/docs/product-wiki-zh/ai-zhi-neng-ti/external-agent-access.md#path-a-let-your-ai-agent-configure-it-for-you) 并将其发送给 Codex。
3. Codex 将自动检测你的 ACE Studio 安装，配置 `~/.codex/config.toml`中的 MCP 服务器，并使工具同时在 Codex 和 ChatGPT Work 中可用。

<figure><img src="https://1816898227-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://1816898227-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://1816898227-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://1816898227-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://1816898227-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://1816898227-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-zh/ai-zhi-neng-ti/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.