HR WORKS MCP 服务器 — 面向 AI 代理的德国人力资源与薪资

HR WORKS 面向 AI 代理

HR WORKS（前称 HRworks）是来自弗赖堡的 SaaS 人力资源/薪资平台，约有 20,000 家中小型企业在 DACH 地区使用。v2 REST API 提供完整的操作数据集 — 员工、缺勤、病假、工作时间、远程工作、项目、申请人、组织单位、假期、成本中心 — AnythingMCP 将所有这些封装在一个单一的、即插即用的 MCP 适配器中，提供 31 个预构建工具。

为什么选择 HR WORKS 的 MCP 适配器

HR WORKS 不提供长期有效的 API 密钥。相反，你需要将 {accessKey, secretAccessKey} 通过 POST 请求发送到 /v2/authentication，并接收一个 15 分钟的 JWT，该令牌随后在每个后续调用中作为 Authorization: Bearer <token> 发送。这个短令牌的有效期，加上每个租户的速率限制和双标识符模式（大多数端点使用人员编号 或 用户名），几乎会让每个 DIY 集成都陷入困境。

AnythingMCP 适配器处理：

• Bearer 令牌合同（你提供令牌；适配器在每次调用时发送它）
• 通过 HRWORKS_BASE_URL 重写访问生产和 api.demo-hrworks.de 沙箱
• 在适用时的可选 personIdentifierType / usePersonnelNumbers 参数
• 列出端点的 1 年最大日期区间规则
• 一个实时集成测试，证明 Bearer 头确实被注入（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：从 HR WORKS 生成 JWT

在 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）

连接性与配置

人员

缺勤与时间

项目与招聘

(显示 31 个工具中的 30 个 — 安装连接器即可查看全部)

AI 代理用例

• “下周工程团队谁在休假？” — 经理自助缺勤概览
• “仓库在第一季度请了多少病假？” — 人力资源分析
• “显示 2026 年 3 月简·多的工作时间总计” — 加班/薪资准备
• “列出柏林前端职位的活跃申请人” — 招聘人员交接
• “今天在弗赖堡办公室的员工有哪些？” — 设施/安全视图

标识符约定

大多数与人员相关的端点接受 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）。HR WORKS API 将跨度限制为 1 年（或 31 天，如果 interval=days）。对于更长的范围，请逐年分页并在客户端聚合。

令牌刷新 — 已知限制

此适配器发送一个静态的 Bearer 令牌。当 JWT 过期（约 15 分钟）时，API 返回 401，你必须重新导入一个新的令牌。对于长期工作流，运行一个 cron 作业，通过 /v2/authentication 刷新令牌，并通过 AnythingMCP 管理 API 更新连接器的 HRWORKS_TOKEN 环境变量。

下一步

• 将 HR WORKS 连接到 Claude
• 将 HR WORKS 连接到 ChatGPT
• Personio MCP 指南 — 另一种 DACH 人力资源连接器
• Kenjo HR MCP 指南 — 另一种 DACH 人力资源连接器