Music Story MCP

Music Story는 원하는 에이전트(Claude, ChatGPT, Cursor, VS Code 등)에 바로 연결할 수 있는 플러그 앤 플레이 MCP 서버를 제공합니다.

고객님의 API 권한과 할당량으로 AI 어시스턴트가 Music Story 카탈로그를 조회할 수 있습니다.

서버 URL: https://mcp.music-story.com/mcp (Streamable HTTP)
인증: 메타데이터 모니터 계정으로 로그인(OAuth)하거나 보유한 API 키 사용
읽기 전용: 데이터를 수정하는 도구는 없습니다

빠른 시작

클라이언트에 서버를 추가한 다음 카탈로그에 대해 질문해 보세요.

Claude.ai / Claude Desktop
ChatGPT
Claude Code
Cursor
VS Code

설정(Settings) › 커넥터(Connectors) 를 열고 사용자 지정 커넥터 추가(Add custom connector) 를 클릭합니다.
이름을 Music Story로 지정하고 URL https://mcp.music-story.com/mcp를 입력합니다.
연결(Connect) 을 클릭한 뒤 메타데이터 모니터 계정으로 로그인하고 접근 요청을 승인합니다.

설정(Settings) › 앱 및 커넥터(Apps & Connectors) 를 열고, 요금제에서 필요한 경우 (고급 설정(Advanced settings) 의) 개발자 모드(Developer mode) 를 활성화합니다.
만들기(Create) 를 클릭하고 이름을 Music Story, URL을 https://mcp.music-story.com/mcp, 인증을 OAuth로 설정합니다.
메타데이터 모니터 계정으로 로그인하고 접근 요청을 승인합니다.

claude mcp add --transport http music-story https://mcp.music-story.com/mcp

그런 다음 Claude Code에서 /mcp를 실행하고 music-story를 선택하여 메타데이터 모니터 계정으로 로그인합니다.

로그인 대신 API 키를 사용하려면:

claude mcp add --transport http music-story https://mcp.music-story.com/mcp \
  --header "Authorization: Bearer YOUR_API_KEY"

~/.cursor/mcp.json(또는 프로젝트의 .cursor/mcp.json)에 서버를 추가합니다:

{
  "mcpServers": {
    "music-story": {
      "url": "https://mcp.music-story.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

워크스페이스의 .vscode/mcp.json에 서버를 추가합니다:

{
  "servers": {
    "music-story": {
      "type": "http",
      "url": "https://mcp.music-story.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY"
      }
    }
  }
}

API 키는 메타데이터 모니터에서 확인할 수 있습니다. 공유 파일이나 버전 관리되는 파일에는 넣지 마세요.

에이전트에게 설정 맡기기

아래 프롬프트를 복사하여 코딩 에이전트(Claude Code, Cursor 등)에게 전달하세요:

Music Story MCP 서버를 설정해 주세요.
- 서버: https://mcp.music-story.com/mcp (Streamable HTTP 전송)
- 인증: 이 클라이언트가 OAuth를 지원하면 OAuth를 사용하세요. 지원하지 않으면 제게
  Music Story API 키를 물어보고 "Authorization: Bearer <키>" 헤더로 전송하세요.
  키는 버전 관리되거나 공유되는 파일에 절대 저장하지 마세요.
- 현재 실행 중인 클라이언트(Claude Code, Cursor, VS Code 등)를 확인하고, 해당 MCP 설정에
  서버를 추가하세요.
- 연결되면 get_account_status 도구를 호출해 정상 작동하는지 확인하고, 오늘 남은 할당량을
  알려 주세요.
- 문서: https://doc.music-story.com/ko/mcp

할 수 있는 일

평소 말투로 질문하면 어시스턴트가 알맞은 도구를 알아서 선택합니다.

플레이리스트나 방송 로그를 카탈로그와 매칭하여 ISRC와 Music Story ID를 확인. "이 목록에 있는 각 곡의 ISRC를 찾아 줘: (목록 붙여넣기)"
코드나 링크 식별: ISRC, EAN/UPC, ISWC, ISNI, IPI 또는 Spotify, Deezer, Apple Music, MusicBrainz 링크. "이 ISRC는 어느 앨범에 수록되어 있어? (ISRC 붙여넣기)"
아티스트 프로필: 약력, 디스코그래피, 사진, 인기도. "Daft Punk의 간단한 프로필을 스튜디오 앨범과 함께 알려 줘."
권리 내역 분석: 작품과 녹음의 작사가, 작곡가, 퍼블리셔. "이 플레이리스트 곡들의 작사·작곡가와 퍼블리셔는? (목록 붙여넣기)"
인기도와 차트 탐색: 장르, 국가, 연도, 월별. "지금 한국에서 가장 인기 있는 록 아티스트 톱 10은?"
추천 받기: 곡이나 아티스트를 기반으로. "Daft Punk의 'Get Lucky'와 비슷한 곡 10개를 추천해 줘."

프롬프트

지원하는 클라이언트(Claude.ai, Claude Desktop 등)에서 슬래시 명령으로 표시되는 바로 사용 가능한 워크플로입니다.

프롬프트	입력	결과
`match_tracklist`	한 줄에 하나씩 "아티스트 - 제목"	각 줄의 ISRC, Music Story ID, 매칭 신뢰도를 담은 표
`rights_breakdown`	차트와 날짜, 또는 곡 목록	전체 곡에서 각 권리자(퍼블리셔, 작가)의 지분
`artist_profile`	아티스트 이름 또는 ID	신원, 경력, 스튜디오 앨범, 인기도
`identify`	ISRC, EAN/UPC, ISWC, ISNI, IPI 또는 플랫폼 링크	대상 식별 및 주요 데이터

접근, 권한 및 제한

고객님의 권한이 적용됩니다. 모든 호출에 고객님의 API 키가 사용되므로, API와 동일하게 구독 권한과 일일 할당량이 적용됩니다. 남은 할당량은 언제든지 어시스턴트에게 물어볼 수 있습니다.
구독 범위 밖의 데이터는 전체 답변을 실패시키지 않고, 누락된 옵션 이름과 함께 "사용 불가"로 표시됩니다.
목록은 10개 항목으로 제한됩니다 (답변을 간결하게 유지하기 위해). 어시스턴트에게는 각 목록의 실제 크기가 전달됩니다.
OAuth로 로그인하면 메타데이터 모니터 계정에 AI assistant (MCP) 라는 API 키가 생성됩니다. 이 키는 모든 MCP 호출에 재사용됩니다.
접근을 취소하려면 AI 클라이언트에서 OAuth 인증을 취소하세요. AI assistant (MCP) 키를 삭제하는 것만으로는 충분하지 않습니다. 인증이 유효한 동안에는 다음 호출 시 다시 생성됩니다.

도구 참조

전체 도구 (읽기 전용)

도구	기능
매칭 및 식별
`match_artist_title`	외부 아티스트/제목 쌍(플레이리스트, 방송 로그 등)을 카탈로그와 매칭
`find_by_identifier`	ISRC, EAN, ISNI, ISWC, IPI, MusicBrainz, Spotify, Deezer, Apple 등으로 엔터티 검색 (플랫폼 URL 가능)
검색
`search_artists`, `search_albums`, `search_recordings`, `search_releases`, `search_works`	전체 텍스트 검색
상세 정보
`get_artist`	아티스트 정보 (약력, 앨범, 사진, 인기도 선택 추가)
`get_album`	앨범 정보 (릴리스, 크레딧, 리뷰, 커버 아트, 오디오 설명 선택 추가)
`get_release`	릴리스 정보 및 트랙 목록
`get_recording`	녹음 정보 (ID 또는 ISRC로 조회, 릴리스, 작품, 크레딧, 오디오 설명, 가사, 인기도, 차트, 클러스터 선택 추가)
탐색
`get_recommendations`	녹음 또는 아티스트 기반 추천
`get_popularity_ranking`	아티스트 또는 녹음의 인기 순위 (장르, 국가, 연도, 월별)
`browse_charts`	차트, 차트 날짜 및 내용 탐색
`get_genre_artists`	장르의 주요 아티스트 (인기순)
참조 데이터 및 계정
`list_reference_data`	장르, 역할, 역할 카테고리, 국가, 방송 유형
`get_account_status`	오늘 남은 할당량
`api_get`	기타 API v2 엔드포인트에 대한 읽기 호출 (방송, CD TOC, 고급 페이징 등)

빠른 시작​

에이전트에게 설정 맡기기​

할 수 있는 일​

프롬프트​

접근, 권한 및 제한​