Hrworks を Gemini に接続する方法 — MCP 経由

HR WORKSをGeminiに接続

HR WORKSは、フライブルクに拠点を置くHR/給与SaaSで、約20,000のDACH中小企業に利用されています。AnythingMCPを使用して、HR WORKSをMCP経由でGeminiに接続し、自然言語で人事業務のワークフローを実行します — 欠勤承認、勤務時間分析、応募者のトリアージ — すべてチャットインターフェースから行えます。

Geminiに尋ねられること

• "来週、エンジニアリングチームで休暇を取っているのは誰ですか？"
• "2026年第1四半期の全組織単位の病気休暇の合計を見せてください"
• "3月の従業員番号1042の勤務時間のエントリをリストしてください"
• "ベルリンのフロントエンド役職に応募しているのは誰ですか？"
• "ジェーン・ドウの休暇口座の残高を取得してください"

セットアップ

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

1. HR WORKSで: Administration → API でAPIキーのペア（accessKey + secretAccessKey）を作成します
2. http://localhost:3000/connectors/storeを開き、HR WORKSをインポートして、キーのペアをHRWORKS_ACCESS_KEYとHRWORKS_SECRET_ACCESS_KEYに貼り付けます。コネクタがこれを短期トークンに交換し、トークンを自動で更新します。
3. （オプション）https://api.demo-hrworks.deのサンドボックスを使う場合は、コネクタのベースURLと認証設定のログインURLをデモホストに変更します
4. コネクタをMCPサーバーに割り当てます

Geminiを接続

サーバーURL: AnythingMCP で MCP Servers を開き、このコネクタがあるサーバーを選んで URL（https://cloud.anythingmcp.com/mcp/…）をコピーします。このガイドで YOUR_SERVER_ID と表示されている箇所に使ってください。

Gemini CLI は ~/.gemini/settings.json（Windows では %USERPROFILE%\.gemini\settings.json）から MCP サーバーを読み込みます。次を追加してください:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. AnythingMCP の MCP Servers → 対象のサーバー → API keys で MCP API キーを作成し、YOUR_MCP_API_KEY と置き換えます。
2. ファイルを保存し、gemini を再起動します。
3. Gemini CLI で /mcp を実行します（またはシェルで gemini mcp list）。anythingmcp が接続済みとして表示されるはずです。
4. プロンプトを入力しましょう — Gemini CLI が HR WORKS のツールを呼び出せるようになりました。

上記のクイックスタートでセルフホストしている場合は、サーバーのローカルエンドポイント http://localhost:4000/mcp/<server-id> を URL として使ってください。

Geminiのためのツールハイライト

(31 個中 30 個のツールを表示 — すべて見るにはコネクタをインストールしてください)

全31ツールのリストは、HR WORKS MCPサーバーの概要にあります。

重要: トークンの有効期限

HR WORKSのトークンは約15分で期限切れになります。コネクタはキーのペアでログインし、期限切れ前にトークンを更新し、401を受け取ると再ログインします。そのため、長い会話、スケジュール実行、エージェントもトークンに触れることなく動き続けます。

日付間隔の制限

hrworks_list_absences, _sick_leaves, _remote_work, _working_timesは、呼び出しごとに1年（またはinterval=daysの場合は31日）に制限されます。複数年の分析を行う場合は、Geminiに年ごとに繰り返すように依頼してください。

FAQ

Gemini CLI はどこから MCP サーバーを読み込みますか? ユーザー単位では ~/.gemini/settings.json、プロジェクト単位ではプロジェクト内の .gemini/settings.json です。gemini mcp list で各サーバーと接続状態を確認できます。

関連ガイド

• HR WORKS MCPサーバーの概要
• HR WORKSをClaudeに接続
• HR WORKSをChatGPTに接続
• HR WORKSをCursorに接続
• HR WORKSをMeta Museに接続
• Personio MCPサーバー — 代替のDACH HR
• Kenjo HR MCPサーバー — 代替のDACH HR