> For the complete documentation index, see [llms.txt](https://docs.acestudio.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.acestudio.ai/docs/product-wiki-ko/ai-3/ace-studio-mcp-server.md). # 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 Server**. 3. 트랜스포트 모드를 선택하세요: **HTTP** 또는 **STDIO**. > 여기서 선택한 트랜스포트 모드에 따라 AI 클라이언트가 ACE Studio에 연결하는 방식이 결정됩니다. 자세한 내용과 클라이언트별 설정은 아래 섹션을 참조하세요. 선택한 트랜스포트 모드와 AI 클라이언트에 맞는 설정을 선택하세요. #### Streamable HTTP 모드 HTTP 모드에서는 ACE Studio가 고정 주소에서 로컬 MCP 서버를 실행합니다. AI 클라이언트는 네트워크를 통해 이에 연결합니다. **서버 주소:** `http://localhost:21572/mcp` > **기술 참고**: ACE Studio MCP 서버는 **Streamable 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. 다음을 찾습니다 **도구 & 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": {} } } } ``` **기타 클라이언트** 대부분의 클라이언트에서는 다음 구성 설정을 사용하세요: * **트랜스포트 유형:** Streamable 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 Server**. 2. 모드를 다음으로 설정하세요: **STDIO**. 3. 메인 툴바에서 **명령 복사** 서버 명령을 클립보드에 복사합니다. 복사된 명령은 다음과 같습니다: ``` "/Applications/ACE Studio.app/Contents/Helpers/ace_mcp_server" --stdio ``` 아래 설정 단계에서 이 명령을 사용하세요. {% hint style="info" %} 명령 경로는 OS마다 다릅니다. 아래의 모든 클라이언트 설정에는 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. 다음을 찾습니다 **도구 & 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 This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://docs.acestudio.ai/docs/product-wiki-ko/ai-3/ace-studio-mcp-server.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.