Conecte o seu assistente de IA à LabelGrid (MCP)

Atualizado em julho de 2026.

A LabelGrid publica um servidor MCP (Model Context Protocol) oficial para você conectar o seu próprio assistente de IA à sua conta LabelGrid e trabalhar em linguagem natural. Em vez de escrever chamadas REST, você pede à sua IA para criar o rascunho de um lançamento, validá-lo, consultar o status da revisão ou puxar os seus analytics, e ela usa a API da LabelGrid nos bastidores.

O servidor é o pacote npm @labelgrid/mcp e é de código aberto sob a licença MIT em github.com/labelgrid/labelgrid-mcp. Ele funciona com o Claude Desktop, o Claude Code, o Cursor ou qualquer cliente compatível com MCP.

O que dá para fazer

Depois de conectado, você pode pedir ao seu assistente de IA para:

• Criar e atualizar rascunhos de lançamentos e faixas — montar os metadados conversando
• Enviar áudio, arte e documentos de licença para os seus lançamentos e faixas
• Validar lançamentos antes do envio para que os problemas apareçam cedo
• Consultar problemas de revisão, relatórios de qualidade e status de entrega
• Puxar analytics de streaming, extratos de royalties e detalhamentos
• Gerenciar webhooks para notificações assíncronas
• Enviar lançamentos para distribuição ou tirá-los do ar — disponível somente quando você habilita essas ações explicitamente (veja Segurança e permissões)

Nos bastidores, o servidor expõe um conjunto enxuto de ferramentas consolidadas em oito conjuntos: account, reference, catalog, releases, insights, finance, webhooks e distribution. Muitas ferramentas decidem sobre o que agir a partir de um argumento que você fornece: uma única ferramenta de busca no catálogo, por exemplo, cobre selos, artistas, compositores, editoras, lançamentos e faixas. Dados de referência como gêneros, idiomas e territórios também são expostos como recursos MCP. Os uploads de arquivos fazem parte dos conjuntos catalog e distribution. O seu cliente de IA lista exatamente quais ferramentas foram oferecidas a ele, então você sempre consegue ver de dentro do cliente o que está disponível no momento.

---

O que você precisa ter

1. Uma conta LabelGrid com acesso à API. O acesso à API faz parte dos planos de API da LabelGrid: veja a Visão geral da API para saber como obtê-lo.
2. Um token de API. Gere um no seu painel da LabelGrid em Profile → API Tokens.
3. Node.js 20 ou mais recente no computador que executa o seu cliente de IA.

---

Instalação

Adicione a LabelGrid à configuração MCP do seu cliente de IA:

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

Substitua your-api-token pelo token do seu painel e reinicie o cliente.

No Claude Code, basta um comando:

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

Cuidado

Esse comando coloca o token na linha de comando: o shell o grava no histórico e outros usuários da máquina conseguem lê-lo na lista de processos. Apague-o do histórico depois ou, em vez disso, coloque o token na configuração JSON acima.

---

Configuração guiada

Se você iniciar o servidor sem um token, ele não falha: entra em um modo de configuração guiada. Adicione a LabelGrid ao seu cliente sem o valor de LABELGRID_API_TOKEN, depois peça à sua IA para “configurar a LabelGrid” e ela conduz você pela criação do token e por onde colocá-lo. O fluxo de configuração instrui o assistente a mandar você até o arquivo de configuração do seu cliente e a nunca pedir o token no chat: mantenha-o lá e não cole o token na conversa, mesmo que peçam.

---

Segurança e permissões

O servidor usa três níveis de permissão, para que você decida até onde a sua IA pode ir:

• As leituras estão sempre disponíveis. A sua IA pode consultar lançamentos, faixas, revisões, analytics, extratos e status de entrega a qualquer momento.
• As gravações seguras vêm ativadas por padrão. Criar e editar rascunhos, atualizar metadados e gerenciar webhooks já vêm habilitados. Você pode desativá-los com LABELGRID_ENABLE_WRITES=false ou forçar tudo para somente leitura com LABELGRID_READ_ONLY=true.
• As ações de maior impacto vêm desativadas por padrão. Enviar um lançamento para distribuição, tirar um lançamento do ar e fazer uploads de arquivos imutáveis exigem LABELGRID_ENABLE_FULL_WRITES=true mais uma frase de confirmação explícita, documentada no README do projeto.

Todas as proteções da sua conta (validação, limites do plano e limites de taxa) são aplicadas pelos servidores da LabelGrid. A IA não consegue contorná-las, sejam quais forem as permissões que você conceder.

---

O que o seu cliente de IA vê

O servidor roda na sua própria máquina e conversa com a API da LabelGrid usando o seu token. Ele não tem nenhuma ligação com a LabelGrid além das chamadas de API que a sua IA pede para fazer, e a LabelGrid não recebe as suas conversas.

O fluxo de dados corre no sentido contrário, e vale a pena pensar nisso com calma: tudo o que a sua IA lê pelo servidor — metadados de lançamentos, problemas de revisão, analytics, extratos de royalties — é repassado ao cliente de IA que você configurou e, dali, ao modelo que esse cliente usa. Escolher um cliente a quem você confie o seu catálogo e os dados da sua conta, e informar esse fluxo sempre que os seus próprios contratos exigirem, é responsabilidade sua.

Duas consequências práticas:

• Se alguma parte dos seus dados nunca deve chegar a um provedor de IA, use LABELGRID_TOOLSETS para deixar essa área totalmente de fora, em vez de contar com a IA não pedir por ela. Uma ferramenta que não é oferecida não tem como ser chamada.
• Os dados financeiros também fazem parte disso. O conjunto finance lê extratos e detalhamentos de royalties, então deixe-o de fora a menos que você queira isso na conversa.

---

Limitar quais ferramentas ficam disponíveis

Se você quiser expor apenas parte da sua conta, defina LABELGRID_TOOLSETS para limitar quais áreas de ferramentas o servidor oferece. Isso mantém a IA concentrada nas áreas que você escolheu. O conjunto webhooks vem desativado por padrão: acrescente-o a LABELGRID_TOOLSETS para ativá-lo.

---

Solução de problemas

• Token inválido ou recusado — recrie o token no seu painel em Profile → API Tokens e atualize-o na sua configuração MCP.
• A página “API Tokens” não aparece — a sua conta ainda não tem acesso à API. Veja a Visão geral da API para saber como habilitá-lo.
• Não tem certeza de que o servidor conectou — o servidor imprime o seu status ao iniciar, então confira os logs de MCP do seu cliente.
• Você quer desconectar — revogue o token no seu painel a qualquer momento. Isso interrompe na hora tudo o que usa esse token, inclusive este servidor. Os outros tokens da sua conta não são afetados, então revogue um a um os que você quiser aposentar e remova também o valor da sua configuração MCP.

---

Perguntas frequentes

”A LabelGrid tem um servidor MCP?”

Tem. A LabelGrid publica um servidor MCP oficial como o pacote npm @labelgrid/mcp, de código aberto sob a licença MIT em github.com/labelgrid/labelgrid-mcp. Ele conecta o Claude Desktop, o Claude Code, o Cursor ou qualquer cliente de IA compatível com MCP à sua conta LabelGrid, para você trabalhar em linguagem natural.

”O que dá para fazer com ele?”

Criar e atualizar rascunhos de lançamentos e faixas; enviar áudio, arte e documentos de licença; validar lançamentos antes do envio; consultar problemas de revisão, relatórios de qualidade e status de entrega; puxar analytics de streaming, extratos de royalties e detalhamentos; e gerenciar webhooks. Enviar lançamentos para distribuição e tirá-los do ar só ficam disponíveis quando você habilita essas ações explicitamente.

”É seguro deixar uma IA gerenciar a minha conta?”

O servidor tem três níveis de permissão. As leituras estão sempre disponíveis; as gravações seguras (rascunhos, metadados, webhooks) vêm ativadas por padrão e podem ser desativadas; e as ações de maior impacto (envio para distribuição, takedowns, uploads de arquivos imutáveis) vêm desativadas por padrão e exigem que você habilite as gravações completas mais uma confirmação explícita. Todas as proteções da conta (validação, limites do plano, limites de taxa) são aplicadas pelos servidores da LabelGrid e não podem ser contornadas pela IA.

As permissões definem o que a IA pode fazer. Pense separadamente no que ela pode ver: tudo o que ela lê pelo servidor chega ao seu cliente de IA e ao modelo por trás dele. Veja O que o seu cliente de IA vê.

”Preciso de um plano de API?”

Precisa. O servidor MCP se conecta pela API pública da LabelGrid, então a sua conta precisa de acesso à API, que faz parte dos planos de API da LabelGrid. Veja a Visão geral da API para saber como obter acesso.

”Quais aplicativos de IA são compatíveis?”

Qualquer cliente compatível com MCP, incluindo o Claude Desktop, o Claude Code e o Cursor.

---

Relacionados

• Visão geral da API — como obter acesso à API e fazer a autenticação
• Ferramenta de linha de comando da LabelGrid (CLI) — as mesmas ações pelo seu terminal ou por um script
• Webhooks — notificações assíncronas de eventos
• @labelgrid/mcp no npm
• labelgrid-mcp no GitHub

---

Precisa de ajuda?

Se você tiver dúvidas sobre o servidor MCP, fale com a nossa equipe de suporte.