Deputy в MCP: графики смен, табели, отсутствия, доступность и сотрудники в любом AI-агенте

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

Deputy

Управление персоналом Deputy для одной инсталляции: сотрудники, локации и зоны, графики смен (rosters) с копированием и публикацией, табели с отметкой прихода и ухода и утверждением, отсутствия и недоступность, мемо, заметки руководителя и любые другие записи через resource query API. Подключается с постоянным токеном.

Настройка

Настройка занимает около 5 минут, нужен системный администратор Deputy.

1. Запишите адрес вашей инсталляции из адресной строки браузера, когда вы вошли в систему, например mycompany.au.deputy.com (регионы au, eu, uk и na для США). Укажите его в DEPUTY_HOST без https:// и без пути.
2. Откройте https://<адрес вашей инсталляции>/exec/devapp/oauth_clients, добавьте OAuth-клиент (любое имя и описание; сам client id не используется) и нажмите Get an Access Token.
3. Сразу скопируйте постоянный токен (он показывается только один раз) в DEPUTY_ACCESS_TOKEN. Установите коннектор: deputy_get_me служит проверкой установки.

Токен работает только в той инсталляции, которая его выдала, и действует от имени создавшего его пользователя с его правами. Системный администратор видит все локации.

Персональные данные: записи сотрудников содержат имена, даты рождения, контакты, адреса и данные об оплате. Запрашивайте только то, что нужно для задачи.

Термины Deputy: локация (место работы) называется Company, зона (отдел) OperationalUnit, смена Roster, фактически отработанное время Timesheet, а тип отсутствия это запись LeaveRules.

Что он читает:

• Пользователь токена: deputy_get_me и его собственные смены, табели, отсутствия, недоступность, локации и коллеги (deputy_get_my_rosters, deputy_get_my_timesheets, deputy_get_my_leave, deputy_get_my_unavailability, deputy_get_my_locations, deputy_get_my_colleagues).
• Структура и люди: deputy_list_locations, deputy_list_areas (каждая зона принадлежит локации; смены и табели используют id зон), deputy_list_employees, deputy_get_employee, deputy_query_employees для фильтров и deputy_get_employee_shift_status, чтобы узнать, кто работает прямо сейчас.
• График: deputy_list_rosters охватывает период от 12 часов назад до 36 часов вперёд; deputy_query_rosters любой период, сотрудника или зону (фильтры по Date, Employee, OperationalUnit).
• Время: deputy_query_timesheets и deputy_get_timesheet (слоты, перерывы, строки оплаты, комментарии и статус утверждения).
• Отсутствия и доступность: deputy_query_leave, deputy_get_employee_leave, deputy_get_employee_unavailability и deputy_query_availability. Типы отсутствий даёт deputy_query_resource с object LeaveRules.
• Всё остальное (команды, праздники, события, обучение, пользовательские поля, данные продаж, расчётные периоды и другое): deputy_get_resource_info перечисляет поля объекта, deputy_query_resource ищет по нему, deputy_get_resource читает одну запись.

Что он записывает:

• График: deputy_save_shift добавляет смену или, с roster_id, обновляет её; deputy_copy_rosters копирует диапазон дат некоторых зон вперёд (например, прошлую неделю на текущую); deputy_publish_rosters публикует смены с выбранным уведомлением (notify 1 SMS и email, 2 SMS, 3 email, 4 без уведомления, 5 попросить сотрудников подтвердить).
• Время: deputy_start_timesheet, deputy_pause_timesheet (повторный вызов завершает перерыв) и deputy_end_timesheet отмечают приход и уход сотрудника; deputy_save_timesheet добавляет или исправляет завершённый табель; deputy_approve_timesheet утверждает время, чтобы его можно было выгрузить в расчёт зарплаты.
• Отсутствия и доступность: deputy_add_leave (статус 0 ждёт утверждения руководителем, 1 фиксирует уже утверждённое отсутствие, которое влияет на табели и остатки), deputy_update_leave (утвердить, отклонить или отменить через status 1, 2 или 3) и deputy_add_unavailability (разово или с повтором, например каждый второй понедельник).
• Сотрудники: deputy_add_employee, deputy_update_employee, deputy_invite_employee (отправляет приглашение для входа по email), deputy_terminate_employee (сотрудник больше не может войти и не попадает в график; обратимо) и deputy_reactivate_employee.
• Заметки и новости: deputy_post_journal добавляет в профиль сотрудника личную заметку руководителя; deputy_post_memo публикует сообщение в ленте новостей локации, при желании выбранным пользователям и с просьбой подтвердить прочтение.

Опубликованные смены, приглашения и мемо доходят до реальных сотрудников, поэтому проверьте смены и способ уведомления, прежде чем просить об этом.

Отключены при установке: deputy_delete_employee, deputy_discard_rosters и deputy_discard_timesheet. Их действие нельзя отменить; администратор workspace включает их, когда они нужны команде. Вместо удаления сотрудника можно обратимо деактивировать его через deputy_terminate_employee.

Инструменты запросов: deputy_query_* и deputy_query_resource отправляют POST, но только читают. Тело search содержит условия, которые должны выполняться все, например {"s1":{"field":"Date","type":"ge","data":"2026-11-01"},"s2":{"field":"Date","type":"le","data":"2026-11-07"}}, с операторами eq, ne, gt, ge, lt, le, in, not in, starts, contains, is и is not. sort ({"Date":"asc"}) и join (["EmployeeObject"]) необязательны.

Форматы данных: id это целые числа. StartTime, EndTime и входные start и end это Unix-метки времени в секундах; поля Date это локальные даты локации (2026-11-03T00:00:00+11:00), поэтому время пересчитывается по часовому поясу локации. Roster с Employee 0 это открытая смена, Published false черновик. Статус табеля показывают TimeApproved, PayRuleApproved, Discarded и IsInProgress; TotalTime в часах. Status отсутствия: 0 ждёт утверждения, 1 утверждено, 2 отклонено, 3 отменено, 4 оплата утверждена. Добавление или изменение смены отвечает 200 с пустым телом; ИИ проверяет результат через deputy_query_rosters.

Постраничный вывод: в ответе не более 500 записей. Инструменты запросов принимают max (до 500) и start (смещение); если страница заполнена, ИИ вызывает снова, увеличив start на max. Инструменты списков без постраничного вывода возвращают всё, что разрешает Deputy, одним ответом.

Частые ошибки: 401 означает неверный токен или токен другой инсталляции, 403 право, которого нет у пользователя токена, 404 неверный адрес инсталляции или id записи, 400 неверное имя поля в фильтре (проверьте его через deputy_get_resource_info).

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

Предварительные требования: DEPUTY_HOST, DEPUTY_ACCESS_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, выберите Deputy и введите переменные, перечисленные в Предварительных требованиях.

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

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

• «Кто сейчас работает в магазине в Sydney и кто выходит следующим?»
• «Покажи график на следующую неделю для зоны Кухня, включая открытые смены.»
• «Выведи табели прошлой недели, которые ещё не утверждены, с сотрудником и общим числом часов.»
• «Скопируй смены прошлой недели в зоне Бар на эту неделю и покажи мне черновики перед публикацией.»
• «Какие заявки на отсутствие ждут утверждения в этом месяце?»

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

• Подключить к Claude
• Подключить к ChatGPT