Servidor MCP
Conecta asistentes de IA a HILLS mediante el Model Context Protocol: URL del servidor, inicio de sesión OAuth, quién puede conectarse y las herramientas.
El servidor MCP de HILLS Music permite que los asistentes de IA compatibles con el Model Context Protocol lean tu espacio de trabajo: catálogo, estado de los lanzamientos, reproducciones e ingresos, liquidaciones y solicitudes. Cada llamada se ejecuta como la cuenta de HILLS que lo conectó y ve lo mismo que esa cuenta ve en el espacio de trabajo.
Conexión
| URL del servidor | https://mcp.hillsmusic.com |
| Transporte | Streamable HTTP, sin estado: mensajes JSON-RPC por POST y respuestas JSON (sin flujo de eventos del servidor ni sesión). GET y DELETE responden 405. |
| Inicio de sesión | OAuth 2.1 con tu cuenta de HILLS (ámbito read) |
| Límite de llamadas | 120 llamadas por minuto por aplicación conectada |
Añade la URL del servidor como servidor MCP remoto (conector personalizado) en tu asistente. Se abre el inicio de sesión de HILLS, apruebas la conexión y aparecen las herramientas. Puedes desconectarlo cuando quieras en Settings, Connected apps de la aplicación web de HILLS.
Autorización
HILLS es el servidor de autorización OAuth 2.1, y el endpoint MCP, el recurso protegido. Una solicitud sin un token válido recibe un 401 con una cabecera WWW-Authenticate que indica los metadatos del recurso: así descubren los clientes MCP dónde iniciar sesión. Los clientes se registran solos (registro dinámico de clientes), el usuario aprueba la conexión en la aplicación web de HILLS y cada llamada a una herramienta se ejecuta como esa cuenta.
| Metadatos del recurso | https://mcp.hillsmusic.com/.well-known/oauth-protected-resource |
| Metadatos del servidor de autorización | https://mcp.hillsmusic.com/.well-known/oauth-authorization-server |
Ámbito read |
Acceso de solo lectura a tu catálogo, tus reproducciones y tus liquidaciones |
| PKCE | Solo S256 |
| Tokens de acceso | Válidos durante 1 hora |
| Tokens de actualización | Válidos durante 30 días; se renuevan en cada uso (reutilizar uno pone fin a la conexión) |
Quién puede conectarse
- Socios y los miembros de su equipo, el propietario y los administradores: activado por defecto.
- Artistas y sellos con su propia cuenta de HILLS, y el resto del personal: cuando el equipo de HILLS lo activa.
- Artistas y sellos que dependen de un socio: nunca; el MCP es del socio.
- Algunas herramientas son solo para cuentas de socio (saldo y retiros: también para artistas y sellos directos, a quienes paga HILLS); una cuenta que no puede usar una herramienta no la ve.
- Un miembro del equipo de un socio necesita el permiso de rol que indica cada herramienta; el personal de HILLS ve lo que le abren los permisos de su rol.
Herramientas
| Herramienta | Qué hace | Quién la tiene |
|---|---|---|
list_members |
Listar artistas y sellos | Solo cuentas de socio y su equipo |
payouts |
Saldo y retiros | Solo algunas cuentas |
smartlinks |
Smart links | Solo cuentas de socio y su equipo |
list_deliveries |
Entregas DDEX | Solo cuentas de socio y su equipo |
delivery_status |
Estado de la entrega | Solo cuentas de socio y su equipo |
search_catalog |
Buscar en el catálogo | Todas las cuentas con acceso a MCP |
release_status |
Estado del lanzamiento | Todas las cuentas con acceso a MCP |
streams_and_revenue |
Reproducciones e ingresos | Todas las cuentas con acceso a MCP |
statements |
Liquidaciones | Todas las cuentas con acceso a MCP |
requests |
Solicitudes | Todas las cuentas con acceso a MCP |
Qué se les dice a los asistentes
El servidor da estas instrucciones a cada asistente cuando se conecta:
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.