Как подключить HiBob к Gemini через MCP

💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → HiBob, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без git clone, без локального сервера.

HiBob + Gemini

HR-платформа HiBob (Bob) через публичный API с сервисным пользователем: поиск и карточки сотрудников, история должностей, занятости, жизненного цикла и зарплаты, пользовательские таблицы, списки компании, отсутствия с тем, кто отсутствует, заявками, остатками и политиками, праздники, сохранённые отчёты, онбординг, задачи и документы. Запись в основные данные при установке отключена.

Предварительные требования

Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:

HIBOB_SERVICE_USER_ID, HIBOB_SERVICE_USER_TOKEN

Шаг 1 — Получите учётные данные

Настройка занимает около 10 минут, нужен администратор Bob. Коннектор работает с публичным REST API Bob (https://api.hibob.com/v1) через сервисного пользователя.

1. В Bob под администратором откройте Settings > Integrations > Automation > Service Users, нажмите Manage и создайте сервисного пользователя с именем и отображаемым именем. Сразу скопируйте его ID и token: токен показывается только при создании. Потерянный токен можно сгенерировать заново, старый при этом перестаёт действовать.
2. Создайте для сервисного пользователя отдельную группу прав (permission group) и добавьте его туда. У новой группы нет прав, поэтому выдайте только то, что используете:
   • People's data > People's fields: View на категории, которые читаете (для hibob_search_people как минимум root, about, employment и work), View history на таблицы истории (work, employment, lifecycle, payroll), 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 для общей папки.
3. Вставьте ID в HIBOB_SERVICE_USER_ID, а токен в HIBOB_SERVICE_USER_TOKEN. Они передаются через HTTP Basic auth.
4. Установите коннектор и запустите 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 или рабочему email, hibob_list_profiles даёт быстрый справочник. В большой компании ИИ сначала ищет с 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 (ИИ сначала проверяет единицу типа политики через 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 МБ, документ виден сотруднику). Администратор рабочего пространства включает их в коннекторе осознанно.

Форматы данных: id сотрудников это длинные числа, передаваемые строками (3332883884017713238). В запросах используется точечная нотация (work.department), в ответах ключи через косую черту (/work/department), и то же значение может дополнительно быть вложено по категории. Поля-списки содержат id элементов; human_readable: APPEND или REPLACE добавляет названия или подставляет их вместо id. Даты в формате YYYY-MM-DD; hibob_list_time_off_changes принимает дату-время ISO 8601. Остатки указаны в единице типа политики (дни или часы), зарплаты в своей валюте. После обновления Bob до 20 секунд может возвращать старое значение.

Тихое пропускание: поле без прав или с неверным id просто отсутствует в ответе, без ошибки. Если чего-то не хватает, проверьте группу прав сервисного пользователя, прежде чем решать, что значение пустое.

Постраничный вывод: поиск сотрудников, профили, история одного сотрудника, открытые задачи (не больше 5 000) и список отсутствующих возвращаются целиком. Пакетные инструменты истории и hibob_search_calendar_events листают с cursor, равным response_metadata.next_cursor; ИИ останавливается, когда он равен null.

Ограничения: лимиты запросов действуют для каждой конечной точки (поиск сотрудников допускает 50 запросов в минуту), при превышении приходит 429. У списка отсутствующих и диапазонов календаря есть максимальная длина, а изменения отсутствий доступны не более чем за 6 месяцев назад.

Частые ошибки: 401 означает неверный ID или токен, 403 нехватку прав в группе сервисного пользователя, 400 неверный фильтр, поле или диапазон дат. Повторяющиеся ответы 401 или 403 файрвол Bob может на время заблокировать, поэтому исправьте права до повторной попытки.

Коннектор не рассчитывает зарплату, не меняет строки таблиц истории через hibob_update_employee и не имеет инструментов для согласования или отклонения ожидающих заявок на отсутствие.

Шаг 2 — Установите адаптер

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

Шаг 3 — Добавьте коннектор в Gemini

URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указано YOUR_SERVER_ID.

Gemini CLI читает MCP-серверы из ~/.gemini/settings.json (в Windows: %USERPROFILE%\.gemini\settings.json). Добавь:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Создай MCP API-ключ в AnythingMCP в разделе MCP Servers → твой сервер → API keys и вставь его вместо YOUR_MCP_API_KEY.
2. Сохрани файл и перезапусти gemini.
3. Выполни /mcp в Gemini CLI (или gemini mcp list в терминале): anythingmcp должен отображаться как подключённый.
4. Начинай писать промпты: Gemini CLI теперь может вызывать инструменты HiBob.

Доступные инструменты

Примеры запросов

• «Кто будет отсутствовать на следующей неделе и по какой политике отсутствия?»
• «Покажи историю должностей [email protected]: должности, отделы и руководители с датами вступления в силу.»
• «Сколько дней отпуска осталось в этом году у сотрудника 3332883884017713238 и сколько ожидает согласования?»
• «Запусти сохранённый отчёт «Headcount by department» и сведи его по площадкам.»
• «Перечисли все открытые просроченные задачи онбординга с ответственным и новым сотрудником, к которому они относятся.»

FAQ

Где Gemini CLI ищет MCP-серверы? В ~/.gemini/settings.json для твоего пользователя или в .gemini/settings.json внутри проекта. gemini mcp list показывает каждый сервер и статус подключения.

Следующие шаги

• Страница коннектора
• Подключить к Claude
• Подключить к ChatGPT
• Подключить к Cursor
• Подключить к Meta Muse
• Подключить к Microsoft Copilot