In breve
TimeTrack time tracking: dipendenti, clienti, progetti, registrazioni di tempo dei progetti, presenza con ingresso e uscita, assenze e tipi di assenza, spese, report giornalieri e report di fogli di presenza raggruppati e timer. Chiave e segreto dell'app.
Configurazione guidata
Collega TimeTrack a Microsoft Copilot in 2 minuti
Avvia la prova gratuita su AnythingMCP Cloud, collega TimeTrack con la configurazione guidata e aggiungi il tuo URL MCP a Microsoft Copilot. Senza codice e senza server da gestire.
Nessuna carta di credito · 7 giorni di prova · Alternativa self-host disponibile
Prova a chiedere
Prompt di esempio per TimeTrack
Clicca su un prompt per copiarlo. Incollalo in Claude, ChatGPT, Cursor, Gemini, Copilot o OpenClaw per eseguirlo contro questo connettore.
Claude è un'AI e può sbagliare. Verifica sempre le risposte.
💡 Nessuna installazione? Usa direttamente cloud.anythingmcp.com. Accedi, clicca su Connectors → TimeTrack, incolla le tue credenziali, crea una chiave API MCP e hai finito. Niente Docker, niente
git clone, niente server locale.
TimeTrack + Microsoft Copilot
TimeTrack time tracking: dipendenti, clienti, progetti, registrazioni di tempo dei progetti, presenza con ingresso e uscita, assenze e tipi di assenza, spese, report giornalieri e report di fogli di presenza raggruppati e timer. Chiave e segreto dell'app.
Prerequisiti
Consulta le istruzioni complete di configurazione integrate nel connettore (visibili nello store dell'app quando selezioni il connettore). Le variabili ambientali richieste per questo connettore sono:
TIMETRACK_ACCOUNT, TIMETRACK_API_KEY, TIMETRACK_API_SECRET
Passo 1 — Ottieni le credenziali
La configurazione richiede circa 3 minuti.
- Accedi all'app web di TimeTrack come amministratore e apri Impostazioni, Generale, API.
- Copia la Chiave App in
TIMETRACK_API_KEYe il Segreto App inTIMETRACK_API_SECRET. Entrambi vengono generati per te; un nuovo segreto può essere generato in qualsiasi momento, invalidando quello vecchio. - Inserisci la prima parte del tuo indirizzo TimeTrack in
TIMETRACK_ACCOUNT: perhttps://acme.timetrackenterprise.comèacme.
Ogni chiamata invia i due valori negli header X-TimeTrack-Api-Key e X-TimeTrack-Api-Secret. L'API agisce per l'intero account, non per un singolo dipendente.
Da dove iniziare: timetrack_list_users restituisce i nomi utente che ogni altro strumento utilizza per nominare un dipendente. timetrack_list_clients e timetrack_list_projects restituiscono i nomi dei clienti e dei progetti a cui si riferiscono le registrazioni di tempo (per nome, non per ID).
Dati master: timetrack_get_user, timetrack_get_client, timetrack_create_client, timetrack_get_project, timetrack_create_project, timetrack_update_project, timetrack_list_tasks (i tipi di attività su cui viene registrato il tempo).
Tempo di progetto: timetrack_list_project_time_entries, timetrack_get_project_time_entry, timetrack_create_project_time_entry, timetrack_update_project_time_entry. timetrack_delete_project_time_entry è installato disattivato. timetrack_list_expenses elenca le spese registrate sui progetti.
Presenza: timetrack_list_attendances, timetrack_get_attendance, timetrack_create_attendance, timetrack_update_attendance; timetrack_delete_attendance è disattivato. Per registrare l'ingresso o l'uscita ora usa timetrack_start_attendance_timer e timetrack_stop_attendance_timer; timetrack_get_attendance_timer indica se qualcuno è registrato.
Timer di progetto: timetrack_get_project_timer, timetrack_start_project_timer, timetrack_stop_project_timer.
Assenze: timetrack_list_absence_types fornisce gli ID dei tipi, timetrack_list_absences e timetrack_get_absence sono richieste di lettura, timetrack_create_absence ne crea una e timetrack_update_absence la approva (stato 1) o la disapprova (stato 2). timetrack_delete_absence è disattivato.
Report: timetrack_list_daily_reports restituisce un record di foglio di presenza per giorno, timetrack_get_grouped_report i totali con straordinari e ferie. Le durate nei report sono in secondi; nelle registrazioni di tempo sono in minuti.
Paging: le liste restituiscono 50 record a meno che non passi limit (al massimo 1000); page_number inizia da 0.
Date: le assenze prendono date semplici (YYYY-MM-DD); le registrazioni di tempo, le spese, i report e i timer prendono timestamp come 2026-10-20T09:00:00.000Z. Gli strumenti del timer necessitano del tempo attuale reale in date.
Limite di richiesta: 30 richieste al minuto. Usa filtri e un grande limit invece di una chiamata per record.
Errori: una chiamata fallita risponde con errors, una lista con title, status, code e detail. 401: chiave o segreto errati. 403: azione non consentita. 404: record non trovato o eliminato. 422: un parametro è errato o la modifica confligge con dati esistenti (un nome utente, cliente o progetto sconosciuto è la causa abituale).
Passo 2 — Installa l'adattatore
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
Passo 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 mostraYOUR_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.
- In Copilot Studio apri il tuo agente (o creane uno), vai su Tools e scegli Add a tool → New tool → Model Context Protocol.
- Inserisci un Server name (per esempio
AnythingMCP), una Server description che dica cosa fa il connettore e il Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descrizione per decidere quando chiamare il server. - Come autenticazione scegli API key, imposta Type su Header e come nome dell'header
X-API-Key, poi seleziona Create. - 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.
- Provalo nel riquadro Test dell'agente: chiedi qualcosa che richiede i tool di
TimeTrack. - 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.
Strumenti disponibili
| Strumento | Cosa fa |
|---|---|
timetrack_list_users | Elenca i dipendenti dell'account TimeTrack: ID, nome utente, email, nome, cognome, numero personale, lingua, tariffa oraria e i flag… |
timetrack_get_user | Legge un dipendente per ID numerico: nome utente, email, nome e cognome, numero personale, lingua, tariffa oraria e l'amministratore, esterno… |
timetrack_list_clients | Elenca i clienti (clienti per cui i progetti sono prenotati): ID, nome, abilitato, colore, note, email, telefono, campi indirizzo, persona di contatto e i… |
timetrack_get_client | Legge un cliente per ID numerico: nome, abilitato, dettagli di contatto, indirizzo e campi liberi. Solo lettura |
timetrack_create_client | Crea un cliente e restituiscilo. I progetti vengono creati sotto un cliente, quindi un nuovo cliente ha bisogno di questo prima. Scrive su TimeTrack |
timetrack_list_projects | Elenca i progetti: ID, nomeProgetto, nomeCliente, progettoAbilitato, note, tariffaOraria, tempoStimato (durata pianificata in minuti) e… |
timetrack_get_project | Legge un progetto per ID numerico: nomeProgetto, nomeCliente, progettoAbilitato, note, tariffaOraria, tempoStimato in minuti e budgetStimato.… |
timetrack_create_project | Crea un progetto sotto un cliente esistente e restituiscilo. Scrive su TimeTrack |
timetrack_update_project | Modifica un progetto: note, tariffa oraria, tempo pianificato o budget, il suo nome o il suo cliente. Solo i campi che passi cambiano. Scrive su TimeTrack |
timetrack_list_tasks | Elenca i tipi di attività su cui viene registrato il tempo del progetto (ad esempio Sviluppo o Consulenza): ID, nome, note e tariffaOraria. Le registrazioni di tempo… |
timetrack_list_project_time_entries | Elenca il tempo registrato sui progetti: ID, utente, nomeCliente, nomeProgetto, attività, da e a (timestamp), minutiLavorati (pausa non inclusa)… |
timetrack_get_project_time_entry | Legge una registrazione di tempo di progetto per ID numerico: dipendente, cliente, progetto, attività, inizio e fine, minuti lavorati e di pausa, tariffa, flag fatturabile… |
timetrack_create_project_time_entry | Prenota il tempo di lavoro di un dipendente su un progetto e restituisci la registrazione. Cliente e progetto devono esistere e sono forniti per nome. Scrive su… |
timetrack_update_project_time_entry | Correggi una registrazione di tempo di progetto: inizio, fine, pausa, attività, tariffa, flag fatturabile o note. Dipendente, cliente e progetto non possono essere cambiati: elimina… |
timetrack_delete_project_time_entry | Elimina una registrazione di tempo di progetto. Il tempo prenotato scompare dai report e dalle fatture. Installato disattivato; correggi una registrazione con… |
timetrack_list_attendances | Elenca le registrazioni di presenza (ingresso e uscita senza progetto): ID, utente, da, a, minutiLavorati, minutiPausa, note, manuale (inserito… |
timetrack_get_attendance | Legge una registrazione di presenza per ID numerico: dipendente, inizio, fine, minuti lavorati e di pausa, note e se è stata inserita manualmente.… |
timetrack_create_attendance | Registra il tempo di lavoro di un dipendente dopo il fatto (inizio e fine noti) e restituisci la registrazione. Per registrare l'ingresso ora usa… |
timetrack_update_attendance | Correggi una registrazione di presenza: inizio, fine, pausa o note. Il dipendente non può essere cambiato. Solo i campi che passi cambiano. Scrive su… |
timetrack_delete_attendance | Contrassegna una registrazione di presenza come eliminata. Il tempo di lavoro scompare dal foglio di presenza del dipendente. Installato disattivato; correggi un… |
timetrack_list_absence_types | Elenca i tipi di assenza dell'account (ferie, malattia, permesso compensativo e così via): ID, nome e nomeBreve. L'ID è ciò che un'assenza… |
timetrack_list_absences | Elenca le assenze: ID, utente, da e a (date), stato (0 nuovo e in attesa di approvazione, 1 approvato, 2 disapprovato), tipoAssenza (ID) e… |
timetrack_get_absence | Legge un'assenza per ID numerico: dipendente, primo e ultimo giorno, stato (0 in attesa, 1 approvato, 2 disapprovato) e tipo di assenza. Solo lettura |
timetrack_create_absence | Richiedi un'assenza (ferie, malattia) per un dipendente e restituiscila. Una nuova assenza ha stato 0 e attende approvazione a meno che il… |
timetrack_update_absence | Approva o disapprova un'assenza impostando il suo stato. Lo stato è l'unico campo che l'API ti consente di modificare; per altre date elimina il… |
timetrack_delete_absence | Elimina un'assenza. Installato disattivato: una vacanza o malattia approvata dovrebbe normalmente essere disapprovata con timetrack_update_absence… |
timetrack_list_expenses | Elenca le spese registrate sui progetti: ID, utente, nomeCliente, nomeProgetto, nome, prezzo, quantità, fatturabile, tipoPagamento, dettagli, tag e data.… |
timetrack_list_daily_reports | Leggi i record giornalieri del foglio di presenza di un dipendente per un periodo, uno per giorno: dataLavoro, inizioLavoro, fineLavoro, secondiObiettivo, secondiLavorati… |
timetrack_get_grouped_report | Leggi i totali di un dipendente per un periodo: secondiObiettivo, secondiLavorati, differenzaObiettivoLavoro (straordinari o ore in meno)… |
timetrack_get_attendance_timer | Leggi il timer di presenza in corso di un dipendente (la persona è registrata): da, a, minutiLavorati, minutiPausa, manuale e note.… |
timetrack_start_attendance_timer | Registra un dipendente: avvia il timer di presenza all'orario dato. Fallisce quando un timer è già in esecuzione. Scrive su TimeTrack |
timetrack_stop_attendance_timer | Registra un dipendente in uscita: ferma il timer di presenza in corso all'orario dato, completando la registrazione di presenza. Scrive su TimeTrack |
timetrack_get_project_timer | Leggi il timer di progetto di un dipendente: iniziatoA, secondiLavorati, secondiPausa, i flag di stato in esecuzione, in pausa e fermato, e nomeCliente… |
timetrack_start_project_timer | Avvia il timer di progetto di un dipendente su un cliente e progetto all'orario dato. Scrive su TimeTrack |
timetrack_stop_project_timer | Ferma il timer di progetto in corso di un dipendente all'orario dato, il che salva una registrazione di tempo di progetto. Scrive su TimeTrack |
Esempi di prompt
- "Quante ore ha registrato il team sul progetto Rilancio Sito Web il mese scorso, per persona?"
- "Chi è registrato in questo momento?"
- "Prenota 2,5 ore di design sul progetto Rilancio Sito Web per jsmith ieri pomeriggio."
- "Quali richieste di assenza sono in attesa di approvazione?"
- "Mostra il saldo di straordinari e ferie di ogni dipendente per ottobre."
FAQ
Da dove provengono le credenziali? Accedi all'app web di TimeTrack come amministratore e apri Impostazioni, Generale, API: copia la Chiave App e il Segreto App. TIMETRACK_ACCOUNT è la prima parte del tuo indirizzo TimeTrack (acme per acme.timetrackenterprise.com). L'API agisce per l'intero account, non per un singolo dipendente.
Cosa copre? Dipendenti, clienti, progetti e tipi di attività, registrazioni di tempo di progetto, presenza con ingresso e uscita, assenze e tipi di assenza con approvazione, spese, report giornalieri e raggruppati di fogli di presenza con straordinari e ferie, e i timer di presenza e progetto. L'API consente 30 richieste al minuto.
Quali strumenti sono installati disattivati? timetrack_delete_project_time_entry, timetrack_delete_attendance e timetrack_delete_absence. Attivali nella pagina del connettore solo se l'IA deve usarli.
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
Questa guida ti è stata utile?