> 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 서버**. 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. 다음 항목을 찾습니다: **도구 및 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 서버 구성 섹션을 찾습니다. 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. 다음 항목을 찾습니다: **도구 및 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 서버 구성 섹션을 찾습니다. 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.