Deputy a MCP: turnos, partes de horas, ausencias, disponibilidad y empleados en cualquier agente de IA

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Deputy, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Deputy

Gestión de personal con Deputy para una instalación: empleados, ubicaciones y áreas, turnos (rosters) con copia y publicación, partes de horas con fichaje de entrada y salida y aprobación, ausencias e indisponibilidad, memos, notas del responsable y cualquier otro registro a través de la resource query API. Se conecta con un token permanente.

Configuración

La configuración lleva unos 5 minutos y necesita un administrador del sistema de Deputy.

1. Apunta la dirección de tu instalación desde la barra del navegador con la sesión iniciada, por ejemplo mycompany.au.deputy.com (regiones au, eu, uk y na para EE. UU.). Ponla en DEPUTY_HOST sin https:// y sin ruta.
2. Abre https://<la dirección de tu instalación>/exec/devapp/oauth_clients, añade un cliente OAuth (cualquier nombre y descripción; el client id no se usa) y haz clic en Get an Access Token.
3. Copia enseguida el token permanente (solo se muestra una vez) en DEPUTY_ACCESS_TOKEN. Instala el conector: deputy_get_me es la comprobación de instalación.

El token solo funciona en la instalación que lo emitió y actúa como el usuario que lo creó, con sus permisos. Un administrador del sistema ve todas las ubicaciones.

Datos personales: los registros de empleados contienen nombres, fechas de nacimiento, datos de contacto, direcciones y datos salariales. Pide solo lo que necesita la tarea.

El vocabulario de Deputy: una ubicación (centro de trabajo) es una Company, un área (departamento) una OperationalUnit, un turno un Roster, el tiempo realmente trabajado un Timesheet y un tipo de ausencia un registro LeaveRules.

Qué lee:

• El usuario del token: deputy_get_me y sus propios turnos, partes de horas, ausencias, indisponibilidades, ubicaciones y compañeros (deputy_get_my_rosters, deputy_get_my_timesheets, deputy_get_my_leave, deputy_get_my_unavailability, deputy_get_my_locations, deputy_get_my_colleagues).
• Estructura y personas: deputy_list_locations, deputy_list_areas (cada área pertenece a una ubicación; turnos y partes de horas usan ids de área), deputy_list_employees, deputy_get_employee, deputy_query_employees para filtrar y deputy_get_employee_shift_status para saber quién está trabajando ahora.
• Turnos: deputy_list_rosters cubre de 12 horas atrás a 36 horas adelante; deputy_query_rosters cualquier periodo, empleado o área (filtros sobre Date, Employee, OperationalUnit).
• Tiempo: deputy_query_timesheets y deputy_get_timesheet (tramos, pausas, líneas de pago, comentarios y estado de aprobación).
• Ausencias y disponibilidad: deputy_query_leave, deputy_get_employee_leave, deputy_get_employee_unavailability y deputy_query_availability. Los tipos de ausencia salen de deputy_query_resource con object LeaveRules.
• Todo lo demás (equipos, festivos, eventos, formación, campos personalizados, datos de ventas, periodos de pago y más): deputy_get_resource_info lista los campos de un objeto, deputy_query_resource lo busca y deputy_get_resource lee un registro.

Qué escribe:

• Turnos: deputy_save_shift añade un turno o, con roster_id, lo actualiza; deputy_copy_rosters copia hacia delante un rango de fechas de algunas áreas (por ejemplo, de la semana pasada a esta); deputy_publish_rosters publica turnos con la notificación elegida (notify 1 SMS y email, 2 SMS, 3 email, 4 ninguna, 5 pedir confirmación a los empleados).
• Tiempo: deputy_start_timesheet, deputy_pause_timesheet (llamarlo de nuevo termina la pausa) y deputy_end_timesheet fichan la entrada y la salida de un empleado; deputy_save_timesheet añade o corrige un parte de horas terminado; deputy_approve_timesheet aprueba el tiempo para que pueda exportarse a nómina.
• Ausencias y disponibilidad: deputy_add_leave (estado 0 espera la aprobación del responsable, 1 registra una ausencia ya aprobada que afecta a partes de horas y saldos), deputy_update_leave (aprobar, rechazar o cancelar con status 1, 2 o 3) y deputy_add_unavailability (puntual o periódica, por ejemplo un lunes de cada dos).
• Empleados: deputy_add_employee, deputy_update_employee, deputy_invite_employee (envía por email una invitación para acceder), deputy_terminate_employee (ya no puede entrar ni recibir turnos; reversible) y deputy_reactivate_employee.
• Notas y noticias: deputy_post_journal añade una nota privada del responsable al perfil de un empleado; deputy_post_memo publica en el feed de noticias de una ubicación, opcionalmente a usuarios concretos y pidiendo confirmación de lectura.

Los turnos publicados, las invitaciones y los memos llegan a empleados reales, así que revisa turnos y notificación antes de pedirlos.

Desactivadas al instalar: deputy_delete_employee, deputy_discard_rosters y deputy_discard_timesheet. No se pueden deshacer; un administrador del workspace las activa cuando el equipo las necesita. Dar de baja a un empleado con deputy_terminate_employee es la alternativa reversible a borrarlo.

Herramientas de consulta: deputy_query_* y deputy_query_resource envían POST pero solo leen. El cuerpo search lleva condiciones que deben cumplirse todas, por ejemplo {"s1":{"field":"Date","type":"ge","data":"2026-11-01"},"s2":{"field":"Date","type":"le","data":"2026-11-07"}}, con los operadores eq, ne, gt, ge, lt, le, in, not in, starts, contains, is e is not. sort ({"Date":"asc"}) y join (["EmployeeObject"]) son opcionales.

Formatos de datos: los ids son enteros. StartTime, EndTime y las entradas start y end son marcas de tiempo Unix en segundos; los campos Date son fechas locales de la ubicación (2026-11-03T00:00:00+11:00), así que las horas se convierten con la zona horaria de la ubicación. Un roster con Employee 0 es un turno abierto, Published false un borrador. El estado del parte de horas está en TimeApproved, PayRuleApproved, Discarded e IsInProgress; TotalTime va en horas. Status de ausencias: 0 pendiente de aprobación, 1 aprobada, 2 rechazada, 3 cancelada, 4 pago aprobado. Añadir o actualizar un turno responde 200 con el cuerpo vacío; la IA comprueba el resultado con deputy_query_rosters.

Paginación: una respuesta tiene como máximo 500 registros. Las herramientas de consulta aceptan max (hasta 500) y start (desplazamiento); cuando una página llega llena, la IA vuelve a llamar con start aumentado en max. Las herramientas de lista sin paginación devuelven en una respuesta todo lo que Deputy permite.

Errores comunes: 401 indica un token erróneo o de otra instalación, 403 un permiso que le falta al usuario del token, 404 una dirección de instalación o un id de registro incorrectos, 400 un nombre de campo erróneo en un filtro (compruébalo con deputy_get_resource_info).

El conector no exporta por sí mismo los partes de horas a un sistema de nómina, no crea ubicaciones ni áreas y no borra nada mientras las herramientas de borrado estén desactivadas.

Requisitos previos: DEPUTY_HOST, DEPUTY_ACCESS_TOKEN

Instalar el conector localmente

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

Abre http://localhost:3000/connectors/store, elige Deputy e introduce las variables listadas en los Requisitos previos.

Herramientas disponibles

Ejemplos de prompts

• "¿Quién está trabajando ahora en la tienda de Sydney y quién entra después?"
• "Muéstrame los turnos de la semana que viene del área Cocina, incluidos los turnos abiertos."
• "Lista los partes de horas de la semana pasada que aún no están aprobados, con empleado y horas totales."
• "Copia los turnos de la semana pasada del área Bar a esta semana y enséñame los borradores antes de publicarlos."
• "¿Qué solicitudes de ausencia están pendientes de aprobación este mes?"

Siguientes pasos

• Conectar a Claude
• Conectar a ChatGPT