Come collegare Deputy a Microsoft Copilot via MCP

💡 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 + Microsoft Copilot

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.

Prerequisiti

Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:

DEPUTY_HOST, DEPUTY_ACCESS_TOKEN

Step 1 — Ottieni le credenziali

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.

Step 2 — Installa l'adapter

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

Step 3 — Aggiungi il connettore in Microsoft Copilot

L'URL del tuo server: in AnythingMCP apri MCP Servers → il server su cui si trova questo connettore e copia il suo URL (https://cloud.anythingmcp.com/mcp/…). Usalo ovunque questa guida mostra YOUR_SERVER_ID.

Microsoft Copilot usa i server MCP tramite gli agenti creati in Copilot Studio: aggiungi AnythingMCP a un agente come strumento, poi pubblichi l'agente in Microsoft 365 Copilot e in Teams. Copilot Studio si collega dal cloud di Microsoft via Streamable HTTP, che AnythingMCP supporta.

1. In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
2. Inserisci un Server name (per esempio AnythingMCP), una Server description che dica cosa fa il connettore e il Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server.
3. Come autenticazione scegli API key, imposta Type su Header e come nome dell'header X-API-Key, poi seleziona Create.
4. In Add tool scegli Create a new connection, incolla una chiave API MCP di AnythingMCP (MCP Servers → il tuo server → API keys) e seleziona Add to agent.
5. Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di Deputy.
6. Seleziona Publish, poi Channels → Microsoft 365 and Microsoft Teams, lascia selezionato Make agent available in Microsoft Copilot e scegli Add channel. See agent in Teams lo installa per te; in Microsoft 365 Copilot scrivi @ e scegli l'agente.

Preferisci un accesso per ogni utente? Al posto della chiave API scegli OAuth 2.0 → Dynamic discovery: ogni persona accede ad AnythingMCP la prima volta che l'agente lo chiama.

Usi il self-hosting? Usa l'indirizzo HTTPS pubblico della tua istanza al posto di https://cloud.anythingmcp.com. Copilot Studio si collega dal cloud di Microsoft, quindi localhost non funziona.

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?"

FAQ

Per quale Copilot vale? Per Microsoft 365 Copilot in azienda, tramite gli agenti di Copilot Studio. L'app Microsoft Copilot per account personali non permette di aggiungere un proprio server MCP.

Cosa mi serve? Un account di lavoro con accesso a Copilot Studio (licenza o prova) per creare l'agente. Chi lo usa in Microsoft 365 Copilot o in Teams deve avere accesso all'agente: condividilo, oppure chiedi a un amministratore di pubblicarlo per l'organizzazione. Se la tua organizzazione applica criteri sui dati ai connettori di Power Platform, valgono anche per i server MCP.

L'agente non chiama i tool. Controlla che il nome dell'header sia esattamente X-API-Key e che la chiave appartenga allo stesso server MCP dell'URL, e scrivi una Server description precisa: Copilot Studio la usa per decidere quando chiamare il server. Dopo ogni modifica pubblica di nuovo l'agente; in una chat già aperta scrivi "start over" per passare alla nuova versione.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Cursor
• Collegare a Gemini
• Collegare a Meta Muse