workday-mcp

workday-mcp

Workday 用の読み取り専用 MCP サーバーです。Workday の組織図、従業員プロフィール、給与、福利厚生、パフォーマンス、およびあらゆるタスクやデータカードを読み取り、構造化された JSON として返します。すべてのリクエストは、ContextMint Bridge ブラウザー拡張機能を介して、ご自身がサインイン済みの *.myworkday.com タブにルーティングされます。既存の SSO 認証済みセッションを再利用します。

⚠️ Workday は従業員向けの個人用 API を提供していません。このサーバーは、Workday のウェブアプリが呼び出すものと同じ内部の *.htmld エンドポイントを、ご自身がサインイン済みのブラウザータブ経由で呼び出して読み取ります。読み取り専用で、ご自身のデータだけを扱います。勤務先の利用規定を確認してください。ご自身の判断でご利用ください。

🤖 このプロジェクトは AI（Claude Code）によって開発・保守されています。

公式 API ではなくブリッジを使う理由

公式の Workday REST/SOAP API を使うには、テナント管理者が OAuth API クライアントと Integration System User を登録する必要があり、従業員が自分で設定することはできません。また、テナントは MFA を伴う企業向け SSO（Ping/Okta/Entra）の背後にあるため、サーバー側でログインする方法もありません。従業員が自分のデータにアクセスできる唯一の手段は、実際に使用中のブラウザーセッションです。このサーバーはそのセッションを中継します。

インストール

詳しいセットアップ方法は SKILL.md をご覧ください。概要は以下のとおりです。

{
  "mcpServers": {
    "workday": {
      "command": "npx",
      "args": ["-y", "workday-mcp"],
      "env": { "WORKDAY_TENANT": "your-tenant-slug" }
    }
  }
}

次に、ContextMint Bridge をリリースページからインストールし（Chrome の場合は、Chrome 用 zip を解凍して chrome://extensions で展開済みの拡張機能として読み込みます。Safari はまだ利用できません。一般公開されていないダウンロードリンクの ContextMint アプリに同梱される予定のため、当面は Chrome をお使いください）、ブラウザーで Workday にサインインしてください。

ContextMint Bridge は、同じメンテナーによる fetchproxy ブラウザー拡張機能の新しい名称です。fetchproxy 自体の README にも案内があります。ソースコードは https://github.com/nullnet-app/contextmint-bridge で公開されています。ご自身でビルドするか、リリース zip と同じ場所に公開されている .sha256 ファイルを使って照合してください（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

ツール

ツール	機能
workday_get_apps	起動可能なタスク ID とともに Workday アプリを一覧表示します。検出の起点となるツールです
workday_open_app	アプリを名前で開き（「Talent and Performance」、「Absence」など）、実際のコンテンツを含む子カードまでたどります
workday_get_task	ID またはパスを指定して、任意のタスク／データカードを読み取ります → フィールド、テーブルの全行、参照、関連タスク、エクスポートリンク。expand: true を指定するとハブページをたどります
workday_get_org_chart	自分の報告系統を表示します。各人の役職、所在地、直属の部下の数、および詳細表示に使う profileUri を含みます
workday_get_worker	従業員のプロフィールを表示します。読み取り可能な情報すべてのカタログ（9 セクション、名前付きタスク約 40 件）を含みます
workday_get_worker_task	カタログから名前で項目を 1 つ開きます。「Compensation」、「Performance Reviews」、「Management Chain」などが対象です
workday_get_my_profile	自分用の同じカタログを表示します
workday_fetch	秘密情報を伏せて .htmld を直接読み取ります。まだパーサーでモデル化されていないページを扱うための手段です
workday_graphql	Workday の PEX サーフェスに対して読み取り専用の GraphQL を実行します（ミューテーションは拒否されます）。Inbox／検索にアクセスする唯一の方法です
workday_healthcheck	実用的なヒントを表示しながら、ブリッジとセッションが正常に機能するかをエンドツーエンドで確認します

パーサーは、Workday のページファミリー 7 種類（データカード、グリッド（チャンク分割とエクスポートリンクに対応した実際のテーブル）、フォーム形式の詳細ページ、従業員プロフィール、組織図、アプリハブ、レポートのプロンプトフォーム）を認識し、各ページに kind を設定します。docs/WORKDAY-API.md をご覧ください。

マネージャー向けクイックスタート

workday_get_org_chart                                   → who reports where, with profileUris
workday_get_worker         { worker: "<profileUri>" }   → that person's full catalog
workday_get_worker_task    { worker: "…", task: "Compensation" }
workday_open_app           { app: "talent" }            → a whole app hub, crawled

すべての ID は、ご自身のアプリメニューと組織図から実行時に検出されます。テナント固有の値はハードコードされていないため、どの Workday テナントでも動作します。

開発

npm install
npm test          # vitest
npm run build     # tsc --noEmit + esbuild bundle → dist/bundle.js

ウィジェットツリーのパーサー（src/parse.ts）は、長期的に維持される中核です。取得したエンドポイントの形式とスキーマについては、 docs/WORKDAY-API.mdを参照してください。 ライセンス：MIT。