Come collegare Deputy a Cursor 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 + Cursor

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 Cursor

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.

Cursor legge i server MCP da ~/.cursor/mcp.json. Aggiungi questa voce:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Crea una chiave API MCP in AnythingMCP da MCP Servers → il tuo server → API keys e incollala al posto di YOUR_MCP_API_KEY.
2. Salva il file e riavvia Cursor.
3. Apri Cursor → Settings → MCP e verifica che anythingmcp sia elencato e connesso.
4. Inizia a chattare: l'agente ora può usare i tool di Deputy.

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

Cursor supporta server MCP personalizzati nel piano gratuito? Sì, MCP è disponibile nei piani Hobby, Pro e Business.

Prossimi passi

• Landing del connettore
• Collegare a Claude
• Collegare a ChatGPT
• Collegare a Gemini
• Collegare a Meta Muse
• Collegare a Microsoft Copilot