HR WORKS MCP Server — Немецкий HR и зарплата для AI-агентов

HR WORKS для AI-агентов

HR WORKS (ранее HRworks) — это SaaS платформа HR/зарплаты из Фрайбурга, используемая ~20,000 малых и средних компаний в DACH. v2 REST API предоставляет полный операционный набор данных — сотрудники, отсутствия, больничные, рабочие часы, удаленная работа, проекты, кандидаты, организационные единицы, праздники, центры затрат — и AnythingMCP оборачивает все это в один адаптер MCP с 31 предустановленным инструментом.

Зачем нужен адаптер MCP для HR WORKS

HR WORKS не предоставляет долгосрочный API-ключ. Вместо этого ты отправляешь POST-запрос с {accessKey, secretAccessKey} на /v2/authentication и получаешь JWT на 15 минут, который затем отправляется как Authorization: Bearer <token> при каждом последующем вызове. Этот короткий срок действия токена, в сочетании с лимитами по арендаторам и паттерном двойного идентификатора (номер персонала или имя пользователя на большинстве конечных точек), затрудняет почти каждую интеграцию DIY.

Адаптер AnythingMCP обрабатывает:

• Контракт на использование токена-носителя (ты предоставляешь токен; адаптер отправляет его при каждом вызове)
• Как продуктивную среду, так и песочницу api.demo-hrworks.de через переопределение HRWORKS_BASE_URL
• Опциональные параметры personIdentifierType / usePersonnelNumbers, где это применимо
• Правило максимального интервала дат в 1 год для конечных точек списка
• Тест интеграции в реальном времени, который доказывает, что заголовок носителя действительно внедрен (InvalidBearerTokenError вместо MissingAuthorizationHeaderError)

Быстрая настройка

Шаг 1: Разверни 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

Шаг 2: Получи JWT от HR WORKS

В админке HR WORKS: Настройки → API → Сгенерировать ключ доступа для получения пары accessKey + secretAccessKey. Затем обменяйте их на 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"}'

Ответ содержит {"token": "eyJ..."}. Срок действия токена составляет ~15 минут — для краткосрочных рабочих процессов тот же токен подойдет; для долгосрочных агентов оберни этот адаптер в прокси, который обновляется автоматически.

Шаг 3: Импортируй адаптер

Открой http://localhost:3000/connectors/store, нажми Импорт на HR WORKS и вставь JWT в HRWORKS_TOKEN.

Для песочницы: также установи HRWORKS_BASE_URL=https://api.demo-hrworks.de и используй учетные данные, выданные песочницей.

Шаг 4: Подключи к твоему AI-агенту

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

Доступные инструменты (31)

Подключение и конфигурация

Люди

Отсутствия и время

Проекты и набор кадров

(показано 30 из 31 инструментов — установи коннектор, чтобы увидеть все)

Сценарии использования AI-агента

• "Кто будет в отпуске в инженерной команде на следующей неделе?" — обзор отсутствий для менеджера
• "Сколько больничных дней взял склад в Q1?" — HR-аналитика
• "Покажи общие рабочие часы для Джейн Доу в марте 2026 года" — подготовка к переработкам / зарплате
• "Список активных кандидатов на роль Frontend в Берлине" — передача рекрутеру
• "Какие сотрудники были сегодня в офисе во Фрайбурге?" — обзор для охраны/безопасности

Конвенции идентификаторов

Большинство конечных точек, связанных с людьми, принимают либо номер персонала HR WORKS, либо имя пользователя. Используй опциональные параметры personIdentifierType / usePersonnelNumbers, когда идентификатор, который у тебя есть, не является стандартным — адаптер передаст их.

Интервалы дат: максимальный срок 1 год

hrworks_list_absences, hrworks_list_sick_leaves, hrworks_list_remote_work и hrworks_list_working_times требуют ISO beginDate / endDate (YYYY-MM-DD). API HR WORKS ограничивает диапазон до 1 года (или 31 дня, если interval=days). Для более длинных диапазонов проходишь по годам и агрегируйте на стороне клиента.

Обновление токена — известное ограничение

Этот адаптер отправляет один статический токен-носитель. Когда JWT истекает (~15 мин), API возвращает 401, и тебе необходимо повторно импортировать свежий токен. Для долгосрочных рабочих процессов запусти cron, который обновляет токен через /v2/authentication и обновляет переменную окружения HRWORKS_TOKEN адаптера через API администрирования AnythingMCP.

Следующие шаги

• Подключи HR WORKS к Claude
• Подключи HR WORKS к ChatGPT
• Руководство по Personio MCP — альтернативный HR-адаптер для DACH
• Руководство по Kenjo HR MCP — альтернативный HR-адаптер для DACH