Cómo conectar XNómina con tu asistente de IA
Tu lugar es el timón, no el teclado: con MCP conectás tu asistente de IA a XNómina y le pedís por chat lo que hoy hacés clic por clic, siempre dentro de tus propios permisos.
Por el equipo de XNómina ·
En resumen
- Podés conectar tu propio asistente de IA, como Claude o ChatGPT, a XNómina por MCP, para pedirle por chat lo que hoy hacés navegando el panel.
- El token de conexión se genera en el menú de tu usuario, arriba a la derecha (hacé clic en tu nombre), en Conectar mi IA, y se muestra una sola vez: hay que copiarlo antes de salir de la pantalla.
- Por default el token es de solo lectura; para que tu IA pueda cargar novedades o gestionar usuarios hay que habilitarlo explícitamente al crearlo.
- El token nunca puede hacer más de lo que vos podés hacer en el panel: cada acción respeta tus permisos, y tiene vencimiento obligatorio y es revocable en cualquier momento.
Qué es "Conectar mi IA"
XNómina ya tiene un asistente conversacional dentro del panel, con el que podés chatear para pedirle cosas mientras trabajás. Conectar mi IA va un paso más allá: te deja conectar tu propio asistente de IA (Claude, ChatGPT u otro que hable el protocolo MCP) para que consulte y, si vos querés, también cargue datos en tu cuenta de XNómina desde afuera del panel.
La idea de fondo es la misma que la marca de XNómina: tu lugar es el timón, no el teclado. En vez de navegar pantalla por pantalla, le pedís a tu asistente lo que necesitás y él lo resuelve contra los mismos servicios que usa el panel.
Generar tu token
En el menú de tu usuario, arriba a la derecha (hacé clic en tu nombre), entrás a Conectar mi IA. Ahí ves el endpoint de conexión y un formulario para generar un token nuevo: le ponés un nombre (por ejemplo, Mi Claude) y elegís cada cuánto querés que venza (30 días, 90 días, 180 días o 1 año). El vencimiento es obligatorio: no existe un token que no venza nunca.
Con el botón Generar token se crea la conexión y el token en texto plano aparece una única vez en pantalla, con la advertencia de que no se vuelve a mostrar. Copialo en ese momento y pegalo en la configuración MCP de tu asistente, junto con el endpoint que te muestra la misma pantalla.
Qué puede hacer tu IA
Con un token recién creado, sin tildar ninguna casilla, tu IA puede consultar información de tu cuenta: empleados, convenios, períodos, usuarios y un resumen del período con recibos, neto, contribuciones patronales, costo laboral total y total pagado.
Si además tildás las opciones al crear el token, tu IA también puede escribir: cargar novedades del período, o crear usuarios y cambiarles el rol. Son dos permisos separados y ninguno viene activado por default.
| Qué puede hacer | Necesita habilitación |
|---|---|
| Consultar empleados, convenios, períodos y usuarios | No, viene por default |
| Ver el resumen del período: recibos, neto, contribuciones, costo laboral y total pagado | No, viene por default |
| Cargar novedades del período | Sí, tildando Permitir cargar novedades al crear el token |
| Crear usuarios o cambiarles el rol | Sí, tildando Permitir gestionar usuarios al crear el token |
El marco de seguridad
La regla central es simple: tu token nunca puede hacer más de lo que vos podés hacer en el panel. Cada acción que tu IA ejecuta pasa por los mismos servicios y los mismos permisos que usa tu usuario cuando entrás vos mismo, así que si tu rol no incluye, por ejemplo, gestionar usuarios, tu IA tampoco va a poder hacerlo aunque el token lo tenga habilitado.
Además, el token está atado a tu empresa: solo puede ver y tocar datos de tu cuenta de XNómina, nunca de otra. Y si en algún momento dejás de ser usuario de esa cuenta, el token deja de funcionar aunque todavía no haya vencido.
Gestionar y revocar tus tokens
La misma pantalla de Conectar mi IA lista todos los tokens que generaste, con su nombre, sus permisos, cuándo se usaron por última vez y cuándo vencen. Podés tener más de uno activo, por ejemplo uno para consultar desde tu asistente personal y otro con permisos de escritura para un uso más puntual.
Si perdés un token o dejás de confiar en él, no hay forma de recuperarlo: se revoca con la acción Revocar en su fila y generás uno nuevo si lo seguís necesitando. Conectar mi IA está disponible en el plan Completo; con un plan menor, la pantalla te muestra igual la función pero te invita a mejorar tu plan para activarla.
Paso a paso
Abrí Conectar mi IA desde el menú de tu usuario
En el menú de tu usuario, arriba a la derecha (hacé clic en tu nombre), entrá a Conectar mi IA. Ahí vas a ver el endpoint de conexión y el formulario de token nuevo.
Copiá el endpoint
El endpoint MCP se muestra arriba del formulario, con un botón para copiarlo directamente.
Completá el token nuevo
Ponele un nombre que lo identifique (por ejemplo, Mi Claude) y elegí cada cuánto querés que venza.
Tildá los permisos de escritura si los necesitás
Si querés que tu IA pueda cargar novedades o gestionar usuarios, marcá esas casillas. Si no, el token queda de solo lectura.
Generá el token y copialo
Tocá Generar token. El valor en texto plano aparece una sola vez: copialo antes de salir de la pantalla.
Configurá tu asistente de IA
Pegá el endpoint y el token en la configuración MCP de tu asistente, en el header Authorization con el formato Bearer.
Preguntas frecuentes
¿Qué asistentes de IA puedo conectar?
¿Mi IA puede hacer cualquier cosa en mi cuenta de XNómina?
¿Qué pasa si pierdo el token o alguien más lo ve?
¿Puedo tener más de un token activo?
¿Está disponible en cualquier plan de XNómina?
Conectá tu IA y empezá a operar XNómina por chat
Escribinos y te mostramos XNómina funcionando con tu convenio, o entrá al panel y probalo.