leave.config.get
read读取休假单位、审批模式、日历、通知、payroll export、资料权限与 audit 设定。
建议先读取
-
治理与审批
只读；按 HR 权限返回。
安全说明
不得暴露 payroll 或员工敏感权限设定。
休假管理系统 MCP 工具
休假管理系统 MCP 工具支援员工与部门、假期类型、年假 accrual、入职日 pro-rata、carry-forward、公众假期、手机请假、病假纸附件、假期余额、团队更表、冲突检查、主管审批、TOIL 补假、月度 payroll 汇出、通知及 audit。
leave.employees.list
read查询员工、部门、主管、入职日期、工作制及适用假期政策。
建议先读取
leave.config.get
治理与审批
只读；员工私隐资料按角色遮罩。
安全说明
只回传请假判断需要的最少员工资料。
leave.employee.get
read读取单一员工的假期政策、入职日、主管、工作日、余额及申请历史摘要。
建议先读取
leave.employees.list
治理与审批
只读；只限本人、主管或 HR。
安全说明
病假证明和 payroll 栏位不在普通查询显示。
leave.departments.list
read查询部门、主管、最低人手要求及休假审批负责人。
建议先读取
leave.config.get
治理与审批
只读；用于团队覆盖检查。
安全说明
人手要求属内部营运资料，需按管理权限显示。
leave.leave_types.list
read读取年假、病假、补假、产假、侍产假等类型、单位及附件要求。
建议先读取
leave.config.get
治理与审批
只读；用于申请表及政策检查。
安全说明
类型设定需反映公司政策及香港法例。
leave.policies.list
read读取公司假期政策、适用员工、结转、折现、试用期、附件与审批规则。
建议先读取
leave.config.get
治理与审批
只读；政策版本需可追溯。
安全说明
不可混淆不同员工群组的政策。
leave.accrual_rules.list
read读取按入职日、比例年假、每月累积、封顶、结转及到期的 accrual 规则。
建议先读取
leave.policies.list
治理与审批
只读；作余额计算与 preview 使用。
安全说明
年假计算规则必须版本化，避免历史余额被错改。
leave.public_holidays.list
read读取香港公众假、劳工假、银行假、公司假及非工作日规则。
建议先读取
leave.config.get
治理与审批
只读；用于请假日数计算。
安全说明
公众假资料需按年份及政策版本固定。
leave.balances.list
read按员工、部门、假期类型查询已用、剩余、待批、即将到期及结转余额。
建议先读取
leave.employees.list, leave.leave_types.list
治理与审批
只读；员工可看本人，主管看团队，HR 看全公司。
安全说明
不可让一般员工查阅其他人余额。
leave.balance.get
read读取单一员工和假期类型的余额、计算基础、待批扣减及到期日。
建议先读取
leave.balances.list
治理与审批
只读；按员工/主管/HR 权限。
安全说明
需清楚分开实际余额与待批申请影响。
leave.balance_movements.list
read查询假期增加、扣减、补假、调整、结转、到期及取消申请的 ledger。
建议先读取
leave.balance.get
治理与审批
只读；ledger 不可被普通使用者修改。
安全说明
ledger 需保留来源和 action request id。
leave.requests.list
read按员工、部门、日期、状态、假期类型及主管查询请假申请。
建议先读取
leave.employees.list
治理与审批
只读；按本人、主管、HR 权限。
安全说明
病假原因与附件不可在团队日历公开。
leave.request.get
read读取请假日期、单位、原因、附件、余额影响、冲突、审批及通知纪录。
建议先读取
leave.requests.list
治理与审批
只读；附件按 HR/主管权限。
安全说明
限制病假纸等敏感文件的可见性。
leave.proof_documents.list
read查询病假纸、证明文件、上载时间、审核状态及保留期限。
建议先读取
leave.request.get
治理与审批
只读；只限 HR、主管或提交者。
安全说明
文件应加密、可遮罩并有查阅 audit。
leave.pending_approvals.list
read列出主管待批、待补资料、超额或有人手冲突的请假申请。
建议先读取
leave.requests.list, leave.coverage_conflicts.list
治理与审批
只读；只列出该 approver 可处理项目。
安全说明
不可把其他主管队伍的待批资料暴露。
leave.approval_chain.get
read读取申请的审批人、代理审批人、跳级规则、状态及 SLA。
建议先读取
leave.request.get
治理与审批
只读；用于判断写入审批是否合法。
安全说明
审批人不可自行改写审批链。
leave.team_calendar.get
read读取团队假期日历、已批准/待批请假、公众假及人手分布。
建议先读取
leave.departments.list, leave.requests.list
治理与审批
只读；团队日历不显示敏感原因。
安全说明
公开视图只显示可见状态，不显示病历或个人原因。
leave.coverage_conflicts.list
read检查同日多人请假、最低人手不足、关键角色缺席及连续长假冲突。
建议先读取
leave.team_calendar.get, leave.departments.list
治理与审批
只读；提供审批建议，不自动拒绝。
安全说明
AI 建议不能取代主管决策。
leave.toil_records.list
read查询加班补假 TOIL 申请、来源、审批、可用余额及到期日。
建议先读取
leave.employee.get
治理与审批
只读；补假来源与审批纪录保留。
安全说明
避免未审批加班直接增加假期余额。
leave.payroll_exports.list
read查询月度 payroll 假期汇出、状态、生成者、期间、档案版本及错误。
建议先读取
leave.config.get
治理与审批
只读；payroll 档案只限 HR/payroll。
安全说明
payroll export 可能含敏感缺勤资料，需权限及下载 audit。
leave.summary_report.get
read读取月度/年度请假、余额、到期、缺勤率、部门使用量及假期负债摘要。
建议先读取
leave.requests.list, leave.balances.list
治理与审批
只读；可按权限聚合。
安全说明
报表需避免暴露个别病假原因。
leave.audit_logs.list
read查询请假、附件、审批、余额、政策、结转、payroll export 及通知操作纪录。
建议先读取
leave.config.get
治理与审批
只读；audit log 不可由普通使用者改写。
安全说明
audit 需防篡改并支援劳资争议追溯。
leave.request_check.preview
preview预览请假日数、余额扣减、附件要求、公众假排除、冲突及人手影响。
建议先读取
leave.balance.get, leave.public_holidays.list, leave.coverage_conflicts.list
治理与审批
只产生预览；提交或审批前必须确认。
安全说明
防止余额不足或错计公众假仍提交。
leave.approval_result.preview
preview预览批准或拒绝后的余额、日历、人手、通知、payroll 及 audit 影响。
建议先读取
leave.request.get, leave.approval_chain.get
治理与审批
审批前必须由指定 approver 确认。
安全说明
AI 不可自行批准请假。
leave.balance_adjustment.preview
preview预览人手调整余额、原因、ledger、到期日、payroll 影响及通知。
建议先读取
leave.balance.get, leave.balance_movements.list
治理与审批
余额调整需 HR/管理层审批。
安全说明
所有调整必须有原因、附件或 action request。
leave.policy_change.preview
preview预览政策、假期类型、accrual 或公众假变更对员工余额和历史申请的影响。
建议先读取
leave.policies.list, leave.accrual_rules.list
治理与审批
政策变更必须 HR/管理层审批并版本化。
安全说明
避免政策变更错改已关帐或历史纪录。
leave.carry_forward_run.preview
preview预览年结结转、清零、到期、折现及每个员工余额变化。
建议先读取
leave.balances.list, leave.accrual_rules.list
治理与审批
执行前需 HR/payroll 审批。
安全说明
年结操作不可重复执行；需 idempotency。
leave.payroll_export.preview
preview预览指定月份 payroll 汇出的请假、缺勤、扣薪、补假及异常项目。
建议先读取
leave.requests.list, leave.summary_report.get
治理与审批
产生正式汇出前需 HR/payroll 确认。
安全说明
汇出前需标示未批申请及资料缺口。
leave.request.create
write建立手机请假申请，包含类型、日期、单位、原因、附件要求及预览结果。
建议先读取
leave.request_check.preview
治理与审批
员工提交后进入审批；不即时扣实际余额。
安全说明
需检查余额、附件及日数计算。
leave.request.update
write更新草稿或待补资料申请的日期、类型、原因、附件或单位。
建议先读取
leave.request.get, leave.request_check.preview
治理与审批
已审批申请不可直接改，需改期/取消流程。
安全说明
防止更改已审批资料而无 audit。
leave.request.withdraw
write员工撤回草稿、待批或按规则可取消的请假申请。
建议先读取
leave.request.get
治理与审批
已批准且影响 payroll 的取消需主管/HR 审批。
安全说明
取消需回滚余额、日历和通知状态。
leave.proof_document.attach
write上载或替换病假纸及其他证明文件，连结到请假申请。
建议先读取
leave.request.get, leave.proof_documents.list
治理与审批
附件可由提交者上载；查阅及核实按主管/HR 权限。
安全说明
文件需病毒扫描、加密和查阅 audit。
leave.approval.approve
write批准请假申请，扣减余额、更新团队日历、发送通知并保留审批纪录。
建议先读取
leave.approval_result.preview
治理与审批
必须由审批链指定 approver 执行。
安全说明
AI 不可自行批准；需人手确认冲突和人手影响。
leave.approval.reject
write拒绝请假申请，记录原因，保留余额，并通知员工。
建议先读取
leave.approval_result.preview
治理与审批
必须由指定 approver 提供原因。
安全说明
拒绝原因需专业且不暴露其他员工私隐。
leave.approval.request_info
write要求员工补交证明、修改日期或补充请假原因。
建议先读取
leave.request.get
治理与审批
由指定 approver 或 HR 发出。
安全说明
只要求处理申请必要资料，不过度收集。
leave.balance.adjust
write人手调整假期余额、到期日或 ledger，并保留原因及附件。
建议先读取
leave.balance_adjustment.preview
治理与审批
需 HR/管理层审批。
安全说明
所有余额变动需 ledger、原因和 audit。
leave.toil_record.create
write建立加班补假 TOIL 记录，连结加班来源、可用时数及到期日。
建议先读取
leave.toil_records.list, leave.employee.get
治理与审批
建立后通常需主管/HR 审批才增加余额。
安全说明
防止虚假加班直接转为假期。
leave.toil_record.approve
write审批 TOIL 记录并增加补假余额与 ledger。
建议先读取
leave.toil_records.list, leave.balance_adjustment.preview
治理与审批
只限主管/HR 审批。
安全说明
需保留加班来源、审批人和到期规则。
leave.policy.upsert
write建立或更新假期政策、结转、折现、试用期、附件及审批规则。
建议先读取
leave.policy_change.preview
治理与审批
政策变更需 HR/管理层审批并版本化。
安全说明
不能直接改写已生效历史政策而无版本。
leave.leave_type.upsert
write建立或更新假期类型、半日/小时计算、附件要求及是否影响 payroll。
建议先读取
leave.leave_types.list, leave.policy_change.preview
治理与审批
需 HR 审批。
安全说明
避免删除已有历史申请引用的类型。
leave.accrual_rule.upsert
write建立或更新年假累积、入职日比例、封顶、结转及到期规则。
建议先读取
leave.accrual_rules.list, leave.policy_change.preview
治理与审批
需 HR/管理层审批；影响既有余额需 preview。
安全说明
避免错计全公司假期余额。
leave.public_holiday.upsert
write建立或更新公众假、公司假、劳工假/银行假日历及适用年份。
建议先读取
leave.public_holidays.list, leave.policy_change.preview
治理与审批
需 HR/admin 审批，尤其影响已提交申请时。
安全说明
需避免已批假期日数被无声更改。
leave.carry_forward_run.execute
write执行年结假期结转、清零、到期或未用假折现，并写入 ledger。
建议先读取
leave.carry_forward_run.preview
治理与审批
正式执行需 HR/payroll 审批及 idempotency key。
安全说明
不可重复执行；需产生完整前后对照。
leave.calendar_sync.push
write将已批请假同步到公司/团队日历，隐藏敏感原因并更新出勤状态。
建议先读取
leave.approval_result.preview, leave.team_calendar.get
治理与审批
只同步已审批申请；失败可重试。
安全说明
不得把病假原因或附件同步到公开日历。
leave.payroll_export.create
write生成指定期间 payroll 假期/缺勤汇出档及异常清单。
建议先读取
leave.payroll_export.preview
治理与审批
需 HR/payroll 审批；下载需 audit。
安全说明
payroll 资料敏感，需限制汇出格式和收件人。
leave.notification.send
write发送提交、待补、批准、拒绝、余额到期、payroll 异常及年结提醒。
建议先读取
leave.request.get, leave.balance.get
治理与审批
正式讯息需按模板和收件人 preview；敏感内容不可广播。
安全说明
避免把病假、拒绝原因或 payroll 资料发错人。
leave.action_request.status
status查询休假管理写入动作的 preview、审批、执行、失败、回滚及 audit 状态。
建议先读取
leave.audit_logs.list
治理与审批
只读状态；不能用此 endpoint 强制审批。
安全说明
审批状态需可追溯，不可由申请者自行改写。