Claude · Codex · Gemini CLI
음악 라이브러리 MCP 서버
Claude 또는 Codex를 MyMusik에 연결하세요. AI로 태그, 폴더, 재생목록을 관리하고 재생을 제어하며, 트랙을 자르고 음악을 가져오거나 내보낼 수 있습니다.

Insights에서 Claude 또는 Codex 연결하기
처음 연결할 때는 에이전트에게 라이브러리의 앨범 세 개를 알려 달라고 한 뒤 MyMusik의 앨범 화면에서 결과를 확인하세요.
- MyMusik을 열고 Insights(/insights)로 이동하여 '기기 연결'을 찾으세요.
- 방패 아이콘을 선택하고 권한과 접근 기간을 설정한 뒤 '적용'을 선택하세요. 라이브러리를 먼저 살펴보려면 '읽기 전용'으로 시작하는 것이 좋습니다.
- '에이전트 프롬프트 복사'(작은 화면에서는 'AI 에이전트')를 선택하세요. 복사할 때마다 새 일회용 초대가 생성됩니다.
- mymusik-mcp pair를 실행하고 #grant=가 포함된 초대 URL만 붙여 넣으세요.
- MyMusik 라이브러리에서 앨범 세 개를 보여 달라고 요청하세요.
MyMusik을 실행한 상태로 두세요. 에이전트에는 MCP 또는 HTTP 도구와 앱에 연결할 수 있는 네트워크가 필요합니다.
AI로 음악 앱 제어하기
트랙 찾기, 컬렉션 정리, 오디오 편집, 음악 감상까지 전체 작업 흐름에 AI를 활용하세요. MyMusik의 음악 MCP 서버는 선택한 권한에 따라 에이전트가 앱 작업에 접근할 수 있게 합니다. 원하는 결과를 설명하면 에이전트가 여러 작업을 조합하여 처리할 수 있습니다.
이는 요청 예시이며, 자동으로 실행되는 작업이나 보장된 선곡 결과가 아닙니다. 변경 전에 확인하고 싶다면 제안된 변경 사항을 먼저 보여 달라고 요청하세요. 연결로 실제 수행할 수 있는 작업은 권한에 따라 결정됩니다.
페이지를 일일이 열지 않고 음악 찾기
“내 라이브러리에서 [artist]의 앨범을 찾아 트랙을 보여 줘.” 에이전트가 곡, 앨범, 아티스트, 재생목록, 앱에서 관리하는 폴더를 검색하고 선택을 도울 수 있습니다.
작업하면서 계속 음악 듣기
“[playlist]를 재생하고, 내가 요청하면 일시 정지해 줘.” 재생 권한이 있으면 대화를 이어 가는 동안 에이전트가 플레이어와 대기열을 조작할 수 있습니다.
대화로 재생목록 만들기
“이 아티스트들의 곡 중에서 12곡을 추천해 줘. 선택한 곡을 보여 주고, 내가 승인하면 '업무일'로 저장해 줘.” 라이브러리 편집 권한으로 에이전트가 트랙을 모아 재생목록을 만들도록 하세요.
라이브러리 전체의 태그 관리하기
“이 곡과 앨범에 '자동차 여행' 태그를 추가해 줘. 기존 태그는 유지해 줘.” 지원되는 음악 항목에 라이브러리 태그를 만들고, 이름을 바꾸고, 지정하거나 제거할 수 있습니다. 자신만의 분류에 맞게 컬렉션을 정리하세요.
중첩 폴더 만들고 정리하기
“'자동차 여행' 폴더를 만들고 그 안에 '여름' 하위 폴더를 만든 다음, 이 앨범들을 추가해 줘.” 앱 폴더와 항목을 만들고 이름을 바꾸거나 이동할 수 있습니다. 이 폴더는 라이브러리 참조를 정리하며, 원본 파일은 그대로 유지됩니다.
트랙과 앨범 정보 업데이트하기
“앨범 이름이 잘못된 트랙을 보여 주고, 내가 승인한 수정 사항을 적용해 줘.” 지원되는 라이브러리 메타데이터를 편집하여 컬렉션 전체의 이름을 일관되게 유지하세요.
AI로 음악 가져오기, 자르기, 내보내기
에이전트에 음악 작업 전체를 맡기고 앱의 가져오기, 오디오 편집, 내보내기 도구로 처리하게 하세요. 에이전트는 작업 진행 상황을 확인하고 대화에서 결과를 알려 줄 수 있습니다.
'사용자 지정 접근'에서 전체 작업에 필요한 리소스 그룹을 선택하세요. 예를 들어 오디오를 편집하고 곡을 만들려면 '가져오기 및 파일'과 '음악 라이브러리' 권한이 모두 필요할 수 있습니다. 앱과 에이전트는 결과 파일을 저장하거나 다운로드하는 기능도 지원해야 합니다.
음악을 가져오고 진행 상황 확인하기
“이 폴더의 오디오를 가져오고 결과를 확인한 뒤, 어떤 트랙을 살펴봐야 하는지 알려 줘.” 읽을 수 있는 파일, 폴더 또는 지원되는 오디오 URL을 사용하세요. MyMusik을 실행하는 기기에서 원본에 접근할 수 있어야 합니다. 트랙이 자동으로 수락되는지 검토가 필요한지는 가져오기 설정에 따라 결정됩니다.
트랙 자르기, 다듬기, 추출하기
“이 트랙의 00:30부터 01:00까지를 별도 곡으로 추출하고 원본은 유지해 줘.” 정확한 시간 범위를 지정하여 구간을 제거하거나 해당 구간으로 새 트랙을 만들 수 있습니다. 오디오를 편집하려면 유효한 범위와 편집 가능한 로컬 오디오가 필요합니다.
재생목록과 음악 컬렉션 내보내기
“이 재생목록을 M3U8로 내보내고 트랙을 ZIP으로 묶어 줘.” 재생목록 참조를 내보내거나 앨범, 재생목록, 라이브러리 폴더의 곡을 태그가 포함된 MP3 오디오로 묶을 수 있습니다. ZIP 내보내기는 최대 1,000개 트랙을 지원하며, 내보낼 수 있는 오디오가 필요합니다. M3U8 파일은 미디어 위치를 참조하므로 다른 곳에서 사용하려면 해당 파일이나 URL에 접근할 수 있어야 합니다.
허용할 접근 범위 선택하기
연결 카드의 방패 아이콘을 사용하여 작업에 맞는 접근 권한을 설정하세요. 앱은 작업을 실행할 때 세션의 권한을 확인합니다.
선택을 변경해도 기존 세션은 바뀌지 않습니다. 새 AI 프롬프트를 복사하고 새 초대로 다시 연결하세요. 프롬프트는 앱에 대한 비공개 접근 정보로 취급하고, 신뢰하는 에이전트와만 공유하세요.
읽기 전용
변경을 허용하지 않고 접근 가능한 라이브러리 정보를 살펴보고 요약합니다. 연결을 확인하고 계획을 논의할 때 이 권한으로 시작하세요.
원격 재생
음악 감상에 필요한 플레이어와 대기열 제어를 허용합니다. 이 사전 설정은 공개 API 전체의 읽기 접근 권한도 부여합니다.
라이브러리 편집기
트랙, 앨범, 아티스트, 재생목록, 태그, 앱 폴더에 대한 지원되는 변경을 허용합니다. 컬렉션 정리와 라이브러리 정보 업데이트에 사용하세요.
가져오기 관리자
가져오기, 오디오 편집, 압축 파일, 파일에 대한 작업을 허용합니다. 라이브러리 항목도 변경하는 작업 흐름에는 추가 '음악 라이브러리' 권한이 필요할 수 있습니다.
사용자 지정 접근
'재생', '음악 라이브러리', '가져오기 및 파일' 리소스 그룹에 작업에 필요한 접근 수준을 조합하세요. 그러면 하나의 에이전트가 앱의 여러 기능에 걸친 작업 흐름을 수행할 수 있습니다.
MCP를 활용한 AI 음악 라이브러리 관리
MCP는 Model Context Protocol의 약자입니다. MyMusik은 문서화된 앱 작업을 에이전트가 찾아 사용할 수 있는 도구로 제공합니다. 에이전트는 요청과 관련된 제어 기능을 찾아보고 앱에서 결과를 받을 수 있습니다.
앱 제어는 접근 권한 범위에서 공개된 API 작업에 한정됩니다. 컴퓨터의 마우스와 키보드를 전반적으로 제어하는 기능은 제공하지 않습니다.
수동 설정 줄이기
복사한 프롬프트에는 초대, 연결 안내, 권한, 복구 절차가 포함됩니다. 음악 작업마다 별도의 연동 기능을 작성할 필요가 없습니다.
작업을 위한 여유 확보
에이전트는 필요한 작업 세부 정보와 결과 필드만 가져오고, 큰 결과는 페이지 단위로 살펴볼 수 있습니다. 전체 API 카탈로그를 대화에 불러오지 않아도 됩니다.
적용하기 전에 요청 확인하기
MCP 서버는 제안된 API 요청을 실행하지 않고 검증할 수 있습니다. 인수와 적용되는 접근 규칙을 확인하며, 실제 작업을 실행할 때도 해당 작업 자체의 검사가 수행됩니다.
앱에 도달할 수 있는 연결 유지하기
가장 간단한 구성은 MyMusik과 같은 컴퓨터에서 에이전트를 실행하는 것입니다. 원격 에이전트에는 실행 중인 앱에 도달할 수 있는 네트워크 경로도 필요합니다.
- 로컬 네트워크의 다른 기기에서 연결하려면 '설정 → 웹 서버 → 원격 접근 허용'을 확인하세요. 연결 구성을 변경한 뒤에는 새 프롬프트를 복사하세요.
- 클라우드 샌드박스에서 실행되는 에이전트는 컴퓨터의 localhost에 자동으로 접근할 수 없습니다. 에이전트를 로컬에서 실행하거나 접근 가능한 연결을 마련하세요. 복사한 프롬프트에는 네트워크 안내가 포함되어 있습니다.
- 초대가 만료되었거나 이미 사용되었다면 새 AI 프롬프트를 복사하세요. MyMusik이 종료되었거나 일시 중단되었다면 다시 연 후 시도하세요.
알아 두면 좋은 내용
AI 에이전트가 앱 전체를 제어할 수 있나요?
라이브러리 정리, 태그, 폴더, 재생목록, 재생, 가져오기, 오디오 편집, 내보내기 등 MyMusik이 공개한 앱 기능 전반을 사용할 수 있습니다. 사용 가능한 작업은 설치된 버전, 플랫폼, 연결 권한에 따라 달라집니다. 에이전트는 앱의 API로 작업을 수행하므로 화면을 하나씩 클릭할 필요가 없습니다.
모든 Codex 또는 Claude 환경에서 작동하나요?
에이전트에는 사용 가능한 MCP 또는 HTTP 도구, 연결할 권한, 앱에 대한 네트워크 접근이 필요합니다. 텍스트 전용 채팅에 프롬프트를 붙여 넣는 것만으로는 연결되지 않습니다. 음악 작업을 맡기기 전에 에이전트에 접근을 확인해 달라고 요청하세요.
표준 MCP 클라이언트를 사용할 수 있나요?
네. 페어링한 뒤 클라이언트가 mymusik-mcp stdio를 실행하도록 설정하세요.
MyMusik에 내장된 AI 음성 기능과 같은 건가요?
이 연결은 직접 선택한 외부 에이전트가 MyMusik과 작업할 수 있게 합니다. 앱 내 AI 음성 기능에는 별도의 설정이 있습니다. 외부 에이전트의 계정, 모델, 결제 요건은 그대로 적용되며, AI 기반 앱 작업에도 서비스 접근 권한이 필요할 수 있습니다.
음악 앱이나 에이전트를 계속 열어 두어야 하나요?
MyMusik의 네이티브 서버는 계속 실행 중이며 접근 가능한 상태여야 합니다. 앱을 종료하거나 일시 중단하면 접근이 중단됩니다. 세션에는 만료 시간이 있으며, 다시 연결할 때 새 초대가 필요할 수 있습니다. 연결을 종료해도 앱에서 이미 시작한 작업이 반드시 취소되는 것은 아닙니다.
에이전트는 어떤 정보를 볼 수 있나요?
세션에서 허용한 앱 데이터를 요청할 수 있습니다. 해당 데이터는 사용 중인 에이전트와 모델 제공업체가 처리합니다. '읽기 전용'은 쓰기를 막지만 데이터 읽기는 여전히 허용합니다. 필요에 따라 범위를 좁힌 사용자 지정 권한을 선택하고, 초대와 세션 인증 정보를 비공개로 유지하세요.


