Deputy su MCP: turni, timesheet, assenze, disponibilità e dipendenti in qualsiasi agente AI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Deputy, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Deputy

Gestione del personale Deputy per un'installazione: dipendenti, sedi e aree, turni (roster) con copia e pubblicazione, timesheet con timbratura di entrata e uscita e approvazione, assenze e indisponibilità, memo, note del manager e qualsiasi altro record tramite la resource query API. Si collega con un token permanente.

Setup

La configurazione richiede circa 5 minuti e serve un amministratore di sistema di Deputy.

1. Annota l'indirizzo della tua installazione dalla barra del browser quando hai effettuato l'accesso, ad esempio mycompany.au.deputy.com (regioni au, eu, uk e na per gli Stati Uniti). Inseriscilo in DEPUTY_HOST senza https:// e senza percorso.
2. Apri https://<indirizzo della tua installazione>/exec/devapp/oauth_clients, aggiungi un client OAuth (nome e descrizione a piacere; il client id non viene usato), poi fai clic su Get an Access Token.
3. Copia subito il token permanente (viene mostrato una sola volta) in DEPUTY_ACCESS_TOKEN. Installa il connettore: deputy_get_me è il controllo di installazione.

Il token funziona solo sull'installazione che lo ha emesso e agisce come l'utente che lo ha creato, con i suoi permessi. Un amministratore di sistema vede tutte le sedi.

Dati personali: i record dei dipendenti contengono nomi, date di nascita, recapiti, indirizzi e dati retributivi. Chiedi solo ciò che serve al compito.

Le parole di Deputy: una sede (luogo di lavoro) è una Company, un'area (reparto) una OperationalUnit, un turno un Roster, il tempo effettivamente lavorato un Timesheet e un tipo di assenza un record LeaveRules.

Cosa legge:

• L'utente del token: deputy_get_me e i suoi turni, timesheet, assenze, indisponibilità, sedi e colleghi (deputy_get_my_rosters, deputy_get_my_timesheets, deputy_get_my_leave, deputy_get_my_unavailability, deputy_get_my_locations, deputy_get_my_colleagues).
• Struttura e persone: deputy_list_locations, deputy_list_areas (ogni area appartiene a una sede; turni e timesheet usano gli id delle aree), deputy_list_employees, deputy_get_employee, deputy_query_employees per i filtri e deputy_get_employee_shift_status per sapere chi sta lavorando adesso.
• Turni: deputy_list_rosters copre da 12 ore indietro a 36 ore avanti; deputy_query_rosters qualsiasi periodo, dipendente o area (filtri su Date, Employee, OperationalUnit).
• Tempo: deputy_query_timesheets e deputy_get_timesheet (slot, pause, voci di paga, commenti e stato di approvazione).
• Assenze e disponibilità: deputy_query_leave, deputy_get_employee_leave, deputy_get_employee_unavailability e deputy_query_availability. I tipi di assenza arrivano da deputy_query_resource con object LeaveRules.
• Tutto il resto (team, festività, eventi, formazione, campi personalizzati, dati di vendita, periodi di paga e altro): deputy_get_resource_info elenca i campi di un oggetto, deputy_query_resource lo cerca e deputy_get_resource legge un singolo record.

Cosa scrive:

• Turni: deputy_save_shift aggiunge un turno o, con roster_id, lo aggiorna; deputy_copy_rosters copia in avanti un intervallo di date di alcune aree (ad esempio dalla settimana scorsa a questa); deputy_publish_rosters pubblica i turni con la notifica scelta (notify 1 SMS ed email, 2 SMS, 3 email, 4 nessuna, 5 chiede ai dipendenti di confermare).
• Tempo: deputy_start_timesheet, deputy_pause_timesheet (richiamarlo termina la pausa) e deputy_end_timesheet timbrano entrata e uscita di un dipendente; deputy_save_timesheet aggiunge o corregge un timesheet concluso; deputy_approve_timesheet approva il tempo perché possa essere esportato nelle paghe.
• Assenze e disponibilità: deputy_add_leave (stato 0 attende l'approvazione del manager, 1 registra un'assenza già approvata che incide su timesheet e saldi), deputy_update_leave (approva, rifiuta o annulla con status 1, 2 o 3) e deputy_add_unavailability (una tantum o ricorrente, ad esempio un lunedì sì e uno no).
• Dipendenti: deputy_add_employee, deputy_update_employee, deputy_invite_employee (invia per email un invito ad accedere), deputy_terminate_employee (non può più accedere né essere messo in turno; reversibile) e deputy_reactivate_employee.
• Note e notizie: deputy_post_journal aggiunge una nota privata del manager al profilo di un dipendente; deputy_post_memo pubblica nel feed di notizie di una sede, facoltativamente a utenti scelti e chiedendo conferma di lettura.

Turni pubblicati, inviti e memo arrivano a dipendenti reali, quindi controlla turni e notifica prima di chiederli.

Disattivati all'installazione: deputy_delete_employee, deputy_discard_rosters e deputy_discard_timesheet. Non si possono annullare; un amministratore del workspace li attiva quando servono al team. Cessare un dipendente con deputy_terminate_employee è l'alternativa reversibile all'eliminazione.

Strumenti di query: deputy_query_* e deputy_query_resource inviano POST ma leggono soltanto. Il corpo search contiene condizioni che devono valere tutte, ad esempio {"s1":{"field":"Date","type":"ge","data":"2026-11-01"},"s2":{"field":"Date","type":"le","data":"2026-11-07"}}, con gli operatori eq, ne, gt, ge, lt, le, in, not in, starts, contains, is e is not. sort ({"Date":"asc"}) e join (["EmployeeObject"]) sono facoltativi.

Formati dei dati: gli id sono numeri interi. StartTime, EndTime e gli input start e end sono timestamp Unix in secondi; i campi Date sono date locali della sede (2026-11-03T00:00:00+11:00), quindi gli orari si convertono con il fuso orario della sede. Un roster con Employee 0 è un turno aperto, Published false una bozza. Lo stato del timesheet sta in TimeApproved, PayRuleApproved, Discarded e IsInProgress; TotalTime è in ore. Status delle assenze: 0 in attesa di approvazione, 1 approvata, 2 rifiutata, 3 annullata, 4 paga approvata. Aggiungere o aggiornare un turno risponde 200 con corpo vuoto; l'AI verifica il risultato con deputy_query_rosters.

Paginazione: una risposta contiene al massimo 500 record. Gli strumenti di query accettano max (fino a 500) e start (offset); quando una pagina è piena, l'AI richiama con start aumentato di max. Gli strumenti di elenco senza paginazione restituiscono in una risposta tutto ciò che Deputy consente.

Errori comuni: 401 indica un token errato o di un'altra installazione, 403 un permesso che manca all'utente del token, 404 un indirizzo di installazione o un id di record errato, 400 un nome di campo sbagliato in un filtro (verificalo con deputy_get_resource_info).

Il connettore non esporta da solo i timesheet in un sistema paghe, non crea sedi né aree e non elimina nulla finché gli strumenti di eliminazione sono disattivati.

Prerequisiti: DEPUTY_HOST, DEPUTY_ACCESS_TOKEN

Installazione locale del connettore

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

Apri http://localhost:3000/connectors/store, scegli Deputy e inserisci le variabili elencate nei Prerequisiti.

Tool disponibili

Esempi di prompt

• "Chi sta lavorando adesso nel negozio di Sydney e chi entra in turno dopo?"
• "Mostrami i turni della prossima settimana per l'area Cucina, compresi i turni aperti."
• "Elenca i timesheet della settimana scorsa non ancora approvati, con dipendente e ore totali."
• "Copia i turni della settimana scorsa dell'area Bar su questa settimana e mostrami le bozze prima di pubblicarle."
• "Quali richieste di assenza sono in attesa di approvazione questo mese?"

Prossimi passi

• Collegare a Claude
• Collegare a ChatGPT