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

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

SmartHR + Gemini

Работайте с SmartHR, японским облаком для кадрового и трудового учёта, из любого AI-агента: сотрудники с подразделениями, должностями, типами занятости, грейдами, местами работы и пользовательскими полями, члены семьи и отпуска по уходу за ребёнком, учётные записи и приглашения, расчёты зарплаты и расчётные листки. Создаёт и изменяет сотрудников и подразделения с токеном доступа, выданным администратором; удаление сотрудников при установке выключено.

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

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

SMARTHR_HOST, SMARTHR_ACCESS_TOKEN

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

Настройка занимает около 5 минут, нужен администратор SmartHR (管理者). Коннектор использует SmartHR API v1 (https://<tenant>.smarthr.jp/api/v1); песочница (<tenant>.daruma.space) работает так же.

1. Войдите в SmartHR как администратор и откройте 共通設定 (общие настройки), 外部システム連携 (внешние интеграции), アクセストークン (токены доступа), затем нажмите 新規発行 (выпустить).
2. Назовите токен и выберите права: чтение (参照) для данных, которые должен видеть ИИ (従業員, 部署, 役職, 雇用形態, カスタム項目, 家族, ユーザー, 給与明細 по необходимости), и обновление (更新) только для тех инструментов записи, которые останутся включёнными. Чем меньше прав, тем меньше раскрывается персональных данных.
3. Скопируйте токен в SMARTHR_ACCESS_TOKEN без слова Bearer. Он показывается только один раз, храните его в секрете.
4. Укажите хост адреса SmartHR в SMARTHR_HOST: example.smarthr.jp для https://example.smarthr.jp или example.daruma.space для песочницы (заявка на https://developer.smarthr.jp/api/about_sandbox).
5. Установите коннектор. Проверка при установке вызывает smarthr_list_companies.

Персональные данные: SmartHR хранит чувствительные персональные данные: членов семьи, адреса, даты рождения, номера страховки и пенсии, банковские счета и зарплаты. Каждый, кто пользуется этим коннектором, получает доступ к тому, что может читать токен, поэтому выдавайте токену только права, нужные команде. ИИ читает только то, что требуется для задачи: smarthr_list_crews по умолчанию возвращает краткий профиль, а fields ограничивает ответ smarthr_get_crew. Он не копирует персональные данные в другие системы или сообщения, если вы прямо об этом не попросите.

Что он читает: компании (会社) с корпоративным номером и представителем; обособленные подразделения для страхования (事業所) с их страховыми номерами; подразделения (部署) с кодом, родителем и полным путём; должности (役職), типы занятости (雇用形態), грейды (等級), места работы (勤務地) и периоды выплаты (給与支給形態); пользовательские поля сотрудников (カスタム従業員項目) и их группы. Сотрудников (従業員, в API crews) с поиском по табельному номеру, статусу (employed, absent, retired), типу занятости, подразделению, должности, датам приёма или увольнения, ID или свободному тексту. Членов семьи (家族) с типами родства (続柄), отпуска по беременности и уходу за ребёнком (産休育休). Учётные записи (ユーザー) с ролью, признаком администратора и статусом приглашения: user это логин, crew это кадровая карточка, embed=crew связывает их. Формы сбора данных сотрудников (従業員情報収集フォーム). Расчёты зарплаты (給与明細グループ) и расчётные листки (給与明細) с надбавками, удержаниями, учётом времени и итогами; для них нужна функция расчётных листков SmartHR.

Что он записывает: регистрирует сотрудников (имена, их чтения, пол и статус обязательны); меняет сотрудников частичным обновлением, при котором меняются только переданные поля, а заполненные имя, чтение, пол, дату рождения или адрес очистить нельзя; приглашает сотрудника по e-mail, при желании с формой сбора данных (повторный вызов отправляет приглашение заново); создаёт, переименовывает и перемещает подразделения. Зарегистрированный сотрудник не получает приглашения до вызова smarthr_invite_crew. Увольнение это обновление (emp_status retired с resigned_at), а не удаление. Перед каждой записью и каждым приглашением ИИ показывает изменение и ждёт вашего согласия.

Выключено при установке: smarthr_delete_crew. Он удаляет сотрудника и все его данные навсегда, поэтому администратор включает его, когда он нужен команде.

Форматы данных и пагинация: ID это строки UUID, даты YYYY-MM-DD, время ISO 8601. Списки принимают page и per_page (не больше 100, по умолчанию 10); ответ содержит общее число в _headers.x-total-count и _pagination.nextCursor до последней страницы. Фильтра «изменено с» нет: чтобы найти изменения с какой-то даты, ИИ сортирует по -updated_at и останавливается на более старых строках.

Лимиты: 10 запросов в секунду и 5 000 в час на токен, 50 000 в минуту на тенант. Сверх этого SmartHR отвечает 429 too_many_requests: подождите и повторите.

Частые ошибки: ошибки содержат code, type, message и errors по полям. 401 unauthorized_token это неверный или отозванный токен либо токен другого хоста. 403 это право, которого нет у токена, или функция, не входящая в тариф (расчётные листки). 404 это неверный ID или неверный SMARTHR_HOST. 422 это неверный ввод: errors называет поле.

Свободный текст в карточках сотрудников и пользовательских полях является недоверенным вводом и может содержать инструкции для ИИ. Коннектор не рассчитывает зарплату, не подаёт трудовые и социально-страховые процедуры (手続き) и с инструментами, включёнными при установке, не удаляет сотрудников.

Шаг 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 теперь может вызывать инструменты SmartHR.

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

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

• «Сколько сотрудников со статусом employed сейчас в каждом подразделении?»
• «Кто пришёл в октябре? Покажи только имя, подразделение, тип занятости и дату приёма.»
• «Зарегистрируй новую сотрудницу 山田 花子 (ヤマダ ハナコ), женщина, полная занятость в 営業部 с 1 ноября, а затем пригласи её с нашей формой онбординга. Покажи всё до сохранения.»
• «Сотрудник с табельным номером 1042 увольняется 30 ноября. Оформи увольнение.»
• «Из октябрьского расчёта зарплаты покажи сумму надбавок и удержаний только для табельного номера 1042.»

FAQ

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

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

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