Conecta tu IA con Personio

Qué puede hacer tu IA con Personio

Una vez conectado, estas herramientas aparecen automáticamente en tu asistente de IA:

• list_employeessolo lectura

  Enumere las personas de la empresa, con sus contratos. Filtre por correo para localizar a alguien sin conocer su identificador.

• get_employeesolo lectura

  Obtenga una persona, con sus datos personales y su contrato en curso.

• create_employeeescritura · requiere aprobación

  Cree una persona y su primer contrato — una incorporación. Solo el nombre es estrictamente obligatorio, pero un contrato sin fecha de inicio, estado y tipo sirve de poco: indíquelos juntos. Requiere el scope persons:write en las credenciales de Personio. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• update_employeeescritura · requiere aprobación

  Modifique los datos propios de una persona. Su contrato se modifica con update_employment. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• list_employmentssolo lectura

  Enumere los contratos de una persona — su sucesión en el tiempo, con fechas de inicio y fin, jornada, entidad jurídica, puesto y responsable.

• get_employmentsolo lectura

  Obtenga íntegramente un contrato de una persona.

• update_employmentescritura · requiere aprobación

  Modifique un contrato: estado, fechas, jornada, puesto, responsable o entidad jurídica. Es el expediente contractual de alguien — un valor erróneo aquí lo ve la nómina. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• list_compensationssolo lectura

  Enumere los elementos retributivos — salarios y otros componentes, cada uno con su importe, moneda, periodicidad y fecha de efecto. Personio rechaza un rango superior a un mes: consulte mes a mes.

• create_compensationescritura · requiere aprobación

  Registre una retribución para una persona — subida, prima, nuevo salario. Surte efecto en la fecha indicada y alimenta la nómina. El tipo procede de list_compensation_types. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• list_compensation_typessolo lectura

  Enumere los tipos de retribución definidos por la empresa — salario base, prima, complemento. Sus identificadores son los que espera create_compensation.

• list_salary_bandssolo lectura

  Enumere las bandas salariales definidas para la empresa.

• get_salary_bandsolo lectura

  Obtenga una banda salarial, con sus límites.

• list_absencessolo lectura

  Enumere las ausencias — vacaciones, bajas y cualquier otro tipo, cada una con su tipo, fechas y sustituto.

• get_absencesolo lectura

  Obtenga una ausencia íntegramente.

• list_absence_typessolo lectura

  Enumere los tipos de ausencia definidos por la empresa — vacaciones retribuidas, baja, sin sueldo. Sus identificadores son los que espera create_absence.

• create_absenceescritura · requiere aprobación

  Registre una ausencia para alguien. Las fechas se dan sin zona horaria; use startHalf o endHalf cuando la ausencia cubra solo medio día al principio o al final. Que el sustituto sea obligatorio, opcional o esté prohibido depende de la política del tipo de ausencia. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• update_absenceescritura · requiere aprobación

  Modifique las fechas, el sustituto o el comentario de una ausencia ya registrada. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• list_attendancessolo lectura

  Enumere los tiempos de presencia — las horas realmente trabajadas y las pausas, imputadas en su caso a un proyecto.

• get_attendancesolo lectura

  Obtenga íntegramente un tiempo de presencia.

• create_attendanceescritura · requiere aprobación

  Registre tiempo trabajado o una pausa para alguien. Un periodo no puede superar las 24 horas, y una pausa no puede imputarse a un proyecto — solo el trabajo puede. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• update_attendanceescritura · requiere aprobación

  Modifique los horarios, el proyecto o el comentario de un tiempo de presencia ya introducido. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• list_projectssolo lectura

  Enumere los proyectos a los que se puede imputar tiempo.

• get_projectsolo lectura

  Obtenga un proyecto.

• create_projectescritura · requiere aprobación

  Cree un proyecto al que los empleados podrán imputar tiempo. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• update_projectescritura · requiere aprobación

  Renombre un proyecto, o ciérrelo a nuevas imputaciones. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• list_project_memberssolo lectura

  Enumere las personas autorizadas a imputar tiempo a un proyecto.

• add_project_membersescritura · requiere aprobación

  Autorice a personas a imputar tiempo a un proyecto. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• remove_project_membersescritura · requiere aprobación

  Retire a personas el derecho a imputar tiempo a un proyecto. El tiempo ya introducido permanece; solo se retira el derecho a añadir más. Acción de escritura: sujeta a la barrera de confirmación cuando está activada.

• list_org_unitssolo lectura

  Enumere las unidades organizativas — departamentos y equipos.

• get_org_unitsolo lectura

  Obtenga una unidad organizativa, con su lugar en la jerarquía.

• list_legal_entitiessolo lectura

  Enumere las entidades jurídicas del grupo — las sociedades que emplean a los trabajadores.

• get_legal_entitysolo lectura

  Obtenga una entidad jurídica.

• list_cost_centerssolo lectura

  Enumere los centros de coste a los que pueden vincularse los contratos.

• list_workplacessolo lectura

  Enumere los centros de trabajo — oficinas y sedes a las que están adscritos los empleados.

• list_jobssolo lectura

  Enumere los puestos definidos por la empresa — las funciones para las que se contrata.

• get_jobsolo lectura

  Obtenga un puesto.

• list_documentssolo lectura

  Enumere los metadatos de los documentos de los empleados — contratos, certificados, nóminas. Devuelve qué es cada documento, no su contenido.

• list_applicationssolo lectura

  Enumere las candidaturas, con el candidato y el puesto correspondientes.

• get_applicationsolo lectura

  Obtenga una candidatura íntegramente.

• list_application_stagessolo lectura

  Enumere los cambios de etapa de una candidatura — cuándo superó cada paso del proceso, lo que permite medir dónde se atascan los candidatos.

• list_candidatessolo lectura

  Enumere los candidatos que se han presentado.

• get_candidatesolo lectura

  Obtenga los datos de un candidato.

• list_open_positionssolo lectura

  Enumere los puestos abiertos a candidaturas. Son las ofertas de selección, distintas del catálogo de puestos que devuelve list_jobs.

• get_open_positionsolo lectura

  Obtenga un puesto abierto.

• list_job_categoriessolo lectura

  Enumere las categorías bajo las que se agrupan los puestos abiertos.

• list_reportssolo lectura

  Enumere los informes personalizados construidos en Personio. Ejecutar uno es la manera de responder a una pregunta que las demás herramientas no cubren, con las definiciones de la empresa.

• get_reportsolo lectura

  Obtenga un informe con sus datos.

• list_report_attributessolo lectura

  Enumere los atributos disponibles para construir un informe — los campos de la empresa, incluidos los personalizados. Conviene leerlo para saber qué guarda Personio realmente antes de pedirlo.

Ejemplos de prompts

Pídeselo a tu IA en lenguaje natural: elegirá la herramienta de Personio adecuada.

• “Enumere las personas de la empresa, con sus contratos. Filtre por correo para localizar a alguien sin conocer su identificador — desde Personio, en lenguaje natural.”
• “Obtenga una persona, con sus datos personales y su contrato en curso — desde Personio, en lenguaje natural.”
• “Enumere los contratos de una persona — su sucesión en el tiempo, con fechas de inicio y fin, jornada, entidad jurídica, puesto y responsable — desde Personio, en lenguaje natural.”
• “Obtenga íntegramente un contrato de una persona — desde Personio, en lenguaje natural.”

Cómo funciona

1. Crea tu cuenta de Proxoria y añade tu endpoint MCP a Claude o ChatGPT.
2. Conecta Personio con tu clave API: cada persona conecta su propia cuenta y las credenciales se cifran en reposo.
3. Tu IA obtiene al instante las herramientas de Personio. Las acciones de escritura esperan tu aprobación en el panel antes de cambiar nada.

Preguntas frecuentes

¿Personio tiene un servidor MCP oficial?

No te hace falta. Proxoria expone Personio a tu IA mediante el Model Context Protocol, así que puedes usarlo desde Claude, ChatGPT, Mistral o cualquier cliente compatible con MCP, sin ningún servidor MCP oficial de Personio.

¿Qué puede hacer mi IA con Personio a través de Proxoria?

Obtiene 48 herramientas: 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. Por ejemplo: enumere las personas de la empresa, con sus contratos. filtre por correo para localizar a alguien sin conocer su identificador.

¿El conector de Personio es de solo lectura?

No, también puede modificar datos. Las acciones de escritura pasan por defecto por el control de confirmación de Proxoria: tu IA las propone y tú apruebas cada una desde tu panel antes de que se escriba nada en Personio.

¿Cómo conecto Personio con mi IA?

Crea una cuenta de Proxoria, conecta Personio con tu clave API y añade tu endpoint MCP de Proxoria a Claude o ChatGPT. Tu IA obtiene al instante las herramientas de Personio.