Koppel je AI-assistent aan LabelGrid (MCP)

Bijgewerkt juli 2026.

LabelGrid publiceert een officiële MCP-server (Model Context Protocol), zodat je je eigen AI-assistent aan je LabelGrid-account kunt koppelen en in gewone taal kunt werken. In plaats van REST-aanroepen te schrijven, vraag je je AI om een release op te zetten, die te valideren, de reviewstatus te controleren of je analytics op te halen; onder water gebruikt hij de LabelGrid API.

De server is het npm-pakket @labelgrid/mcp en is open source onder de MIT-licentie op github.com/labelgrid/labelgrid-mcp. Hij werkt met Claude Desktop, Claude Code, Cursor of een andere MCP-compatibele client.

Wat je ermee kunt

Zodra de koppeling staat, kun je je AI-assistent vragen om:

• Concept-releases en tracks aan te maken en bij te werken — de metadata al pratend opbouwen
• Audio, artwork en licentiedocumenten te uploaden naar je releases en tracks
• Releases te valideren voordat je ze indient, zodat problemen vroeg aan het licht komen
• Reviewpunten, kwaliteitsrapporten en de leveringsstatus te bekijken
• Streaminganalytics, royaltyoverzichten en uitsplitsingen op te halen
• Webhooks te beheren voor asynchrone meldingen
• Releases in te dienen voor distributie of offline te halen — alleen beschikbaar wanneer je die acties uitdrukkelijk inschakelt (zie Veiligheid en rechten)

Onder water biedt de server een compacte set gebundelde tools verdeeld over acht toolsets: account, reference, catalog, releases, insights, finance, webhooks en distribution. Bij veel tools bepaal je met een argument waarop ze werken. Eén zoektool voor de catalogus dekt bijvoorbeeld labels, artiesten, schrijvers, uitgevers, releases en tracks. Referentiegegevens zoals genres, talen en gebieden zijn daarnaast beschikbaar als MCP-resources. Bestandsuploads horen bij de toolsets catalog en distribution. Je AI-client toont precies welke tools hem zijn aangeboden, dus je ziet altijd vanuit de client zelf wat er op dat moment beschikbaar is.

---

Wat je nodig hebt

1. Een LabelGrid-account met API-toegang. API-toegang hoort bij de API-abonnementen van LabelGrid; zie het API-overzicht voor hoe je die krijgt.
2. Een API-token. Dat genereer je in je LabelGrid-dashboard onder Profiel → API-tokens.
3. Node.js 20 of nieuwer op de computer waarop je AI-client draait.

---

Installeren

Voeg LabelGrid toe aan de MCP-configuratie van je AI-client:

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

Vervang your-api-token door het token uit je dashboard en start je client opnieuw op.

Voor Claude Code volstaat één opdracht:

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

Opgepast

Die opdracht zet het token op je opdrachtregel: je shell legt het vast in de geschiedenis en andere gebruikers op de machine kunnen het uit de processenlijst lezen. Wis het daarna uit je geschiedenis, of zet het token in plaats daarvan in de JSON-configuratie hierboven.

---

Begeleide setup

Start je de server zonder token, dan loopt hij niet vast maar start hij een begeleide setup. Voeg LabelGrid aan je client toe zonder de waarde van LABELGRID_API_TOKEN, vraag je AI vervolgens om “LabelGrid in te stellen” en hij leidt je door het aanmaken van een token en vertelt je waar je dat neerzet. De begeleide setup draagt de assistent op je door te verwijzen naar het configuratiebestand van je client en nooit in de chat om het token te vragen: laat het daar staan en plak het niet in het gesprek, ook niet als erom wordt gevraagd.

---

Veiligheid en rechten

De server werkt met drie rechtenniveaus, zodat jij bepaalt hoeveel je AI mag doen:

• Lezen kan altijd. Je AI kan op elk moment releases, tracks, reviews, analytics, overzichten en de leveringsstatus opzoeken.
• Veilige schrijfacties staan standaard aan. Concepten aanmaken en bewerken, metadata bijwerken en webhooks beheren werken meteen. Je zet ze uit met LABELGRID_ENABLE_WRITES=false, of je zet alles op alleen-lezen met LABELGRID_READ_ONLY=true.
• Ingrijpende acties staan standaard uit. Een release indienen voor distributie, een release offline halen en bestanden uploaden die daarna niet meer te wijzigen zijn, vereisen LABELGRID_ENABLE_FULL_WRITES=true plus een uitdrukkelijke bevestigingszin, die in de README van het project staat.

Alle beveiligingen op je account (validatie, abonnementslimieten en rate limits) worden door de servers van LabelGrid afgedwongen. De AI kan er niet omheen, welke rechten je hem ook geeft.

---

Wat je AI-client te zien krijgt

De server draait op je eigen machine en praat met de LabelGrid API met jouw token. Hij heeft geen enkele verbinding met LabelGrid buiten de API-aanroepen die je AI hem laat doen, en LabelGrid krijgt je gesprekken niet te zien.

De datastroom loopt de andere kant op, en daar is het de moeite waard bewust mee om te gaan: alles wat je AI via de server leest — releasemetadata, reviewpunten, analytics, royaltyoverzichten — gaat naar de AI-client die je hebt ingesteld en van daaruit naar het model dat die client gebruikt. Het is aan jou om een client te kiezen waaraan je je catalogus en accountgegevens durft toe te vertrouwen, en om die gegevensstroom te melden waar je eigen afspraken dat vragen.

Twee praktische gevolgen:

• Mogen bepaalde gegevens nooit bij een AI-aanbieder terechtkomen, sluit dat gebied dan volledig uit met LABELGRID_TOOLSETS in plaats van erop te vertrouwen dat de AI er niet naar vraagt. Een tool die niet wordt aangeboden, kan niet worden aangeroepen.
• Financiële gegevens horen daar ook bij. De toolset finance leest overzichten en royaltyuitsplitsingen, dus laat die weg tenzij je dat in het gesprek wilt hebben.

---

Beperken welke tools beschikbaar zijn

Wil je maar een deel van je account beschikbaar stellen, stel dan LABELGRID_TOOLSETS in om te bepalen welke toolsets de server aanbiedt. Zo blijft de AI gericht op de onderdelen die jij kiest. De toolset webhooks staat standaard uit; voeg die aan LABELGRID_TOOLSETS toe om hem aan te zetten.

---

Problemen oplossen

• Token ongeldig of geweigerd — maak het token opnieuw aan in je dashboard onder Profiel → API-tokens en werk het bij in je MCP-configuratie.
• Je ziet geen pagina “API-tokens” — je account heeft nog geen API-toegang. Zie het API-overzicht voor hoe je die inschakelt.
• Je weet niet zeker of de server verbinding heeft — de server toont zijn status bij het opstarten, dus controleer de MCP-logs van je client.
• Je wilt de verbinding verbreken — trek het token op elk moment in vanuit je dashboard. Alles wat dat token gebruikt, deze server incluis, stopt dan direct. Andere tokens op je account blijven ongemoeid, dus trek elk token dat je wilt intrekken apart in, en verwijder de waarde ook uit je MCP-configuratie.

---

FAQ

”Heeft LabelGrid een MCP-server?”

Ja. LabelGrid publiceert een officiële MCP-server als het npm-pakket @labelgrid/mcp, open source onder de MIT-licentie op github.com/labelgrid/labelgrid-mcp. Je koppelt er Claude Desktop, Claude Code, Cursor of een andere MCP-compatibele AI-client mee aan je LabelGrid-account, zodat je in gewone taal kunt werken.

”Wat kan ik ermee?”

Concept-releases en tracks aanmaken en bijwerken; audio, artwork en licentiedocumenten uploaden; releases valideren voordat je ze indient; reviewpunten, kwaliteitsrapporten en de leveringsstatus bekijken; streaminganalytics, royaltyoverzichten en uitsplitsingen ophalen; en webhooks beheren. Releases indienen voor distributie en releases offline halen kan alleen wanneer je dat uitdrukkelijk inschakelt.

”Is het veilig om een AI mijn account te laten beheren?”

De server werkt met drie rechtenniveaus. Lezen kan altijd; veilige schrijfacties (concepten, metadata, webhooks) staan standaard aan en kun je uitzetten; en ingrijpende acties (indienen voor distributie, offline halen, bestanden uploaden die daarna niet meer te wijzigen zijn) staan standaard uit en vereisen dat je volledige schrijfrechten inschakelt plus een uitdrukkelijke bevestiging. Alle beveiligingen op je account, zoals validatie, abonnementslimieten en rate limits, worden door de servers van LabelGrid afgedwongen; de AI kan ze niet omzeilen.

Rechten bepalen wat de AI mag doen. Denk daarnaast na over wat hij mag zien: alles wat hij via de server leest, komt bij je AI-client en het model daarachter terecht. Zie Wat je AI-client te zien krijgt.

”Heb ik een API-abonnement nodig?”

Ja. De MCP-server werkt via de publieke LabelGrid API, dus je account heeft API-toegang nodig en die hoort bij de API-abonnementen van LabelGrid. Zie het API-overzicht voor hoe je toegang krijgt.

”Welke AI-apps worden ondersteund?”

Elke MCP-compatibele client, waaronder Claude Desktop, Claude Code en Cursor.

---

Gerelateerd

• API-overzicht en Quickstart — hoe je API-toegang krijgt en authenticeert
• LabelGrid-opdrachtregeltool (CLI) — dezelfde acties vanuit je terminal of een script
• Webhooks — asynchrone meldingen van gebeurtenissen
• @labelgrid/mcp op npm
• labelgrid-mcp op GitHub

---

Hulp nodig?

Heb je vragen over de MCP-server, neem dan contact op met ons supportteam.