Koppla din AI-assistent till LabelGrid (MCP)

Uppdaterad juli 2026.

LabelGrid publicerar en officiell MCP-server (Model Context Protocol) så att du kan koppla din egen AI-assistent till ditt LabelGrid-konto och arbeta på vanligt språk. I stället för att skriva REST-anrop kan du be din AI att skapa ett releaseutkast, validera det, kontrollera dess granskningsstatus eller hämta din analys, och den använder LabelGrids API i bakgrunden.

Servern är npm-paketet @labelgrid/mcp och är öppen källkod under MIT-licens på github.com/labelgrid/labelgrid-mcp. Den fungerar med Claude Desktop, Claude Code, Cursor eller vilken MCP-kompatibel klient som helst.

Vad du kan göra

När allt är kopplat kan du be din AI-assistent att:

• Skapa och uppdatera utkast till releaser och spår – bygg upp metadatan i dialog
• Ladda upp ljud, omslag och licensdokument till dina releaser och spår
• Validera releaser före inlämning så att problem dyker upp tidigt
• Kontrollera granskningsanmärkningar, kvalitetsrapporter och leveransstatus
• Hämta streaminganalys, royaltyutdrag och uppdelningar
• Hantera webhooks för asynkrona aviseringar
• Skicka in releaser för distribution eller ta ner dem – bara tillgängligt när du uttryckligen aktiverar dessa åtgärder (se Säkerhet och behörigheter)

Under huven exponerar servern en kompakt uppsättning sammanslagna verktyg fördelade på åtta verktygsuppsättningar: account, reference, catalog, releases, insights, finance, webhooks och distribution. Många verktyg avgör vad de ska agera på utifrån ett argument du anger. Ett enda katalogsökverktyg täcker till exempel skivbolag, artister, låtskrivare, förlag, releaser och spår. Referensdata som genrer, språk och territorier exponeras dessutom som MCP-resurser. Filuppladdningar ingår i verktygsuppsättningarna catalog och distribution. Din AI-klient listar exakt vilka verktyg den har erbjudits, så du kan alltid se den aktuella ytan inifrån klienten.

---

Vad du behöver

1. Ett LabelGrid-konto med API-åtkomst. API-åtkomst ingår i LabelGrids API-planer; se API-översikt för hur du får den.
2. En API-token. Generera en i din LabelGrid-dashboard under Profil → API-tokens.
3. Node.js 20 eller senare på datorn som kör din AI-klient.

---

Installera

Lägg till LabelGrid i din AI-klients MCP-konfiguration:

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

Byt ut your-api-token mot token från din dashboard och starta sedan om klienten.

För Claude Code räcker ett enda kommando:

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

Caution

Det kommandot lägger din token på kommandoraden, där terminalen sparar den i sin historik och andra användare på datorn kan läsa den i processlistan. Rensa den ur historiken efteråt, eller lägg i stället in token i JSON-konfigurationen ovan.

---

Guidad uppsättning

Om du startar servern utan token misslyckas den inte, utan startar ett guidat uppsättningsläge i stället. Lägg till LabelGrid i din klient utan värdet för LABELGRID_API_TOKEN, be sedan din AI att “sätta upp LabelGrid”, så leder den dig genom att skapa en token och var du ska lägga den. Uppsättningsflödet instruerar assistenten att hänvisa dig till din klients konfigurationsfil och att aldrig be om token i chatten – så håll den där, och klistra inte in token i konversationen ens om du blir ombedd.

---

Säkerhet och behörigheter

Servern använder tre behörighetsnivåer så att du bestämmer hur mycket din AI får göra:

• Läsningar är alltid tillgängliga. Din AI kan när som helst slå upp releaser, spår, granskningar, analys, utdrag och leveransstatus.
• Säkra skrivningar är påslagna som standard. Att skapa och redigera utkast, uppdatera metadata och hantera webhooks är aktiverat direkt. Du kan stänga av det med LABELGRID_ENABLE_WRITES=false, eller tvinga allt till skrivskyddat läge med LABELGRID_READ_ONLY=true.
• Åtgärder med konsekvenser är avstängda som standard. Att skicka in en release för distribution, ta ner en release och göra oåterkalleliga filuppladdningar kräver LABELGRID_ENABLE_FULL_WRITES=true plus en uttrycklig bekräftelsemening, som är dokumenterad i projektets README.

Alla dina kontoskydd, alltså validering, plangränser och hastighetsbegränsningar, upprätthålls av LabelGrids servrar. AI:n kan inte kringgå dem, oavsett vilka behörigheter du ger den.

---

Vad din AI-klient ser

Servern körs på din egen dator och pratar med LabelGrids API med din token. Den har ingen annan koppling till LabelGrid än de API-anrop som din AI ber den göra, och LabelGrid tar inte emot dina konversationer.

Dataflödet går åt andra hållet, och det är värt att vara medveten om: allt som din AI läser via servern – releasemetadata, granskningsanmärkningar, analys, royaltyutdrag – skickas vidare till den AI-klient du har konfigurerat, och därifrån till den modell som klienten använder. Att välja en klient som du litar på med din katalog och dina kontouppgifter, och att upplysa om det flödet där dina egna avtal kräver det, är ditt ansvar.

Två praktiska följder:

• Om delar av din data aldrig ska nå en AI-leverantör använder du LABELGRID_TOOLSETS för att hålla tillbaka hela det området, i stället för att förlita dig på att AI:n inte frågar efter det. Ett verktyg som inte erbjuds kan inte anropas.
• Ekonomisk data omfattas. Verktygsuppsättningen finance läser utdrag och royaltyuppdelningar, så utelämna den om du inte vill ha med det i konversationen.

---

Begränsa vilka verktyg som är tillgängliga

Om du bara vill exponera en del av ditt konto sätter du LABELGRID_TOOLSETS för att begränsa vilka verktygsområden servern erbjuder. Det håller AI:n fokuserad på de områden du väljer. Verktygsuppsättningen webhooks är avstängd som standard; lägg till den i LABELGRID_TOOLSETS för att slå på den.

---

Felsökning

• Token ogiltig eller avvisad – skapa om token i din dashboard under Profil → API-tokens och uppdatera den i din MCP-konfiguration.
• Du ser ingen sida för “API-tokens” – ditt konto har ännu inte API-åtkomst. Se API-översikt för hur du aktiverar den.
• Osäker på om servern anslöt – servern skriver ut sin status när den startar, så kontrollera din klients MCP-loggar.
• Du vill koppla från – återkalla token i din dashboard när som helst. Det stoppar omedelbart allt som använder just den token, inklusive den här servern. Övriga tokens på ditt konto påverkas inte, så återkalla varje token som du vill ta ur bruk, och ta även bort värdet ur din MCP-konfiguration.

---

Vanliga frågor

”Har LabelGrid en MCP-server?”

Ja. LabelGrid publicerar en officiell MCP-server som npm-paketet @labelgrid/mcp, öppen källkod under MIT-licens på github.com/labelgrid/labelgrid-mcp. Den kopplar Claude Desktop, Claude Code, Cursor eller vilken MCP-kompatibel AI-klient som helst till ditt LabelGrid-konto så att du kan arbeta på naturligt språk.

”Vad kan jag göra med den?”

Skapa och uppdatera utkast till releaser och spår; ladda upp ljud, omslag och licensdokument; validera releaser före inlämning; kontrollera granskningsanmärkningar, kvalitetsrapporter och leveransstatus; hämta streaminganalys, royaltyutdrag och uppdelningar; och hantera webhooks. Att skicka in releaser för distribution och ta ner dem är bara tillgängligt när du uttryckligen aktiverar det.

”Är det säkert att låta en AI hantera mitt konto?”

Servern har tre behörighetsnivåer. Läsningar är alltid tillgängliga; säkra skrivningar (utkast, metadata, webhooks) är påslagna som standard och kan stängas av; och åtgärder med konsekvenser (inlämning för distribution, nedtagningar, oåterkalleliga filuppladdningar) är avstängda som standard och kräver att du aktiverar fullständiga skrivningar plus en uttrycklig bekräftelse. Alla kontoskydd, alltså validering, plangränser och hastighetsbegränsningar, upprätthålls av LabelGrids servrar och kan inte kringgås av AI:n.

Behörigheterna styr vad AI:n kan göra. Fundera separat över vad den kan se: allt den läser via servern når din AI-klient och modellen bakom den. Se Vad din AI-klient ser.

”Behöver jag en API-plan?”

Ja. MCP-servern ansluter via LabelGrids publika API, så ditt konto behöver API-åtkomst, vilket ingår i LabelGrids API-planer. Se API-översikt för hur du får åtkomst.

”Vilka AI-appar stöds?”

Alla MCP-kompatibla klienter, däribland Claude Desktop, Claude Code och Cursor.

---

Relaterat

• API-översikt och snabbstart – hur du får API-åtkomst och autentiserar dig
• LabelGrids kommandoradsverktyg (CLI) – samma åtgärder från din terminal eller ett skript
• Webhooks – asynkrona händelseaviseringar
• @labelgrid/mcp på npm
• labelgrid-mcp på GitHub

---

Behöver du hjälp?

Har du frågor om MCP-servern? Kontakta vårt supportteam.