Collega il tuo assistente IA a LabelGrid (MCP)

Aggiornato a luglio 2026.

LabelGrid pubblica un server MCP (Model Context Protocol) ufficiale con cui puoi collegare il tuo assistente IA al tuo account LabelGrid e lavorare in linguaggio naturale. Invece di scrivere chiamate REST, chiedi alla tua IA di preparare una bozza di release, validarla, controllarne lo stato di revisione o recuperare le tue analisi, e lei usa l’API di LabelGrid dietro le quinte.

Il server è il pacchetto npm @labelgrid/mcp ed è open source con licenza MIT su github.com/labelgrid/labelgrid-mcp. Funziona con Claude Desktop, Claude Code, Cursor o qualsiasi client compatibile con MCP.

Cosa puoi fare

Una volta collegato, puoi chiedere al tuo assistente IA di:

• Creare e aggiornare bozze di release e tracce — costruire i metadati in modo conversazionale
• Caricare audio, artwork e documenti di licenza sulle tue release e tracce
• Validare le release prima dell’invio per far emergere i problemi in anticipo
• Controllare segnalazioni di revisione, report di qualità e stato di consegna
• Recuperare analisi di streaming, rendiconti delle royalty e relativi dettagli
• Gestire i webhook per le notifiche asincrone
• Inviare release alla distribuzione o ritirarle — disponibile solo quando abiliti esplicitamente queste azioni (vedi Sicurezza e permessi)

Dietro le quinte, il server espone un insieme compatto di strumenti consolidati suddivisi in otto gruppi: account, riferimento, catalogo, release, analisi, finanze, webhook e distribuzione. La maggior parte degli strumenti sceglie su cosa agire in base a un argomento che indichi tu; per esempio, un unico strumento di ricerca del catalogo copre etichette, artisti, autori, editori, release e tracce. Anche i dati di riferimento, come generi, lingue e territori, sono esposti come risorse MCP. I caricamenti di file fanno parte dei gruppi catalogo e distribuzione. Il tuo client IA elenca esattamente gli strumenti che gli sono stati offerti, quindi puoi sempre vedere dal client quali sono disponibili in quel momento.

---

Cosa ti serve

1. Un account LabelGrid con accesso all’API. L’accesso all’API è incluso nei piani API di LabelGrid — consulta la panoramica dell’API per sapere come ottenerlo.
2. Un token API. Generalo dalla dashboard di LabelGrid in Profilo → API Tokens.
3. Node.js 20 o più recente sul computer che esegue il tuo client IA.

---

Installazione

Aggiungi LabelGrid alla configurazione MCP del tuo client IA:

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

Sostituisci your-api-token con il token della tua dashboard e riavvia il client.

Per Claude Code basta un solo comando:

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

Attenzione

Quel comando mette il token sulla riga di comando: la shell lo registra nella cronologia e gli altri utenti della macchina possono leggerlo dall’elenco dei processi. Cancellalo poi dalla cronologia, oppure inserisci il token nella configurazione JSON qui sopra.

---

Configurazione guidata

Se avvii il server senza token, non fallisce: parte in modalità di configurazione guidata. Aggiungi LabelGrid al tuo client senza il valore di LABELGRID_API_TOKEN, poi chiedi alla tua IA di “configurare LabelGrid”: ti guiderà nella creazione del token e ti indicherà dove inserirlo. La procedura guidata dice all’assistente di rimandarti al file di configurazione del tuo client e di non chiedere mai il token in chat: tienilo lì e non incollarlo nella conversazione, nemmeno se te lo chiede.

---

Sicurezza e permessi

Il server usa tre livelli di permessi, così sei tu a decidere quanto può fare la tua IA:

• Le letture sono sempre disponibili. La tua IA può consultare in qualsiasi momento release, tracce, revisioni, analisi, rendiconti e stato di consegna.
• Le scritture sicure sono attive per impostazione predefinita. Creare e modificare bozze, aggiornare metadati e gestire webhook sono abilitati fin dall’inizio. Puoi disattivarle con LABELGRID_ENABLE_WRITES=false, oppure forzare tutto in sola lettura con LABELGRID_READ_ONLY=true.
• Le azioni con conseguenze sono disattivate per impostazione predefinita. Inviare una release alla distribuzione, ritirarla e caricare file immutabili richiedono LABELGRID_ENABLE_FULL_WRITES=true più una frase di conferma esplicita, documentata nel README del progetto.

Tutte le protezioni del tuo account — validazione, limiti del piano e limiti di richieste — sono applicate dai server di LabelGrid. L’IA non può aggirarle, indipendentemente dai permessi che le concedi.

---

Cosa vede il tuo client IA

Il server gira sul tuo computer e parla con l’API di LabelGrid usando il tuo token. Non ha alcun collegamento con LabelGrid al di fuori delle chiamate all’API che la tua IA gli chiede di fare, e LabelGrid non riceve le tue conversazioni.

Il flusso dei dati va nella direzione opposta, e vale la pena esserne consapevoli: tutto ciò che la tua IA legge tramite il server — metadati delle release, segnalazioni di revisione, analisi, rendiconti delle royalty — viene passato al client IA che hai configurato e, da lì, al modello che quel client utilizza. Sta a te scegliere un client a cui affidare con fiducia il tuo catalogo e i dati del tuo account, e dichiarare questo flusso ovunque i tuoi accordi lo richiedano.

Due conseguenze pratiche:

• Se una parte dei tuoi dati non deve mai arrivare a un fornitore di IA, usa LABELGRID_TOOLSETS per escludere del tutto quell’area, invece di contare sul fatto che l’IA non la chieda. Uno strumento che non viene offerto non può essere richiamato.
• Anche i dati finanziari rientrano nel discorso. Il gruppo finance legge rendiconti e dettagli delle royalty: lascialo fuori, a meno che tu non voglia averli nella conversazione.

---

Limitare gli strumenti disponibili

Se vuoi esporre solo una parte del tuo account, imposta LABELGRID_TOOLSETS per limitare i gruppi di strumenti offerti dal server. Così l’IA resta concentrata sulle aree che scegli tu. Il gruppo webhooks è disattivato per impostazione predefinita; aggiungilo a LABELGRID_TOOLSETS per attivarlo.

---

Risoluzione dei problemi

• Token non valido o rifiutato — ricrea il token dalla dashboard in Profilo → API Tokens e aggiornalo nella configurazione MCP.
• Non vedi la pagina “API Tokens” — il tuo account non ha ancora l’accesso all’API. Consulta la panoramica dell’API per sapere come abilitarlo.
• Non sai se il server si è collegato — il server stampa il proprio stato all’avvio; controlla i log MCP del tuo client.
• Vuoi scollegarlo — revoca il token dalla dashboard in qualsiasi momento: tutto ciò che usa quel token, questo server compreso, smette di funzionare immediatamente. Gli altri token del tuo account non vengono toccati, quindi revoca uno per uno quelli che vuoi ritirare, e rimuovi anche il valore dalla configurazione MCP.

---

FAQ

”LabelGrid ha un server MCP?”

Sì. LabelGrid pubblica un server MCP ufficiale come pacchetto npm @labelgrid/mcp, open source con licenza MIT su github.com/labelgrid/labelgrid-mcp. Collega Claude Desktop, Claude Code, Cursor o qualsiasi client IA compatibile con MCP al tuo account LabelGrid per lavorare in linguaggio naturale.

”Cosa posso farci?”

Creare e aggiornare bozze di release e tracce; caricare audio, artwork e documenti di licenza; validare le release prima dell’invio; controllare segnalazioni di revisione, report di qualità e stato di consegna; recuperare analisi di streaming, rendiconti delle royalty e relativi dettagli; e gestire i webhook. L’invio alla distribuzione e i ritiri sono disponibili solo quando li abiliti esplicitamente.

”È sicuro lasciare che un’IA gestisca il mio account?”

Il server ha tre livelli di permessi. Le letture sono sempre disponibili; le scritture sicure (bozze, metadati, webhook) sono attive per impostazione predefinita e possono essere disattivate; le azioni con conseguenze (invio alla distribuzione, ritiri, caricamenti di file immutabili) sono disattivate per impostazione predefinita e richiedono di abilitare le scritture complete più una conferma esplicita. Tutte le protezioni dell’account — validazione, limiti del piano, limiti di richieste — sono applicate dai server di LabelGrid e l’IA non può aggirarle.

I permessi regolano ciò che l’IA può fare. Valuta a parte ciò che può vedere: tutto quello che legge tramite il server arriva al tuo client IA e al modello che ci sta dietro. Vedi Cosa vede il tuo client IA.

”Serve un piano API?”

Sì. Il server MCP passa dall’API pubblica di LabelGrid, quindi il tuo account deve avere l’accesso all’API, incluso nei piani API di LabelGrid. Consulta la panoramica dell’API per sapere come ottenerlo.

”Quali app di IA sono supportate?”

Qualsiasi client compatibile con MCP, tra cui Claude Desktop, Claude Code e Cursor.

---

Correlati

• Panoramica dell’API — come ottenere l’accesso all’API e autenticarsi
• Strumento da riga di comando di LabelGrid (CLI) — le stesse azioni dal tuo terminale o da uno script
• Webhook — notifiche asincrone degli eventi
• @labelgrid/mcp su npm
• labelgrid-mcp su GitHub

---

Serve aiuto?

Per domande sul server MCP, contatta il nostro team di assistenza.