Conectar Jisr MCP con Meta Muse

💡 ¿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 + Meta Muse

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 Muse

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.

Muse añade los servidores MCP remotos como conectores personalizados e inicia sesión en ellos con OAuth.

1. En Muse, abre Settings → Connectors y elige Add custom connector.
2. Pega la URL del servidor MCP https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
3. Muse abre la página de inicio de sesión de AnythingMCP: inicia sesión y aprueba el acceso.
4. En un chat, pídele a Muse algo que necesite las herramientas de Jisr.

También puedes configurarlo desde un chat, en la web, en las apps de iOS y Android o en WhatsApp. Envía a Muse este mensaje:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Muse se conecta desde la nube de Meta, así que localhost no funciona.

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

¿Dónde está disponible Muse? Por ahora Meta ofrece Muse en Estados Unidos y Canadá, en la web, en las apps de iOS y Android y en WhatsApp.

¿Meta revisa este conector? No. Meta no revisa los conectores personalizados. Muse solo ve las herramientas que activaste para este servidor MCP en AnythingMCP, y puedes desconectarlo cuando quieras en Settings → Connectors.

Siguientes pasos

• Página del conector
• Conectar a Claude