Apresentamos o servidor MCP da LabelGrid: conecte o Claude, o Cursor ou qualquer assistente de IA à sua distribuição musical

Hoje lançamos o servidor MCP oficial da LabelGrid: uma forma de conectar o seu próprio assistente de IA à sua conta da LabelGrid e conduzir sua distribuição musical apenas pedindo o que você quer. Aponte o Claude Desktop, o Claude Code, o Cursor ou qualquer outro cliente do Model Context Protocol para a sua conta e você pode preparar um lançamento, perguntar por que um deles está travado na revisão, obter os royalties do último trimestre ou verificar em quais plataformas um single ficou disponível, tudo em linguagem natural. Ele é próprio da LabelGrid, é de código aberto sob a licença MIT e já está no ar no npm como @labelgrid/mcp.

Se você já desejou poder conversar com o backend da sua distribuição do mesmo jeito que conversa com um colega, é exatamente isso. A seguir, o que é de fato o Model Context Protocol, tudo o que o servidor pode fazer, como conectá-lo em cerca de um minuto e a parte que mais nos importa: o modelo de segurança que mantém o assistente de IA firmemente dentro das barreiras de proteção que a sua conta já tem.

O que é o Model Context Protocol, em termos simples

O Model Context Protocol, geralmente abreviado como MCP, é um padrão aberto para conectar assistentes de IA a ferramentas e dados externos. Sozinho, um assistente só pode raciocinar e escrever texto. O MCP lhe dá um conjunto de ações concretas que ele pode invocar, publicadas por um servidor, para que possa realizar trabalho real contra um sistema real em vez de descrever o que você poderia fazer. Um servidor MCP, em outras palavras, é a ponte entre o assistente e um serviço.

O servidor MCP da LabelGrid é essa ponte para a sua conta de distribuição. Ele expõe as operações da LabelGrid a qualquer assistente compatível com o protocolo e é construído como uma camada fina e tipada sobre a mesma API pública contra a qual os desenvolvedores já constroem. Não há nada de novo por trás e nenhuma regra nova é inventada. Quando o seu assistente pede ao servidor para criar um lançamento, o servidor chama a API pública da LabelGrid, e a API valida a solicitação exatamente como faria para qualquer outro cliente. Você pode ler a especificação do protocolo em modelcontextprotocol.io.

O que o servidor pode fazer

As ferramentas do servidor são agrupadas por área em conjuntos de ferramentas e, juntas, alcançam a maior parte do que você faz no painel. Em vez de listar cada ferramenta, aqui está a forma geral, área por área, com o tipo de pedido que cada uma atende.

• Identidade e conta. «Com qual conta estou conectado e com quais gravadoras posso trabalhar?» O assistente confirma a conta e o escopo antes de tocar em qualquer coisa.
• Dados de referência. «Liste os gêneros e os idiomas que posso definir em um lançamento», para que os valores que você usa sejam os que a plataforma realmente aceita.
• Catálogo. Crie e gerencie gravadoras, artistas, compositores e editoras: «Adicione um novo artista chamado Neon Harbor e defina a mim como compositor.»
• Lançamentos e faixas. «Prepare um álbum de doze faixas com a minha gravadora principal e defina a data de lançamento para a próxima sexta-feira.» O rascunho é criado para você revisar, nada é enviado.
• Revisão e qualidade. «Valide este lançamento e me diga o que está impedindo que ele passe na revisão», e o assistente lê os problemas em aberto e informa o que corrigir. Ele também pode ler os alertas antecipados opcionais do Stream Radar, então você pode perguntar se algo incomum foi detectado nos seus streams.
• Análises. «Mostre os streams do meu último single por plataforma nesta semana», detalhados do jeito que você pediu, por plataforma e por período.
• Contabilidade e royalties. «Extraia o extrato de royalties do último trimestre e detalhe-o por gravadora», com as divisões aplicadas do jeito que você pediu.
• Status de entrega. «Em quais plataformas o single ficou disponível e há algo ainda pendente?»
• Webhooks. «Adicione um webhook que avise o meu servidor sempre que uma entrega for concluída», para que os seus próprios sistemas se mantenham sincronizados.

E, quando você ativa, a distribuição. O servidor pode enviar um lançamento para distribuição, remover um e fazer o upload do áudio e da arte finalizados, mas, como os arquivos finalizados são imutáveis e um envio vai para o mundo, essas ações ficam atrás de uma barreira explícita à qual voltaremos em um instante. As páginas de destino com smart links também estão cobertas, então um pedido como «crie uma página de destino para o novo single» tem o seu lugar. A ideia dos dez conjuntos de ferramentas é que a camada de linguagem natural não é uma fachada de demonstração sobre alguns endpoints: ela alcança o trabalho real de gerenciar um catálogo.

Configuração em sessenta segundos: adicione uma linha e sua IA faz o resto

O servidor roda com npx, então não há nada para baixar nem manter atualizado. Você precisa do Node.js 20 ou mais recente e adiciona uma única entrada à configuração do seu cliente MCP:

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

E aqui vem a melhor parte. Se você iniciar o servidor sem um token, ele não falha com um erro: entra em um modo de configuração guiada e o seu assistente acompanha você na conexão da sua conta, um passo de cada vez. Então a versão honesta da instalação é esta: adicione uma linha e a sua IA cuida do resto. Quando estiver pronto, gere um token em Perfil e depois Tokens de API no seu painel, coloque-o na configuração e você estará trabalhando seu catálogo em linguagem natural.

O modelo de segurança: três níveis, fechados por padrão

Entregar a um assistente de IA as chaves de uma conta de distribuição só é uma boa ideia se essas chaves forem moldadas com cuidado. É aqui que investimos mais esforço de design, então vale a pena percorrer. O servidor agrupa cada ação em três níveis de permissão, e o conjunto todo é fechado por padrão: se um nível não estiver habilitado, suas ações simplesmente não estão disponíveis.

As leituras estão sempre ativas. Consultar lançamentos, problemas de revisão, análises, extratos de royalties e status de entrega não traz risco de alterar nada, então o seu assistente pode responder perguntas desde a primeira conexão. As escritas seguras estão ativadas por padrão, mas você mantém o controle sobre elas: preparar rascunhos de lançamentos e faixas, editar metadados, gerenciar gravadoras, artistas, compositores e editoras, configurar webhooks e criar páginas de destino entram todas aqui. Você pode desativá-las, ou forçar toda a conexão para somente leitura, quando quiser.

As ações de consequência são o terceiro nível, e estão desativadas por padrão. O envio para distribuição, as remoções e os uploads imutáveis de áudio e arte permanecem desativados até que você os ative de forma deliberada. Ativá-los não é um interruptor que você aciona por acidente: exige uma ativação explícita e uma confirmação por escrito. Antes que qualquer envio ou remoção conduzidos por IA possa ser executado, você confirma com a frase exata «I accept responsibility for AI-driven distribution actions» (assumo a responsabilidade pelas ações de distribuição conduzidas por IA). Essa frase cumpre uma função real: transforma as ações de maior impacto em uma escolha consciente, não em algo predeterminado.

Duas coisas sustentam os três níveis. Primeiro, cada regra e validação é executada nos servidores da LabelGrid, então a IA nunca pode contornar as proteções da sua conta. Os mesmos controles que detectam um ISRC incorreto ou um campo ausente no painel os detectam aqui, porque é a mesma API fazendo a checagem. Segundo, os envios para distribuição continuam contando para os seus limites semanais de lançamentos, exatamente como quando você envia manualmente. O assistente é uma forma mais rápida de operar a plataforma, não uma maneira de driblar suas regras.

Código aberto, e para quem é

O servidor é próprio da LabelGrid e de código aberto sob a licença MIT. O código está em github.com/labelgrid/labelgrid-mcp e o pacote está no npm como @labelgrid/mcp, então você pode ler cada linha, fazer um fork, integrá-lo ao seu próprio fluxo de trabalho ou abrir uma issue se algo estiver errado. Construí-lo de forma aberta nos pareceu o certo para uma ferramenta que fica tão próxima do seu catálogo: você deve poder ver exatamente o que ela faz antes de apontá-la para a sua conta.

Como o servidor se comunica com a API pública da LabelGrid, ele está disponível nos planos de API da LabelGrid. Se você já tem acesso à API, pode gerar um token e se conectar hoje mesmo. Se está chegando à API pela primeira vez, a introdução à API no centro de ajuda é o lugar para começar, e você pode comparar as opções na página de preços. Desenvolvedores que quiserem conhecer a parte de REST e sandbox por trás disso podem ler as páginas da API de distribuição e para desenvolvedores.

É esse o lançamento. Uma linha na sua configuração, uma configuração guiada que conecta a sua conta e um modelo de permissões feito para que um assistente de IA possa ajudar sem nunca sair das regras da sua conta. Estamos ansiosos para ver o que as pessoas vão construir com ele, então, se você experimentar, conte para a gente o que faz com ele.

Perguntas frequentes