# ACE Studio MCP 서버

## ACE Studio MCP 서버

{% hint style="warning" %}

#### 실험 상태

ACE Studio MCP 서버는 현재 **실험적 단계**.

**참고하세요:**

* 일부 기능과 설정은 아직 완전히 구현되지 않았을 수 있습니다
* 기능과 동작은 변경될 수 있습니다
* 사용 중 버그나 성능 문제가 발생할 수 있습니다
* 안정 버전이 출시되면 사용 지침과 사용 제한이 안내될 예정입니다

현재 이 기능을 적극적으로 개선하고 있습니다. 의견이 있거나 문제가 발생하면 다음으로 문의해 주세요. [**support@acestudio.ai**](mailto:support@acestudio.ai).
{% endhint %}

ACE Studio MCP 서버는 AI 에이전트가 창의적인 편집 작업을 자율적으로 탐색하고 실행할 수 있게 해주는 풍부한 툴킷을 제공합니다. 프로젝트의 모든 세부 정보를 AI 에이전트에 종합적으로 제공함으로써, 더 빠르고 더 큰 창작 자유로 곡을 만들고 편집하는 데 도움을 줍니다.

[모델 컨텍스트 프로토콜](https://modelcontextprotocol.io/docs/getting-started/intro) (MCP)는 AI 어시스턴트가 외부 애플리케이션 및 데이터 소스와 원활하게 연결할 수 있게 해주는 공개 표준입니다. ACE Studio MCP 서버는 이 프로토콜을 구현하여 AI 에이전트가 창작 작업 공간에 직접 접근할 수 있도록 합니다.

### 빠른 시작

#### ACE Studio MCP 서버 실행

1. 열기 **ACE Studio**.
2. 다음으로 이동: **환경설정 → 일반 → MCP 서버**.
3. 트랜스포트 모드를 선택하세요: **HTTP** 또는 **STDIO**.

> 여기서 선택한 트랜스포트 모드에 따라 AI 클라이언트가 ACE Studio에 연결하는 방식이 결정됩니다. 자세한 내용과 클라이언트별 설정은 아래 섹션을 참조하세요.

선택한 트랜스포트 모드와 AI 클라이언트에 맞게 적절한 구성을 선택하세요.

#### 스트리밍 가능 HTTP 모드

HTTP 모드에서는 ACE Studio가 고정 주소에서 로컬 MCP 서버를 실행합니다. AI 클라이언트는 네트워크를 통해 이 서버에 연결합니다.

**서버 주소:** `http://localhost:21572/mcp`

> **기술 참고**: ACE Studio MCP 서버는 **스트리밍 가능 HTTP 트랜스포트 프로토콜**을 사용합니다. 다음 설정 단계에서 이 주소를 보관해 두세요.

**Claude Desktop**

> ⚠ Claude Desktop에서 ACE Studio MCP 서버를 설정하려면 JSON 구성 파일을 수정해야 합니다. 기술적 설정에 익숙하지 않다면, 더 사용하기 쉬운 클라이언트를 사용해 보시길 권장합니다.

**설정 단계:**

1. 필요한 경우 Node.js를 설치하세요.
   * 다음을 방문하세요 [nodejs.org](https://nodejs.org) 에서 LTS 버전을 다운로드하세요.
2. Claude Desktop 설정 파일을 찾습니다.
   * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
   * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
3. 설정 파일을 편집하고 다음 내용을 추가하세요:

```json
{
   "mcpServers": {
       "acestudio": {
           "command": "npx",
           "args": [
               "mcp-remote",
               "http://localhost:21572/mcp"
           ]
       }
   }
}
```

4. 파일을 저장하고 Claude Desktop을 다시 시작하세요.

**연결 확인:**\
Claude에 다음을 입력하세요:

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

Claude가 프로젝트 세부 정보를 반환하면 연결이 성공한 것입니다.

**Cursor**

다음을 클릭하면 Cursor에 MCP 서버를 직접 추가할 수 있습니다 [여기](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9).

또는 수동으로 설정하세요:

1. Cursor 설정을 엽니다.
2. 다음을 찾습니다 **Tools & MCP** 섹션을 찾습니다.
3. 다음을 클릭합니다 **새 MCP 서버**.
4. 다음 JSON을 입력하세요:

```json
{
 "mcpServers": {
   "ACE-Studio": {
     "url": "http://localhost:21572/mcp",
     "headers": {}
   }
 }
}
```

5. 다음을 클릭합니다 **저장**.
6. Cursor를 다시 시작하세요.

**연결 확인:**\
Cursor Chat에 다음을 입력하세요:

```
@acestudio 현재 프로젝트에 어떤 트랙이 있나요?
```

**기본 MCP 지원을 통한 VS Code**

다음을 클릭하면 VS Code에 MCP 서버를 직접 추가할 수 있습니다 [여기](https://insiders.vscode.dev/redirect?url=vscode%3Amcp%2Finstall%3F%7B%22name%22%3A%22acestudio%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22http%3A%2F%2Flocalhost%3A21572%2Fmcp%22%7D).

또는 수동으로 설정하세요:

1. 다음을 만들거나 편집하세요 `.vscode/mcp.json` 워크스페이스에서.
2. 다음 구성을 추가하세요:

```json
{
 "servers": {
   "ACE-Studio": {
     "type": "http",
     "url": "http://localhost:21572/mcp"
   }
 }
}
```

**Cline을 통한 VS Code**

1. Cline 확장 프로그램을 설치하세요.
2. 확장 프로그램 설정을 엽니다.
3. MCP Servers 구성 섹션을 찾습니다.
4. 새 서버를 추가하세요:

```json
{
 "mcpServers": {
   "ACE-Studio": {
     "url": "http://localhost:21572/mcp",
     "type": "streamableHttp",
     "headers": {}
   }
 }
}
```

**기타 클라이언트**

대부분의 클라이언트에서는 다음 구성 설정을 사용하세요:

* **트랜스포트 유형:** 스트리밍 가능 HTTP. 일부 클라이언트에서는 이를 `원격`.
* **서버 URL:** `http://localhost:21572/mcp`

또는 다음 JSON으로 MCP 서버를 가져오세요:

```json
{
 "mcpServers": {
   "ACE-Studio": {
     "url": "http://localhost:21572/mcp",
     "headers": {}
   }
 }
}
```

#### STDIO 모드

STDIO 모드에서는 AI 클라이언트가 표준 입력과 출력을 통해 직접 ACE Studio MCP 서버를 실행하고 통신합니다. 설정이 더 간단합니다. 서버를 수동으로 시작하거나 네트워크 주소를 사용할 필요가 없습니다.

**명령 가져오기:**

1. ACE Studio에서 **환경설정 → 일반 → MCP 서버**.
2. 모드를 다음으로 설정하세요 **STDIO**.
3. 다음을 클릭합니다 **명령 복사** 를 사용해 서버 명령을 클립보드에 복사합니다.

복사된 명령은 다음과 같이 표시됩니다:

```
"/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server" --stdio
```

아래 설정 단계에서 이 명령을 사용하세요.

{% hint style="info" %}
명령 경로는 운영 체제에 따라 다릅니다. 아래의 모든 클라이언트 설정에서는 ACE Studio에서 복사한 정확한 명령을 사용하세요.
{% endhint %}

**Claude Desktop**

STDIO는 Claude Desktop의 기본 트랜스포트입니다. 다음과 같은 추가 도구는 필요하지 않습니다 `mcp-remote`.

1. Claude Desktop 설정 파일을 찾습니다.
   * **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
   * **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
2. 설정 파일을 편집하고 다음 내용을 추가하세요:

```json
{
   "mcpServers": {
       "acestudio": {
           "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server",
           "args": ["--stdio"]
       }
   }
}
```

3. 파일을 저장하고 Claude Desktop을 다시 시작하세요.

**연결 확인:**\
Claude에 다음을 입력하세요:

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

Claude가 프로젝트 세부 정보를 반환하면 연결이 성공한 것입니다.

**Cursor**

1. Cursor 설정을 엽니다.
2. 다음을 찾습니다 **Tools & MCP** 섹션을 찾습니다.
3. 다음을 클릭합니다 **새 MCP 서버**.
4. 다음 JSON을 입력하세요:

```json
{
 "mcpServers": {
   "ACE-Studio": {
     "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server",
     "args": ["--stdio"]
   }
 }
}
```

5. 다음을 클릭합니다 **저장**.
6. Cursor를 다시 시작하세요.

**연결 확인:**\
Cursor Chat에 다음을 입력하세요:

```
@acestudio 현재 프로젝트에 어떤 트랙이 있나요?
```

**기본 MCP 지원을 통한 VS Code**

1. 다음을 만들거나 편집하세요 `.vscode/mcp.json` 워크스페이스에서.
2. 다음 구성을 추가하세요:

```json
{
 "servers": {
   "ACE-Studio": {
     "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server",
     "args": ["--stdio"]
   }
 }
}
```

**Cline을 통한 VS Code**

1. Cline 확장 프로그램을 설치하세요.
2. 확장 프로그램 설정을 엽니다.
3. MCP Servers 구성 섹션을 찾습니다.
4. 새 서버를 추가하세요:

```json
{
 "mcpServers": {
   "ACE-Studio": {
     "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server",
     "args": ["--stdio"]
   }
 }
}
```

**기타 클라이언트**

대부분의 클라이언트에서는 다음 구성 설정을 사용하세요:

* **트랜스포트 유형:** STDIO
* **명령:** `/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server`
* **인수:** `--stdio`

또는 다음 JSON으로 MCP 서버를 가져오세요:

```json
{
 "mcpServers": {
   "ACE-Studio": {
     "command": "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server",
     "args": ["--stdio"]
   }
 }
}
```

### 사용 예시

연결이 완료되면 AI 어시스턴트와 협업하기 위해 다음 프롬프트를 시도해 볼 수 있습니다:

#### 새 프로젝트 만들기

```
ACE Studio에서 BPM 120의 새로운 팝 스타일 프로젝트를 만들도록 도와주세요,
C장조로 설정하고 리드 보컬 트랙과 바이올린 반주 트랙을 추가해 주세요
```

#### 가사와 멜로디 생성

```
"바닷가의 여름 추억"을 주제로
ACE Studio에서 8마디 후렴구를 작성해 주세요.
멜로디는 경쾌하고 생동감 있게, 펜타토닉 음계를 사용해 주세요
```

#### MIDI 편집

```
ACE Studio에서 9-16마디에 피아노 코드 진행을 추가하세요:
C - Am - F - G, 각 코드는 2마디씩 유지
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.acestudio.ai/docs/product-wiki-ko/ai-3/ace-studio-mcp.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.