Come collegare Connecteam a Gemini via MCP

💡 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 + Gemini

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.

Prerequisiti

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

CONNECTEAM_API_HOST, CONNECTEAM_API_KEY

Step 1 — Ottieni le credenziali

La configurazione richiede circa 2 minuti e serve un owner o un admin di Connecteam.

1. 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.
2. Imposta CONNECTEAM_API_HOST su https://api.connecteam.com, oppure su https://api-au.connecteam.com se accedi da app-au.connecteam.com (account australiani).
3. 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_categories e connecteam_list_smart_groups.
• Time clock: connecteam_list_time_activities restituisce turni timbrati, pause manuali e assenze per utente, al massimo 92 giorni per chiamata; connecteam_get_timesheet_totals restituisce 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_fields e connecteam_list_user_unavailabilities.
• Job (i clienti, i cantieri o i progetti su cui si registrano turni e ore timbrate): connecteam_list_jobs, connecteam_get_job e connecteam_list_job_custom_fields.
• Moduli: connecteam_list_forms, connecteam_get_form (le domande), connecteam_list_form_submissions e connecteam_get_form_submission con ogni risposta, comprese immagini e link ai file.
• Attività: connecteam_list_tasks e connecteam_list_task_labels.
• Assenze: connecteam_list_time_off_policy_types, connecteam_list_time_off_balances e connecteam_list_time_off_requests, che restituisce solo le richieste approvate se non passi statuses.
• Chat: connecteam_list_conversations e connecteam_list_publishers.

Cosa scrive:

• Time clock: connecteam_clock_in e connecteam_clock_out timbrano un utente adesso o a un certo istante, facoltativamente su un job o un turno pianificato. connecteam_create_time_activities aggiunge turni o pause manuali passati (ad esempio una timbratura dimenticata) e connecteam_update_time_activities li corregge. I giorni bloccati o approvati vengono rifiutati.
• Pianificazione: connecteam_create_shifts e connecteam_update_shifts; con isPublished true e notifyUsers true il personale vede il turno e riceve una notifica.
• Job: connecteam_create_jobs (anche sotto-job con parentId) e connecteam_update_job (title è obbligatorio).
• Attività: connecteam_create_task e connecteam_update_task. L'API sostituisce l'intera attività, quindi l'AI invia ogni volta userIds, status e title; lo stato completed la chiude.
• Assenze: connecteam_create_time_off_request (in attesa o già approvata) e connecteam_update_time_off_request (approva o rifiuta con status).
• Utenti: connecteam_create_users (ognuno richiede firstName, lastName, phoneNumber e userType; sendActivation invia l'SMS di attivazione), connecteam_update_users, connecteam_archive_users (reversibile: aggiorna con isArchived false) e connecteam_create_user_note.
• Chat: connecteam_send_message scrive in una conversazione e connecteam_send_private_message a un singolo utente, entrambi con un id publisher di connecteam_list_publishers come senderId. 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.

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 Gemini

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.

Gemini CLI legge i server MCP da ~/.gemini/settings.json (su Windows %USERPROFILE%\.gemini\settings.json). Aggiungi:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "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 gemini.
3. Esegui /mcp in Gemini CLI (oppure gemini mcp list dal terminale): anythingmcp dovrebbe risultare connesso.
4. Inizia a scrivere prompt: Gemini CLI ora può chiamare i tool di Connecteam.

Tool disponibili

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

FAQ

Dove cerca i server MCP Gemini CLI? In ~/.gemini/settings.json per il tuo utente, oppure in .gemini/settings.json dentro un progetto. gemini mcp list mostra ogni server e se si connette.

Prossimi passi

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