Пропустите установку. Заработает меньше чем за 2 минуты.
Начните бесплатный период на cloud.anythingmcp.com, добавьте SmartHR одним кликом и направьте свой ИИ-клиент (Claude, ChatGPT, Copilot или Cursor) на сгенерированный MCP-эндпоинт. Без Docker, без git clone, без опыта разработки.
Кратко
Работайте с SmartHR, японским облаком для кадрового и трудового учёта, из любого AI-агента: сотрудники с подразделениями, должностями, типами занятости, грейдами, местами работы и пользовательскими полями, члены семьи и отпуска по уходу за ребёнком, учётные записи и приглашения, расчёты зарплаты и расчётные листки. Создаёт и изменяет сотрудников и подразделения с токеном доступа, выданным администратором; удаление сотрудников при установке выключено.
Попробуй спросить
Примеры промптов для SmartHR
Кликни по промпту — он скопируется. Вставь в Claude, ChatGPT, Cursor, Gemini, Copilot или OpenClaw и запусти через этот коннектор.
Claude — это AI, он может ошибаться. Проверяйте ответы.
💡 Без установки? Используйте cloud.anythingmcp.com напрямую. Войдите, нажмите Connectors → SmartHR, вставьте учётные данные, создайте MCP API key, и готово. Без Docker, без
git clone, без локального сервера.
SmartHR + Microsoft Copilot
Работайте с SmartHR, японским облаком для кадрового и трудового учёта, из любого AI-агента: сотрудники с подразделениями, должностями, типами занятости, грейдами, местами работы и пользовательскими полями, члены семьи и отпуска по уходу за ребёнком, учётные записи и приглашения, расчёты зарплаты и расчётные листки. Создаёт и изменяет сотрудников и подразделения с токеном доступа, выданным администратором; удаление сотрудников при установке выключено.
Предварительные требования
Полные инструкции по настройке встроены в коннектор (видны в магазине при выборе коннектора). Требуемые переменные окружения:
SMARTHR_HOST, SMARTHR_ACCESS_TOKEN
Шаг 1 — Получите учётные данные
Настройка занимает около 5 минут, нужен администратор SmartHR (管理者). Коннектор использует SmartHR API v1 (https://<tenant>.smarthr.jp/api/v1); песочница (<tenant>.daruma.space) работает так же.
- Войдите в SmartHR как администратор и откройте 共通設定 (общие настройки), 外部システム連携 (внешние интеграции), アクセストークン (токены доступа), затем нажмите 新規発行 (выпустить).
- Назовите токен и выберите права: чтение (参照) для данных, которые должен видеть ИИ (従業員, 部署, 役職, 雇用形態, カスタム項目, 家族, ユーザー, 給与明細 по необходимости), и обновление (更新) только для тех инструментов записи, которые останутся включёнными. Чем меньше прав, тем меньше раскрывается персональных данных.
- Скопируйте токен в
SMARTHR_ACCESS_TOKENбез слова Bearer. Он показывается только один раз, храните его в секрете. - Укажите хост адреса SmartHR в
SMARTHR_HOST:example.smarthr.jpдля https://example.smarthr.jp илиexample.daruma.spaceдля песочницы (заявка на https://developer.smarthr.jp/api/about_sandbox). - Установите коннектор. Проверка при установке вызывает
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 — Добавьте коннектор в Microsoft Copilot
URL вашего сервера: в AnythingMCP откройте MCP Servers → сервер, на котором находится этот коннектор, и скопируйте его URL (
https://cloud.anythingmcp.com/mcp/…). Используйте его везде, где в этом руководстве указаноYOUR_SERVER_ID.
Microsoft Copilot использует MCP-серверы через агентов, созданных в Copilot Studio: ты добавляешь AnythingMCP в агента как инструмент, а затем публикуешь агента в Microsoft 365 Copilot и Teams. Copilot Studio подключается из облака Microsoft по Streamable HTTP, который AnythingMCP поддерживает.
- В Copilot Studio открой своего агента (или создай нового), перейди в Tools и выбери Add a tool → New tool → Model Context Protocol.
- Укажи Server name (например,
AnythingMCP), Server description, которое объясняет, что делает коннектор, и Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. По описанию Copilot Studio решает, когда вызывать сервер. - В аутентификации выбери API key, установи Type в Header, укажи имя заголовка
X-API-Keyи нажми Create. - В окне Add tool выбери Create a new connection, вставь MCP API-ключ из AnythingMCP (MCP Servers → твой сервер → API keys) и нажми Add to agent.
- Проверь в панели Test агента: попроси о том, для чего нужны инструменты
SmartHR. - Нажми Publish, затем Channels → Microsoft 365 and Microsoft Teams, оставь включённым Make agent available in Microsoft Copilot и нажми Add channel. See agent in Teams установит агента для тебя; в Microsoft 365 Copilot введи @ и выбери агента.
Хочешь, чтобы каждый входил под своей учётной записью? Вместо API-ключа выбери OAuth 2.0 → Dynamic discovery: каждый пользователь войдёт в AnythingMCP при первом вызове агентом.
Размещаешь сам? Используй публичный HTTPS-адрес своего экземпляра вместо https://cloud.anythingmcp.com. Copilot Studio подключается из облака Microsoft, поэтому localhost не подойдёт.
Доступные инструменты
| Tool | What it does |
|---|---|
smarthr_list_companies | List the companies (会社) of the SmartHR tenant: id, name, corporate number, address and representative |
smarthr_list_biz_establishments | List the business establishments (事業所) used for social and labour insurance: id, name, address, insurance numbers and owner |
smarthr_list_departments | List departments (部署) with id, name, code, position (sort order), parent and full path |
smarthr_get_department | Read one department (部署) with its name, code, parent and position in the tree |
smarthr_create_department | Create a department (部署), optionally under a parent department |
smarthr_update_department | Rename or move a department (部署): name is always sent; code, parent and position only when given |
smarthr_list_job_titles | List job titles (役職, positions) with id, name and rank |
smarthr_list_employment_types | List employment types (雇用形態) with id, name and preset_type (full_timer, part_timer, contract_worker ...) |
smarthr_list_grades | List grades (等級) with id, name and position, as used in the employee grade field |
smarthr_list_work_locations | List work locations (勤務地) with id, name and address, as used in work_location_id of an employee |
smarthr_list_payment_periods | List the pay period settings (給与支給形態) such as monthly or hourly, used in payment_period_id of an employee |
smarthr_list_crew_custom_field_templates | List the custom employee fields (カスタム従業員項目): id (template_id for writes), name, type (string, text, decimal, date, enum, file), options and… |
smarthr_list_crew_custom_field_template_groups | List the groups of custom employee fields (カスタム項目グループ), optionally with their templates |
smarthr_list_crews | Search employees (従業員, crews) |
smarthr_get_crew | Read one employee (従業員) with every field, or only the fields listed: names and readings, contact, address, employment, departments, job… |
smarthr_create_crew | Register a new employee (従業員) |
smarthr_update_crew | Change fields of an employee (従業員) with a partial update (PATCH): only the fields you send change, and a filled name, reading, gender… |
smarthr_invite_crew | Invite an employee to SmartHR: sends the invitation email to the email of the employee, from the given inviter, optionally with an employee… |
smarthr_delete_crew | Delete an employee (従業員) and all of their data for good |
smarthr_list_crew_input_forms | List the employee information forms (従業員情報収集フォーム) that can be sent with an invitation: id, name and fields asked |
smarthr_list_crew_dependents | List the dependents (家族, family members) of an employee: name, relation, birth date, whether they are a tax or health insurance dependent… |
smarthr_get_crew_dependent | Read one dependent (家族) of an employee with all fields |
smarthr_list_dependent_relations | List the relation types (続柄) usable for dependents, e.g. spouse, child; filter spouse returns only spouse relations |
smarthr_list_crew_childcare_leaves | List maternity and childcare leaves (産休育休) of an employee with their periods |
smarthr_list_users | List SmartHR user accounts (ユーザー): id, email, role, admin flag, invitation state and, with embed crew, the linked employee |
smarthr_get_user | Read one SmartHR user account with role, admin flag and invitation dates |
smarthr_list_payrolls | List payroll runs (給与明細グループ): id, payment type (salary or bonus), paid date, period, status (fixed, published) and name |
smarthr_get_payroll | Read one payroll run (給与明細グループ) with its status, dates and settings |
smarthr_list_payslips | List the payslips (給与明細) of a payroll run: per employee the allowances, deductions, attendance and totals |
smarthr_get_payslip | Read one payslip (給与明細) with allowances, deductions, attendance and aggregates |
Примеры запросов
- «Сколько сотрудников со статусом employed сейчас в каждом подразделении?»
- «Кто пришёл в октябре? Покажи только имя, подразделение, тип занятости и дату приёма.»
- «Зарегистрируй новую сотрудницу 山田 花子 (ヤマダ ハナコ), женщина, полная занятость в 営業部 с 1 ноября, а затем пригласи её с нашей формой онбординга. Покажи всё до сохранения.»
- «Сотрудник с табельным номером 1042 увольняется 30 ноября. Оформи увольнение.»
- «Из октябрьского расчёта зарплаты покажи сумму надбавок и удержаний только для табельного номера 1042.»
FAQ
Для какого Copilot это руководство? Для Microsoft 365 Copilot на работе — через агентов Copilot Studio. В приложении Microsoft Copilot для личных аккаунтов добавить свой MCP-сервер нельзя.
Что нужно? Рабочий аккаунт с доступом к Copilot Studio (лицензия или пробная версия), чтобы создать агента. Тем, кто будет пользоваться им в Microsoft 365 Copilot или Teams, нужен доступ к агенту: поделись им или попроси администратора опубликовать его для организации. Если в организации действуют политики данных для коннекторов Power Platform, они распространяются и на MCP-серверы.
Агент не вызывает инструменты. Проверь, что имя заголовка — ровно X-API-Key, а ключ относится к тому же MCP-серверу, что и URL, и сделай Server description конкретным: по нему Copilot Studio решает, когда вызывать сервер. После каждого изменения опубликуй агента заново; в открытом чате введи «start over», чтобы перейти на новую версию.
Следующие шаги
- Страница коннектора
- Подключить к Claude
- Подключить к ChatGPT
- Подключить к Cursor
- Подключить к Gemini
- Подключить к Meta Muse
Это руководство помогло?