Servidor MCP de HR WORKS — Recursos Humanos y Nómina Alemanes para Agentes de IA

HR WORKS para Agentes de IA

HR WORKS (anteriormente HRworks) es la plataforma SaaS de recursos humanos/nómina de Friburgo utilizada por ~20,000 pequeñas y medianas empresas en DACH. La API REST v2 expone el conjunto de datos operativo completo: empleados, ausencias, bajas por enfermedad, horarios de trabajo, trabajo remoto, proyectos, solicitantes, unidades organizativas, días festivos, centros de costo, y AnythingMCP envuelve todo esto en un único adaptador MCP con 31 herramientas preconstruidas.

Por qué un Adaptador MCP para HR WORKS

HR WORKS no expone una clave API de larga duración. En su lugar, envías un POST a {accessKey, secretAccessKey} a /v2/authentication y recibes un JWT de 15 minutos que luego se envía como Authorization: Bearer <token> en cada llamada subsiguiente. Esa corta duración del token, combinada con los límites de tasa por inquilino y el patrón de doble identificador (número de personal o nombre de usuario en la mayoría de los puntos finales), complica casi todas las integraciones DIY.

El adaptador AnythingMCP maneja:

• El contrato del token portador (tú proporcionas el token; el adaptador lo envía en cada llamada)
• Tanto producción como el sandbox api.demo-hrworks.de a través de la sobreescritura de HRWORKS_BASE_URL
• Los parámetros opcionales personIdentifierType / usePersonnelNumbers donde sea aplicable
• La regla de intervalo de fecha máxima de 1 año en los puntos finales de listado
• Una prueba de integración en vivo que demuestra que el encabezado portador se inyecta realmente (InvalidBearerTokenError en lugar de MissingAuthorizationHeaderError)

Configuración Rápida

Paso 1: Desplegar AnythingMCP

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d

Paso 2: Generar un JWT desde HR WORKS

En el administrador de HR WORKS: Configuración → API → Generar Clave de Acceso para obtener un par de accessKey + secretAccessKey. Luego intercámbialos por un JWT:

curl -X POST https://api.hrworks.de/v2/authentication \
  -H 'Content-Type: application/json' \
  -d '{"accessKey":"YOUR_ACCESS_KEY","secretAccessKey":"YOUR_SECRET_ACCESS_KEY"}'

La respuesta contiene {"token": "eyJ..."}. La duración del token es ~15 minutos — para flujos de trabajo de corta duración, el mismo token está bien; para agentes de larga duración, envuelve este adaptador en un proxy que se actualice automáticamente.

Paso 3: Importar el Adaptador

Abre http://localhost:3000/connectors/store, haz clic en Importar en HR WORKS, y pega el JWT en HRWORKS_TOKEN.

Para el sandbox: también establece HRWORKS_BASE_URL=https://api.demo-hrworks.de y utiliza credenciales emitidas por el sandbox.

Paso 4: Conectar a Tu Agente de IA

{
  "mcpServers": {
    "hrworks": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Herramientas Disponibles (31)

Conectividad y Configuración

Personas

Ausencias y Tiempo

Proyectos y Reclutamiento

(se muestran 30 de 31 herramientas — instala el conector para verlas todas)

Casos de Uso del Agente de IA

• "¿Quién está de vacaciones en el equipo de ingeniería la próxima semana?" — vista de ausencias para autoservicio del gerente
• "¿Cuántos días de enfermedad tomó el almacén en el primer trimestre?" — análisis de RRHH
• "Mostrar totales de tiempo de trabajo para Jane Doe en marzo de 2026" — preparación de horas extras / nómina
• "Listar solicitantes activos para el rol de Frontend en Berlín" — traspaso al reclutador
• "¿Qué empleados estuvieron presentes en la oficina de Friburgo hoy?" — vista de instalaciones/seguridad

Convenciones de Identificadores

La mayoría de los puntos finales relacionados con personas aceptan ya sea el número de personal de HR WORKS o el nombre de usuario. Utiliza los parámetros opcionales personIdentifierType / usePersonnelNumbers cuando el identificador que tienes no es el predeterminado — el adaptador los pasará.

Intervalos de Fechas: Máximo de 1 Año

hrworks_list_absences, hrworks_list_sick_leaves, hrworks_list_remote_work, y hrworks_list_working_times requieren beginDate / endDate en formato ISO (YYYY-MM-DD). La API de HR WORKS limita el intervalo a 1 año (o 31 días si interval=days). Para rangos más largos, paginar año por año y agregar del lado del cliente.

Actualización de Token — Limitación Conocida

Este adaptador envía un único token portador estático. Cuando el JWT expira (~15 min), la API devuelve 401 y debes reimportar un token nuevo. Para flujos de trabajo de larga duración, ejecuta un cron que actualice el token a través de /v2/authentication y actualice la variable de entorno HRWORKS_TOKEN del conector a través de la API de administración de AnythingMCP.

Próximos Pasos

• Conectar HR WORKS a Claude
• Conectar HR WORKS a ChatGPT
• Guía MCP de Personio — conector alternativo de RRHH en DACH
• Guía MCP de Kenjo — conector alternativo de RRHH en DACH