SuperAPI AI 工具集

bamboohr-automation

办公与效率

查看项目

更新于 10-15 20:33

技能介绍

用途:把 BambooHR 的人力资源操作接入 Rube MCP,通过 Composio 的 BambooHR 工具包自动执行员工、休假、福利与家属相关任务。工具包文档:composio.dev/toolkits/bamboohr

前置条件:Rube MCP 已连接且 RUBE_SEARCH_TOOLS 可用;通过 RUBE_MANAGE_CONNECTIONS 建立 toolkit 为 bamboohr 的活动连接;运行任何流程前先调用 RUBE_SEARCH_TOOLS 获取当前工具架构。

设置:在客户端配置中添加 MCP 服务器 https://rube.app/mcp,无需 API 密钥;确认 RUBE_SEARCH_TOOLS 有响应后,调用 RUBE_MANAGE_CONNECTIONS 并传入 toolkit bamboohr;若连接非 ACTIVE,按返回的认证链接完成 BambooHR 认证,确认状态为 ACTIVE 后再执行工作流。

主要能力与用法:

  1. 员工查询:先调用 BAMBOOHR_GET_ALL_EMPLOYEES 获取目录,再用 BAMBOOHR_GET_EMPLOYEE(参数 id、fields)取详情;员工 ID 为数字整数,fields 控制返回字段,停用或离职员工可能出现在结果中,需检查 status。
  2. 变更追踪:调用 BAMBOOHR_EMPLOYEE_GET_CHANGED(参数 since 为 ISO 8601 时间、type 如 inserted/updated/deleted),返回的是变更员工 ID,需逐个再调用 GET_EMPLOYEE 取详情,可用于增量同步与审计,建议缓存上次同步时间戳。
  3. 休假管理:先 BAMBOOHR_GET_META_TIME_OFF_TYPES 获取类型 ID,再按需调用 BAMBOOHR_GET_TIME_OFF_BALANCES、GET_TIME_OFF_REQUESTS、CREATE_TIME_OFF_REQUEST、UPDATE_TIME_OFF_REQUEST;日期用 YYYY-MM-DD,创建请求不会自动批准,需单独的审批步骤,审批需相应角色权限。
  4. 更新员工:先 GET_EMPLOYEE 查看当前值,再 BAMBOOHR_UPDATE_EMPLOYEE(id 必需及字段值对)仅更新传入字段;字段名须与 BambooHR 完全一致,部分字段只读,更新会被审计。
  5. 家属与福利:BAMBOOHR_DEPENDENTS_GET_ALL 列出家属,BAMBOOHR_BENEFIT_GET_COVERAGES 获取福利覆盖;福利参数以 RUBE_SEARCH_TOOLS 返回的架构为准。

限制与注意事项:API 密钥权限决定可访问字段与操作,部分操作需管理员或经理权限。数据含 PII 尤其家属数据敏感,需妥善保护。BambooHR API 有按密钥的速率限制,批量操作应节流。各端点日期格式不一致,员工 ID 始终为数字,响应数据可能嵌套在 data 键下,空字段可能省略或为 null,解析时应容错。实际收费、价格与具体可用范围官方资料未提供。