Ihren KI-Assistenten mit LabelGrid verbinden (MCP)

Stand: Juli 2026.

LabelGrid veröffentlicht einen offiziellen MCP-Server (Model Context Protocol), mit dem Sie Ihren eigenen KI-Assistenten mit Ihrem LabelGrid-Konto verbinden und in natürlicher Sprache arbeiten können. Statt REST-Aufrufe zu schreiben, bitten Sie Ihre KI, einen Release-Entwurf anzulegen, ihn zu validieren, den Review-Status zu prüfen oder Ihre Analysen abzurufen — sie nutzt dafür im Hintergrund die LabelGrid-API.

Der Server ist das npm-Paket @labelgrid/mcp und Open Source unter MIT-Lizenz auf github.com/labelgrid/labelgrid-mcp. Er funktioniert mit Claude Desktop, Claude Code, Cursor oder jedem MCP-kompatiblen Client.

Was Sie tun können

Einmal verbunden, können Sie Ihren KI-Assistenten bitten:

• Release- und Track-Entwürfe erstellen und aktualisieren — Metadaten im Dialog aufbauen
• Audio, Artwork und Lizenzdokumente hochladen zu Ihren Releases und Tracks
• Releases vor der Einreichung validieren, damit Probleme früh sichtbar werden
• Review-Beanstandungen, Qualitätsberichte und Lieferstatus prüfen
• Streaming-Analysen, Royalty-Abrechnungen und Aufschlüsselungen abrufen
• Webhooks verwalten für asynchrone Benachrichtigungen
• Releases zum Vertrieb einreichen oder zurückziehen — nur verfügbar, wenn Sie diese Aktionen ausdrücklich aktivieren (siehe Sicherheit und Berechtigungen)

Im Hintergrund stellt der Server mehr als 80 Tools in zehn Gruppen bereit: Identität, Referenzdaten, Katalog (Labels, Künstler, Autoren und Verlage), Releases und Tracks, Review und Qualität, Analysen, Buchhaltung und Royalties, Lieferstatus, Webhooks und Vertrieb. Datei-Uploads gehören zu den Gruppen Katalog und Vertrieb.

---

Was Sie benötigen

1. Ein LabelGrid-Konto mit API-Zugang. API-Zugang ist Teil der API-Tarife von LabelGrid — wie Sie ihn erhalten, steht im API-Überblick.
2. Ein API-Token. Generieren Sie es im LabelGrid-Dashboard unter Profil → API-Tokens.
3. Node.js 20 oder neuer auf dem Rechner, auf dem Ihr KI-Client läuft.

---

Installation

Fügen Sie LabelGrid der MCP-Konfiguration Ihres KI-Clients hinzu:

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

Ersetzen Sie your-api-token durch das Token aus Ihrem Dashboard und starten Sie den Client neu.

Für Claude Code genügt ein einziger Befehl:

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

---

Geführte Einrichtung

Wenn Sie den Server ohne Token starten, schlägt er nicht fehl — er startet stattdessen in einem geführten Einrichtungsmodus. Fügen Sie LabelGrid Ihrem Client ohne den Wert für LABELGRID_API_TOKEN hinzu und bitten Sie Ihre KI dann, „LabelGrid einzurichten“; sie führt Sie durch das Erstellen des Tokens und zeigt Ihnen, wo es hingehört. Das Token selbst wird nie in den Chat eingefügt.

---

Sicherheit und Berechtigungen

Der Server nutzt drei Berechtigungsstufen — Sie entscheiden, wie viel Ihre KI tun darf:

• Lesezugriffe sind immer verfügbar. Ihre KI kann jederzeit Releases, Tracks, Reviews, Analysen, Abrechnungen und den Lieferstatus abrufen.
• Sichere Schreibzugriffe sind standardmäßig aktiviert. Entwürfe anlegen und bearbeiten, Metadaten aktualisieren und Webhooks verwalten sind ab Werk aktiv. Sie können sie mit LABELGRID_ENABLE_WRITES=false abschalten oder mit LABELGRID_READ_ONLY=true alles auf Nur-Lesen stellen.
• Folgenreiche Aktionen sind standardmäßig deaktiviert. Ein Release zum Vertrieb einreichen, ein Release zurückziehen und unveränderliche Datei-Uploads erfordern LABELGRID_ENABLE_FULL_WRITES=true plus einen ausdrücklichen Bestätigungssatz, dokumentiert im README des Projekts.

Alle Schutzmechanismen Ihres Kontos — Validierung, Tariflimits und Ratenbegrenzungen — werden von den LabelGrid-Servern durchgesetzt. Die KI kann sie nicht umgehen, unabhängig davon, welche Berechtigungen Sie ihr geben.

---

Verfügbare Tools einschränken

Wenn Sie nur einen Teil Ihres Kontos freigeben möchten, begrenzen Sie mit LABELGRID_TOOLSETS, welche Tool-Gruppen der Server anbietet. So bleibt die KI auf die Bereiche beschränkt, die Sie wählen.

---

Fehlerbehebung

• Token ungültig oder abgelehnt — erstellen Sie das Token im Dashboard unter Profil → API-Tokens neu und aktualisieren Sie es in Ihrer MCP-Konfiguration.
• Die Seite „API-Tokens“ fehlt — Ihr Konto hat noch keinen API-Zugang. Wie Sie ihn aktivieren, steht im API-Überblick.
• Unklar, ob der Server verbunden ist — der Server gibt beim Start seinen Status aus; prüfen Sie die MCP-Logs Ihres Clients.
• Sie möchten die Verbindung trennen — Sie können ein Token jederzeit im Dashboard widerrufen; der Zugriff endet sofort.

---

FAQ

„Hat LabelGrid einen MCP-Server?“

Ja. LabelGrid veröffentlicht einen offiziellen MCP-Server als npm-Paket @labelgrid/mcp, Open Source unter MIT-Lizenz auf github.com/labelgrid/labelgrid-mcp. Er verbindet Claude Desktop, Claude Code, Cursor oder jeden MCP-kompatiblen KI-Client mit Ihrem LabelGrid-Konto, damit Sie in natürlicher Sprache arbeiten können.

„Was kann ich damit tun?“

Release- und Track-Entwürfe erstellen und aktualisieren; Audio, Artwork und Lizenzdokumente hochladen; Releases vor der Einreichung validieren; Review-Beanstandungen, Qualitätsberichte und Lieferstatus prüfen; Streaming-Analysen, Royalty-Abrechnungen und Aufschlüsselungen abrufen; und Webhooks verwalten. Das Einreichen zum Vertrieb und Takedowns sind nur verfügbar, wenn Sie sie ausdrücklich aktivieren.

„Ist es sicher, eine KI mein Konto verwalten zu lassen?“

Der Server hat drei Berechtigungsstufen. Lesezugriffe sind immer verfügbar; sichere Schreibzugriffe (Entwürfe, Metadaten, Webhooks) sind standardmäßig aktiviert und lassen sich abschalten; folgenreiche Aktionen (Einreichen zum Vertrieb, Takedowns, unveränderliche Datei-Uploads) sind standardmäßig deaktiviert und erfordern das Aktivieren der vollen Schreibrechte plus eine ausdrückliche Bestätigung. Alle Kontoschutzmechanismen — Validierung, Tariflimits, Ratenbegrenzungen — werden von den LabelGrid-Servern durchgesetzt und können von der KI nicht umgangen werden.

„Brauche ich einen API-Tarif?“

Ja. Der MCP-Server verbindet sich über die öffentliche LabelGrid-API, Ihr Konto benötigt daher API-Zugang, der Teil der API-Tarife von LabelGrid ist. Wie Sie ihn erhalten, steht im API-Überblick.

„Welche KI-Apps werden unterstützt?“

Jeder MCP-kompatible Client, darunter Claude Desktop, Claude Code und Cursor.

---

Verwandte Themen

• API-Überblick — wie Sie API-Zugang erhalten und sich authentifizieren
• Webhooks — asynchrone Ereignisbenachrichtigungen
• @labelgrid/mcp auf npm
• labelgrid-mcp auf GitHub

---

Brauchen Sie Hilfe?

Bei Fragen zum MCP-Server wenden Sie sich an unser Support-Team.