Collega la tua IA a Personio

Cosa può fare la tua IA con Personio

Una volta collegato, questi strumenti compaiono automaticamente nel tuo assistente IA:

• list_employeessola lettura

  Elencate le persone dell azienda, con i loro contratti. Filtrate per email per ritrovare qualcuno senza conoscerne l identificatore.

• get_employeesola lettura

  Ottenete una persona, con i suoi dati personali e il contratto in corso.

• create_employeescrittura · richiede approvazione

  Create una persona e il suo primo contratto — un inserimento. Solo il nome è strettamente obbligatorio, ma un contratto senza data di inizio, stato e tipo serve a poco: indicateli insieme. Richiede lo scope persons:write sulle credenziali Personio. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• update_employeescrittura · richiede approvazione

  Modificate i dati propri di una persona. Il contratto si modifica con update_employment. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• list_employmentssola lettura

  Elencate i contratti di una persona — la loro successione nel tempo, con date di inizio e fine, orario, entità giuridica, posizione e responsabile.

• get_employmentsola lettura

  Ottenete per intero un contratto di una persona.

• update_employmentscrittura · richiede approvazione

  Modificate un contratto: stato, date, orario, posizione, responsabile o entità giuridica. È il fascicolo contrattuale di qualcuno — un valore errato qui è visibile alle paghe. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• list_compensationssola lettura

  Elencate gli elementi retributivi — stipendi e altre componenti, ciascuno con importo, valuta, periodicità e data di efficacia. Personio rifiuta un intervallo superiore a un mese: interrogate mese per mese.

• create_compensationscrittura · richiede approvazione

  Registrate una retribuzione per una persona — aumento, premio, nuovo stipendio. Ha effetto dalla data indicata e alimenta le paghe. Il tipo proviene da list_compensation_types. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• list_compensation_typessola lettura

  Elencate i tipi di retribuzione definiti dall azienda — stipendio base, premio, indennità. I loro identificatori sono quelli attesi da create_compensation.

• list_salary_bandssola lettura

  Elencate le fasce retributive definite per l azienda.

• get_salary_bandsola lettura

  Ottenete una fascia retributiva, con i suoi limiti.

• list_absencessola lettura

  Elencate le assenze — ferie, malattie e ogni altro tipo, ciascuna con tipo, date e sostituto.

• get_absencesola lettura

  Ottenete un assenza per intero.

• list_absence_typessola lettura

  Elencate i tipi di assenza definiti dall azienda — ferie retribuite, malattia, non retribuita. I loro identificatori sono quelli attesi da create_absence.

• create_absencescrittura · richiede approvazione

  Registrate un assenza per qualcuno. Le date sono indicate senza fuso orario; usate startHalf o endHalf quando l assenza copre solo mezza giornata all inizio o alla fine. Se il sostituto sia obbligatorio, facoltativo o vietato dipende dalla politica del tipo di assenza. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• update_absencescrittura · richiede approvazione

  Modificate date, sostituto o commento di un assenza già registrata. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• list_attendancessola lettura

  Elencate i tempi di presenza — le ore realmente lavorate e le pause, eventualmente imputate a un progetto.

• get_attendancesola lettura

  Ottenete per intero un tempo di presenza.

• create_attendancescrittura · richiede approvazione

  Registrate tempo lavorato o una pausa per qualcuno. Un periodo non può superare 24 ore, e una pausa non può essere imputata a un progetto — solo il lavoro può esserlo. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• update_attendancescrittura · richiede approvazione

  Modificate orari, progetto o commento di un tempo di presenza già inserito. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• list_projectssola lettura

  Elencate i progetti a cui è possibile imputare tempo.

• get_projectsola lettura

  Ottenete un progetto.

• create_projectscrittura · richiede approvazione

  Create un progetto a cui i dipendenti potranno imputare tempo. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• update_projectscrittura · richiede approvazione

  Rinominate un progetto, o chiudetelo a nuove imputazioni. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• list_project_memberssola lettura

  Elencate le persone autorizzate a imputare tempo a un progetto.

• add_project_membersscrittura · richiede approvazione

  Autorizzate delle persone a imputare tempo a un progetto. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• remove_project_membersscrittura · richiede approvazione

  Togliete a delle persone il diritto di imputare tempo a un progetto. Il tempo già inserito resta; viene tolto solo il diritto di aggiungerne. Azione di scrittura: soggetta alla barriera di conferma quando è attiva.

• list_org_unitssola lettura

  Elencate le unità organizzative — reparti e team.

• get_org_unitsola lettura

  Ottenete un unità organizzativa, con la sua posizione nella gerarchia.

• list_legal_entitiessola lettura

  Elencate le entità giuridiche del gruppo — le società che impiegano i dipendenti.

• get_legal_entitysola lettura

  Ottenete un entità giuridica.

• list_cost_centerssola lettura

  Elencate i centri di costo a cui i contratti possono essere collegati.

• list_workplacessola lettura

  Elencate le sedi di lavoro — uffici e siti a cui i dipendenti sono assegnati.

• list_jobssola lettura

  Elencate le posizioni definite dall azienda — le funzioni per cui si assume.

• get_jobsola lettura

  Ottenete una posizione.

• list_documentssola lettura

  Elencate i metadati dei documenti dei dipendenti — contratti, attestati, buste paga. Restituisce che cosa è ciascun documento, non il suo contenuto.

• list_applicationssola lettura

  Elencate le candidature, con il candidato e la posizione interessati.

• get_applicationsola lettura

  Ottenete una candidatura per intero.

• list_application_stagessola lettura

  Elencate i passaggi di fase di una candidatura — quando ha superato ogni tappa del processo, il che permette di misurare dove i candidati si arenano.

• list_candidatessola lettura

  Elencate i candidati che si sono proposti.

• get_candidatesola lettura

  Ottenete le informazioni di un candidato.

• list_open_positionssola lettura

  Elencate le posizioni aperte alle candidature. Sono gli annunci di selezione, distinti dal catalogo di posizioni restituito da list_jobs.

• get_open_positionsola lettura

  Ottenete una posizione aperta.

• list_job_categoriessola lettura

  Elencate le categorie sotto cui sono raggruppate le posizioni aperte.

• list_reportssola lettura

  Elencate i rapporti personalizzati costruiti in Personio. Eseguirne uno è il modo di rispondere a una domanda che gli altri strumenti non coprono, con le definizioni dell azienda.

• get_reportsola lettura

  Ottenete un rapporto con i suoi dati.

• list_report_attributessola lettura

  Elencate gli attributi disponibili per costruire un rapporto — i campi dell azienda, compresi quelli personalizzati. Da leggere per sapere cosa Personio detiene davvero prima di chiederlo.

Esempi di prompt

Chiedi alla tua IA in linguaggio naturale: sceglierà lo strumento Personio giusto.

• “Elencate le persone dell azienda, con i loro contratti. Filtrate per email per ritrovare qualcuno senza conoscerne l identificatore — da Personio, in linguaggio naturale.”
• “Ottenete una persona, con i suoi dati personali e il contratto in corso — da Personio, in linguaggio naturale.”
• “Elencate i contratti di una persona — la loro successione nel tempo, con date di inizio e fine, orario, entità giuridica, posizione e responsabile — da Personio, in linguaggio naturale.”
• “Ottenete per intero un contratto di una persona — da Personio, in linguaggio naturale.”

Come funziona

1. Crea il tuo account Proxoria e aggiungi il tuo endpoint MCP a Claude o ChatGPT.
2. Collega Personio con la tua chiave API — ogni persona collega il proprio account, con credenziali cifrate a riposo.
3. La tua IA ottiene subito gli strumenti Personio. Le azioni di scrittura attendono la tua approvazione nella dashboard prima di qualsiasi modifica.

Domande frequenti

Personio ha un server MCP ufficiale?

Non ti serve. Proxoria espone Personio alla tua IA tramite il Model Context Protocol: puoi usarlo da Claude, ChatGPT, Mistral o da qualsiasi client compatibile con MCP, senza alcun server MCP ufficiale di Personio.

Cosa può fare la mia IA con Personio tramite Proxoria?

Ottiene 48 strumenti: list_employees, get_employee, create_employee, update_employee, list_employments, get_employment, update_employment, list_compensations, create_compensation, list_compensation_types, list_salary_bands, get_salary_band, list_absences, get_absence, list_absence_types, create_absence, update_absence, list_attendances, get_attendance, create_attendance, update_attendance, list_projects, get_project, create_project, update_project, list_project_members, add_project_members, remove_project_members, list_org_units, get_org_unit, list_legal_entities, get_legal_entity, list_cost_centers, list_workplaces, list_jobs, get_job, list_documents, list_applications, get_application, list_application_stages, list_candidates, get_candidate, list_open_positions, get_open_position, list_job_categories, list_reports, get_report, list_report_attributes. Per esempio: elencate le persone dell azienda, con i loro contratti. filtrate per email per ritrovare qualcuno senza conoscerne l identificatore.

Il connettore Personio è in sola lettura?

No — può anche modificare i dati. Le azioni di scrittura passano per impostazione predefinita dal controllo di conferma di Proxoria: la tua IA le propone e tu approvi ciascuna dalla dashboard prima che venga scritto qualcosa su Personio.

Come collego Personio alla mia IA?

Crea un account Proxoria, collega Personio con la tua chiave API e aggiungi il tuo endpoint MCP Proxoria a Claude o ChatGPT. La tua IA ottiene subito gli strumenti Personio.