跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用，一键添加 HiBob，然后将你的 AI 客户端（Claude、ChatGPT、Copilot 或 Cursor）指向生成的 MCP 端点。无需 Docker，无需 git clone，无需任何工程经验。
摘要
通过服务用户以公开 API 使用 HR 平台 HiBob（Bob）：员工搜索与档案，工作、雇佣、生命周期和薪资历史，自定义表，公司列表，休假（谁不在、申请、余额和政策），节假日，已保存报表，入职流程，任务和文档。主数据写入在安装时关闭。
试试这样问
HiBob 的示例提示
点击任意提示即可复制，然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中，在该连接器上运行。
Claude 是 AI，可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → HiBob、粘贴凭证、生成 MCP API key，即可完成。无 Docker、无
git clone、无本地服务器。
HiBob
通过服务用户以公开 API 使用 HR 平台 HiBob（Bob）：员工搜索与档案，工作、雇佣、生命周期和薪资历史，自定义表，公司列表，休假（谁不在、申请、余额和政策），节假日，已保存报表，入职流程，任务和文档。主数据写入在安装时关闭。
设置
设置大约需要 10 分钟，需要一位 Bob 管理员。连接器通过服务用户使用 Bob 的公开 REST API（https://api.hibob.com/v1）。
- 以管理员身份在 Bob 中打开 Settings > Integrations > Automation > Service Users，点击 Manage，创建一个带名称和显示名称的服务用户。立即复制它的 ID 和 token：令牌只在生成时显示。丢失的令牌可以重新生成，旧令牌随之失效。
- 为服务用户创建一个专用的权限组（permission group）并把它加进去。新建的组没有任何权限，只授予你实际用到的：
- People's data > People's fields：对要读取的类别授予 View（
hibob_search_people至少需要 root、about、employment 和 work），对历史表（work、employment、lifecycle、payroll）授予 View history，对要更新的地方授予 Edit。 - Access data for：Everyone 或某个条件。默认只覆盖在职人员；去掉条件 Lifecycle status equals Employed 才能用
show_inactive读取离职人员。 - People's data > Time off：查看申请和余额；如果使用相应工具，还要能提交或取消申请；
include_private需要查看私密申请的权限。 - Features > Reports：View reports according to people's data access rights。
- People's data > Tasks and flow > People's tasks：View and mark selected people's tasks as complete。
- People's data > Docs > [文件夹]：按文档文件夹授予 View，共享文件夹再授予 Upload。
- People's data > People's fields：对要读取的类别授予 View（
- 把 ID 粘贴到
HIBOB_SERVICE_USER_ID，把令牌粘贴到HIBOB_SERVICE_USER_TOKEN。它们以 HTTP Basic 认证发送。 - 安装连接器并运行
hibob_list_employee_fields检查访问权限。
先查字段 ID：hibob_list_employee_fields 列出所有内置和自定义字段及其点号表示的 ID（root.displayName、work.department、work.custom.field_123），以及列表型字段的列表 ID。hibob_list_named_lists 和 hibob_get_named_list 把列表 ID 转成名称（部门、地点、职位、日历）。
可读取的内容：
- 员工：
hibob_search_people一次调用读取多名员工（全部，或仅按root.id或root.email筛选；其他筛选会被拒绝），hibob_get_employee按 ID 或工作邮箱读取一个人，hibob_list_profiles提供快速通讯录。在大公司里，AI 先用fields: ["root.id"]搜索，再每次读取 50 到 200 个 ID。 - 单人的历史表（work、employment、lifecycle、salary），以及多人的批量历史（work、lifecycle、salary）。
- 自定义表及其列，以及某位员工的条目。
- 休假：某段日期或某一天谁不在，某个时间点以来变更的申请，带每日明细的单个申请，员工某个政策类型的余额，政策类型、原因代码、政策，以及通过
hibob_search_calendar_events查询公司节假日和停业日。 - 已保存报表，以 JSON 行、CSV 或 XLSX 运行；大型报表用
hibob_request_report_download在后台生成，再用hibob_download_report_by_name获取。 - 入职向导、全公司的未完成任务、某位员工的任务、文档文件夹，以及员工带下载链接的文档。
安装后可写入的内容：hibob_submit_time_off_request（AI 会先用 hibob_get_policy_type 查看政策类型的单位；除非管理员设置 skip_manager_approval，申请按政策的审批流程走），hibob_cancel_time_off_request 和 hibob_complete_task。
安装时关闭：主数据写入工具 hibob_update_employee（只改字段，不改表格行）、hibob_create_work_entry（晋升、调动、更换上级）、hibob_create_custom_table_entry、hibob_add_named_list_item 和 hibob_upload_shared_document（公开或预签名 URL，最大 5 MB，员工本人可见）。由工作区管理员在连接器中有意开启。
数据格式：员工 ID 是以字符串形式发送的长数字（3332883884017713238）。请求使用点号表示法（work.department），响应使用斜杠键（/work/department），同一个值也可能按类别嵌套出现。列表型字段保存的是条目 ID；human_readable: APPEND 或 REPLACE 会附加名称或用名称替换。日期为 YYYY-MM-DD；hibob_list_time_off_changes 接受 ISO 8601 日期时间。余额使用政策类型的单位（天或小时），薪资带有各自的币种。更新后最多 20 秒内，Bob 可能仍返回旧值。
静默省略：没有权限或 ID 错误的字段会直接从响应中消失，不报错。缺少某个值时，先检查服务用户的权限组，再下结论说该值为空。
翻页：员工搜索、个人资料、单人历史、未完成任务（最多 5,000 条）和谁不在会一次返回全部。批量历史工具和 hibob_search_calendar_events 用 cursor 等于 response_metadata.next_cursor 翻页，为 null 时 AI 停止。
限制：速率限制按端点计算（员工搜索每分钟 50 次请求），超出返回 429。谁不在和日历查询的日期范围有最大跨度，休假变更最多只能回溯 6 个月。
常见错误：401 表示 ID 或令牌错误，403 表示服务用户所在组缺少权限，400 表示筛选、字段或日期范围无效。反复出现 401 或 403 可能被 Bob 的防火墙暂时封禁，所以请先修正权限再重试。
该连接器不做薪资核算，不会通过 hibob_update_employee 修改历史表的行，也没有审批或拒绝待处理休假申请的工具。
前提条件: HIBOB_SERVICE_USER_ID, HIBOB_SERVICE_USER_TOKEN
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store，选择 HiBob 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
hibob_search_people | Read employee fields for many employees in one call: everyone the service user can access, or only the employees whose id or email is given… |
hibob_get_employee | Read the fields of one employee, identified by employee id or work email |
hibob_update_employee | Update fields of one employee record |
hibob_list_profiles | Public profile section of every active employee the service user can access: a fixed set of fields such as name, email, work title… |
hibob_list_employee_fields | All employee fields defined in the company (built-in and custom) with their field id (the dot-notation id to pass in fields), name… |
hibob_list_named_lists | All company lists (departments, sites, job titles, calendars, custom lists) with their items: each item has an id, the value Bob stores in… |
hibob_get_named_list | One company list by its internal name (e.g. department, site, title, calendar), with its items, their ids and names, and child items for… |
hibob_add_named_list_item | Add a new item to an existing company list, for example a new department or job title, optionally below a parent item in a hierarchy list |
hibob_list_work_history | Work history of one employee: one entry per change with effective date, title, department, site, manager (reportsTo) and reason |
hibob_list_employment_history | Employment history of one employee: contract type, weekly hours, working pattern, FTE and similar entries, each with its effective date |
hibob_list_lifecycle_history | Lifecycle status history of one employee: hired, employed, on leave, terminated and so on, each with its effective date and reason |
hibob_list_salary_history | Salary (payroll) history of one employee: base pay amount, currency, pay period and frequency, each entry with its effective date |
hibob_bulk_list_work_history | Work history for many employees at once (one page of employees per call, each with all its work entries) |
hibob_bulk_list_lifecycle_history | Lifecycle history for many employees at once (one page of employees per call, each with all its lifecycle entries) |
hibob_bulk_list_salary_history | Salary history for many employees at once (one page of employees per call, each with all its salary entries) |
hibob_create_work_entry | Add a work history entry for an employee (promotion, transfer, new manager, department change) taking effect on a given date |
hibob_list_custom_tables | Custom employee tables defined in the company, with their ids, names and column definitions |
hibob_get_custom_table_metadata | Definition of one custom employee table: its columns with id, name, type and the list id for list columns |
hibob_list_custom_table_entries | All entries of one custom table for one employee; values are keyed by column id |
hibob_create_custom_table_entry | Add one or more entries to an employee's custom table |
hibob_list_whos_out | Time off requests in a date range, for everyone the service user can access: who is out, which policy, request type, dates and status |
hibob_list_out_today | Who is out of the office today (UTC) or on one given date, optionally only at one site |
hibob_list_time_off_changes | Time off requests created, approved, declined, cancelled or deleted since a point in time (at most 6 months back and a 6-month window) |
hibob_get_time_off_request | Details of one time off request of an employee: policy type, dates, portions, status, approver, total cost and (by default) the duration… |
hibob_get_time_off_balance | Time off balance of one employee for one policy type on a given date: the amount available, used, pending and accrued, in the policy's unit… |
hibob_list_policy_types | Names of all time off policy types in the company (Holiday, Sick, custom types) |
hibob_get_policy_type | Settings of one time off policy type: unit (days or hours), allowed request types, whether it is a working type, visibility and similar… |
hibob_list_policy_type_reason_codes | Reason codes defined for one time off policy type, with the numeric id to pass as reason_code when submitting a request |
hibob_list_policy_names | Names of the policies (for example per country or contract) that belong to one time off policy type |
hibob_get_policy | Details of one time off policy: its type, allowance, accrual, carry-over and other rules |
hibob_search_calendar_events | Company holidays and closures (calendar events) in a date range, optionally for one calendar, site or event type |
hibob_submit_time_off_request | Submit a time off request for an employee |
hibob_cancel_time_off_request | Cancel an existing time off request of an employee |
hibob_list_reports | Company reports saved in Bob that the service user can see, with id, name, description, type, folder and dates (the column configuration is… |
hibob_download_report | Run a saved report and return its data. format json gives rows the model can read directly; csv returns text; xlsx returns a file |
hibob_request_report_download | Start generating a saved report in the background, for reports too large to download at once |
hibob_download_report_by_name | Fetch a report file generated by hibob_request_report_download |
hibob_list_onboarding_wizards | Onboarding wizards configured in Bob (id and name), the flows new hires are invited with |
hibob_list_open_tasks | All open tasks in the company (onboarding, offboarding and other flow tasks) with owner, related employee, due date and status |
hibob_list_employee_tasks | Tasks assigned to one employee (onboarding and other flow tasks), open, closed or both |
hibob_complete_task | Mark a task as complete, for example an onboarding step that was done outside Bob |
hibob_list_document_folders | Document folders defined in Bob (shared, confidential and custom folders) with their ids and metadata |
hibob_list_employee_documents | Documents of one employee in the folders the service user may view, with name and a download link per document |
hibob_upload_shared_document | Add a document to an employee's shared folder by giving a public or pre-signed URL that Bob downloads (max 5 MB) |
示例提示
- “下周谁不在办公室？用的是哪种休假政策？”
- “显示 [email protected] 的工作历史：职位、部门和上级，以及各自的生效日期。”
- “员工 3332883884017713238 今年还剩多少天年假？有多少天在待审批？”
- “运行已保存的报表“Headcount by department”，并按地点汇总。”
- “列出所有已逾期的未完成入职任务，附上负责人和对应的新员工。”
下一步
这份指南对你有帮助吗?