Salta l'installazione. Attivo in meno di 2 minuti.
Avvia una prova gratuita su cloud.anythingmcp.com, aggiungi HiBob 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
La piattaforma HR HiBob (Bob) tramite l'API pubblica con un service user: ricerca e schede dei dipendenti, storico di lavoro, impiego, lifecycle e retribuzione, tabelle personalizzate, liste aziendali, assenze con chi è fuori, richieste, saldi e policy, festività, report salvati, onboarding, attività e documenti. Le scritture sui dati anagrafici sono disattivate all'installazione.
Prova a chiedere
Prompt di esempio per HiBob
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 → HiBob, inserisci le credenziali, genera una MCP API key e hai finito. Niente Docker, niente
git clone, niente server locale.
HiBob + Microsoft Copilot
La piattaforma HR HiBob (Bob) tramite l'API pubblica con un service user: ricerca e schede dei dipendenti, storico di lavoro, impiego, lifecycle e retribuzione, tabelle personalizzate, liste aziendali, assenze con chi è fuori, richieste, saldi e policy, festività, report salvati, onboarding, attività e documenti. Le scritture sui dati anagrafici sono disattivate all'installazione.
Prerequisiti
Le istruzioni di setup complete sono incluse nel connettore stesso (visibili nello store quando lo selezioni). Le variabili d'ambiente richieste sono:
HIBOB_SERVICE_USER_ID, HIBOB_SERVICE_USER_TOKEN
Step 1 — Ottieni le credenziali
La configurazione richiede circa 10 minuti e serve un amministratore di Bob. Il connettore usa l'API REST pubblica di Bob (https://api.hibob.com/v1) con un service user.
- In Bob, come amministratore, vai in Settings > Integrations > Automation > Service Users, fai clic su Manage e crea un service user con nome e nome visualizzato. Copia subito il suo ID e il token: il token compare solo quando viene generato. Un token perso si può rigenerare, e quello vecchio smette di valere.
- Crea un gruppo di permessi (permission group) dedicato e aggiungici il service user. Un gruppo nuovo non ha permessi, quindi concedi solo ciò che usi:
- People's data > People's fields: View sulle categorie che leggi (almeno root, about, employment e work per
hibob_search_people), View history sulle tabelle storiche (work, employment, lifecycle, payroll), Edit dove aggiorni. - Access data for: Everyone oppure una condizione. Per impostazione predefinita sono coperte solo le persone in forza; togli la condizione Lifecycle status equals Employed per leggere chi è uscito con
show_inactive. - People's data > Time off: vedere richieste e saldi, e inviare o annullare richieste se usi quegli strumenti; vedere le richieste private per
include_private. - Features > Reports: View reports according to people's data access rights.
- People's data > Tasks and flow > People's tasks: View and mark selected people's tasks as complete.
- People's data > Docs > [cartella]: View per cartella di documenti, e Upload per la cartella condivisa.
- People's data > People's fields: View sulle categorie che leggi (almeno root, about, employment e work per
- Incolla l'ID in
HIBOB_SERVICE_USER_IDe il token inHIBOB_SERVICE_USER_TOKEN. Vengono inviati come autenticazione HTTP Basic. - Installa il connettore ed esegui
hibob_list_employee_fieldsper verificare l'accesso.
Prima gli id dei campi: hibob_list_employee_fields elenca ogni campo standard e personalizzato con il suo id in notazione a punti (root.displayName, work.department, work.custom.field_123) e l'id di lista dei campi a lista. hibob_list_named_lists e hibob_get_named_list trasformano gli id di lista in nomi (reparti, sedi, qualifiche, calendari).
Cosa legge:
- Persone:
hibob_search_peoplelegge molti dipendenti in una sola chiamata (tutti, oppure filtrati solo perroot.idoroot.email; altri filtri vengono rifiutati),hibob_get_employeeuna persona per id o email di lavoro,hibob_list_profilesuna rubrica rapida. In un'azienda grande l'AI cerca prima confields: ["root.id"]e poi legge da 50 a 200 id per chiamata. - Tabelle storiche di una persona (work, employment, lifecycle, salary) e in blocco per molte (work, lifecycle, salary).
- Tabelle personalizzate con le loro colonne e le voci di un dipendente.
- Assenze: chi è fuori in un intervallo di date o in un giorno, richieste cambiate da un certo momento, una richiesta con i suoi giorni, il saldo di un dipendente per un tipo di policy, tipi di policy, codici motivo, policy, e festività e chiusure aziendali con
hibob_search_calendar_events. - Report salvati, eseguiti come righe JSON, CSV o XLSX; quelli grandi vengono generati in background con
hibob_request_report_downloade scaricati conhibob_download_report_by_name. - Wizard di onboarding, attività aperte in tutta l'azienda, le attività di un dipendente, le cartelle di documenti e i documenti di un dipendente con link di download.
Cosa scrive dopo l'installazione: hibob_submit_time_off_request (l'AI controlla prima l'unità del tipo di policy con hibob_get_policy_type; la richiesta segue il flusso di approvazione della policy, salvo che un amministratore imposti skip_manager_approval), hibob_cancel_time_off_request e hibob_complete_task.
Disattivati all'installazione: le scritture sui dati anagrafici hibob_update_employee (solo campi, non righe di tabelle), hibob_create_work_entry (promozione, trasferimento, nuovo responsabile), hibob_create_custom_table_entry, hibob_add_named_list_item e hibob_upload_shared_document (un URL pubblico o prefirmato, al massimo 5 MB, visibile al dipendente). Un amministratore del workspace li attiva consapevolmente nel connettore.
Formati dei dati: gli id dei dipendenti sono numeri lunghi inviati come stringhe (3332883884017713238). Le richieste usano la notazione a punti (work.department); le risposte usano chiavi con barre (/work/department) e possono annidare lo stesso valore anche per categoria. I campi a lista contengono id di voci; human_readable: APPEND o REPLACE aggiunge i nomi o li mette al loro posto. Le date sono YYYY-MM-DD; hibob_list_time_off_changes accetta date-ora ISO 8601. I saldi sono nell'unità del tipo di policy (giorni o ore) e le retribuzioni hanno la propria valuta. Dopo un aggiornamento Bob può restituire il valore vecchio per un massimo di 20 secondi.
Omissione silenziosa: un campo senza permesso o con un id sbagliato manca semplicemente dalla risposta, senza errore. Se manca qualcosa, controlla il gruppo di permessi del service user prima di concludere che il valore è vuoto.
Paginazione: ricerca persone, profili, lo storico di un dipendente, le attività aperte (al massimo 5.000) e chi è fuori restituiscono tutto in una volta. Gli strumenti storici in blocco e hibob_search_calendar_events paginano con cursor uguale a response_metadata.next_cursor; l'AI si ferma quando è null.
Limiti: i rate limit valgono per endpoint (la ricerca persone consente 50 richieste al minuto) e rispondono 429. Chi è fuori e gli intervalli del calendario hanno un'ampiezza massima, e le modifiche alle assenze risalgono al massimo a 6 mesi fa.
Errori comuni: 401 indica un ID o un token errato, 403 un permesso mancante nel gruppo del service user, 400 un filtro, un campo o un intervallo di date non valido. Risposte 401 o 403 ripetute possono essere bloccate per un po' dal firewall di Bob, quindi correggi i permessi prima di riprovare.
Il connettore non elabora le buste paga, non modifica le righe delle tabelle storiche con hibob_update_employee e non ha strumenti per approvare o rifiutare richieste di assenza in sospeso.
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 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
HiBob. - 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.
Tool disponibili
| Tool | What it does |
|---|---|
hibob_search_people | Read employee fields for many employees in one call: everyone the service user can access, or only the employees whose id or email is given… |
hibob_get_employee | Read the fields of one employee, identified by employee id or work email |
hibob_update_employee | Update fields of one employee record |
hibob_list_profiles | Public profile section of every active employee the service user can access: a fixed set of fields such as name, email, work title… |
hibob_list_employee_fields | All employee fields defined in the company (built-in and custom) with their field id (the dot-notation id to pass in fields), name… |
hibob_list_named_lists | All company lists (departments, sites, job titles, calendars, custom lists) with their items: each item has an id, the value Bob stores in… |
hibob_get_named_list | One company list by its internal name (e.g. department, site, title, calendar), with its items, their ids and names, and child items for… |
hibob_add_named_list_item | Add a new item to an existing company list, for example a new department or job title, optionally below a parent item in a hierarchy list |
hibob_list_work_history | Work history of one employee: one entry per change with effective date, title, department, site, manager (reportsTo) and reason |
hibob_list_employment_history | Employment history of one employee: contract type, weekly hours, working pattern, FTE and similar entries, each with its effective date |
hibob_list_lifecycle_history | Lifecycle status history of one employee: hired, employed, on leave, terminated and so on, each with its effective date and reason |
hibob_list_salary_history | Salary (payroll) history of one employee: base pay amount, currency, pay period and frequency, each entry with its effective date |
hibob_bulk_list_work_history | Work history for many employees at once (one page of employees per call, each with all its work entries) |
hibob_bulk_list_lifecycle_history | Lifecycle history for many employees at once (one page of employees per call, each with all its lifecycle entries) |
hibob_bulk_list_salary_history | Salary history for many employees at once (one page of employees per call, each with all its salary entries) |
hibob_create_work_entry | Add a work history entry for an employee (promotion, transfer, new manager, department change) taking effect on a given date |
hibob_list_custom_tables | Custom employee tables defined in the company, with their ids, names and column definitions |
hibob_get_custom_table_metadata | Definition of one custom employee table: its columns with id, name, type and the list id for list columns |
hibob_list_custom_table_entries | All entries of one custom table for one employee; values are keyed by column id |
hibob_create_custom_table_entry | Add one or more entries to an employee's custom table |
hibob_list_whos_out | Time off requests in a date range, for everyone the service user can access: who is out, which policy, request type, dates and status |
hibob_list_out_today | Who is out of the office today (UTC) or on one given date, optionally only at one site |
hibob_list_time_off_changes | Time off requests created, approved, declined, cancelled or deleted since a point in time (at most 6 months back and a 6-month window) |
hibob_get_time_off_request | Details of one time off request of an employee: policy type, dates, portions, status, approver, total cost and (by default) the duration… |
hibob_get_time_off_balance | Time off balance of one employee for one policy type on a given date: the amount available, used, pending and accrued, in the policy's unit… |
hibob_list_policy_types | Names of all time off policy types in the company (Holiday, Sick, custom types) |
hibob_get_policy_type | Settings of one time off policy type: unit (days or hours), allowed request types, whether it is a working type, visibility and similar… |
hibob_list_policy_type_reason_codes | Reason codes defined for one time off policy type, with the numeric id to pass as reason_code when submitting a request |
hibob_list_policy_names | Names of the policies (for example per country or contract) that belong to one time off policy type |
hibob_get_policy | Details of one time off policy: its type, allowance, accrual, carry-over and other rules |
hibob_search_calendar_events | Company holidays and closures (calendar events) in a date range, optionally for one calendar, site or event type |
hibob_submit_time_off_request | Submit a time off request for an employee |
hibob_cancel_time_off_request | Cancel an existing time off request of an employee |
hibob_list_reports | Company reports saved in Bob that the service user can see, with id, name, description, type, folder and dates (the column configuration is… |
hibob_download_report | Run a saved report and return its data. format json gives rows the model can read directly; csv returns text; xlsx returns a file |
hibob_request_report_download | Start generating a saved report in the background, for reports too large to download at once |
hibob_download_report_by_name | Fetch a report file generated by hibob_request_report_download |
hibob_list_onboarding_wizards | Onboarding wizards configured in Bob (id and name), the flows new hires are invited with |
hibob_list_open_tasks | All open tasks in the company (onboarding, offboarding and other flow tasks) with owner, related employee, due date and status |
hibob_list_employee_tasks | Tasks assigned to one employee (onboarding and other flow tasks), open, closed or both |
hibob_complete_task | Mark a task as complete, for example an onboarding step that was done outside Bob |
hibob_list_document_folders | Document folders defined in Bob (shared, confidential and custom folders) with their ids and metadata |
hibob_list_employee_documents | Documents of one employee in the folders the service user may view, with name and a download link per document |
hibob_upload_shared_document | Add a document to an employee's shared folder by giving a public or pre-signed URL that Bob downloads (max 5 MB) |
Esempi di prompt
- "Chi è fuori ufficio la prossima settimana, e con quale policy di assenza?"
- "Mostra lo storico di lavoro di [email protected]: qualifiche, reparti e responsabili con le date di decorrenza."
- "Quanti giorni di ferie restano quest'anno al dipendente 3332883884017713238, e quanti sono in attesa?"
- "Esegui il report salvato "Headcount by department" e riassumilo per sede."
- "Elenca tutte le attività di onboarding aperte e scadute, con il responsabile e il nuovo assunto a cui si riferiscono."
FAQ
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
- Landing del connettore
- Collegare a Claude
- Collegare a ChatGPT
- Collegare a Cursor
- Collegare a Gemini
- Collegare a Meta Muse
Questa guida ti è stata utile?