Presentiamo il server MCP di LabelGrid: collega Claude, Cursor o qualsiasi assistente IA alla tua distribuzione musicale

Oggi rilasciamo il server MCP ufficiale di LabelGrid: un modo per collegare il tuo assistente IA al tuo account LabelGrid e gestire la distribuzione musicale semplicemente chiedendo ciò che ti serve. Punta Claude Desktop, Claude Code, Cursor o qualsiasi altro client del Model Context Protocol al tuo account e potrai preparare una pubblicazione, chiedere perché una è bloccata in revisione, ottenere le royalty dell’ultimo trimestre o controllare su quali piattaforme è uscito un singolo, tutto in linguaggio naturale. È ufficiale, è open source con licenza MIT ed è già disponibile su npm come @labelgrid/mcp.

Se hai mai desiderato di poter parlare con il backend della tua distribuzione come parli con un collega, è proprio questo. Qui sotto trovi che cos’è davvero il Model Context Protocol, tutto ciò che il server può fare, come collegarlo in circa un minuto e la parte che ci sta più a cuore: il modello di sicurezza che tiene un assistente IA ben dentro le barriere di protezione che il tuo account ha già.

Che cos’è il Model Context Protocol, in parole semplici

Il Model Context Protocol, spesso abbreviato in MCP, è uno standard aperto per collegare gli assistenti IA a strumenti e dati esterni. Da solo, un assistente può soltanto ragionare e scrivere testo. MCP gli dà un insieme di azioni concrete che può invocare, pubblicate da un server, così può svolgere un lavoro reale su un sistema reale invece di descrivere ciò che potresti fare. Un server MCP, in altre parole, è il ponte tra l’assistente e un servizio.

Il server MCP di LabelGrid è quel ponte per il tuo account di distribuzione. Espone le operazioni di LabelGrid a qualsiasi assistente che supporta il protocollo ed è costruito come un wrapper leggero e tipizzato sulla stessa API pubblica su cui gli sviluppatori già lavorano. Non c’è nulla di nuovo dietro e non vengono inventate nuove regole. Quando il tuo assistente chiede al server di creare una pubblicazione, il server chiama l’API pubblica di LabelGrid e l’API valida la richiesta esattamente come farebbe per qualsiasi altro client. Puoi leggere la specifica del protocollo su modelcontextprotocol.io.

Cosa può fare il server

Gli strumenti del server sono raggruppati per area in set di strumenti e, insieme, coprono la maggior parte di ciò che fai nel pannello. Invece di elencare ogni strumento, ecco la sua forma generale, area per area, con il tipo di richiesta a cui ciascuno risponde.

• Identità e account. «Con quale account sono connesso e con quali etichette posso lavorare?» L’assistente conferma l’account e l’ambito prima di toccare qualsiasi cosa.
• Dati di riferimento. «Elenca i generi e le lingue che posso impostare su una pubblicazione», così i valori che usi sono quelli che la piattaforma accetta davvero.
• Catalogo. Crea e gestisci etichette, artisti, autori ed editori: «Aggiungi un nuovo artista di nome Neon Harbor e impostami come autore».
• Pubblicazioni e tracce. «Prepara un album di dodici tracce sotto la mia etichetta principale e imposta la data di uscita a venerdì prossimo». La bozza viene creata perché tu la riveda, non viene inviato nulla.
• Revisione e qualità. «Valida questa pubblicazione e dimmi cosa le impedisce di superare la revisione», e l’assistente legge le segnalazioni aperte e riferisce cosa correggere. Può anche leggere gli avvisi tempestivi opzionali di Stream Radar, così puoi chiedergli se è stato rilevato qualcosa di insolito nei tuoi ascolti.
• Analytics. «Mostra gli ascolti del mio ultimo singolo per piattaforma questa settimana», scomposti come hai chiesto, per piattaforma e per periodo.
• Contabilità e royalty. «Estrai il rendiconto delle royalty dell’ultimo trimestre e suddividilo per etichetta», con le ripartizioni applicate come hai chiesto.
• Stato della consegna. «Su quali piattaforme è uscito il singolo, e c’è ancora qualcosa in sospeso?»
• Webhook. «Aggiungi un webhook che avvisa il mio server ogni volta che una consegna è completata», così i tuoi sistemi restano sincronizzati.

E, quando la attivi, la distribuzione. Il server può inviare una pubblicazione per la distribuzione, rimuoverne una e caricare l’audio e l’artwork definitivi, ma poiché i file definitivi sono immutabili e un invio esce nel mondo, queste azioni restano dietro una barriera esplicita su cui torneremo tra un momento. Anche le landing page con smart link sono coperte, quindi una richiesta come «crea una landing page per il nuovo singolo» ha il suo posto. Il senso dei dieci set di strumenti è che il livello di linguaggio naturale non è una facciata da demo su un paio di endpoint: copre il lavoro reale di gestire un catalogo.

Configurazione in sessanta secondi: aggiungi una riga, la tua IA fa il resto

Il server viene eseguito tramite npx, quindi non c’è nulla da scaricare né da tenere aggiornato. Ti serve Node.js 20 o una versione più recente e aggiungi una sola voce alla configurazione del tuo client MCP:

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

Ed ecco la parte migliore. Se avvii il server senza un token, non fallisce con un errore: entra in una modalità di configurazione guidata e il tuo assistente ti accompagna passo dopo passo mentre colleghi il tuo account. Quindi la versione onesta dell’installazione è questa: aggiungi una riga e la tua IA fa il resto. Quando sei pronto, genera un token in Profilo poi Token API nel tuo pannello, inseriscilo nella configurazione e gestirai il tuo catalogo in linguaggio naturale.

Il modello di sicurezza: tre livelli, chiusi per impostazione predefinita

Affidare a un assistente IA le chiavi di un account di distribuzione è una buona idea solo se quelle chiavi sono progettate con cura. È qui che abbiamo dedicato il maggiore sforzo di design, quindi vale la pena ripercorrerlo. Il server raggruppa ogni azione in tre livelli di permessi, e l’intero sistema è chiuso per impostazione predefinita: se un livello non è abilitato, le sue azioni semplicemente non sono disponibili.

Le letture sono sempre attive. Consultare pubblicazioni, segnalazioni di revisione, analytics, rendiconti delle royalty e stato della consegna non comporta alcun rischio di modificare qualcosa, così il tuo assistente può rispondere alle domande fin dalla prima connessione. Le scritture sicure sono attive per impostazione predefinita, ma ne mantieni il controllo: preparare bozze di pubblicazioni e tracce, modificare i metadati, gestire etichette, artisti, autori ed editori, configurare i webhook e creare landing page rientrano tutte qui. Puoi disattivarle, o forzare l’intera connessione in sola lettura, quando vuoi.

Le azioni di rilievo sono il terzo livello e sono disattivate per impostazione predefinita. L’invio a distribuzione, le rimozioni e i caricamenti immutabili di audio e artwork restano disabilitati finché non li attivi deliberatamente. Attivarli non è un interruttore che azioni per sbaglio: richiede un consenso esplicito più una conferma scritta. Prima che venga eseguito qualsiasi invio o rimozione guidati dall’IA, confermi con la frase esatta «I accept responsibility for AI-driven distribution actions» (accetto la responsabilità delle azioni di distribuzione guidate dall’IA). Quella frase ha una funzione concreta: rende le azioni di maggiore impatto una scelta consapevole, non un’impostazione predefinita.

Due cose stanno alla base di tutti e tre i livelli. Primo, ogni regola e validazione viene eseguita sui server di LabelGrid, quindi l’IA non può mai aggirare le protezioni del tuo account. Gli stessi controlli che individuano un ISRC errato o un campo mancante nel pannello lo individuano anche qui, perché è la stessa API a fare la verifica. Secondo, gli invii a distribuzione continuano a contare per i tuoi limiti settimanali di pubblicazione, esattamente come quando li invii a mano. L’assistente è un modo più veloce per gestire la piattaforma, non un modo per aggirarne le regole.

Open source, e a chi è rivolto

Il server è ufficiale e open source con licenza MIT. Il codice si trova su github.com/labelgrid/labelgrid-mcp e il pacchetto è su npm come @labelgrid/mcp, così puoi leggere ogni riga, farne un fork, integrarlo nel tuo flusso di lavoro o aprire una issue se qualcosa non va. Costruirlo in modo aperto ci è sembrato giusto per uno strumento così vicino al tuo catalogo: dovresti poter vedere esattamente cosa fa prima di puntarlo al tuo account.

Poiché il server dialoga con l’API pubblica di LabelGrid, è disponibile con i piani API di LabelGrid. Se hai già l’accesso all’API, puoi generare un token e collegarti oggi stesso. Se arrivi all’API per la prima volta, la panoramica dell’API nel centro assistenza è il punto da cui partire, e puoi confrontare le opzioni nella pagina dei prezzi. Gli sviluppatori che vogliono conoscere la parte REST e sandbox sottostante possono leggere le pagine API di distribuzione e per sviluppatori.

Questo è il lancio. Una riga nella configurazione, una configurazione guidata che collega il tuo account e un modello di permessi costruito perché un assistente IA possa aiutarti senza mai uscire dalle regole del tuo account. Non vediamo l’ora di scoprire cosa costruirà la gente, quindi se lo provi, raccontaci cosa gli fai fare.

Domande frequenti