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 più di 80 strumenti suddivisi in dieci gruppi: identità, dati di riferimento, catalogo (etichette, artisti, autori ed editori), release e tracce, revisione e qualità, analisi, contabilità e royalty, stato di consegna, webhook e distribuzione. I caricamenti di file fanno parte dei gruppi catalogo e distribuzione.

---

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

---

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. Il token in sé non viene mai incollato nella chat.

---

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.

---

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.

---

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 — puoi revocare un token in qualsiasi momento dalla dashboard: l’accesso si interrompe immediatamente.

---

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.

”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
• 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.