HR WORKS MCPサーバー — AIエージェント向けのドイツのHR & 給与

AIエージェント向けのHR WORKS

HR WORKS（旧HRworks）は、DACH地域の約20,000の中小企業に利用されているフライブルクのSaaS HR/給与プラットフォームです。v2 REST APIは、従業員、欠勤、病気休暇、労働時間、リモートワーク、プロジェクト、応募者、組織単位、休日、コストセンターなどの完全な運用データセットを公開しており、AnythingMCPはこれらすべてを単一のドロップインMCPアダプターにラップし、31の事前構築ツールを提供します。

HR WORKSのためのMCPアダプターの理由

HR WORKSは長期的なAPIキーを公開していません。代わりに、{accessKey, secretAccessKey}を/v2/authenticationにPOSTし、15分間のJWTを受け取ります。このトークンは、以降のすべての呼び出しで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: 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エージェントのユースケース

• 「来週、エンジニアリングチームで誰が休暇を取っていますか？」 — マネージャー自己サービスの欠勤概要
• 「Q1で倉庫は何日病気休暇を取りましたか？」 — HR分析
• 「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の場合）に制限しています。より長い範囲の場合は、年ごとにページをめくり、クライアント側で集計します。

トークンの更新 — 知られている制限

このアダプターは単一の静的ベアラートークンを送信します。JWTが期限切れになると（約15分）、APIは401を返し、新しいトークンを再インポートする必要があります。長時間実行されるワークフローの場合は、/v2/authenticationを介してトークンを更新し、AnythingMCP管理APIを介してコネクタのHRWORKS_TOKEN環境変数を更新するcronを実行します。

次のステップ

• HR WORKSをClaudeに接続
• HR WORKSをChatGPTに接続
• Personio MCPガイド — 代替DACH HRコネクタ
• Kenjo HR MCPガイド — 代替DACH HRコネクタ