Conectar Jisr MCP con Microsoft Copilot

💡 ¿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 + Microsoft Copilot

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 Microsoft Copilot

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.

Microsoft Copilot usa servidores MCP a través de agentes creados en Copilot Studio: añades AnythingMCP a un agente como herramienta y luego publicas el agente en Microsoft 365 Copilot y Teams. Copilot Studio se conecta desde la nube de Microsoft por Streamable HTTP, que AnythingMCP admite.

1. En Copilot Studio, abre tu agente (o crea uno), ve a Tools y elige Add a tool → New tool → Model Context Protocol.
2. Escribe un Server name (por ejemplo AnythingMCP), una Server description que diga qué hace el conector y la Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Copilot Studio usa la descripción para decidir cuándo llamar al servidor.
3. En la autenticación, elige API key, pon Type en Header y X-API-Key como nombre de la cabecera, y selecciona Create.
4. En Add tool, elige Create a new connection, pega una clave de API MCP de AnythingMCP (MCP Servers → tu servidor → API keys) y selecciona Add to agent.
5. Pruébalo en el panel Test del agente: pide algo que necesite las herramientas de Jisr.
6. Selecciona Publish y luego Channels → Microsoft 365 and Microsoft Teams, deja marcada Make agent available in Microsoft Copilot y elige Add channel. See agent in Teams lo instala para ti; en Microsoft 365 Copilot, escribe @ y elige el agente.

¿Prefieres que cada persona inicie sesión? En lugar de la clave de API elige OAuth 2.0 → Dynamic discovery: cada usuario inicia sesión en AnythingMCP la primera vez que el agente lo llama.

¿Lo alojas tú mismo? Usa la dirección HTTPS pública de tu instancia en lugar de https://cloud.anythingmcp.com. Copilot Studio se conecta desde la nube de Microsoft, 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

¿Para qué Copilot es? Para Microsoft 365 Copilot en el trabajo, mediante agentes de Copilot Studio. La app de Microsoft Copilot para cuentas personales no permite añadir tu propio servidor MCP.

¿Qué necesito? Una cuenta de trabajo con acceso a Copilot Studio (licencia o prueba) para crear el agente. Quien lo use en Microsoft 365 Copilot o Teams necesita acceso al agente: compártelo o pide a un administrador que lo publique para la organización. Si tu organización aplica directivas de datos a los conectores de Power Platform, también cubren los servidores MCP.

El agente no llama a las herramientas. Comprueba que el nombre de la cabecera sea exactamente X-API-Key y que la clave pertenezca al mismo servidor MCP que la URL, y escribe una Server description concreta: Copilot Studio la usa para decidir cuándo llamar al servidor. Vuelve a publicar el agente después de cada cambio; en un chat abierto, escribe "start over" para usar la nueva versión.

Siguientes pasos

• Página del conector
• Conectar a Claude