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 un jeu compact d’outils consolidés répartis en huit ensembles : compte, référence, catalogue, sorties, analyses, finances, webhooks et distribution. La plupart des outils choisissent ce sur quoi ils agissent à partir d’un argument que vous fournissez ; par exemple, un seul outil de recherche du catalogue couvre labels, artistes, auteurs, éditeurs, sorties et pistes. Les données de référence, comme les genres, les langues et les territoires, sont également exposées comme ressources MCP. Les imports de fichiers font partie des ensembles catalogue et distribution. Votre client IA liste exactement les outils qui lui sont proposés : vous pouvez donc toujours voir la surface actuelle depuis le client.

---

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

Attention

Cette commande place le jeton sur votre ligne de commande, où votre shell le consigne dans l’historique et où les autres utilisateurs de la machine peuvent le lire dans la liste des processus. Effacez-le ensuite de votre historique, ou ajoutez plutôt le jeton à la configuration JSON ci-dessus.

---

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 processus de configuration demande à l’assistant de vous renvoyer vers le fichier de configuration de votre client et de ne jamais réclamer le jeton dans la conversation : gardez-le donc à cet endroit et ne collez pas le jeton dans la conversation, même si on vous le demande.

---

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.

---

Ce que voit votre client IA

Le serveur s’exécute sur votre propre machine et dialogue avec l’API de LabelGrid à l’aide de votre jeton. Il n’a aucune liaison avec LabelGrid en dehors des appels d’API que votre IA lui demande de faire, et LabelGrid ne reçoit pas vos conversations.

Le flux de données va dans l’autre sens, et il mérite votre attention : tout ce que votre IA lit via le serveur — métadonnées de sorties, problèmes de revue, statistiques, relevés de royalties — est transmis au client IA que vous avez configuré, puis au modèle que ce client utilise. Il vous revient de choisir un client à qui vous confiez votre catalogue et les données de votre compte, et de divulguer ce flux partout où vos propres engagements l’exigent.

Deux conséquences pratiques :

• Si certaines de vos données ne doivent jamais parvenir à un fournisseur d’IA, utilisez LABELGRID_TOOLSETS pour retenir entièrement ce domaine plutôt que de compter sur l’IA pour ne pas le demander. Un outil qui n’est pas proposé ne peut pas être appelé.
• Les données financières sont concernées. L’ensemble finance lit les relevés et les détails des royalties : laissez-le de côté si vous ne voulez pas de cela dans la conversation.

---

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. L’ensemble webhooks est désactivé par défaut ; ajoutez-le à LABELGRID_TOOLSETS pour l’activer.

---

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 — révoquez le jeton depuis votre tableau de bord à tout moment. Cela interrompt immédiatement tout ce qui utilise ce jeton, y compris ce serveur. Les autres jetons de votre compte ne sont pas affectés : révoquez donc un par un ceux que vous voulez retirer, et supprimez aussi la valeur de votre configuration MCP.

---

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.

Les autorisations régissent ce que l’IA peut faire. Considérez séparément ce qu’elle peut voir : tout ce qu’elle lit via le serveur parvient à votre client IA et au modèle qui l’anime. Voir Ce que voit votre client IA.

« 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
• Outil en ligne de commande de LabelGrid (CLI) — les mêmes actions depuis votre terminal ou un script
• 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.