Come collegare Workday a Gemini via MCP

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

Workday + Gemini

Dai alla tua AI accesso in lettura a Workday HCM tramite il tuo client API: cerca i dipendenti e il loro inquadramento, i diretti riporti, le organizzazioni di supervisione e i loro membri, i profili professionali e le posizioni, i saldi di assenza, le voci di assenza, i congedi e gli annunci di lavoro. Sola lettura.

Prerequisiti

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

WORKDAY_HOST, WORKDAY_TENANT, WORKDAY_CLIENT_ID, WORKDAY_CLIENT_SECRET, WORKDAY_REFRESH_TOKEN

Step 1 — Ottieni le credenziali

Un amministratore Workday lo configura una sola volta, in circa 15 minuti:

1. Crea un Integration System User (attività Create Integration System User) e aggiungilo a un gruppo di sicurezza per integrazioni (attività Create Security Group, tipo Integration System Security Group, senza vincoli o limitato alle organizzazioni che vuoi esporre).
2. Dai a quel gruppo accesso Get (visualizzazione) solo sui domini che l'AI deve leggere, per esempio Worker Data: Public Worker Reports, Reports: Organization, View: Supervisory Organization, Job Profile: View, Worker Position: View, Worker Data: Time Off (Time Off Balances), Worker Data: Time Off (Time Off), Worker Data: Leave of Absence e Job Postings: External. Poi esegui Activate Pending Security Policy Changes.
3. Esegui Register API Client for Integrations: dagli un nome, spunta Non-Expiring Refresh Tokens e aggiungi solo gli scope che ti servono: Staffing, Organizations and Roles, Jobs & Positions, Time Off and Leave, Recruiting. Copia Client ID e Client Secret; il secret viene mostrato una sola volta.
4. Esegui Manage Refresh Tokens for Integrations, scegli l'Integration System User, poi Generate New Refresh Token per il client API e copia il token.
5. Esegui View API Clients. Il Token Endpoint è https://<host>/ccx/oauth2/<tenant>/token: metti l'host (per esempio wd5-services1.myworkday.com, senza https://) in WORKDAY_HOST e il tenant in WORKDAY_TENANT.
6. Incolla client ID, secret e refresh token in WORKDAY_CLIENT_ID, WORKDAY_CLIENT_SECRET e WORKDAY_REFRESH_TOKEN e installa il connettore.

Nessun accesso dal browser: AnythingMCP scambia il refresh token senza scadenza con un access token di breve durata presso il token endpoint del tuo tenant e lo rinnova da solo. Nessuno deve fare login, e il connettore agisce come Integration System User, non come una persona.

Sola lettura: tutti i 16 tool leggono soltanto. L'AI non può assumere, cambiare posizioni, inserire o approvare assenze né modificare i dati di contatto.

I dati HR sono sensibili: Workday applica a ogni chiamata i gruppi di sicurezza dell'utente di integrazione, quindi l'AI vede esattamente ciò che quell'utente può vedere e niente di più. Saldi di assenza, voci di assenza e congedi sono destinati alla persona interessata, al suo responsabile o all'HR; il connettore chiede all'AI di cercare le persone solo per un motivo di lavoro legittimo e di non inoltrare mai questi dati. I commenti sui congedi sono esclusi perché possono contenere dettagli sanitari o familiari. Retribuzioni, buste paga, benefit, indirizzi di casa e documenti d'identità non fanno parte di questo connettore.

Cosa legge: dipendenti per nome, matricola o email aziendale con il loro inquadramento, diretti riporti, organizzazioni di supervisione e chi ne occupa le posizioni (anche quelle vacanti), altre gerarchie come società, centri di costo e regioni, profili professionali e posizioni coperte, saldi e voci di assenza con il loro stato, congedi e annunci di lavoro con la descrizione completa.

Test connection: il pulsante Test connection nella pagina del connettore può segnalare un errore anche quando la configurazione è corretta, perché chiama l'indirizzo base dell'API e ogni percorso Workday contiene il tenant. Conta il controllo eseguito all'installazione, una ricerca di un singolo dipendente.

Errori comuni: invalid_grant: il refresh token è stato revocato o appartiene a un altro client API; generane uno nuovo. invalid_client: client ID o secret errati. 401: host o tenant non corrispondono al token endpoint. 403 o elenco vuoto: al gruppo di sicurezza manca il dominio o al client API manca lo scope. 503 Service unavailable di solito significa che il tenant non esiste su quell'host.

Non incluso: scritture di qualsiasi tipo, retribuzioni e paghe, benefit, dati su performance e talenti, candidati e potenziali candidati, e report con Workday Query Language.

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

Tool disponibili

Esempi di prompt

• "Chi riporta direttamente a Maria Schneider, e chi di loro guida a sua volta un team?"
• "Mostrami l'organizzazione di supervisione Vendite DACH con i suoi responsabili e tutte le posizioni, comprese quelle vacanti."
• "Sono il responsabile di Lukas Weber. Quanti giorni di ferie gli restano quest'anno, e ha richieste di assenza ancora in attesa di approvazione?"
• "Elenca i nostri annunci di lavoro aperti per sviluppatori software con sede, modalità di lavoro da remoto e link esterno."
• "Confronta i profili professionali Senior Software Engineer e Staff Engineer: livello, livello manageriale e famiglia professionale."

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