UKG Ready MCP

UKG Ready RESTエンドポイント用のMCPサーバー。従業員、タイムカード、例外、報酬、保存済みレポート、および汎用認証エンドポイントツールを含みます。

設定

.env.example をローカル環境設定にコピーして、以下を設定します:

• UKG_BASE_URL: UKGテナントのベースURL。デフォルトは https://secure.entertimeonline.com。

• UKG_API_KEY、UKG_USERNAME、UKG_PASSWORD、UKG_COMPANY。

• UKG_DEFAULT_REPORT_ID: オプションの保存済みレポートID。

実際の認証情報をコミットしたり、ソースファイルに配置したりしないでください。

Related MCP server: woffu-mcp

実行

npm install
npm run build
npm start

サーバーはMCP stdioを介して通信します。利用可能なツール:

• get_ukg_saved_report_csv

• list_ukg_employees

• get_ukg_employee

• get_ukg_timecards

• list_ukg_exceptions

• get_ukg_compensation

• call_ukg_endpoint

ワークフォースツールは文書化された形式のデフォルト値を使用し、オプションのpathオーバーライドを公開します。UKG Readyのエンドポイントの利用可否はテナントと有効化されたモジュールによって異なるためです。汎用ツールは任意のAPIパスを受け入れるため、認証情報はサーバー設定内に保持されたままになります。書き込みツールは、テナントのエンドポイント契約と権限が確認された後にのみ追加してください。

UKG従業員とCommand Cloudドライバーのマッピング

想定される統合は、UKG従業員がCommand Cloudのドライバーに対応するというものです。このマッピングは計画されたシステム間の関係であり、まだ自動的な前提ではありません。

実装する際は、利用可能な場合は安定した識別子を使用してレコードを照合し、その後に従業員/ドライバー名、従業員番号、電話番号、メールアドレス、アクティブステータスなどの補助フィールドで検証してください。UKG従業員IDからCommand CloudドライバーIDへの明示的なマッピングを維持してください。名前は変更されたり重複したりする可能性があるため、名前だけに依存しないでください。

このマッピングは、UKGのタイムカードや打刻ステータスをCommand Cloudのドライバー、配車、チケットアクティビティと比較するなどの将来のワークフローをサポートします。実際のマッチングルールとソース・オブ・トゥルースの決定は、同期ツールを作成する前に確認する必要があります。