Jisr MCP mit Cursor verbinden

💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → Jisr klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein git clone, kein lokaler Server.

Jisr + Cursor

Frag deine HR-Organisation in Jisr aus jedem KI-Assistenten ab: Mitarbeitende und ihre Stellendaten, Anwesenheitsübersichten und Stempelungen, Jahresurlaubssalden, Abteilungen und Standorte. Standardmäßig nur lesend; das Übermitteln von Stempelungen ist verfügbar, aber ausgeschaltet.

Voraussetzungen

Die vollständige Setup-Anleitung ist in den Connector eingebaut (im Store sichtbar, wenn du den Connector auswählst). Benötigte Umgebungsvariablen für diesen Connector:

JISR_SLUG, JISR_API_KEY, JISR_API_SECRET

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten. Du brauchst einen Jisr-Benutzer mit der Rolle Admin, denn nur ein Admin kann API-Keys anlegen, und den Slug deiner Organisation, also die Subdomain deiner Jisr-Adresse.

1. Öffne in Jisr Settings → Webhook & API Keys → API Keys und klicke auf Add new API key (Hilfeartikel von Jisr).
2. Gib dem Key einen Namen und hake die APIs an, die er nutzen darf: Get List Employees, Get Employee Basic Information, Get attendance summary, View attendance records, View summary of employee annual leave und die Lookups, die du brauchst. Hake Get Employee Financial Info nur an, wenn die KI Gehälter sehen darf.
3. Klicke auf Generate und kopiere den API key in JISR_API_KEY und das secret in JISR_API_SECRET. Jisr zeigt das Secret nur einmal an: Ist es verloren, erzeugst du einen neuen Key.
4. Setz JISR_SLUG auf den Slug deiner Organisation: die Subdomain deiner Jisr-Adresse in Kleinbuchstaben, also acme für acme.jisr.net, nicht die ganze Adresse.
5. Installiere den Connector. Prüfe die Verbindung mit jisr_list_employees.

Cloud und Self-Hosting funktionieren gleich: Es gibt keine App zu registrieren und keine Redirect URL; der Connector braucht nur Slug, API-Key und Secret.

Der Connector meldet sich selbst an: Er ruft POST /openapi/v1/auth mit Slug, API-Key und Secret auf, erhält ein Zugriffstoken und schickt es bei jedem Aufruf als Header Access-Token mit, zusammen mit slug und api-version. Key und Secret gehen nur an diesen Anmeldeaufruf. Lehnt Jisr das Token ab, meldet sich der Connector neu an; du musst nichts erneuern.

In Saudi-Arabien gehostete Organisationen: Endet deine Jisr-Adresse auf .jisr.net.sa, nutzt deine Organisation https://api.jisr.net.sa/api statt https://apis.jisr.net/api. Stell die Base URL und die Login URL des Connectors auf diesen Host um (Login URL https://api.jisr.net.sa/api/openapi/v1/auth).

Mitarbeiterdaten sind personenbezogene Daten: Die Datensätze enthalten Geburtsdatum, private Kontaktdaten sowie Ausweis- und Passnummern. Hake am Key nur die APIs an, die du brauchst, und gib nur weiter, was nötig ist. Bankdaten (IBAN) werden aus Mitarbeiterlisten immer entfernt; Gehälter bleiben verborgen, solange Get Employee Financial Info nicht angehakt ist; Custom Fields kommen nur zurück, wenn der Key diese Berechtigung hat.

Zwei Kennungen pro Person: Jede Person hat eine öffentliche id (eine UUID wie bab6cd98-7246-4cfc-a576-19bc00391792), die jisr_get_employee und der Filter der Anwesenheitsübersicht nutzen, und einen numerischen employee code (etwa 43), den Stempelungen und Urlaubssalden nutzen.

Datum und Seiten: Datumsangaben sind YYYY-MM-DD; Stempelzeiten sind Datum mit Uhrzeit wie 2026-11-01T08:00:00. Ohne Zeitraum deckt die Anwesenheitsübersicht den aktuellen Monat ab und die Stempelliste die letzte Stunde. Listen liefern bis zu 100 Einträge pro Seite (page ab 1, rpp oder limit); die KI liest weiter, solange data.pagination eine next_page zeigt.

Häufige Fehler: This call requires login heißt, dass das Token abgelaufen ist; der Connector meldet sich neu an. Organization not found with given subdomain heißt, dass JISR_SLUG falsch ist. Wird die Anmeldung abgelehnt, stimmt Slug, API-Key oder Secret nicht: Kopiere sie erneut oder erzeug einen neuen Key, wenn das Secret verloren ist. Ein 403 heißt, dass dem API-Key die Berechtigung für diese API fehlt: Bearbeite den Key unter Settings → Webhook & API Keys und hake sie an.

Nicht enthalten: Mitarbeitende anlegen, Lohn- und Rückstellungsbuchungen, Journale, Webhooks und Audit-Ereignisse.

Was der Connector liest: Mitarbeitende mit öffentlicher id und employee code, englischem und arabischem Namen, dienstlicher und privater E-Mail, Telefon, Status, Stellenbezeichnung, Abteilung, Standort, Geschäftsbereich, Beschäftigungsart, Nationalität, Vorgesetztem, Eintrittsdatum, Geburtsdatum, Ausweis- und Passnummern sowie Austritts- und Löschdatum, filterbar nach Status und nach Anlage-, Eintritts-, Austritts- oder Löschdatum; das vollständige Basisprofil einer Person mit persönlichen Angaben, Adresse und Kontaktdaten; Anwesenheitssummen pro Person für einen Zeitraum: Arbeitsstunden, Verspätungen und vorzeitige Gehzeiten, Mehrarbeit, genehmigte Überstunden, Abwesenheit, Tage ohne Stempelungen, Urlaubs- und freie Tage, ganztägige Entschuldigungen und Dienstreisetage; einzelne Stempelungen mit Zeit, Seriennummer des Geräts und, bei abgelehnten, dem Fehler von Jisr; Jahresurlaubssalden mit Anfangs- und Vorjahressaldo, manuellen Korrekturen, genommenen, beantragten und reservierten Tagen, Abzug für unbezahlten Urlaub und Saldo zum Jahresende; die Listen der Abteilungen, Standorte, Beschäftigungsarten, Geschäftsbereiche, Nationalitäten und Outsourcing-Firmen mit englischem und arabischem Namen.

Bei der Installation deaktiviert: jisr_create_attendance_logs. Es übermittelt bis zu 100 Stempelungen an Jisr, wie es eine Stempeluhr oder ein Zutrittssystem täte; Jisr verarbeitet sie im Hintergrund, und sie ändern die Anwesenheitsdaten der Mitarbeitenden. Das Ergebnis prüfst du danach mit jisr_list_attendance_logs (Status success oder failed). Schalte es auf der Connector-Seite nur ein, wenn du es brauchst; die KI lässt sich jede Änderung vorher von dir bestätigen. Alle anderen Tools lesen nur.

Schritt 2 — Adapter installieren

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

Schritt 3 — Connector in Cursor hinzufügen

Deine Server-URL: Öffne in AnythingMCP MCP Servers → den Server, auf dem dieser Connector liegt, und kopiere seine URL (https://cloud.anythingmcp.com/mcp/…). Setze sie überall ein, wo diese Anleitung YOUR_SERVER_ID zeigt.

Cursor liest MCP-Server aus ~/.cursor/mcp.json. Füge diesen Eintrag hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "url": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte Cursor neu.
3. Öffne Cursor → Settings → MCP und prüfe, ob anythingmcp aufgeführt und verbunden ist.
4. Leg los: Der Agent kann jetzt die Jisr-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wer ist in den letzten 30 Tagen eingetreten, und in welcher Abteilung und an welchem Standort?“
• „Zeig mir die Anwesenheitsübersicht dieses Monats: Wer hat die meisten Verspätungen und Abwesenheitstage?“
• „Welche Stempelungen hat Jisr gestern abgelehnt, und mit welchem Fehler jeweils?“
• „Wie viele Urlaubstage haben die Mitarbeitenden mit den Codes 43 und 77 noch?“
• „Liste die Mitarbeitenden auf, die dieses Jahr ausgeschieden sind, mit Stellenbezeichnung und Austrittsdatum.“

FAQ

Unterstützt Cursor eigene MCP-Server im kostenlosen Tarif? Ja — MCP gibt es in den Tarifen Hobby, Pro und Business.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden