Workday

@mindstone/mcp-server-workday

Model Context Protocol ホスト向けの Workday HCM MCP サーバーです。OAuth 2.0 認証を使用する標準化された MCP インターフェースを通じて、Workday の従業員、プロフィール、直属の部下、組織、勤務地、職務、休暇、求人申請を照会できます。

ステータス

• バージョン： 0.3.2 · npm
• 認証： OAuth (WORKDAY_REFRESH_TOKEN)
• ツール： 9（従業員、組織、休暇、採用、勤務地、職務）
• サーフェス： cloud-api
• 機械可読： STATUS.json

要件

• Node.js 20+
• npm

ワンクリックインストール

ボタンをクリックすると、ホストから次の項目を入力するよう求められます：WORKDAY_HOST、WORKDAY_TENANT、WORKDAY_CLIENT_ID、WORKDAY_CLIENT_SECRET、WORKDAY_REFRESH_TOKEN。

{
  "mcpServers": {
    "Workday": {
      "command": "npx",
      "args": [
        "-y",
        "@mindstone/mcp-server-workday"
      ],
      "env": {
        "WORKDAY_HOST": "",
        "WORKDAY_TENANT": "",
        "WORKDAY_CLIENT_ID": "",
        "WORKDAY_CLIENT_SECRET": "",
        "WORKDAY_REFRESH_TOKEN": ""
      }
    }
  }
}

クイックスタート

インストールとビルド

cd <path-to-repo>/connectors/workday
npm install
npm run build

npx（公開後）

npx -y @mindstone/mcp-server-workday

ローカル

node dist/index.js

設定

環境変数

• WORKDAY_HOST — Workday API ホスト（例：wd5-impl-services1.workday.com）
• WORKDAY_TENANT — Workday テナント ID
• WORKDAY_CLIENT_ID — OAuth 2.0 クライアント ID
• WORKDAY_CLIENT_SECRET — OAuth 2.0 クライアントシークレット
• WORKDAY_REFRESH_TOKEN — OAuth 2.0 リフレッシュトークン（任意。指定すると refresh_token グラントが有効になります。指定しない場合は client_credentials グラントが使用されます）
• WORKDAY_RECRUITING_API_VERSION — 採用 REST ファミリーのバージョンを上書きする値（任意。デフォルトは v41.2。Workday はプラットフォームリリースごとにこの API のバージョンを設定するため、異なるリリースのテナントでは、たとえば v42.1 が必要になる場合があります）
• MCP_HOST_BRIDGE_STATE — 認証情報の管理に使用するホストブリッジ状態ファイルのパス（任意）
• MINDSTONE_REBEL_BRIDGE_STATE — MCP_HOST_BRIDGE_STATE と後方互換性のある別名

ホスト設定例

Claude Desktop / Cursor

{
  "mcpServers": {
    "Workday": {
      "command": "npx",
      "args": ["-y", "@mindstone/mcp-server-workday"],
      "env": {
        "WORKDAY_HOST": "wd5-impl-services1.workday.com",
        "WORKDAY_TENANT": "your-tenant",
        "WORKDAY_CLIENT_ID": "your-client-id",
        "WORKDAY_CLIENT_SECRET": "your-client-secret",
        "WORKDAY_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

ローカル開発（npm 公開は不要）

{
  "mcpServers": {
    "Workday": {
      "command": "node",
      "args": ["<path-to-repo>/connectors/workday/dist/index.js"],
      "env": {
        "WORKDAY_HOST": "wd5-impl-services1.workday.com",
        "WORKDAY_TENANT": "your-tenant",
        "WORKDAY_CLIENT_ID": "your-client-id",
        "WORKDAY_CLIENT_SECRET": "your-client-secret",
        "WORKDAY_REFRESH_TOKEN": "your-refresh-token"
      }
    }
  }
}

ツール（9）

設定

• configure_workday_credentials — Workday OAuth API の認証情報を設定します

ワーカー

• list_workday_workers — ワーカー（従業員および有期雇用者）を一覧表示または検索します
• get_workday_worker — ID でワーカーの全プロフィールを取得します
• list_workday_direct_reports — ワーカーの直属の部下を一覧表示します（組織図の1階層分）

組織

• list_workday_organizations — 組織（部門、上司組織、コストセンター）を一覧表示します
• list_workday_locations — 勤務地（オフィス、拠点）を一覧表示します

休暇

• list_workday_time_off — ワーカーの休暇記録を一覧表示します（ISU に Absence Management ドメインへのアクセス権が必要です）

採用

• list_workday_job_requisitions — 求人申請／募集中の職務を一覧表示します（Recruiting ドメインへのアクセス権が必要です。テナントで 404 が返される場合は WORKDAY_RECRUITING_API_VERSION を参照してください）

ジョブ

• list_workday_jobs — ワーカーの職務割り当て（ポジション、役職、勤務地、組織）を一覧表示します

注意事項

• 検索はクライアント側で行われます。 Workday の /workers コレクションで文書化されているのは limit／offset のみです。そのため、list_workday_workers の search 引数はワーカーのページを取得し、ローカルでフィルタリングします（名前、メールアドレス、役職を大文字と小文字を区別せずに照合）。スキャンするワーカーは最大1000人です。より大規模なテナントでは、具体的な検索語を使用してください。
• フィールドの許可リスト。 すべてのツールは Workday のレスポンスを許可リストに含まれるフィールドに絞り込みます（ネストされた参照も ID と名前だけを深く抽出します）。そのため、休暇のコメント、求人申請の説明、住所などの自由記述フィールドがモデルに渡ることはありません。
• 信頼できないコンテンツのエンベロープ。 Workday から返される許可リスト内のすべての文字列（名前、役職、メールアドレス、ステータス、日付など。想定外の形式で届いた値も含みます）は、モデルが指示ではなくデータとして扱うよう、<untrusted-content source="workday"> エンベロープで囲まれます。ベンダー形式のサブオブジェクト内のキーもエンベロープで囲まれます。id と href はそのまま保持されるため、後続のツール呼び出しに渡せます。
• 厳格なページネーション。 limit は1～100の整数、offset は0以上の整数である必要があります。範囲外または小数の値は、黙って範囲内に調整されるのではなく、拒否されます。worker_id 引数を空白以外の文字を含む値にする必要があります。
• エラーの制限とリダイレクトの追跡禁止。 API エラーとトークンエラーでは、コネクターが生成したメッセージが返され（ベンダーの生のエラーボディは返されません）、HTTP リダイレクトは追跡せず拒否されるため、認証情報がリダイレクト先に再送されることはありません。設定されたホストは、ループバック／プライベート範囲（非正規の IP 表記や IPv6 形式を含む）に該当しないか検証され、認証情報を送信する前に DNS で再解決されます。
• ISU のセキュリティドメイン。 Workday では、REST の各ファミリーへのアクセスを Integration System User のドメイン権限で制御しています。list_workday_time_off、list_workday_job_requisitions、または list_workday_jobs で 403 が返される場合、ISU のセキュリティグループに該当するドメイン（Absence Management、Recruiting、Payroll）の権限が必要です。

ライセンス

FSL-1.1-MIT — Functional Source License, Version 1.1。将来的に MIT ライセンスへ移行します。このソフトウェアは 2030-04-08 に MIT ライセンスへ移行します。