Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi Connecteam con un clic, poi punta il tuo client AI (Claude, ChatGPT, Copilot o Cursor) all'endpoint MCP generato. Niente Docker, niente git clone, nessuna esperienza di sviluppo richiesta.
In breve
Connecteam, l'app per i team che non lavorano alla scrivania: utenti e campi personalizzati, il time clock con turni timbrati, totali dei timesheet e timbratura di entrata e uscita, turni dello scheduler, job, moduli e compilazioni, quick task, saldi e richieste di assenza e messaggi in chat. Connecteam API con una API key.
Prova a chiedere
Prompt di esempio per Connecteam
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.
💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Connecteam, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
Connecteam
Connecteam, l'app per i team che non lavorano alla scrivania: utenti e campi personalizzati, il time clock con turni timbrati, totali dei timesheet e timbratura di entrata e uscita, turni dello scheduler, job, moduli e compilazioni, quick task, saldi e richieste di assenza e messaggi in chat. Connecteam API con una API key.
Setup
La configurazione richiede circa 2 minuti e serve un owner o un admin di Connecteam.
- In Connecteam apri Settings > API Keys e fai clic su Add API key. Copia la chiave in
CONNECTEAM_API_KEY. Dà accesso all'intero account, quindi trattala come una password. - Imposta
CONNECTEAM_API_HOSTsuhttps://api.connecteam.com, oppure suhttps://api-au.connecteam.comse accedi da app-au.connecteam.com (account australiani). - Installa il connettore:
connecteam_get_accountè il controllo di installazione.
L'accesso all'API richiede il piano Expert o superiore, per hub: Operations per time clock, scheduler, job e attività; Communications per la chat; HR & Skills per le assenze. Utenti, account e publisher funzionano con qualsiasi hub idoneo.
Dati personali: gli utenti contengono nomi, numeri di telefono, email e campi di profilo personalizzati come compleanno, indirizzo o numeri di documento; le attività di tempo possono contenere posizioni GPS. Chiedi solo ciò che serve al compito.
Prima gli id: ogni time clock, scheduler e task board è un'istanza di app a sé. L'AI ne ricava gli id con connecteam_list_time_clocks, connecteam_list_schedulers e connecteam_list_task_boards prima di chiamare gli strumenti che richiedono timeClockId, schedulerId o taskBoardId.
Cosa legge:
- Account e persone:
connecteam_get_account,connecteam_list_users(filtri per id, nomi, email, telefoni, stato o data di modifica),connecteam_list_custom_fields,connecteam_list_custom_field_categorieseconnecteam_list_smart_groups. - Time clock:
connecteam_list_time_activitiesrestituisce turni timbrati, pause manuali e assenze per utente, al massimo 92 giorni per chiamata;connecteam_get_timesheet_totalsrestituisce le ore per utente e giorno con pause, straordinari, retribuzione e stato di approvazione, invio e blocco. - Pianificazione:
connecteam_list_shifts(intervallo di tempo in secondi Unix),connecteam_get_shift,connecteam_list_shift_custom_fieldseconnecteam_list_user_unavailabilities. - Job (i clienti, i cantieri o i progetti su cui si registrano turni e ore timbrate):
connecteam_list_jobs,connecteam_get_jobeconnecteam_list_job_custom_fields. - Moduli:
connecteam_list_forms,connecteam_get_form(le domande),connecteam_list_form_submissionseconnecteam_get_form_submissioncon ogni risposta, comprese immagini e link ai file. - Attività:
connecteam_list_taskseconnecteam_list_task_labels. - Assenze:
connecteam_list_time_off_policy_types,connecteam_list_time_off_balanceseconnecteam_list_time_off_requests, che restituisce solo le richieste approvate se non passistatuses. - Chat:
connecteam_list_conversationseconnecteam_list_publishers.
Cosa scrive:
- Time clock:
connecteam_clock_ineconnecteam_clock_outtimbrano un utente adesso o a un certo istante, facoltativamente su un job o un turno pianificato.connecteam_create_time_activitiesaggiunge turni o pause manuali passati (ad esempio una timbratura dimenticata) econnecteam_update_time_activitiesli corregge. I giorni bloccati o approvati vengono rifiutati. - Pianificazione:
connecteam_create_shiftseconnecteam_update_shifts; conisPublishedtrue enotifyUserstrue il personale vede il turno e riceve una notifica. - Job:
connecteam_create_jobs(anche sotto-job conparentId) econnecteam_update_job(titleè obbligatorio). - Attività:
connecteam_create_taskeconnecteam_update_task. L'API sostituisce l'intera attività, quindi l'AI invia ogni voltauserIds,statusetitle; lo statocompletedla chiude. - Assenze:
connecteam_create_time_off_request(in attesa o già approvata) econnecteam_update_time_off_request(approva o rifiuta constatus). - Utenti:
connecteam_create_users(ognuno richiede firstName, lastName, phoneNumber e userType;sendActivationinvia l'SMS di attivazione),connecteam_update_users,connecteam_archive_users(reversibile: aggiorna conisArchivedfalse) econnecteam_create_user_note. - Chat:
connecteam_send_messagescrive in una conversazione econnecteam_send_private_messagea un singolo utente, entrambi con un id publisher diconnecteam_list_publisherscomesenderId. I messaggi vengono consegnati subito.
Disattivati all'installazione: connecteam_delete_user, connecteam_delete_shift e connecteam_delete_task. Non si possono annullare; un amministratore del workspace li attiva quando servono al team. Archiviare un utente è l'alternativa reversibile.
Formati dei dati: le risposte hanno la forma { "requestId": "...", "data": {...}, "paging": { "offset": n } }. Gli orari di turni, timbrature e attività sono timestamp Unix in secondi con un timezone IANA separato; le date nei filtri sono YYYY-MM-DD. Gli id utente sono interi; gli id di turni, job, attività e richieste sono stringhe. Le scritture batch (connecteam_create_users, connecteam_create_shifts, connecteam_create_jobs e gli aggiornamenti) accettano una lista e rispondono per ogni elemento.
Paginazione: limit (default 10; il massimo dipende dallo strumento, fino a 500) e offset. L'AI aumenta offset di limit finché una pagina restituisce meno elementi di limit.
Limiti ed errori comuni: i rate limit valgono per account e piano (Expert: 100 richieste al minuto e 10.000 al giorno) e rispondono 429. 401 o 403 indica una chiave errata, l'indirizzo API sbagliato (globale o australiano) o un piano o hub senza accesso all'API; 404 un id sconosciuto; 422 un errore di validazione, con il campo indicato nel corpo.
Il connettore non elabora buste paga, non modifica i moduli né invia risposte ai moduli e non crea time clock, scheduler o task board.
Prerequisiti: CONNECTEAM_API_HOST, CONNECTEAM_API_KEY
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 Connecteam e inserisci le variabili elencate nei Prerequisiti.
Tool disponibili
| Tool | What it does |
|---|---|
connecteam_get_account | Account of the API key: company id, name and time zone |
connecteam_list_users | List users (employees, managers, owners): id, name, phone, email, user type, archived flag, custom field values and smart groups |
connecteam_list_custom_fields | List the user custom fields (profile fields such as employee number, department, birthday) with id, name, type and dropdown options |
connecteam_list_custom_field_categories | List the categories that group user custom fields, with id and name |
connecteam_list_smart_groups | List smart groups (user groups built from rules, used to assign jobs, forms and chats) with id and name |
connecteam_list_time_clocks | List the time clocks of the account (one per time clock app or location) with id and name; the id is needed by every time activity tool |
connecteam_list_time_activities | Clocked work per user in a date range: shifts with start and end (Unix seconds and time zone), job, notes and GPS, manual breaks and time… |
connecteam_get_timesheet_totals | Timesheet totals per user and day for a period: worked hours, breaks, overtime, pay, approval, submission and lock state |
connecteam_list_schedulers | List the job schedulers (schedule apps) with id and name; the id is needed by every shift tool |
connecteam_list_shifts | Scheduled shifts in a time range: id, start and end (Unix seconds), title, job, assigned users, open spots, published flag, notes, tasks… |
connecteam_get_shift | One scheduled shift by id with assignments, job, notes, tasks, breaks and custom fields |
connecteam_list_shift_custom_fields | Custom fields defined on the shifts of a scheduler, with id, name and type, for use in shift customFields |
connecteam_list_user_unavailabilities | Times a user marked as unavailable (and available) for scheduling in a range |
connecteam_list_jobs | List jobs (clients, sites or projects that shifts and clocked time are tracked against): id, title, code, description, GPS address… |
connecteam_get_job | One job by id with code, description, location, assignment, custom fields and sub-jobs |
connecteam_list_job_custom_fields | Custom fields defined on jobs, with id, name, type and options, for use in job customFields |
connecteam_list_forms | List forms (checklists, reports, inspections) with id, name and creation date |
connecteam_get_form | One form by id with its questions (id, type, title and options) |
connecteam_list_form_submissions | Submissions of a form: submitter, time, and the answer to each question (text, choices, images and file links) |
connecteam_get_form_submission | One form submission with the submitter, submission time and the answer to every question |
connecteam_list_task_boards | List quick task boards with id and name; the id is needed by every task tool |
connecteam_list_tasks | Tasks of a board: title, description, assignees, status, start and due time (Unix seconds), labels and sub-tasks |
connecteam_list_task_labels | Labels of a task board with id, title and colour, to filter or tag tasks by label |
connecteam_list_time_off_policy_types | Time off policy types (vacation, sick and others) with id and name; needed for balances and requests |
connecteam_list_time_off_balances | Time off balances of users for one policy type (days or hours left) |
connecteam_list_time_off_requests | Time off requests overlapping a date range: user, policy type, dates or times, all-day flag, status and notes |
connecteam_list_conversations | Chat conversations (channels and groups) the API can post to, with id, title and type |
connecteam_list_publishers | Custom publishers (named senders for API messages) with id and name; a publisher id is the senderId of the chat tools |
connecteam_create_users | Create one or more users |
connecteam_update_users | Update one or more users by userId (or by phone with editUsersByPhone): name, phone, email, user type, custom field values, archived flag |
connecteam_archive_users | Archive users: they lose access but keep their history and can be restored (update with isArchived false) |
connecteam_delete_user | Permanently delete a user and their data |
connecteam_create_user_note | Add a note (title and text) to a user's profile in Connecteam, e.g. a manager remark |
connecteam_create_shifts | Create shifts in a scheduler |
connecteam_update_shifts | Update shifts by shiftId: times, title, job, assignees, publish state, notes, tasks or breaks |
connecteam_delete_shift | Delete a scheduled shift |
connecteam_clock_in | Clock a user in on a time clock now (or at timestamp), optionally on a job or a scheduled shift |
connecteam_clock_out | Clock a user out of the running shift on a time clock now (or at timestamp) |
connecteam_create_time_activities | Add past clocked shifts or manual breaks for users (e.g. a forgotten clock-in) |
connecteam_update_time_activities | Correct clocked shifts or manual breaks by their id (start, end, job, notes) |
connecteam_create_jobs | Create jobs (or sub-jobs with parentId) and attach them to schedulers or time clocks |
connecteam_update_job | Update a job: title, code, description, location, assignment, custom fields or the schedulers and time clocks it belongs to. title is… |
connecteam_create_task | Create a task on a board and assign it to users; publish it to notify them |
connecteam_update_task | Update a task, e.g. mark it completed |
connecteam_delete_task | Delete a task from a board |
connecteam_create_time_off_request | Create a time off request for a user, pending for approval or already approved |
connecteam_update_time_off_request | Approve or deny a time off request (status), or change its dates and notes |
connecteam_send_message | Post a message to a chat conversation (channel or group) as a custom publisher |
connecteam_send_private_message | Send a private chat message to one user as a custom publisher |
Esempi di prompt
- "Quante ore ha lavorato ogni dipendente la settimana scorsa sul time clock Magazzino, straordinari compresi?"
- "Mostrami i turni aperti di domani nello scheduler Squadra esterna."
- "Quali richieste di assenza sono ancora in attesa e quanto saldo resta a ciascuno?"
- "Elenca le compilazioni di questa settimana del modulo di ispezione veicoli con le risposte."
- "Crea sulla board Negozio un'attività per Daniel per rifornire la cella frigorifera entro venerdì e pubblicala."
Prossimi passi
Questa guida ti è stata utile?