Resumen
Accede a HR WORKS, la plataforma alemana de RR. HH. y nóminas: empleados, ausencias, bajas por enfermedad, teletrabajo, horas de trabajo, cuentas de horas, pagos salariales, expedientes de personal, proyectos, candidatos, unidades organizativas, festivos y centros de coste a través de la API REST v2.
Configuración guiada
Conecta HR WORKS a Microsoft Copilot en 2 minutos
Empieza la prueba gratuita en AnythingMCP Cloud, conecta HR WORKS con la configuración guiada y añade tu URL MCP a Microsoft Copilot. Sin código y sin servidores que mantener.
Sin tarjeta de crédito · 7 días de prueba · Alternativa self-host disponible
Prueba a pedir
Prompts de ejemplo para HR WORKS
Haz clic en un prompt para copiarlo. Pégalo en Claude, ChatGPT, Cursor, Gemini, Copilot u OpenClaw para ejecutarlo contra este conector.
Claude es IA y puede equivocarse. Verifica siempre las respuestas.
💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → HR WORKS, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin
git clone, sin servidor local.
HR WORKS + Microsoft Copilot
Accede a HR WORKS, la plataforma alemana de RR. HH. y nóminas: empleados, ausencias, bajas por enfermedad, teletrabajo, horas de trabajo, cuentas de horas, pagos salariales, expedientes de personal, proyectos, candidatos, unidades organizativas, festivos y centros de coste a través de la API REST v2.
Requisitos previos
Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:
HRWORKS_ACCESS_KEY, HRWORKS_SECRET_ACCESS_KEY
Paso 1 — Obtener credenciales
- En HR WORKS, abre Administration → API y crea un par de claves de API: una access key y una secret access key.
- Pega la access key en
HRWORKS_ACCESS_KEYy la secret access key enHRWORKS_SECRET_ACCESS_KEY, y después instala el conector. - Empieza con
hrworks_list_organization_unitsohrworks_list_personspara comprobar que el par de claves funciona.
El conector se ocupa de los tokens: HR WORKS emite tokens que duran unos 15 minutos. El conector cambia tu par de claves por un token, lo renueva antes de que caduque y vuelve a iniciar sesión tras un 401, así que las conversaciones largas y las ejecuciones programadas siguen funcionando.
Qué hace: 48 herramientas que leen empleados y sus datos maestros, unidades organizativas, festivos, ausencias, bajas por enfermedad, teletrabajo, horas de trabajo y cuentas de horas, cuentas de vacaciones, horas de trabajo disponibles, expedientes de personal, pagos salariales, liquidaciones de gastos de viaje, proyectos, candidatos y ofertas de empleo, centros de coste y portadores de coste. Tres herramientas escriben: hrworks_create_working_times registra horas de trabajo o pausas, hrworks_update_working_times modifica las existentes y hrworks_delete_working_times borra las registradas (desactivada al instalar). HR WORKS procesa las tres en segundo plano y devuelve un job id, que hrworks_get_working_times_job consulta. Antes de escribir, la IA confirma contigo las personas, los días y las horas. Todas las demás herramientas solo leen.
Totales y saldos: hrworks_list_time_accounts devuelve las horas previstas, las horas trabajadas y el saldo de horas extra por mes, y hrworks_list_leave_accounts el derecho a vacaciones y los días aprobados, planificados y a punto de caducar de muchas personas a la vez. hrworks_get_absences_accumulated, hrworks_get_sick_leaves_accumulated y hrworks_get_remote_work_accumulated cuentan los días por persona en un periodo en lugar de listar cada registro, y hrworks_get_available_working_hours muestra las horas disponibles descontadas las ausencias, para planificar la capacidad.
Datos confidenciales: los datos maestros, los expedientes de personal, los pagos salariales y las bajas por enfermedad son datos personales, salariales y de salud. Pon el conector solo en un servidor MCP que usen personas autorizadas a ver estos datos, o desactiva esas herramientas.
Rangos de fechas: las ausencias, las bajas, el teletrabajo, los totales y las horas disponibles requieren beginDate y endDate (YYYY-MM-DD) y abarcan como máximo un año por llamada, o 31 días con interval=days. Las horas de trabajo tienen un límite más estricto: como máximo 31 días que toquen como máximo dos meses naturales por llamada, así que la IA las pide mes a mes. Las liquidaciones de gastos de viaje también requieren beginDate y endDate.
Personas: la mayoría de las herramientas de personas aceptan el número de personal o el nombre de usuario de HR WORKS; personIdentifierType o usePersonnelNumbers indican a HR WORKS cuál de los dos usas. Los pagos salariales de una persona requieren su UUID, que devuelven hrworks_get_person y hrworks_list_persons_master_data.
¿Ya lo tienes instalado? Las nuevas herramientas llegan a un conector instalado antes a través de su actualización de catálogo: abre el conector en AnythingMCP y, en Catalog update available, revisa la lista de herramientas nuevas y haz clic en Apply update. Tus credenciales y las herramientas que añadiste tú se quedan como están. Ten en cuenta además que hrworks_list_travel_expense_reports ahora requiere beginDate y endDate, y que hrworks_list_working_times acepta como máximo 31 días dentro de dos meses naturales por llamada.
Sandbox: para probar con la demo de HR WORKS en https://api.demo-hrworks.de, cambia la base URL del conector y la URL de inicio de sesión de su configuración de autenticación al host de la demo.
Límites: la mayoría de las listas devuelven 50 registros por página; si hay más, la IA pide la siguiente page. HR WORKS aplica límites de solicitudes por cuenta.
Paso 2 — Instalar el adapter
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 3 — Añadir el conector en Microsoft Copilot
La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (
https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestraYOUR_SERVER_ID.
Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.
- En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
- Escribe un Server name (por ejemplo
AnythingMCP), una Server description que diga qué hace el conector y la Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor. - En la autenticación, elige API key, pon Type en Header y
X-API-Keycomo nombre de la cabecera, y selecciona Create. - En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
- Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de
HR WORKS. - Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.
¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.
¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, así que localhost no funciona.
Herramientas disponibles
| Tool | What it does |
|---|---|
hrworks_health_check | Check whether the HR WORKS API is reachable |
hrworks_list_organization_units | List all active organization units (Organisationseinheiten) of the company with their uuid, number and name |
hrworks_get_organization_unit | Return the data of a specific organization unit |
hrworks_list_present_persons | List all persons currently 'in the office' for a given organization unit |
hrworks_list_permanent_establishments | List all permanent establishments (Betriebsstätten) of the company with id and name |
hrworks_list_holidays | List company holidays for a given year and (optionally) country |
hrworks_list_persons | List all persons (employees) in the company |
hrworks_get_person | Return the base data of a specific person (employee) |
hrworks_list_persons_master_data | Return the current master data (full personal data, contract details, addresses, bank info, etc.) for one or more persons |
hrworks_get_persons_today | Return day-related objects (working hours, attendance, absences) for the current day for one or more persons |
hrworks_get_leave_account | Return the leave account (vacation balance) of a single person up to a reference date |
hrworks_list_absences | List absences (vacation, parental leave, etc.) for one or more persons over a date interval |
hrworks_list_absence_types | List all absence types (vacation, parental leave, special leave, etc.) configured for the customer account, with their keys for use as… |
hrworks_list_vacation_types | List vacation types defined for the customer account (subset of absence types focused on vacation/leave) |
hrworks_list_sick_leaves | List sick leaves (Krankheitstage) for one or more persons over a date interval |
hrworks_list_sick_leave_types | List all sick leave types configured for the customer account with their keys (used as filter values for hrworks_list_sick_leaves) |
hrworks_list_remote_work | List remote work / home office records for one or more persons over a date interval |
hrworks_list_working_times | List logged working times (time tracking) for one or more persons over a date interval |
hrworks_list_time_recording_regulations | List all time-recording regulations configured for the customer (defines which working time types are allowed per regulation) |
hrworks_list_projects | List time-tracking projects of the company |
hrworks_get_project | Return the data of a specific time-tracking project by id |
hrworks_list_project_customers | List the customers used for project time tracking |
hrworks_list_job_applications | List job applications |
hrworks_list_posts | List all recruiting posts (job postings) of the company |
hrworks_get_post | Return the data of a single recruiting post by uuid |
hrworks_list_applicants | List applicants (only those with at least one job application) |
hrworks_get_applicant | Return data of a specific applicant by uuid |
hrworks_list_cost_centers | List all cost centers (Kostenstellen) of the company with their number/id and name |
hrworks_list_cost_objectives | List all cost objectives (Kostenträger) of the company |
hrworks_list_wage_salary_types | List all wage/salary types defined for the customer account (used in payroll exports) |
hrworks_list_travel_expense_reports | List travel expense reports (Reisekostenabrechnungen) in a date interval, optionally for some people |
hrworks_list_time_accounts | Return the time accounts (Arbeitszeitkonto: target hours, worked hours, overtime balance) of people for one or more months |
hrworks_list_leave_accounts | Return the leave accounts (vacation entitlement, approved, requested, planned and expiring days) of several people at once, up to a… |
hrworks_get_available_working_hours | Return the working hours people are available in a date interval (target hours minus absences), summed or split by day, week or month |
hrworks_get_absences_accumulated | Return the number of working days of absence per absence type (vacation, special leave, ...) for each person in a date interval, instead of… |
hrworks_get_sick_leaves_accumulated | Return the number of working days of sick leave per sick leave type for each person in a date interval |
hrworks_get_remote_work_accumulated | Return the number of remote work (home office) days for each person in a date interval |
hrworks_get_person_master_data | Return the current master data of one person: name, contact data, address, organization unit, employment, contract and similar fields |
hrworks_list_personnel_file_entries | List the entries of one person's digital personnel file (Personalakte), optionally filtered by category, creation date, attached documents… |
hrworks_list_person_wage_payments | List the wage payments (Lohnzahlungen: wage type, amount, period) recorded for one person |
hrworks_list_wage_payments | List wage payments across all people, optionally only for one wage type (see hrworks_list_wage_salary_types) |
hrworks_create_working_times | Record working times or breaks for one or more people |
hrworks_update_working_times | Change working times that already exist in HR WORKS, with the same item format as hrworks_create_working_times |
hrworks_get_working_times_job | Return the status and result of a create or update of working times, by the job id those tools returned |
hrworks_get_working_time_status | Return whether a person is clocked in right now and, if so, the running working time: start, type (working time, business errand, doctor's… |
hrworks_list_onboarding_documents | List the onboarding documents (Onboarding-Dokumente) of new employees: name, join date, organization unit, superior, status and the… |
hrworks_get_onboarding_document | Return one onboarding document by id, with all the data the new employee entered (address, bank account, tax and social security data… |
hrworks_delete_working_times | Delete recorded working times |
Ejemplos de prompts
- "Muéstrame el saldo de horas extra de todas las personas de la unidad organizativa Ventas para septiembre y octubre de 2026."
- "¿Cuántos días de vacaciones les quedan este año a Anna Becker y Jonas Weber, y cuántos tienen ya planificados?"
- "¿Cuántas horas de trabajo tiene disponibles el equipo de desarrollo en noviembre, semana a semana?"
- "Cuenta los días de baja por enfermedad y de teletrabajo por persona del equipo de almacén en el tercer trimestre."
- "Registra para el número de personal 1042 la jornada de ayer de 8:00 a 16:30 con una pausa de 12:00 a 12:30, y luego comprueba que HR WORKS la aceptó."
- "¿Qué entradas relevantes para la nómina se añadieron este año al expediente de personal de Jonas Weber?"
FAQ
¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.
¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.
El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.
Siguientes pasos
- Página del conector
- Conectar a Claude
- Conectar a ChatGPT
- Conectar a Cursor
- Conectar a Gemini
- Conectar a Meta Muse
¿Te ha sido útil esta guía?
