Collegare Jisr MCP a Gemini CLI

💡 Niente installazione? Vai direttamente su cloud.anythingmcp.com. Accedi, clicca Connectors → Jisr, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente git clone, niente server locale.

Jisr + Gemini

Interroga la tua organizzazione HR su Jisr da qualsiasi assistente AI: dipendenti e dati del loro ruolo, riepiloghi delle presenze e timbrature, saldi delle ferie annuali, reparti e sedi. Di default in sola lettura; l'invio di timbrature è disponibile ma disattivato.

Prerequisiti

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

JISR_SLUG, JISR_API_KEY, JISR_API_SECRET

Step 1 — Ottieni le credenziali

La configurazione richiede circa 5 minuti. Ti servono un utente Jisr con il ruolo Admin, perché solo un Admin può creare chiavi API, e lo slug della tua organizzazione, cioè il sottodominio del tuo indirizzo Jisr.

1. In Jisr apri Settings → Webhook & API Keys → API Keys e clicca Add new API key (articolo di aiuto di Jisr).
2. Dai un nome alla chiave e spunta le API che può usare: Get List Employees, Get Employee Basic Information, Get attendance summary, View attendance records, View summary of employee annual leave e le lookup che ti servono. Spunta Get Employee Financial Info solo se l'AI può vedere gli stipendi.
3. Clicca Generate e copia l'API key in JISR_API_KEY e il secret in JISR_API_SECRET. Jisr mostra il secret una sola volta: se lo perdi, genera una nuova chiave.
4. Imposta JISR_SLUG sullo slug della tua organizzazione: il sottodominio del tuo indirizzo Jisr in minuscolo, acme per acme.jisr.net, non l'indirizzo completo.
5. Installa il connettore. Verifica la connessione con jisr_list_employees.

Cloud e self-hosting funzionano allo stesso modo: non c'è nessuna app da registrare né una Redirect URL; al connettore bastano slug, API key e secret.

Il connettore accede da solo: chiama POST /openapi/v1/auth con slug, API key e secret, riceve un token di accesso e lo invia a ogni chiamata nell'header Access-Token, insieme a slug e api-version. Chiave e secret vanno solo a questa chiamata di accesso. Quando Jisr rifiuta il token, il connettore accede di nuovo: non c'è niente da rinnovare.

Organizzazioni ospitate in Arabia Saudita: se il tuo indirizzo Jisr finisce in .jisr.net.sa, la tua organizzazione usa https://api.jisr.net.sa/api invece di https://apis.jisr.net/api. Cambia la base URL e la login URL del connettore con quell'host (login URL https://api.jisr.net.sa/api/openapi/v1/auth).

I dati dei dipendenti sono dati personali: le schede contengono data di nascita, contatti personali e numeri di documento e passaporto. Spunta sulla chiave solo le API che ti servono e condividi solo ciò che è necessario. I dati bancari (IBAN) vengono comunque tolti dagli elenchi dei dipendenti; gli stipendi restano nascosti finché Get Employee Financial Info non è spuntato; i campi personalizzati arrivano solo se la chiave ha quel permesso.

Due identificativi per dipendente: ogni dipendente ha un id pubblico (un UUID come bab6cd98-7246-4cfc-a576-19bc00391792), usato da jisr_get_employee e dal filtro del riepilogo presenze, e un employee code numerico (come 43), usato da timbrature e saldi ferie.

Date e paginazione: le date sono YYYY-MM-DD; gli orari delle timbrature sono data e ora, come 2026-11-01T08:00:00. Senza un intervallo, il riepilogo presenze copre il mese corrente e l'elenco delle timbrature l'ultima ora. Gli elenchi restituiscono fino a 100 voci per pagina (page da 1, rpp o limit); l'AI continua a leggere finché data.pagination indica una next_page.

Errori frequenti: This call requires login vuol dire che il token è scaduto, e il connettore accede di nuovo. Organization not found with given subdomain vuol dire che JISR_SLUG è sbagliato. Se l'accesso viene rifiutato, slug, API key o secret non sono corretti: copiali di nuovo, o genera una nuova chiave se hai perso il secret. Un 403 vuol dire che all'API key manca il permesso per quell'API: modifica la chiave in Settings → Webhook & API Keys e spuntalo.

Non incluso: creazione di dipendenti, transazioni di payroll e accantonamenti, registrazioni contabili (journals), webhook ed eventi di audit.

Cosa legge: dipendenti con id pubblico ed employee code, nome in inglese e in arabo, e-mail di lavoro e personale, telefono, stato, qualifica, reparto, sede, business unit, tipo di impiego, nazionalità, responsabile diretto, data di assunzione, data di nascita, numeri di documento e passaporto, date di cessazione e di cancellazione, filtrabili per stato e per data di creazione, assunzione, cessazione o cancellazione; il profilo base completo di un dipendente con dati personali, indirizzo e contatti; i totali delle presenze per dipendente in un periodo: ore lavorate, ritardi e uscite anticipate, lavoro extra, straordinari approvati, assenze, giorni senza timbrature, giorni di congedo e di riposo, giustificazioni di giornata intera e giorni di trasferta; le singole timbrature con orario, numero di serie del dispositivo e, per quelle rifiutate, l'errore segnalato da Jisr; i saldi delle ferie annuali con saldo iniziale e dell'anno precedente, rettifiche manuali, giorni goduti, in attesa e riservati, detrazione per congedo non retribuito e saldo di fine anno; gli elenchi di reparti, sedi, tipi di impiego, business unit, nazionalità e società di outsourcing, con nome in inglese e in arabo.

Disattivato all'installazione: jisr_create_attendance_logs. Invia a Jisr fino a 100 timbrature, come farebbe un marcatempo o un sistema di controllo accessi; Jisr le elabora in background e modificano le presenze dei dipendenti. Controlla poi l'esito con jisr_list_attendance_logs (stato success o failed). Attivalo nella pagina del connettore solo se ti serve; l'AI ti chiede conferma prima di ogni modifica. Tutti gli altri tool sono in sola lettura.

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

Tool disponibili

Esempi di prompt

• "Chi è stato assunto negli ultimi 30 giorni, e in quale reparto e sede?"
• "Mostrami il riepilogo presenze di questo mese: chi ha più ritardi e giorni di assenza?"
• "Quali timbrature ha rifiutato Jisr ieri, e con quale errore ciascuna?"
• "Quanti giorni di ferie restano ai dipendenti con codice 43 e 77?"
• "Elenca i dipendenti cessati quest'anno, con qualifica e data di cessazione."

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