For the complete documentation index, see llms.txt. This page is also available as Markdown.

外部代理访问

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

实验状态

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

你的代理可以做什么

连接后,代理即可在 ACE Studio 的大部分功能中查看并编辑你的工程:

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

  • 歌声与乐器 — 调整声线模型、音源、多歌手合唱层和人声参数(音高、呼吸、张力),并加载第三方乐器插件。

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

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

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

只需用自然语言描述您的需求,您的助手便会检查工程并进行更改。


连接您的助手

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

路径 A:让您的 AI 代理为您完成配置

如果您使用可访问本地环境或计算机的代理(例如 Claude Code, Codex, OpenClaw,或 Hermes Agent),它可以自动配置。

此方式需要在与 ACE Studio 同一台电脑上运行的代理,并授予其执行命令和编辑配置文件的权限。

最快的方法是在 ACE Studio 内完成。点击 代理图标 在窗口右下角,选择 ChatGPT, Claude,或 其他代理,并按照所示的三个步骤操作:打开你的代理,复制连接提示,其中包含 复制 按钮并发送,然后使用其中一个示例提示开始创建。

这里也复现了相同的连接提示。将其复制并粘贴到你的代理中,然后点击发送:


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

如果你的代理运行环境无法自动配置,你需要将 ACE Studio 的 MCP 服务器手动添加到其配置中。

模型上下文协议(MCP) 是一种连接 AI 助手与外部应用程序的开放标准。ACE Studio 作为本地 STDIO 服务器运行,允许任何兼容 MCP 的客户端使用启动命令直接连接。

通过终端配置

如果你使用 Claude 或 Codex,并偏好直接在终端中配置:

在终端中运行:

macOS:

Windows:

在终端中运行:

macOS:

Windows:

桌面聊天应用

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

其他运行环境与 IDE(VS Code、Cursor、自定义客户端)

大多数 MCP 客户端和 IDE 需要相同的配置参数:

  • 走带类型: STDIO(有时标记为“Local”或“Command”)

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

  • 参数 / 环境: 无

对于通过 JSON 文件配置的运行环境:

供 Cursor 使用(~/.cursor/mcp.json 或 .cursor/mcp.json)以及大多数标准 MCP 运行环境:

添加到 .vscode/mcp.json 在你的工程工作区中:

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

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

  • 点击 复制命令 旁边 MCP 服务器(stdio) 用于 MCP 服务器路径。

  • 点击 复制 旁边 acestudio-cli 可执行文件路径 用于 CLI 路径。


正在验证连接

请确保 ACE Studio 已打开并正在运行,然后向你的助手询问:

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


创意提示示例

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

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

2. 自定义声音混合

3. 和弦与歌曲草稿创作

4. AI 伴奏与音频提取

5. 生成式歌曲创意与层

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

7. FX 链与音轨交付

最后更新于