Connecter votre assistant IA à LabelGrid (MCP)

Mis à jour en juillet 2026.

LabelGrid publie un serveur MCP (Model Context Protocol) officiel qui vous permet de connecter votre propre assistant IA à votre compte LabelGrid et de travailler en langage naturel. Au lieu d’écrire des appels REST, vous demandez à votre IA de préparer une sortie, de la valider, de vérifier son statut de revue ou de récupérer vos statistiques, et elle utilise l’API de LabelGrid en coulisses.

Le serveur est le paquet npm @labelgrid/mcp, open source sous licence MIT sur github.com/labelgrid/labelgrid-mcp. Il fonctionne avec Claude Desktop, Claude Code, Cursor ou tout client compatible MCP.

Ce que vous pouvez faire

Une fois connecté, vous pouvez demander à votre assistant IA de :

• Créer et mettre à jour des brouillons de sorties et de pistes — construire les métadonnées de façon conversationnelle
• Importer de l’audio, des pochettes et des documents de licence vers vos sorties et pistes
• Valider les sorties avant soumission pour repérer les problèmes tôt
• Consulter les problèmes de revue, les rapports de qualité et le statut de livraison
• Récupérer les statistiques de streaming, les relevés de royalties et leurs détails
• Gérer les webhooks pour les notifications asynchrones
• Soumettre des sorties à la distribution ou les retirer — disponible uniquement si vous activez explicitement ces actions (voir Sécurité et autorisations)

En coulisses, le serveur expose plus de 80 outils répartis en dix ensembles : identité, données de référence, catalogue (labels, artistes, auteurs et éditeurs), sorties et pistes, revue et qualité, statistiques, comptabilité et royalties, statut de livraison, webhooks et distribution. Les imports de fichiers font partie des ensembles catalogue et distribution.

---

Ce qu’il vous faut

1. Un compte LabelGrid avec accès API. L’accès API est inclus dans les forfaits API de LabelGrid — consultez l’aperçu de l’API pour savoir comment l’obtenir.
2. Un jeton API. Générez-le dans votre tableau de bord LabelGrid, sous Profil → Jetons API.
3. Node.js 20 ou plus récent sur l’ordinateur qui exécute votre client IA.

---

Installation

Ajoutez LabelGrid à la configuration MCP de votre client IA :

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

Remplacez your-api-token par le jeton de votre tableau de bord, puis redémarrez le client.

Pour Claude Code, une seule commande suffit :

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

---

Configuration guidée

Si vous démarrez le serveur sans jeton, il n’échoue pas : il se lance en mode de configuration guidée. Ajoutez LabelGrid à votre client sans la valeur LABELGRID_API_TOKEN, puis demandez à votre IA de « configurer LabelGrid » ; elle vous guide pour créer le jeton et vous indique où le placer. Le jeton lui-même n’est jamais collé dans la conversation.

---

Sécurité et autorisations

Le serveur utilise trois niveaux d’autorisation : c’est vous qui décidez de ce que votre IA peut faire :

• Les lectures sont toujours disponibles. Votre IA peut consulter à tout moment les sorties, pistes, revues, statistiques, relevés et statuts de livraison.
• Les écritures sûres sont activées par défaut. La création et la modification de brouillons, la mise à jour des métadonnées et la gestion des webhooks sont activées d’office. Vous pouvez les désactiver avec LABELGRID_ENABLE_WRITES=false, ou tout forcer en lecture seule avec LABELGRID_READ_ONLY=true.
• Les actions à conséquences sont désactivées par défaut. Soumettre une sortie à la distribution, retirer une sortie et envoyer des fichiers immuables exigent LABELGRID_ENABLE_FULL_WRITES=true plus une phrase de confirmation explicite, documentée dans le README du projet.

Toutes les protections de votre compte — validation, limites du forfait, limites de requêtes — sont appliquées par les serveurs de LabelGrid. L’IA ne peut pas les contourner, quelles que soient les autorisations que vous lui accordez.

---

Limiter les outils disponibles

Si vous ne souhaitez exposer qu’une partie de votre compte, définissez LABELGRID_TOOLSETS pour limiter les ensembles d’outils proposés par le serveur. L’IA reste ainsi concentrée sur les domaines que vous choisissez.

---

Dépannage

• Jeton invalide ou refusé — recréez le jeton dans votre tableau de bord, sous Profil → Jetons API, et mettez-le à jour dans votre configuration MCP.
• La page « Jetons API » n’apparaît pas — votre compte n’a pas encore l’accès API. Consultez l’aperçu de l’API pour savoir comment l’activer.
• Vous ne savez pas si le serveur est connecté — le serveur affiche son statut au démarrage ; consultez les journaux MCP de votre client.
• Vous voulez couper l’accès — vous pouvez révoquer un jeton à tout moment depuis votre tableau de bord, ce qui interrompt immédiatement tout accès.

---

FAQ

« LabelGrid propose-t-il un serveur MCP ? »

Oui. LabelGrid publie un serveur MCP officiel sous la forme du paquet npm @labelgrid/mcp, open source sous licence MIT sur github.com/labelgrid/labelgrid-mcp. Il connecte Claude Desktop, Claude Code, Cursor ou tout client IA compatible MCP à votre compte LabelGrid pour travailler en langage naturel.

« Que puis-je en faire ? »

Créer et mettre à jour des brouillons de sorties et de pistes ; importer de l’audio, des pochettes et des documents de licence ; valider les sorties avant soumission ; consulter les problèmes de revue, les rapports de qualité et le statut de livraison ; récupérer les statistiques de streaming, les relevés de royalties et leurs détails ; et gérer les webhooks. La soumission à la distribution et les retraits ne sont disponibles que si vous les activez explicitement.

« Est-il sûr de laisser une IA gérer mon compte ? »

Le serveur comporte trois niveaux d’autorisation. Les lectures sont toujours disponibles ; les écritures sûres (brouillons, métadonnées, webhooks) sont activées par défaut et peuvent être désactivées ; les actions à conséquences (soumission à la distribution, retraits, envois de fichiers immuables) sont désactivées par défaut et exigent d’activer les écritures complètes plus une confirmation explicite. Toutes les protections du compte — validation, limites du forfait, limites de requêtes — sont appliquées par les serveurs de LabelGrid et l’IA ne peut pas les contourner.

« Ai-je besoin d’un forfait API ? »

Oui. Le serveur MCP passe par l’API publique de LabelGrid : votre compte doit donc disposer de l’accès API, inclus dans les forfaits API de LabelGrid. Consultez l’aperçu de l’API pour savoir comment l’obtenir.

« Quelles applications d’IA sont prises en charge ? »

Tout client compatible MCP, notamment Claude Desktop, Claude Code et Cursor.

---

Voir aussi

• Aperçu de l’API — comment obtenir l’accès API et s’authentifier
• Webhooks — notifications d’événements asynchrones
• @labelgrid/mcp sur npm
• labelgrid-mcp sur GitHub

---

Besoin d’aide ?

Pour toute question sur le serveur MCP, contactez notre équipe support.