Serveur MCP
Connectez des assistants IA à HILLS via le Model Context Protocol : URL du serveur, connexion OAuth, qui peut se connecter et les outils.
Le serveur MCP de HILLS Music permet aux assistants IA compatibles avec le Model Context Protocol de lire votre espace de travail : catalogue, statut des sorties, écoutes et revenus, relevés et demandes. Chaque appel s’exécute sous le compte HILLS qui l’a connecté et voit ce que ce compte voit dans l’espace de travail.
Connexion
| URL du serveur | https://mcp.hillsmusic.com |
| Transport | Streamable HTTP, sans état : messages JSON-RPC envoyés en POST, réponses JSON (pas de flux server-sent, pas de session). GET et DELETE renvoient 405. |
| Authentification | OAuth 2.1 avec votre compte HILLS (scope read) |
| Limite de débit | 120 appels par minute et par application connectée |
Ajoutez l’URL du serveur comme serveur MCP distant (connecteur personnalisé) dans votre assistant. Une page de connexion HILLS s’ouvre, vous approuvez la connexion et les outils apparaissent. Vous pouvez la déconnecter à tout moment dans Settings, Connected apps de l’application web HILLS.
Autorisation
HILLS est le serveur d’autorisation OAuth 2.1, et l’endpoint MCP la ressource protégée. Une requête sans jeton valide reçoit une 401 avec un en-tête WWW-Authenticate qui désigne les métadonnées de la ressource : c’est ainsi que les clients MCP savent où se connecter. Les clients s’enregistrent eux-mêmes (enregistrement dynamique de client), l’utilisateur approuve la connexion dans l’application web HILLS, et chaque appel d’outil s’exécute sous ce compte.
| Métadonnées de la ressource | https://mcp.hillsmusic.com/.well-known/oauth-protected-resource |
| Métadonnées du serveur d’autorisation | https://mcp.hillsmusic.com/.well-known/oauth-authorization-server |
Scope read |
Accès en lecture seule à votre catalogue, à vos écoutes et à vos relevés |
| PKCE | S256 uniquement |
| Jetons d’accès | Valables 1 heure |
| Jetons de rafraîchissement | Valables 30 jours, renouvelés à chaque utilisation (un jeton réutilisé met fin à la connexion) |
Qui peut se connecter
- Les clients (comptes partenaires) et les membres de leur équipe, propriétaire et administrateurs : activé par défaut.
- Les artistes et labels ayant leur propre compte HILLS, et les autres membres du personnel : lorsque l’équipe HILLS l’active.
- Les artistes et labels rattachés à un client : jamais ; le MCP appartient au client.
- Certains outils sont réservés aux comptes clients (solde et retraits : également les artistes et labels directs, que HILLS paie) ; un compte qui ne peut pas utiliser un outil ne le voit pas.
- Un membre de l’équipe d’un client a besoin de la permission de rôle indiquée pour chaque outil ; le personnel HILLS voit ce que ses permissions de rôle lui ouvrent.
Outils
| Outil | Ce qu’il fait | Qui y a accès |
|---|---|---|
list_members |
Lister les artistes et labels | Comptes clients et leur équipe uniquement |
payouts |
Solde et retraits | Certains comptes uniquement |
smartlinks |
Smart links | Comptes clients et leur équipe uniquement |
list_deliveries |
Livraisons DDEX | Comptes clients et leur équipe uniquement |
delivery_status |
Statut de livraison | Comptes clients et leur équipe uniquement |
search_catalog |
Rechercher dans le catalogue | Tous les comptes ayant accès au MCP |
release_status |
Statut d’une sortie | Tous les comptes ayant accès au MCP |
streams_and_revenue |
Écoutes et revenus | Tous les comptes ayant accès au MCP |
statements |
Relevés | Tous les comptes ayant accès au MCP |
requests |
Demandes | Tous les comptes ayant accès au MCP |
Ce que l’on dit aux assistants
Le serveur donne ces instructions à chaque assistant lors de la connexion (citées en anglais, telles que le serveur les envoie) :
HILLS Music distribution data for the signed-in account, read-only. Find releases with search_catalog, then use their ids with release_status and streams_and_revenue. Streams and revenue come from monthly store statements (USD, net of the store’s share), usually 1–3 months behind, so there are no daily or weekly figures — say so when asked for days or weeks and use the latest months instead. Everything is limited to what this account can see in the HILLS workspace.