# 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.0** 2. 환경설정에서 다음을 확인하세요: **General → MCP Server** **서버 주소:** `http://localhost:21572/mcp` > **기술 노트**: ACE Studio MCP 서버는 **스트리밍 가능한 HTTP 전송 프로토콜**를 사용합니다. 다음 구성 단계에서 이 주소를 보관하세요. ### MCP 서버를 AI 클라이언트에 연결하기 사용 중인 AI 클라이언트에 따라 적절한 구성 방법을 선택하세요: #### **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** 여기를 클릭하여 MCP 서버를 Cursor에 직접 추가할 수 있습니다 [여기](https://cursor.com/en-US/install-mcp?name=ACE-Studio\&config=eyJ1cmwiOiJodHRwOi8vbG9jYWxob3N0OjIxNTcyL21jcCJ9). 또는 수동 설정: 1. Cursor 설정 열기 2. "Tools & MCP" 섹션 찾기 3. "New MCP Server" 클릭 4. 다음 JSON을 입력하세요: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` 5. "Save" 클릭 6. Cursor 재시작 **연결 확인:**\ Cursor 채팅에 입력: ``` @acestudio 현재 프로젝트에 어떤 트랙이 있나요? ``` *** #### **VS Code (네이티브 MCP 지원을 통해)** 여기를 클릭하여 MCP 서버를 VS Code에 직접 추가할 수 있습니다 [여기](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. Cline 또는 Roo Cline 확장 설치 2. 확장 설정 열기 3. MCP Servers 구성 섹션 찾기 4. 새 서버 추가: ```json "mcp": { "servers": { "ACE-Studio": { "type": "http", "url": "http://localhost:21572/mcp", "headers": {} } } } ``` *** #### **VS Code (Cline / Roo Code를 통해)** 1. Cline 또는 Roo Code 확장 설치 2. 확장 설정 열기 3. MCP Servers 구성 섹션 찾기 4. 새 서버 추가: {% tabs %} {% tab title="Cline" %} ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamableHttp", "headers": {} } } } ``` {% endtab %} {% tab title="Roo Code" %} ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "type": "streamable-http", "headers": {} } } } ``` {% endtab %} {% endtabs %} *** #### **기타 클라이언트 / AI 챗봇** 대부분의 클라이언트의 경우**,** 다음 구성 설정을 사용하세요: * **전송 유형:** 스트리밍 가능한 HTTP (일부 클라이언트에서는 이를 "Remote"라고 부를 수 있습니다) * **서버 URL:** `http://localhost:21572/mcp` 또는 다음 JSON을 통해 MCP 서버를 가져오세요: ```json { "mcpServers": { "ACE-Studio": { "url": "http://localhost:21572/mcp", "headers": {} } } } ``` {% hint style="info" %} 참고: ACE Studio는 스트리밍 가능한 HTTP 전송을 요구하며 기존의 HTTP + SSE 프로토콜이나 MCP 버전 2024-11-05는 지원하지 않습니다. {% endhint %} ## 사용 예시 연결 후 다음 프롬프트를 시도하여 AI 어시스턴트와 협업할 수 있습니다: #### 새 프로젝트 만들기 ``` ACE Studio에서 BPM 120의 팝 스타일 새 프로젝트를 만들어 주세요, C장조로 설정하고, 리드 보컬 트랙과 바이올린 반주 트랙을 추가해 주세요 ``` #### 가사 및 멜로디 생성 ``` 주제 "바닷가의 여름 기억"을 바탕으로, ACE Studio에서 8마디 분량의 후렴 구간을 작성해 주세요. 멜로디는 가볍고 경쾌하게, 오선 음계가 아닌 펜타토닉 음계를 사용하세요 ``` #### MIDI 편집 
ACE Studio에서 9-16마디에 피아노 코드 진행을 추가하세요:
C - Am - F - G, 각 코드가 2마디씩 지속됩니다