MODEL CONTEXT PROTOCOL

LabelGrid 공식 MCP 서버

Claude, Cursor 등 모든 AI 어시스턴트를 카탈로그에 연결하고, 자연어로 음원 유통을 처리하세요.

LabelGrid MCP 서버는 Model Context Protocol을 위한 LabelGrid 자체 오픈소스 커넥터입니다. Claude Desktop, Claude Code, Cursor 등 MCP를 지원하는 클라이언트를 LabelGrid 계정에 연결한 뒤, 원하는 것을 말하기만 하면 음원을 만들고 심사 상태를 확인하고 분석 데이터를 불러올 수 있습니다. 여덟 개의 툴셋으로 구성된 도구를 제공하며, LabelGrid 공개 API 위에서 가볍고 타입이 지정된 래퍼로 동작합니다.

npm에서 받기

GitHub에서 소스 보기 →

채팅 말풍선이 리본을 파형 코어로 흘려보내는 이미지 — 음원 유통을 이끄는 자연어

60초 설정

한 줄만 추가하세요. 나머지는 AI가 안내합니다.

서버는 npx로 실행되므로 내려받을 것도, 업데이트할 것도 없습니다. MCP 클라이언트 설정에 항목 하나만 추가하면 바로 연결됩니다:

{
  "mcpServers": {
    "labelgrid": {
      "command": "npx",
      "args": ["-y", "@labelgrid/mcp"],
      "env": {
        "LABELGRID_API_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

토큰 없이 서버를 시작하면 안내형 설정 모드로 전환되어, AI 어시스턴트가 계정 연결을 단계별로 안내합니다. 대시보드의 프로필 → API 토큰에서 토큰을 발급받아 설정에 넣으면, 자연어로 카탈로그를 관리하게 됩니다. 필요한 것은 Node.js 20 이상 버전뿐입니다.

API 개요 읽기

평소 말하듯이

말하면, 그대로 실행됩니다

서버가 처리하는 요청은 이런 것들입니다. 각 요청은 실제 툴셋과 연결되므로, 어시스턴트는 추측하지 않습니다. 대시보드가 쓰는 것과 같은 API를 호출할 뿐입니다.

음원 및 트랙

“제 메인 레이블로 12트랙 앨범 초안을 만들고 발매일을 다음 주 금요일로 설정해 주세요.”

AI가 음원 초안과 트랙을 생성하며, 무엇이든 나가기 전에 직접 검토할 수 있도록 준비해 둡니다.

심사 및 품질

“제 음원 Midnight Sessions가 왜 심사에서 멈춰 있나요?”

미해결 심사 이슈를 읽어 무엇을 고쳐야 하는지 정확히 알려 주고, 그 김에 선택 기능인 Stream Radar의 조기 경고 신호까지 확인할 수 있습니다.

정산 및 로열티

“지난 분기 로열티 명세서를 불러와서 레이블별로 나눠 주세요.”

명세서를 가져와 요청한 방식대로 수치를 나눠 주므로, 스프레드시트를 내보낼 필요가 없습니다.

분석

“이번 주 최신 싱글의 스트리밍을 스토어별로 보여 주세요.”

스트리밍 분석을 불러와 요청한 방식대로, 스토어별·기간별로 수치를 나눠 줍니다. 스트리밍 애널리틱스 지표 섹션 전체를 같은 방식으로 조회할 수 있고, 어떤 스토어가 어떤 지표를 지원하는지는 가용성 매트릭스가 알려 줍니다.

웹훅

“전송이 완료될 때마다 제 서버에 알림을 보내는 웹훅을 추가해 주세요.”

계정에 웹훅을 설정해 두어, 직접 운영하는 시스템이 자동으로 동기화되도록 합니다.

전송 상태

“싱글이 어떤 스토어에 게시되었고, 아직 대기 중인 것이 있나요?”

모든 전송 대상의 상태를 확인해, 게시된 것과 아직 처리 중인 것을 알려 줍니다.

호환 클라이언트

모든 MCP 클라이언트, 처음부터 끝까지 오픈소스

Claude Desktop, Claude Code, Cursor를 비롯해 Model Context Protocol을 지원하는 모든 클라이언트가 같은 방식으로 연결됩니다. 서버는 LabelGrid가 직접 만든 오픈소스이며 MIT 라이선스를 따르므로, 모든 코드를 읽고 포크하거나 이슈를 남길 수 있습니다. 개방형 표준인 Model Context Protocol 위에 만들어져, 호환되는 어시스턴트라면 무엇이든 연동할 수 있습니다. 커뮤니티가 관리하는 awesome-mcp-servers 디렉터리에 공식 서버로 등재되어 있으며, Glama의 독립적인 MCP 서버 심사에서 AAA 등급을 받았습니다.

MCP 자세히 알아보기

GitHub에서 스타 누르기 →

신뢰를 위한 설계

세 단계 권한, 기본은 모두 차단

읽기: 항상 켜짐

음원, 심사 이슈, 분석, 로열티 명세서, 전송 상태를 조회합니다. 읽기 권한은 연결할 때마다 제공되므로, 어시스턴트가 첫날부터 질문에 답할 수 있습니다.

안전한 쓰기: 기본 켜짐

음원과 트랙 초안 작성, 메타데이터 편집, 레이블·아티스트·작곡가·퍼블리셔 관리, 웹훅 설정, 스마트 링크 랜딩 페이지 제작이 여기에 속합니다. 언제든 이 기능을 끄거나 연결 전체를 읽기 전용으로 강제할 수 있습니다.

중대한 작업: 기본 꺼짐

유통 제출, 게시 중단, 그리고 되돌릴 수 없는 오디오·아트워크 업로드는 직접 켜기 전까지 비활성화된 상태로 유지됩니다. 이를 켜려면 명시적으로 동의하고 확인 문구를 직접 입력해야만 어떤 작업이든 실행됩니다.

모든 규칙과 검증은 LabelGrid 서버에서 실행되므로, AI가 계정 보호 장치를 우회하는 일은 결코 없습니다. 대시보드에 적용되는 것과 똑같은 검사가 여기에도 적용됩니다. 중대한 작업을 활성화하려면 먼저 동의한 뒤, 정확한 확인 문구 “I accept responsibility for AI-driven distribution actions”(AI 기반 유통 작업에 대한 책임을 수용합니다)를 입력해야 AI 기반 제출이나 게시 중단이 실행됩니다. 유통 제출은 여전히 주간 발매 한도에 포함됩니다.

이용 방법

LabelGrid API 이용에 포함

MCP 서버는 LabelGrid 공개 API와 통신하므로, LabelGrid API 요금제에 포함되어 있습니다. 이미 API를 이용 중이신가요? 토큰을 발급받아 오늘 바로 연결하세요. API가 처음이신가요? API 개요부터 살펴본 뒤, 잘 맞는 요금제를 선택하세요.

API 요금제 보기

API 개요 읽기 → · 개발자용 →

질문

MCP 서버 자주 묻는 질문

LabelGrid MCP 서버란 무엇인가요?

LabelGrid MCP 서버는 Model Context Protocol을 통해 AI 어시스턴트를 LabelGrid 계정에 연결하는 공식 오픈소스 커넥터입니다. 여덟 개의 툴셋으로 구성된 도구를 제공하므로, 자연어로 요청하기만 하면 음원을 만들고 심사 상태를 확인하고 분석과 로열티를 불러오고 전송을 관리할 수 있습니다. LabelGrid 공개 API 위에서 동작하는 가볍고 타입이 지정된 래퍼입니다.

Claude나 ChatGPT에게 제 스트리밍 통계를 물어볼 수 있나요?

네, MCP를 지원하는 AI 앱이라면 가능합니다. LabelGrid 공식 MCP 서버인 @labelgrid/mcp는 Claude Desktop, Claude Code, Cursor 등 MCP 호환 클라이언트를 계정에 연결해 줍니다. 스트리밍 분석, 로열티 정산서와 세부 내역을 물어보면 최신 데이터를 바탕으로 답을 받을 수 있습니다. 이용하려면 LabelGrid API 요금제, API 토큰, Node.js 20 이상이 필요합니다. 사용 중인 ChatGPT 환경이 MCP 서버에 연결되지 않는다면 내보낸 정산서를 업로드해 질문할 수는 있지만, ChatGPT가 계정 자체를 볼 수는 없습니다.

MCP(Model Context Protocol)란 무엇인가요?

Model Context Protocol은 AI 어시스턴트를 외부 도구 및 데이터와 연결하기 위한 개방형 표준입니다. MCP 서버는 AI 클라이언트가 호출할 수 있는 일련의 작업을 제공하여, Claude나 Cursor 같은 어시스턴트가 서비스를 직접 다룰 수 있게 합니다. LabelGrid는 어시스턴트가 유통 계정을 다룰 수 있도록 MCP 서버를 공개하며, 자세한 사양은 modelcontextprotocol.io에서 확인할 수 있습니다.

API 요금제가 필요한가요?

네. MCP 서버는 LabelGrid 공개 API를 통해 연결되며, 이는 LabelGrid API 요금제에 포함되어 있습니다. 이미 API를 이용 중이라면 토큰을 발급받아 바로 연결할 수 있고, 그렇지 않다면 API 개요와 요금제 페이지에서 시작할 수 있습니다.

AI가 제 승인 없이 음원을 제출하거나 내릴 수 있나요?

아니요. 유통 제출, 게시 중단, 되돌릴 수 없는 업로드는 기본적으로 꺼져 있으며, 직접 명시적으로 동의하고 AI 기반 유통 작업에 대한 책임을 수용하는 확인 문구를 입력하기 전까지 비활성화된 상태로 유지됩니다. 읽기와 안전한 초안 편집은 그 단계 없이도 사용할 수 있고, 모든 작업은 실행되기 전에 LabelGrid 서버에서 검증됩니다.

어떤 AI 어시스턴트에서 사용할 수 있나요?

Model Context Protocol을 지원하는 클라이언트라면 무엇이든 사용할 수 있으며, Claude Desktop, Claude Code, Cursor가 여기에 포함됩니다. 클라이언트 설정에 항목 하나만 추가하면 나머지는 서버가 처리하고, 토큰 없이 시작하면 설정 과정을 안내해 줍니다.

오픈소스인가요?

네. LabelGrid MCP 서버는 LabelGrid가 직접 만든 오픈소스이며 MIT 라이선스를 따릅니다. 코드는 GitHub에 있고 패키지는 npm에 @labelgrid/mcp로 게시되어 있어, 직접 살펴보고 기여하거나 이슈를 남길 수 있습니다.

지금 시작하기

메시지 한 번으로 카탈로그를 관리하세요

AI 어시스턴트를 LabelGrid에 연결하고, 자연어로 음원과 분석, 로열티를 처리하세요.

npm에서 받기

API 개요 읽기 →