En este artículo se explica cómo configurar el conector MCP de Personio. Con el conector MCP, puedes conectar herramientas de IA, como Claude, directamente a la cuenta de Personio. Esto te permite ejecutar flujos de trabajo de RR. HH. entre sistemas sin ingeniería personalizada. Dependiendo de la configuración, las herramientas de IA conectadas pueden hacer lo siguiente:

• Conectarse directamente a los datos de Personio
• Completar un pequeño conjunto de acciones en tu nombre.

El servidor MCP de Personio está en beta en estos momentos y no está disponible para todo el mundo. Puedes probarla y compartir feedback antes del lanzamiento global. Ve a Ajustes personales > MCP de Personio en la cuenta de Personio y selecciona Dar feedback.

Funcionalidades principales

El servidor MCP de Personio admite en estos momentos las siguientes capacidades:

• Permiso de acceso de lectura para herramientas de IA conectadas para recuperar datos como perfiles de los empleados, ausencias, remuneración e información sobre desempeño.
• Operaciones de escritura limitadas que inician workflows controlados por Personio. Por ejemplo, solicitar una ausencia. El acceso de escritura está desactivado de forma predeterminada.
• Controles de herramienta que te permiten activar o desactivar capacidades individuales, como la lectura de la remuneración o la enumeración de periodos de ausencia, para cada herramienta de IA conectada.
• Controles de atributos personales que te permiten ocultar campos específicos de los empleados, como la dirección o el IBAN, a las herramientas de IA conectadas.

Antes de empezar

Permisos

Para configurar el servidor MCP, necesitas los siguientes permisos: 

• Un rol de administrador de Personio.
• Una cuenta en una herramienta de IA compatible y los permisos necesarios dentro de esa herramienta para configurar conectores personalizados. Dependiendo de la organización, podrías ser la persona que gestiona las herramientas de IA. Si otro compañero gestiona las herramientas de IA, trabaja mano a mano con esa persona para completar la configuración. Tanto si eres tú como si es un compañero, nos referimos a este rol en este artículo como el “administrador de la herramienta de IA”. 
  • Para algunas herramientas de IA, como ChatGPT, también necesitas una suscripción de pago.
  • Para configurar Claude, necesitas permisos de administrador en la cuenta de Claude de la organización.

Para que los empleados utilicen el conector MCP de Personio, el acceso refleja los permisos individuales que tienen configurados en Personio. Por ejemplo, para ver datos de remuneración del Departamento de Marketing a través del servidor MCP, el empleado necesita el permiso Ver para Información del salario de ese departamento. El servidor MCP solo puede ver y hacer lo que un empleado ya puede ver y hacer a ti en Personio.

Evaluar las herramientas de IA disponibles

Están disponibles las siguientes herramientas de IA:

• Anthropic Claude (web, escritorio, Cowork, IDE/CLI)
• Google Antigravity
• Visual Studio Code (GitHub Copilot)
• OpenAI (ChatGPT)

Comprender la privacidad de datos y los controles

Personio gestiona los datos de acuerdo con el Anexo de tratamiento de datos. Una vez que la herramienta de IA acceda a los datos a través del servidor MCP de Personio, Personio ya no puede rastrear cómo la usa. A partir de ese momento, los datos están sujetos a la privacidad de datos y al acuerdo de tratamiento establecido con el proveedor de la herramienta de IA.

• El acceso a los datos y las capacidades se rige por los roles asignados al usuario autenticado. El servidor MCP no otorga ningún acceso más allá de lo que un usuario ya tiene.
• El servidor MCP está deshabilitado de forma predeterminada. Los administradores tienen que activarlo manualmente. El acceso de escritura es un botón de activación adicional separado.
• Los administradores pueden deshabilitar herramientas específicas y ocultar atributos de persona específicos en Personio. Personio rechaza las herramientas deshabilitadas y los atributos restringidos, independientemente de los ajustes propios de la herramienta de IA.
• Los cambios en la configuración del MCP se registran con fines de auditoría, de la misma manera que cualquier otra transacción realizada en la aplicación.

Configurar el conector MCP de Personio

Sigue estos pasos para conectar el servidor MCP de Personio a la herramienta de IA. La siguiente tabla resume quién es responsable de cada paso de la configuración. 

Paso 1: Activar el acceso al servidor MCP de Personio para la organización

Ten en cuenta que:
Selecciona el nivel de acceso que mejor se adapte a los requisitos de seguridad de la organización. Al conectar la herramienta de IA al MCP, es posible que estés permitiéndole acceder datos confidenciales de RR. HH. y almacenarlos fuera Personio. Descubre más sobre la privacidad de datos y los controles.

Sigue estos pasos en Personio:

1. Ve a Ajustes.
2. En la sección Cuenta y ayuda, haz clic en Funcionalidades de IA.
3. Ve a la sección Funcionalidades de IA y activa Acceso general con el botón.
4. Ve a la sección MCP de Personio y activa MCP de Personio con el botón de activación/desactivación. 
5. Revisa la lista Herramientas y deshabilita cualquiera (por ejemplo, leer datos de remuneración) que no quieras que usen las herramientas de IA conectadas. 
6. Revisa la lista Atributos de persona y deshabilita cualquier atributo personalizado (por ejemplo, dirección o IBAN) que no quieras que lean las herramientas de IA conectadas. Para actualizar varios atributos a la vez, puedes hacer clic en No permitir ninguno o Permitir todos los mostrados. 
   • Ten en cuenta que: No puedes deshabilitar atributos principales de Personio como el departamento y el puesto (de trabajo). Los empleados solo pueden acceder a estos a través del conector MCP si también tienen los permisos para verlos en Personio. 

Los controles de Herramientas y Atributo de persona están situados junto a los ajustes de aprobación por herramienta de la herramienta de IA. Los botones de activación/desactivación de Personio establecen el límite estricto y los ajustes de la herramienta IA lo reducen aún más por usuario.
 

Paso 2: Recuperar credenciales del MCP

1. Vaya a Ajustes personales.
2. En la pestaña MCP de Personio, haz clic en la herramienta de IA pertinente para expandirla.
3. En la sección expandida, copia la URL del servidor MCP y el ID de cliente OAuth. Necesitarás estos valores en el siguiente paso. 
   • Consejo: https://app.personio.com/mcp

Paso 3: Conecta la herramienta de IA

Escoge la herramienta de IA a continuación y sigue los pasos para completar la conexión.

Anthropic Claude

Puedes configurar el conector MCP de Personio en Anthropic Claude a través de la aplicación de escritorio Claude o a través de la interfaz de línea de comandos (CLI). Consulte la documentación sobre el conector personalizado para más información.

Para conectarse con la aplicación Claude Desktop:

1. Abre claude.ai y ve a Ajustes > Conectores > Añadir conector personalizado. También puedes hacer clic en Conectar si sigues un enlace de Personio.
2. Introduce lo siguiente: https://app.personio.com/mcp
3. Abre Ajustes avanzados y pega el ID de cliente de OAuth copiado anteriormente desde los Ajustes personales de Personio (consulta el paso 2). Deja el campo de la clave del cliente vacío.
4. Haz clic en Añadir y luego en Conectar. Escribe el nombre de la organización, inicia sesión con la cuenta de Personio y aprueba el acceso.

Claude Desktop y Cowork recogen el conector automáticamente.

Para conectarte usando la CLI:

Ejecuta lo siguiente en la aplicación Terminal. Sustituye el nombre del conector, la URL del servidor MCP y el ID de cliente OAuth con los valores del paso 1:

claude mcp add [custom-connector-name] --transport http [https://app.personio.com/mcp] --client-id [client-id] --callback-port 5000

Luego abre Claude Code y ejecuta /mcp. Escoge el nombre del conector que acabas de añadir y autentícate.

Si el conector no aparece después de añadirlo, ejecute /login en Claude e inicie sesión de nuevo. Siempre que cambies la configuración del MCP, tienes que iniciar sesión de nuevo en Claude (no en el MCP).

Google Antigravity

1. Combina el fragmento de abajo en la sección mcpServers de ~/.gemini/config/mcp_config.json. Consulta los documentos del MCP de Antigravity.
2. Reinicia Antigravity, abre Ajustes > Personalizaciones > Servidores MCP instalados y haz clic en Autenticar junto a Personio.
3. En la ventana del navegador que se abre, escribe el nombre de la organización, inicia sesión con tu cuenta de Personio y aprueba el acceso.

{
 "mcpServers": {
   "personio": {
     "type": "http",
     "url": "https://app.personio.com/mcp",
     "oauth": {
       "enabled": true,
       "clientId": "<your-oauth-client-id>",
       "redirectUri": "http://localhost:5000/oauth/callback",
       "scopes": ["mcp:access"]
     }
   }
 }
}

Visual Studio Code (GitHub Copilot)

1. En Visual Studio Code 1.101 o posterior, ejecuta MCP: Add Server… desde la paleta de comandos e introduce lo siguiente: https://app.personio.com/mcp
2. Cuando Visual Studio Code te pida que te autentiques, escoge proporcionar credenciales del cliente manualmente y pega el ID de cliente OAuth. Deja la clave del cliente vacía.
3. Escribe el nombre de la organización, inicia sesión con la cuenta de Personio y aprueba el acceso. Las herramientas de Personio aparecen en chat de Copilot (modo agente).

OpenAI (ChatGPT)

Web

1. Abre chatgpt.com.
2. Ve a Plugins y haz clic en el icono del signo más.
3. Introduce la siguiente información:
   • Nombre: Personio
   • https://app.personio.com/mcp
4. Selecciona la casilla de verificación para reconocer la advertencia de seguridad. A continuación, haz clic en Crear.
5. Haz clic en Autenticar.
6. Escribe el nombre de la organización, inicia sesión con la cuenta de Personio y aprueba el acceso.

Aplicación de escritorio

1. Haz clic en la foto de perfil y ve a Ajustes.
2. Ve a Plugins > Añadir > Añadir servidor MCP.
3. Introduce la siguiente información:
   • Nombre: Personio
   • Tipo: HTTP transmisible
   • https://app.personio.com/mcp
4. Haz clic en Guardar.
5. Selecciona la pestaña MCP y haz clic en Autenticar junto al servidor MCP nuevo.
6. Escribe el nombre de la organización, inicia sesión con la cuenta de Personio y aprueba el acceso.

CLI de Codex

1. Ejecuta el siguiente comando para añadir el servidor MCP de Personio a Codex.
2. Codex imprime un enlace de autorización en el terminal. Copia este enlace y ábrelo en un navegador.
3. Escribe el nombre de la organización, inicia sesión con la cuenta de Personio y aprueba el acceso.

codex mcp add personio --url https://app.personio.com/mcp

Paso 4: Añadir el conector MCP de Personio en la herramienta de IA

Encuentra y añade el conector MCP de Personio en la herramienta de IA. Este paso es necesario incluso si el administrador de la herramienta de IA ya ha configurado el conector en la organización. Cada usuario tiene que añadir el conector individualmente para poder usarlo.

Si se te pide que inicies sesión de nuevo después de haberte conectado, es probable que la autenticación haya vencido después de un periodo de inactividad o puede que haya alcanzado el máximo de su vida útil. Inicia sesión de nuevo con la cuenta de Personio.

Paso 5: Establecer restricciones de acceso en la herramienta

Después de conectar el servidor MCP, tienes que personalizar las restricciones de acceso. Esto le permite controlar qué capacidades de Personio puede usar libremente su herramienta de IA, cuáles requieren aprobación antes de ejecutarse y cuáles se desactivan por completo. En Claude, gestiona estas restricciones desde la página de ajustes del conector.

Para cada herramienta de IA que conectes (por ejemplo, Claude), personalice las restricciones de acceso de la siguiente manera:

• Revisa las herramientas disponibles. Cada herramienta se asigna a una capacidad en la tabla de más abajo.
• Establece un permiso para cada herramienta. Permítelo automáticamente o requiere la aprobación del usuario cada vez que se ejecute. Recomendamos requerir la aprobación para cualquier acción de escritura, como solicitar una ausencia, y para herramientas que lean datos confidenciales, como los de remuneración.
• Deshabilita cualquier herramienta que no necesites. Apagar una herramienta en el conector evita que la herramienta de IA la llame, independientemente de los ajustes de lectura o escritura de Personio.

Ten en cuenta lo siguiente: 

• Los botones de activación/desactivación de Herramientas y Atributos de persona de Personio establecen el límite general de lo que es posible. Puede restringir aún más ese límite con los ajustes de la herramienta de IA, por herramienta y por usuario.
• Si se rechaza una acción de escritura después de que hayas configurado estos ajustes, es probable que el acceso de escritura esté deshabilitado. Activa el ajuste en Personio. A continuación, confirma que la herramienta específica no está desactivada o configurada para requerir aprobación en la herramienta de IA.

Revisar las capacidades a través del MCP de Personio

La siguiente tabla enumera las capacidades actuales disponibles a través del servidor MCP de Personio. La capacidad de aprobar ausencias llegará pronto.

Revisar las limitaciones del servidor MCP

Ten en cuenta lo siguiente cuando utilices el servidor MCP de Personio.

• Los resultados se generan con IA y se basan en probabilidades. Confirma siempre los resultados importantes antes de actuar en función de los datos o de aprobar cambios, incluyendo acciones de escritura como las solicitudes de ausencia.
  • El LLM al que te conectas con el MCP genera los resultados, no el servidor MCP en sí. Como todos los LLM, puede alucinar o malinterpretar datos ocasionalmente, y las tendencias de alucinación varían según el modelo.
• El servidor MCP de Personio no sustituye a la automatización o a las integraciones. Para integraciones programadas permanentes, como la sincronización de datos con otro sistema, utiliza la API de Personio.
• Las consultas grandes están paginadas. En el caso de las grandes empresas, es posible que la herramienta de IA necesite buscar datos por lotes, lo que puede tardar más y, en ocasiones, requiere que le pidas que continúe.
• Los límites de tasa se aplican al uso intensivo o con scripts.
• Los datos básicos de los empleados y los empleos son fundamentales para muchas herramientas. Desactivar estas herramientas centrales puede hacer que otras herramientas devuelvan resultados parciales o nulos. Para restringir lo que pueden ver las herramientas de IA conectadas, use el ámbito de los atributos en lugar de desactivar las herramientas centrales.