workday-mcp

workday-mcp

面向 Workday 的只读 MCP 服务。读取 Workday 组织架构图、员工档案、薪酬、福利、绩效以及任意任务或数据卡片，并将结果作为结构化 JSON 返回。每个请求都会通过 ContextMint Bridge 浏览器扩展，经由你已登录的 *.myworkday.com 标签页发送，复用你现有的 SSO 身份验证会话。

⚠️ Workday 不向员工提供个人 API。本服务读取 Workday Web 应用调用的相同内部 *.htmld 端点，并通过你已登录的浏览器标签页发送请求。服务为只读，且只访问你自己的数据。 请查阅雇主的可接受使用政策。使用风险自负。

🤖 本项目由 AI（Claude Code）开发并维护。

为什么使用桥接，而不是官方 API？

官方 Workday REST/SOAP API 需要租户管理员注册 OAuth API 客户端和 Integration System User，员工无法自行配置。租户也位于企业 SSO（Ping/Okta/Entra）之后，并启用了 MFA，因此无法在服务端登录。员工能够访问自己数据的唯一途径，就是自己的实时浏览器会话；本服务正是通过它转发请求。

安装

完整设置说明请参阅 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 的自述文件也指向它。其源代码公开于 https://github.com/nullnet-app/contextmint-bridge：你可以自行构建，也可以将发布版 zip 与其旁边发布的 .sha256 文件进行校验（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

工具

工具	功能
workday_get_apps	列出你的 Workday 应用及可启动的任务 ID——发现入口
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	打开目录中的一个具名项目——“Compensation”“Performance Reviews”“Management Chain”
workday_get_my_profile	获取你自己的同一份目录
workday_fetch	读取原始 .htmld，并对机密信息进行遮盖——适用于解析器尚未建模的页面
workday_graphql	对 Workday 的 PEX 接口执行只读 GraphQL 请求（拒绝变更操作）。这是访问收件箱／搜索功能的唯一途径
workday_healthcheck	端到端验证桥接和会话，并提供可执行的提示

解析器可识别七种 Workday 页面类型——数据卡片、网格（真实表格，支持分块和导出链接）、表单式详情页、员工档案、组织架构图、应用中心和报告提示词表单——并为每个页面标注其 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

widget-tree 解析器（src/parse.ts）是持久化核心；捕获的端点结构和架构请参阅 docs/WORKDAY-API.md。 许可证：MIT。