Conectar Jisr MCP con ChatGPT

💡 ¿Sin instalación? Usa cloud.anythingmcp.com directamente. Inicia sesión, pulsa Connectors → Jisr, pega tus credenciales, genera una MCP API key y listo. Sin Docker, sin git clone, sin servidor local.

Jisr + ChatGPT

Consulta tu organización de RR. HH. en Jisr desde cualquier asistente de IA: empleados y sus datos laborales, resúmenes de asistencia y fichajes, saldos de vacaciones anuales, departamentos y ubicaciones. Solo lectura por defecto; el envío de fichajes está disponible pero desactivado.

Requisitos previos

Las instrucciones de configuración completas están incluidas en el conector (visibles en el store al seleccionarlo). Las variables de entorno requeridas:

JISR_SLUG, JISR_API_KEY, JISR_API_SECRET

Paso 1 — Obtener credenciales

La configuración lleva unos 5 minutos. Necesitas un usuario de Jisr con el rol Admin, porque solo un Admin puede crear claves de API, y el slug de tu organización, es decir, el subdominio de tu dirección de Jisr.

1. En Jisr, abre Settings → Webhook & API Keys → API Keys y haz clic en Add new API key (artículo de ayuda de Jisr).
2. Ponle un nombre a la clave y marca las API que puede usar: Get List Employees, Get Employee Basic Information, Get attendance summary, View attendance records, View summary of employee annual leave y las listas de consulta (lookups) que quieras. Marca Get Employee Financial Info solo si la IA puede ver los salarios.
3. Haz clic en Generate y copia la API key en JISR_API_KEY y el secret en JISR_API_SECRET. Jisr muestra el secret una sola vez: si lo pierdes, genera una clave nueva.
4. Pon en JISR_SLUG el slug de tu organización: el subdominio de tu dirección de Jisr en minúsculas, acme para acme.jisr.net, no la dirección completa.
5. Instala el conector. Comprueba la conexión con jisr_list_employees.

Cloud y self-hosted funcionan igual: no hay ninguna app que registrar ni Redirect URL; el conector solo necesita el slug, la API key y el secret.

El conector inicia sesión solo: llama a POST /openapi/v1/auth con tu slug, tu API key y tu secret, recibe un token de acceso y lo envía en la cabecera Access-Token, junto con slug y api-version, en cada llamada. La clave y el secret solo van a esa llamada de inicio de sesión. Cuando Jisr rechaza el token, el conector vuelve a iniciar sesión, así que no hay nada que renovar.

Organizaciones alojadas en Arabia Saudí: si tu dirección de Jisr termina en .jisr.net.sa, tu organización usa https://api.jisr.net.sa/api en lugar de https://apis.jisr.net/api. Cambia la base URL y la login URL del conector a ese host (login URL https://api.jisr.net.sa/api/openapi/v1/auth).

Los datos de los empleados son datos personales: las fichas incluyen fecha de nacimiento, datos de contacto personales y números de documento y pasaporte. Marca en la clave solo las API que necesites y comparte solo lo necesario. Los datos bancarios (IBAN) se eliminan siempre de las listas de empleados; los salarios quedan ocultos mientras Get Employee Financial Info no esté marcada; los campos personalizados solo llegan si la clave tiene ese permiso.

Dos identificadores por empleado: cada empleado tiene un id público (un UUID como bab6cd98-7246-4cfc-a576-19bc00391792), que usan jisr_get_employee y el filtro del resumen de asistencia, y un employee code numérico (como 43), que usan los fichajes y los saldos de vacaciones.

Fechas y paginación: las fechas son YYYY-MM-DD; las horas de fichaje son fecha y hora, como 2026-11-01T08:00:00. Sin un rango, el resumen de asistencia cubre el mes en curso y la lista de fichajes la última hora. Las listas devuelven hasta 100 entradas por página (page desde 1, rpp o limit); la IA sigue leyendo mientras data.pagination indique una next_page.

Errores frecuentes: This call requires login significa que el token ha caducado, y el conector vuelve a iniciar sesión. Organization not found with given subdomain significa que JISR_SLUG es incorrecto. Si se rechaza el inicio de sesión, el slug, la API key o el secret no son correctos: cópialos de nuevo, o genera una clave nueva si perdiste el secret. Un 403 significa que la API key no tiene permiso para esa API: edita la clave en Settings → Webhook & API Keys y márcala.

No incluido: crear empleados, transacciones de nómina y de devengos, asientos contables (journals), webhooks y eventos de auditoría.

Qué lee: empleados con id público y employee code, nombre en inglés y en árabe, correo de trabajo y personal, teléfono, estado, puesto, departamento, ubicación, unidad de negocio, tipo de empleo, nacionalidad, responsable directo, fecha de incorporación, fecha de nacimiento, números de documento y pasaporte, y fechas de baja y de eliminación, con filtros por estado y por fecha de creación, incorporación, baja o eliminación; el perfil básico completo de un empleado con datos personales, dirección y contacto; los totales de asistencia por empleado en un periodo: horas trabajadas, llegadas tarde y salidas anticipadas, tiempo extra, horas extra aprobadas, ausencias, días sin registros, días de permiso y de descanso, justificaciones de día completo y días de viaje de trabajo; los fichajes individuales con hora, número de serie del dispositivo y, en los rechazados, el error que dio Jisr; los saldos de vacaciones anuales con saldo inicial y del año anterior, ajustes manuales, días disfrutados, pendientes y reservados, descuento por permiso no retribuido y saldo a fin de año; las listas de departamentos, ubicaciones, tipos de empleo, unidades de negocio, nacionalidades y empresas de outsourcing, con nombre en inglés y en árabe.

Desactivada al instalar: jisr_create_attendance_logs. Envía a Jisr hasta 100 fichajes, como lo haría un reloj de fichaje o un sistema de control de acceso; Jisr los procesa en segundo plano y cambian los registros de asistencia de los empleados. Comprueba después el resultado con jisr_list_attendance_logs (estado success o failed). Actívala en la página del conector solo si la necesitas; la IA te pide confirmación antes de cada cambio. Todas las demás herramientas son de solo lectura.

Paso 2 — Instalar el 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

Paso 3 — Añadir el conector en ChatGPT

La URL de tu servidor: en AnythingMCP abre MCP Servers → el servidor donde está este conector y copia su URL (https://cloud.anythingmcp.com/mcp/…). Úsala donde esta guía muestra YOUR_SERVER_ID.

ChatGPT añade servidores MCP como plugins desde su página Plugins, en la web y en los planes de pago. Ya no hace falta el modo desarrollador. En un espacio Business solo pueden hacerlo los administradores y propietarios; en Enterprise y Edu un administrador puede conceder el permiso Create plugins with MCPs.

1. Ve a chatgpt.com/plugins, pulsa Add y luego Add custom MCP server.
2. Escribe un nombre, por ejemplo Name: Jisr.
3. En Connection, introduce como Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID y deja Authentication en OAuth.
4. Selecciona I understand and want to continue y después Create as a plugin. Cuando ChatGPT lo pida, inicia sesión en AnythingMCP y permite el acceso.
5. Instala el nuevo plugin desde tus plugins personales; luego escribe @ en un chat y elígelo.

Herramientas disponibles

Ejemplos de prompts

• "¿Quién se ha incorporado en los últimos 30 días, y en qué departamento y ubicación?"
• "Muéstrame el resumen de asistencia de este mes: ¿quién tiene más llegadas tarde y días de ausencia?"
• "¿Qué fichajes rechazó Jisr ayer, y con qué error cada uno?"
• "¿Cuántos días de vacaciones les quedan a los empleados con código 43 y 77?"
• "Lista los empleados que causaron baja este año, con su puesto y la fecha de baja."

FAQ

¿Funciona el plan gratuito de ChatGPT con servidores MCP personalizados? OpenAI documenta los servidores MCP personalizados solo para los planes de pago; el plan Free no aparece en su lista.

Siguientes pasos

• Página del conector
• Conectar a Claude