외부 에이전트 액세스

MCP 및 CLI를 통해 ACE Studio를 AI 어시스턴트 및 에이전트에 연결하세요.

실험적 상태

ACE Studio의 외부 에이전트 액세스는 현재 실험 단계이며 활발히 개발 중입니다.

다음 사항을 참고하세요:

• 중단적 변경 사항: 도구 명령, 형식, 규칙은 업데이트 간에 변경될 수 있습니다.

• 개발 중: 아직 ACE Studio의 모든 기능을 에이전트가 완전히 사용할 수 있는 것은 아닙니다.

• 미세한 거친 부분: 에이전트 상호작용을 다듬는 과정에서 버그, 예상치 못한 엣지 케이스, 또는 부자연스러운 동작을 만날 수 있습니다.

문제가 발생하거나 제안이 있다면 다음으로 알려주세요. [e-mail].

Claude, ChatGPT, OpenClaw, Hermes Agent와 같은 AI 어시스턴트와 에이전트를 ACE Studio에 직접 연결해, 음악 프로젝트를 실시간으로 이해하고 편집할 수 있습니다.

에이전트가 할 수 있는 작업

연결이 완료되면 에이전트는 ACE Studio의 대부분 기능에서 프로젝트를 검사하고 편집할 수 있습니다:

• 편곡 및 작곡 — 트랙, 클립, 노트, 가사, 코드, 재생 헤드를 관리합니다.

• 보컬 및 악기 — 음성 모델, 사운드 소스, 다중 가수 합唱단 레이어, 보컬 매개변수(피치, 숨, 긴장)를 조정합니다.

• 타이밍 및 구조 — BPM, 박자표, 루프 마커, 트랜스포트를 설정합니다.

• 프로덕션 및 AI 도구 — 레이어 추가, 보컬 to MIDI, 스템 분리기, Music Enhancer를 실행하고 FX 체인 또는 프리셋을 불러옵니다.

• 세션 제어 및 전달 — 프로젝트를 생성하고 저장하며, 오디오와 MIDI를 가져오고, 전체 믹스다운, 개별 스템, 비디오 등을 내보냅니다.

원하는 내용을 평이한 언어로 설명하기만 하면, 어시스턴트가 프로젝트를 검사하고 변경 사항을 적용합니다.

---

어시스턴트 연결

워크플로에 맞는 설정 방법을 선택하세요:

경로 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: 하니스에서 수동으로 구성

에이전트 하니스가 자동으로 자체 구성할 수 없다면, 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)에서 합창단 모드를 켜고, 두 명의 백킹 싱어를 추가하세요
음성을 추가하고 스테레오 스프레드를 넓힌 다음, 풍성한 배경 하모니를 위해 레벨을 -3dB로 낮추세요.

2. 맞춤형 음성 혼합

트랙 2에서 맞춤형 혼합 보이스를 만드세요. 따뜻한 어쿠스틱 팝 시드 70%를 믹스하고
에어리한 브레시 보이스 시드 30%와 섞은 후, 블렌드 이름을 "Velvet 에어"로 지정하세요.

3. 코드 및 송 초안 작성

코드 트랙의 마디 1–8에 Neo-Soul 진행을 삽입하세요:
Ebmaj9 — G7#9 — Cm9 — F13(각 2마디).
그런 다음 Rhodes 피아노 트랙과 루트 음을 따르는 그루비한 베이스라인을 추가하세요.

4. AI 반주 및 오디오 추출

트랙 1의 가져온 오디오 클립을 보컬, 드럼, 베이스 및 기타 스템으로 분할합니다.
그런 다음 추출한 보컬 스템에서 보컬 to MIDI를 실행해 편집 가능한 Sing 트랙을 만듭니다.

5. 생성형 곡 아이디어 및 레이어

9바부터 25바까지 편곡을 들으며 레이어 추가를 사용해 생성
현재 프로젝트 템포에 맞는 시네마틱 스트링 패드 반주 레이어를.

6. 표현력 있는 보컬 튜닝 및 다이내믹

트랙 1의 코러스 보컬 노트를 확인합니다: 피치 전환을 부드럽게 다듬고,
진입 노트의 숨소리감을 높이고, 지속 노트에는 은은한 비브라토 곡선을 추가합니다.

7. FX 체인 및 스템 전달

빈티지 보컬 컴프레서와 따뜻한 플레이트 리버브를 리드 보컬 FX 체인에 로드하고,
그런 다음 모든 개별 트랙을 24비트 48kHz WAV 스템으로 내보내 내 데스크톱의 "스템" 폴더에 저장합니다.