# 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.

<!-- Generated from openapi/hills-mcp.json by scripts/mcp-reference.mjs. Edit the operation in hills-music (server/lib/ops), not this page. -->

El servidor MCP de HILLS Music permite que los asistentes de IA compatibles con el [Model Context Protocol](https://modelcontextprotocol.io) 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.

<a id="connect"></a>

## 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.

<a id="authorization"></a>

## 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) |

<a id="who-can-connect"></a>

## 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.

<a id="tools"></a>

## Herramientas

| Herramienta | Qué hace | Quién la tiene |
| --- | --- | --- |
| [`list_members`](https://developer.hillsmusic.com/es/mcp/list-members/) | Listar artistas y sellos | Solo cuentas de socio y su equipo |
| [`payouts`](https://developer.hillsmusic.com/es/mcp/payouts/) | Saldo y retiros | Solo algunas cuentas |
| [`smartlinks`](https://developer.hillsmusic.com/es/mcp/smartlinks/) | Smart links | Solo cuentas de socio y su equipo |
| [`list_deliveries`](https://developer.hillsmusic.com/es/mcp/list-deliveries/) | Entregas DDEX | Solo cuentas de socio y su equipo |
| [`delivery_status`](https://developer.hillsmusic.com/es/mcp/delivery-status/) | Estado de la entrega | Solo cuentas de socio y su equipo |
| [`search_catalog`](https://developer.hillsmusic.com/es/mcp/search-catalog/) | Buscar en el catálogo | Todas las cuentas con acceso a MCP |
| [`release_status`](https://developer.hillsmusic.com/es/mcp/release-status/) | Estado del lanzamiento | Todas las cuentas con acceso a MCP |
| [`streams_and_revenue`](https://developer.hillsmusic.com/es/mcp/streams-and-revenue/) | Reproducciones e ingresos | Todas las cuentas con acceso a MCP |
| [`statements`](https://developer.hillsmusic.com/es/mcp/statements/) | Liquidaciones | Todas las cuentas con acceso a MCP |
| [`requests`](https://developer.hillsmusic.com/es/mcp/requests/) | Solicitudes | Todas las cuentas con acceso a MCP |

<a id="what-assistants-are-told"></a>

## 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.

Fuente: https://developer.hillsmusic.com/es/mcp/overview/