AI 어시스턴트를 LabelGrid에 연결하기(MCP)

Q: LabelGrid에 MCP 서버가 있나요?

네. LabelGrid는 공식 MCP(Model Context Protocol) 서버를 npm 패키지 @labelgrid/mcp로 배포합니다. github.com/labelgrid/labelgrid-mcp에서 MIT 라이선스로 공개된 오픈 소스입니다. Claude Desktop, Claude Code, Cursor를 비롯한 MCP 호환 AI 클라이언트를 LabelGrid 계정에 연결해 자연어로 작업할 수 있습니다.

Q: AI에게 계정 관리를 맡겨도 안전한가요?

이 서버에는 세 단계의 권한 계층이 있습니다. 읽기는 언제나 가능합니다. 초안, 메타데이터, 웹훅 같은 안전한 쓰기는 기본으로 켜져 있으며 끌 수 있습니다. 배급 제출, 테이크다운, 변경 불가 파일 업로드처럼 영향이 큰 작업은 기본으로 꺼져 있고, 전체 쓰기 권한 활성화와 명시적인 확인 문구가 함께 필요합니다. 검증, 요금제 한도, 요청 속도 제한을 포함한 모든 계정 보호 장치는 LabelGrid 서버에서 적용되며 AI가 우회할 수 없습니다.

2026년 7월 업데이트.

LabelGrid는 평소 사용하는 AI 어시스턴트를 LabelGrid 계정에 연결해 자연어로 작업할 수 있도록 공식 MCP(Model Context Protocol) 서버를 배포합니다. REST 호출을 직접 작성하는 대신, 릴리스 초안을 만들고 검증하고 검수 상태를 확인하거나 애널리틱스를 불러오도록 AI에게 요청하면, AI가 내부적으로 LabelGrid API를 사용합니다.

이 서버는 npm 패키지 @labelgrid/mcp이며, github.com/labelgrid/labelgrid-mcp에서 MIT 라이선스로 공개된 오픈 소스입니다. Claude Desktop, Claude Code, Cursor를 비롯한 MCP 호환 클라이언트에서 사용할 수 있습니다.

무엇을 할 수 있나요

연결하고 나면 AI 어시스턴트에게 다음을 요청할 수 있습니다.

초안 릴리스와 트랙 생성 및 수정: 대화하면서 메타데이터를 채워 나갑니다
릴리스와 트랙에 오디오, 아트워크, 라이선스 문서 업로드
제출 전 릴리스 검증으로 문제를 미리 파악
검수 이슈, 품질 리포트, 전송 상태 확인
스트리밍 애널리틱스, 로열티 명세서, 상세 내역 조회
비동기 알림을 위한 웹훅 관리
릴리스 배급 제출 또는 테이크다운: 해당 작업을 직접 활성화한 경우에만 사용할 수 있습니다(안전과 권한 참고)

내부적으로 이 서버는 account, reference, catalog, releases, insights, finance, webhooks, distribution의 여덟 개 툴셋에 걸쳐 30개의 통합 도구를 제공합니다. 상당수 도구는 전달한 인자에 따라 대상이 정해집니다. 예를 들어 카탈로그 검색 도구 하나가 레이블, 아티스트, 작가, 퍼블리셔, 릴리스, 트랙을 모두 처리합니다. 장르, 언어, 지역 같은 참조 데이터는 MCP 리소스로도 제공됩니다. 파일 업로드는 catalog 및 distribution 툴셋에 포함되어 있습니다.

준비물

API 접근 권한이 있는 LabelGrid 계정. API 접근 권한은 LabelGrid API 요금제에 포함됩니다. 자세한 내용은 API 개요를 참고하세요.
API 토큰. LabelGrid 대시보드의 Profile → API Tokens에서 생성하세요.
AI 클라이언트를 실행하는 컴퓨터의 Node.js 20 이상.

설치

AI 클라이언트의 MCP 설정에 LabelGrid를 추가합니다.

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

your-api-token을 대시보드에서 발급받은 토큰으로 바꾼 뒤 클라이언트를 다시 시작하세요.

Claude Code에서는 명령 한 줄이면 됩니다.

claude mcp add labelgrid -e LABELGRID_API_TOKEN=your-api-token -- npx -y @labelgrid/mcp

가이드 설정 모드

토큰 없이 서버를 시작해도 실패하지 않습니다. 대신 가이드 설정 모드로 실행됩니다. LABELGRID_API_TOKEN 값 없이 클라이언트에 LabelGrid를 추가한 다음 AI에게 “LabelGrid를 설정해 줘”라고 요청하면, 토큰을 만드는 방법과 어디에 넣어야 하는지 안내해 줍니다. 토큰 자체가 대화창에 붙여넣어지는 일은 없습니다.

안전과 권한

서버는 세 단계의 권한 계층을 두어 AI가 할 수 있는 범위를 직접 정하도록 합니다.

읽기는 언제나 가능합니다. AI는 릴리스, 트랙, 검수, 애널리틱스, 명세서, 전송 상태를 언제든 조회할 수 있습니다.
안전한 쓰기는 기본으로 켜져 있습니다. 초안 생성과 편집, 메타데이터 수정, 웹훅 관리는 처음부터 사용할 수 있습니다. LABELGRID_ENABLE_WRITES=false로 끄거나, LABELGRID_READ_ONLY=true로 전체를 읽기 전용으로 강제할 수 있습니다.
영향이 큰 작업은 기본으로 꺼져 있습니다. 릴리스 배급 제출, 릴리스 테이크다운, 변경 불가 파일 업로드에는 LABELGRID_ENABLE_FULL_WRITES=true와 함께 명시적인 확인 문구가 필요하며, 해당 문구는 프로젝트 README에 안내되어 있습니다.

검증, 요금제 한도, 요청 속도 제한 등 계정 보호 장치는 모두 LabelGrid 서버에서 적용됩니다. 어떤 권한을 부여하든 AI가 이를 우회할 수는 없습니다.

사용할 도구 범위 제한하기

계정의 일부만 노출하고 싶다면 LABELGRID_TOOLSETS를 설정해 서버가 제공하는 도구 영역을 제한하세요. 이렇게 하면 AI가 선택한 영역에만 집중합니다. webhooks 툴셋은 기본으로 꺼져 있으므로, 사용하려면 LABELGRID_TOOLSETS에 추가하세요.

문제 해결

토큰이 유효하지 않거나 거부됨: 대시보드의 Profile → API Tokens에서 토큰을 다시 만들고 MCP 설정을 업데이트하세요.
“API Tokens” 페이지가 보이지 않음: 계정에 아직 API 접근 권한이 없는 것입니다. 활성화 방법은 API 개요를 참고하세요.
서버가 연결되었는지 확실하지 않음: 서버는 시작할 때 상태를 출력하므로 클라이언트의 MCP 로그를 확인하세요.
연결을 끊고 싶음: 대시보드에서 언제든 토큰을 폐기할 수 있으며, 폐기하면 모든 접근이 즉시 중단됩니다.

FAQ

”LabelGrid에 MCP 서버가 있나요?”

네. LabelGrid는 공식 MCP 서버를 npm 패키지 @labelgrid/mcp로 배포하며, github.com/labelgrid/labelgrid-mcp에서 MIT 라이선스로 공개된 오픈 소스입니다. Claude Desktop, Claude Code, Cursor를 비롯한 MCP 호환 AI 클라이언트를 LabelGrid 계정에 연결해 자연어로 작업할 수 있습니다.

”무엇을 할 수 있나요?”

초안 릴리스와 트랙 생성 및 수정, 오디오·아트워크·라이선스 문서 업로드, 제출 전 릴리스 검증, 검수 이슈와 품질 리포트 및 전송 상태 확인, 스트리밍 애널리틱스와 로열티 명세서 및 상세 내역 조회, 웹훅 관리가 가능합니다. 배급 제출과 테이크다운은 직접 활성화한 경우에만 사용할 수 있습니다.

”AI에게 계정 관리를 맡겨도 안전한가요?”

이 서버에는 세 단계의 권한 계층이 있습니다. 읽기는 언제나 가능하고, 안전한 쓰기(초안, 메타데이터, 웹훅)는 기본으로 켜져 있으며 끌 수 있습니다. 영향이 큰 작업(배급 제출, 테이크다운, 변경 불가 파일 업로드)은 기본으로 꺼져 있고, 전체 쓰기 권한 활성화와 명시적인 확인 문구가 함께 필요합니다. 검증, 요금제 한도, 요청 속도 제한 등 모든 계정 보호 장치는 LabelGrid 서버에서 적용되며 AI가 우회할 수 없습니다.

”API 요금제가 필요한가요?”

네. MCP 서버는 LabelGrid 공개 API를 통해 연결되므로 계정에 API 접근 권한이 있어야 하며, 이는 LabelGrid API 요금제에 포함됩니다. 접근 권한을 얻는 방법은 API 개요를 참고하세요.

”어떤 AI 앱을 지원하나요?”

Claude Desktop, Claude Code, Cursor를 비롯해 MCP 호환 클라이언트라면 모두 사용할 수 있습니다.

도움이 필요하세요?

MCP 서버에 대해 궁금한 점이 있으면 고객지원팀에 문의해 주세요.

아직 LabelGrid를 사용하지 않으세요?

방금 읽으신 내용은 모두 저희 플랫폼에서 이용하실 수 있어요.

LabelGrid로 할 수 있는 일 보기 →