# Acceso y planes

> La HILLS API, los webhooks y MCP se incluyen en los planes Enterprise y Custom. Quién puede crear claves, los límites de solicitudes y cómo obtener acceso.

La HILLS API está disponible para las cuentas de socio con los planes Enterprise y Custom.

## Planes

| | Enterprise | Custom |
| --- | --- | --- |
| API REST y DDEX por la API | Sí | Sí |
| Webhooks | Sí | Sí |
| Solicitudes por minuto, por clave | 120 | Según tu volumen (600 salvo otro acuerdo) |

Con otros planes, las claves no funcionan y responden `403 api_not_in_plan`, y no se pueden añadir endpoints de webhook. Si cambias a un plan inferior, las claves existentes dejan de funcionar hasta que el plan vuelva a incluir la API. No se elimina nada. Puedes seguir probando archivos DDEX desde la página DDEX de la aplicación web y desde tu carpeta SFTP `/test`.

Para pasar a Enterprise o Custom, habla con tu contacto en HILLS Music. Si todavía no eres socio, [solicita acceso a la API](https://hillsmusic.com/apply/?type=api). Cuéntanos qué quieres conectar y cuántos lanzamientos y solicitudes esperas, aproximadamente.

## Qué obtienes

- **Claves de API.** Un solo tipo de clave, `hm_live_…`, con sus propios ámbitos y una caducidad opcional. Consulta [Autenticación](https://developer.hillsmusic.com/es/guides/authentication/).
- **Una vía de pruebas que no crea nada.** `POST /ddex/validate` y la carpeta SFTP `/test` ejecutan todas las comprobaciones de una entrega y responden con un informe. Consulta [Carpeta de pruebas](https://developer.hillsmusic.com/es/reference/test-folder/).
- **Entrega DDEX.** Se recomienda ERN 4.3 y se aceptan versiones anteriores, por la API o por SFTP. Consulta [Entrega DDEX](https://developer.hillsmusic.com/es/guides/ddex/).
- **Webhooks.** Hasta 20 endpoints HTTPS, eventos firmados y reintentos. Consulta [Webhooks](https://developer.hillsmusic.com/es/guides/webhooks/).
- **El servidor MCP.** Conecta asistentes de IA a tu espacio de trabajo. Más información abajo.

## Quién puede crear claves

Las claves se crean en la página **Developers** de la aplicación web de HILLS. El propietario de la cuenta siempre puede crearlas. Un miembro del equipo puede hacerlo si su rol tiene el permiso de claves de API, que se configura en **Settings → Team**. Los artistas y sellos que dependen de tu cuenta no pueden crear claves: la API es tuya, y cada respuesta abarca tu cuenta y los artistas y sellos que dependen de ella.

## Servidor MCP

El servidor MCP en `https://mcp.hillsmusic.com` permite que los asistentes de IA lean tu catálogo, el estado de tus lanzamientos, tus reproducciones e ingresos, tus liquidaciones y tus solicitudes. Tiene 10 herramientas de solo lectura. Cada persona inicia sesión con su propia cuenta de HILLS mediante OAuth 2.1, sin clave de API. Pueden conectarlo las cuentas de socio y los miembros de su equipo, y estos necesitan el permiso de rol que indica cada herramienta. Consulta [Servidor MCP](https://developer.hillsmusic.com/es/mcp/overview/).

## Cambios

La API v1 es estable. Con el tiempo se añaden campos. Cuando algo tiene que desaparecer, se anuncia en el [registro de cambios](https://developer.hillsmusic.com/es/changelog/) con una fecha de baja, y hasta entonces las respuestas que lo usan llevan las cabeceras `Deprecation` y `Sunset`. Consulta [Solicitudes a la API](https://developer.hillsmusic.com/es/guides/making-requests/#versioning).

Fuente: https://developer.hillsmusic.com/es/overview/early-access/