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 einen kompakten Satz konsolidierter Tools in acht Gruppen bereit: Konto, Referenz, Katalog, Releases, Analysen, Finanzen, Webhooks und Vertrieb. Die meisten Tools wählen anhand eines von Ihnen angegebenen Arguments, worauf sie sich beziehen — zum Beispiel deckt ein einziges Katalog-Suchtool Labels, Künstler, Autoren, Verlage, Releases und Tracks ab. Auch Referenzdaten wie Genres, Sprachen und Gebiete werden als MCP-Ressourcen bereitgestellt. Datei-Uploads gehören zu den Gruppen Katalog und Vertrieb. Ihr KI-Client listet genau die Tools auf, die ihm angeboten werden — so sehen Sie den aktuellen Umfang jederzeit direkt im Client.

---

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

Achtung

Dieser Befehl schreibt das Token auf Ihre Kommandozeile, wo Ihre Shell es in der History festhält und andere Benutzer des Rechners es über die Prozessliste auslesen können. Löschen Sie es anschließend aus Ihrer History oder tragen Sie das Token stattdessen in die JSON-Konfiguration oben ein.

---

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. Der Einrichtungsablauf weist den Assistenten an, Sie an die Konfigurationsdatei Ihres Clients zu verweisen und niemals im Chat nach dem Token zu fragen — bewahren Sie es also dort auf und fügen Sie das Token nicht in die Unterhaltung ein, auch wenn Sie danach gefragt werden.

---

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.

---

Was Ihr KI-Client sieht

Der Server läuft auf Ihrem eigenen Rechner und spricht mit Ihrem Token die LabelGrid-API an. Er hat keine Verbindung zu LabelGrid außer den API-Aufrufen, die Ihre KI anstößt, und LabelGrid erhält Ihre Unterhaltungen nicht.

Der Datenfluss verläuft in die andere Richtung, und dabei lohnt sich Umsicht: Alles, was Ihre KI über den Server liest — Release-Metadaten, Review-Beanstandungen, Analysen, Royalty-Abrechnungen —, wird an den von Ihnen konfigurierten KI-Client weitergegeben und von dort an das Modell, das dieser Client verwendet. Es liegt in Ihrer Verantwortung, einen Client zu wählen, dem Sie Ihren Katalog und Ihre Kontodaten anvertrauen, und diesen Datenfluss überall dort offenzulegen, wo Ihre eigenen Vereinbarungen es verlangen.

Zwei praktische Konsequenzen:

• Wenn bestimmte Daten niemals einen KI-Anbieter erreichen sollen, halten Sie diesen Bereich mit LABELGRID_TOOLSETS vollständig zurück, statt darauf zu vertrauen, dass die KI nicht danach fragt. Ein Tool, das nicht angeboten wird, kann nicht aufgerufen werden.
• Finanzdaten gehören dazu. Die Gruppe finance liest Abrechnungen und Royalty-Aufschlüsselungen; lassen Sie sie weg, wenn Sie das nicht in der Unterhaltung haben möchten.

---

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. Die Gruppe webhooks ist standardmäßig deaktiviert; fügen Sie sie zu LABELGRID_TOOLSETS hinzu, um sie zu aktivieren.

---

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 — widerrufen Sie das Token jederzeit in Ihrem Dashboard. Das stoppt sofort alles, was dieses Token nutzt, einschließlich dieses Servers. Andere Tokens Ihres Kontos sind davon nicht betroffen; widerrufen Sie also jedes Token einzeln, das Sie stilllegen möchten, und entfernen Sie den Wert auch aus Ihrer MCP-Konfiguration.

---

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.

Berechtigungen regeln, was die KI tun kann. Überlegen Sie separat, was sie sehen kann: Alles, was sie über den Server liest, erreicht Ihren KI-Client und das dahinterliegende Modell. Siehe Was Ihr KI-Client sieht.

„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
• LabelGrid Kommandozeilen-Tool (CLI) — dieselben Aktionen von Ihrem Terminal oder einem Skript aus
• 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.