外部代理访问

通过 MCP 和 CLI 将 ACE Studio 连接到 AI 助手和智能代理。

实验性状态

ACE Studio 中的外部代理访问目前处于实验阶段，并正在积极开发中。

请注意：

• 重大变更： 工具命令、格式和约定可能会在更新之间发生变化。

• 开发中： 目前并非所有 ACE Studio 功能都可被代理完全访问。

• 待完善之处： 在我们优化代理交互的过程中，您可能会遇到漏洞、意外的边界情况或不自然的行为。

如果您遇到问题或有建议，请告诉我们， [e-mail].

将 AI 助手和代理（如 Claude、ChatGPT、OpenClaw 或 Hermes Agent）直接连接到 ACE Studio，以便实时理解并编辑您的音乐工程。

您的代理可以做什么

连接后，代理即可在 ACE Studio 的大部分功能中检查并编辑您的工程：

• 编曲与作曲 — 管理轨道、片段、音符、歌词、和弦以及播放头。

• 歌声与乐器 — 调整声线模型、音源、多歌手合唱层，以及人声参数（音高、呼吸、张力）。

• 时序与结构 — 设置 BPM、拍号、循环段标记和走带。

• 制作与 AI 工具 — 触发添加层、人声转 MIDI、音轨分离、音乐增强器，并加载 FX 链或预设。

• 会话控制与交付 — 创建并保存工程，导入音频和 MIDI，并导出完整混音、单独 Stem、视频等更多内容。

只需用通俗语言描述你的需求，助手就会检查工程并进行相应更改。

---

正在连接您的助手

选择适合您工作流程的设置方式：

路径 A：让你的 AI 智能体为你配置

如果您使用具有本地环境或计算机访问权限的代理（例如 Claude Code, Codex, OpenClaw，或 Hermes Agent），它可以自动进行配置。

此路径需要在与 ACE Studio 相同的电脑上运行一个代理，并具备执行命令和编辑其配置文件的权限。

将此提示复制并粘贴到你的代理中，然后点击发送：

请使用 acestudio-cli 或 MCP 为我连接 ACE Studio。

默认位置：
- 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"

先尝试使用 CLI，并将工具路径记入你的指令/记忆中。如果由于沙箱或权限限制而无法访问 CLI，请注册 MCP 服务器（名称为“ace-studio”，作用域为用户/全局）。如果在默认位置找不到，请向我索取 ACE Studio 的偏好设置 → 常规 → 外部代理访问中的路径。

如果你需要了解 ACE Studio 及其代理集成的更多背景信息，请参阅 https://docs.acestudio.ai/llms.txt 中的文档。如果你的运行环境无法自行配置或执行本地命令，请引导我完成你平台上的手动设置步骤。

---

路径 B：在你的运行环境中手动配置

如果你的 agent harness 无法自动配置，则需要将 ACE Studio 的 MCP 服务器手动添加到其配置中。

模型上下文协议（MCP） 是一项开放标准，用于将 AI 助手连接到外部应用程序。ACE Studio 作为本地 STDIO 服务器运行，允许任何兼容 MCP 的客户端通过启动命令直接连接。

通过终端配置

如果你使用 Claude 或 Codex，并希望直接从终端进行配置：

Claude

在你的终端中运行：

macOS：

claude mcp add --scope user ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"

Windows：

claude mcp add --scope user ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe"

Codex

在你的终端中运行：

macOS：

codex mcp add ace-studio -- "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"

Windows：

codex mcp add ace-studio -- "C:\Program Files\ACE Studio\ace-mcp-server.exe"

桌面聊天应用

如需带配置演示的完整分步指南：

• Claude Desktop 与 Cowork — 面向 Claude Desktop 的分步配置，并附配置文件演示。

• 桌面版 ChatGPT — ChatGPT Work 和 Codex 模式的分步设置。

其他宿主和 IDE（VS Code、Cursor、自定义客户端）

大多数 MCP 客户端和 IDE 都会要求相同的配置参数：

• 走带类型： STDIO（有时标记为“Local”或“Command”）

• 命令： 从 ACE Studio 复制的启动命令

• 参数 / 环境： 无

对于通过 JSON 文件配置的宿主：

标准 MCP 配置（Cursor 等）

由 Cursor 使用（~/.cursor/mcp.json 或 .cursor/mcp.json）以及大多数标准 MCP 宿主：

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

VS Code（GitHub Copilot）

添加到 .vscode/mcp.json 在你的项目工作区中：

{
  "servers": {
    "ace-studio": {
      "type": "stdio",
      "command": "/Applications/ACE Studio.app/Contents/Helpers/ace-mcp-server"
    }
  }
}

JSON 中的 Windows 路径转义： 如果你在 JSON 文件中手动编写 Windows 路径，请将每个反斜杠转义为双反斜杠（\\），或者使用正斜杠（/).

基于浏览器的 AI 助手： ACE Studio 的 MCP 服务器通过 STDIO 在你的机器上本地运行。仅限网页的界面（例如在网页浏览器中的 ChatGPT 或 Claude）无法直接连接到本地 STDIO 服务器。请改用各自的桌面应用或终端客户端。

自定义安装路径： 如果你将 ACE Studio 安装到自定义目录，请打开 偏好设置 → 常规 → 外部代理访问 在 ACE Studio 中：

• 单击 复制命令 旁边的 MCP 服务器（stdio） 用于 MCP 服务器路径。

• 单击 复制 旁边的 acestudio-cli 二进制文件路径 用于 CLI 路径。

---

正在验证连接

请确保 ACE Studio 已打开并正在运行，然后让你的助手执行：

请检查当前 ACE Studio 工程信息

如果你的助手返回了工程的曲速、调号和轨道列表，则说明你的设置已完成并可正常使用。

---

创作提示示例

以下是一些在 ACE Studio 中与 AI 助手协作的真实示例：

1. 人声制作与多歌手和声

在主人人声轨道（轨道 1）上开启合唱模式，添加两条和声歌手
声线，拓宽立体声声场，并将其电平降低 -3 dB，打造丰满的背景和声。

2. 自定义声音混合

在轨道 2 上创建自定义混合声线：混合 70% 温暖的原声流行种子
与 30% 空灵、气声的声线种子，然后将该混合声线命名为“丝绒气声”。

3. 和弦与歌曲草稿编写

在和弦轨道的第 1–8 小节中，插入一段 Neo-Soul 和弦进行：
Ebmaj9 — G7#9 — Cm9 — F13（每个和弦 2 小节）。
然后添加一条 Rhodes 钢琴轨道，以及一条遵循根音的律动贝斯线。

4. AI 伴奏与音频提取

将导入的音频片段在轨道 1 上分割为人声、鼓、贝斯和其他 Stem。
然后在提取的人声音轨上运行人声到 MIDI，以创建一个可编辑的 Sing 轨道。

5. 生成式歌曲创意与分层

聆听从第9小节到第25小节的编曲，并使用添加层生成
与当前工程曲速相匹配的电影感弦乐铺底伴奏层。

6. 富有表现力的人声调音与动态

检查 轨道 1 上的合唱人声音符：平滑音高过渡，
在起始音符上增加气声，并在延音音符上添加一条细微的颤音曲线。

7. FX 链与音轨交付

加载复古人声压缩器和温暖的板式混响到主唱人声 FX 链上，
然后将所有单独轨道导出为 24 位 48kHz WAV Stem，保存到我桌面上的“Stem”文件夹。