MODEL CONTEXT PROTOCOL
LabelGrid 공식 MCP 서버
Claude, Cursor 등 모든 AI 어시스턴트를 카탈로그에 연결하고, 자연어로 음원 유통을 처리하세요.
LabelGrid MCP 서버는 Model Context Protocol을 위한 LabelGrid 자체 오픈소스 커넥터입니다. Claude Desktop, Claude Code, Cursor 등 MCP를 지원하는 클라이언트를 LabelGrid 계정에 연결한 뒤, 원하는 것을 말하기만 하면 음원을 만들고 심사 상태를 확인하고 분석 데이터를 불러올 수 있습니다. 여덟 개의 툴셋에 걸쳐 30개의 도구를 제공하며, LabelGrid 공개 API 위에서 가볍고 타입이 지정된 래퍼로 동작합니다.
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를 호출할 뿐입니다.
음원 및 트랙
“제 메인 레이블로 12트랙 앨범 초안을 만들고 발매일을 다음 주 금요일로 설정해 주세요.”
AI가 음원 초안과 트랙을 생성하며, 무엇이든 나가기 전에 직접 검토할 수 있도록 준비해 둡니다.
심사 및 품질
“제 음원 Midnight Sessions가 왜 심사에서 멈춰 있나요?”
미해결 심사 이슈를 읽어 무엇을 고쳐야 하는지 정확히 알려 주고, 그 김에 선택 기능인 Stream Radar의 조기 경고 신호까지 확인할 수 있습니다.
정산 및 로열티
“지난 분기 로열티 명세서를 불러와서 레이블별로 나눠 주세요.”
명세서를 가져와 요청한 방식대로 수치를 나눠 주므로, 스프레드시트를 내보낼 필요가 없습니다.
분석
“이번 주 최신 싱글의 스트리밍을 스토어별로 보여 주세요.”
스트리밍 분석을 불러와 요청한 방식대로, 스토어별·기간별로 수치를 나눠 줍니다. 37개 스트리밍 애널리틱스 지표 섹션 전체를 같은 방식으로 조회할 수 있고, 어떤 스토어가 어떤 지표를 지원하는지는 가용성 매트릭스가 알려 줍니다.
웹훅
“전송이 완료될 때마다 제 서버에 알림을 보내는 웹훅을 추가해 주세요.”
계정에 웹훅을 설정해 두어, 직접 운영하는 시스템이 자동으로 동기화되도록 합니다.
전송 상태
“싱글이 어떤 스토어에 게시되었고, 아직 대기 중인 것이 있나요?”
모든 전송 대상의 상태를 확인해, 게시된 것과 아직 처리 중인 것을 알려 줍니다.
호환 클라이언트
모든 MCP 클라이언트, 처음부터 끝까지 오픈소스
Claude Desktop, Claude Code, Cursor를 비롯해 Model Context Protocol을 지원하는 모든 클라이언트가 같은 방식으로 연결됩니다. 서버는 LabelGrid가 직접 만든 오픈소스이며 MIT 라이선스를 따르므로, 모든 코드를 읽고 포크하거나 이슈를 남길 수 있습니다. 개방형 표준인 Model Context Protocol 위에 만들어져, 호환되는 어시스턴트라면 무엇이든 연동할 수 있습니다. 커뮤니티가 관리하는 awesome-mcp-servers 디렉터리에 공식 서버로 등재되어 있으며, Glama의 독립적인 MCP 서버 심사에서 AAA 등급을 받았습니다.
신뢰를 위한 설계
세 단계 권한, 기본은 모두 차단
읽기: 항상 켜짐
음원, 심사 이슈, 분석, 로열티 명세서, 전송 상태를 조회합니다. 읽기 권한은 연결할 때마다 제공되므로, 어시스턴트가 첫날부터 질문에 답할 수 있습니다.
안전한 쓰기: 기본 켜짐
음원과 트랙 초안 작성, 메타데이터 편집, 레이블·아티스트·작곡가·퍼블리셔 관리, 웹훅 설정, 스마트 링크 랜딩 페이지 제작이 여기에 속합니다. 언제든 이 기능을 끄거나 연결 전체를 읽기 전용으로 강제할 수 있습니다.
중대한 작업: 기본 꺼짐
유통 제출, 게시 중단, 그리고 되돌릴 수 없는 오디오·아트워크 업로드는 직접 켜기 전까지 비활성화된 상태로 유지됩니다. 이를 켜려면 명시적으로 동의하고 확인 문구를 직접 입력해야만 어떤 작업이든 실행됩니다.
모든 규칙과 검증은 LabelGrid 서버에서 실행되므로, AI가 계정 보호 장치를 우회하는 일은 결코 없습니다. 대시보드에 적용되는 것과 똑같은 검사가 여기에도 적용됩니다. 중대한 작업을 활성화하려면 먼저 동의한 뒤, 정확한 확인 문구 “I accept responsibility for AI-driven distribution actions”(AI 기반 유통 작업에 대한 책임을 수용합니다)를 입력해야 AI 기반 제출이나 게시 중단이 실행됩니다. 유통 제출은 여전히 주간 발매 한도에 포함됩니다.
이용 방법
LabelGrid API 이용에 포함
MCP 서버는 LabelGrid 공개 API와 통신하므로, LabelGrid API 요금제에 포함되어 있습니다. 이미 API를 이용 중이신가요? 토큰을 발급받아 오늘 바로 연결하세요. API가 처음이신가요? API 개요부터 살펴본 뒤, 잘 맞는 요금제를 선택하세요.
질문