HR WORKS MCP mit Microsoft Copilot verbinden

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

HR WORKS + Microsoft Copilot

Greife auf HR WORKS zu, die deutsche HR- und Lohnplattform: Mitarbeitende, Abwesenheiten, Krankmeldungen, mobiles Arbeiten (Homeoffice), Arbeitszeiten, Arbeitszeitkonten, Lohnzahlungen, Personalakten, Projekte, Bewerbende, Organisationseinheiten, Feiertage und Kostenstellen über die v2 REST API.

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:

HRWORKS_ACCESS_KEY, HRWORKS_SECRET_ACCESS_KEY

Schritt 1 — Zugangsdaten holen

1. Öffne in HR WORKS Administration → API und erstelle ein API-Schlüsselpaar: einen Access Key und einen Secret Access Key.
2. Trage den Access Key in HRWORKS_ACCESS_KEY und den Secret Access Key in HRWORKS_SECRET_ACCESS_KEY ein und installiere dann den Connector.
3. Beginne mit hrworks_list_organization_units oder hrworks_list_persons, um zu prüfen, ob das Schlüsselpaar funktioniert.

Tokens erledigt der Connector: HR WORKS stellt Tokens aus, die etwa 15 Minuten gelten. Der Connector tauscht dein Schlüsselpaar gegen einen Token, erneuert ihn vor Ablauf und meldet sich nach einem 401 neu an. So laufen lange Chats und geplante Abläufe ohne Unterbrechung weiter.

Was er kann: 48 Tools, die Mitarbeitende und ihre Stammdaten, Organisationseinheiten, Feiertage, Abwesenheiten, Krankmeldungen, mobiles Arbeiten (Homeoffice), Arbeitszeiten und Arbeitszeitkonten, Urlaubskonten, verfügbare Arbeitsstunden, Personalakten, Lohnzahlungen, Reisekostenabrechnungen, Projekte, Bewerbende und Stellenausschreibungen, Kostenstellen und Kostenträger lesen. Drei Tools schreiben: hrworks_create_working_times erfasst Arbeitszeiten oder Pausen, hrworks_update_working_times ändert bestehende und hrworks_delete_working_times löscht erfasste (bei der Installation deaktiviert). HR WORKS verarbeitet alle drei im Hintergrund und gibt eine Job-ID zurück, die hrworks_get_working_times_job prüft. Bevor die KI schreibt, bestätigt sie Personen, Tage und Uhrzeiten mit dir. Alle anderen Tools lesen nur.

Summen und Salden: hrworks_list_time_accounts liefert Soll-Stunden, Ist-Stunden und den Überstundensaldo pro Monat, hrworks_list_leave_accounts den Urlaubsanspruch sowie genehmigte, geplante und verfallende Tage vieler Personen auf einmal. hrworks_get_absences_accumulated, hrworks_get_sick_leaves_accumulated und hrworks_get_remote_work_accumulated zählen die Tage pro Person in einem Zeitraum, statt jeden Eintrag aufzulisten, und hrworks_get_available_working_hours zeigt für die Kapazitätsplanung, wie viele Stunden nach Abzug der Abwesenheiten verfügbar sind.

Vertrauliche Daten: Stammdaten, Personalakten, Lohnzahlungen und Krankmeldungen sind personenbezogene Daten, Lohndaten und Gesundheitsdaten. Lege den Connector nur auf einen MCP-Server, den Personen nutzen, die diese Daten sehen dürfen, oder schalte diese Tools aus.

Zeiträume: Abwesenheiten, Krankmeldungen, mobiles Arbeiten, die Summen und die verfügbaren Arbeitsstunden brauchen beginDate und endDate (YYYY-MM-DD) und umfassen höchstens ein Jahr pro Aufruf, mit interval=days höchstens 31 Tage. Arbeitszeiten sind enger begrenzt: höchstens 31 Tage in höchstens zwei Kalendermonaten pro Aufruf, deshalb fragt die KI Monat für Monat ab. Auch Reisekostenabrechnungen brauchen beginDate und endDate.

Personen: Die meisten Personen-Tools nehmen die Personalnummer oder den HR-WORKS-Benutzernamen; personIdentifierType oder usePersonnelNumbers sagen HR WORKS, welches von beiden gemeint ist. Die Lohnzahlungen einer Person brauchen ihre UUID, die hrworks_get_person und hrworks_list_persons_master_data liefern.

Schon installiert? Ein früher installierter Connector bekommt die neuen Tools über sein Katalog-Update: Öffne den Connector in AnythingMCP, prüfe unter Catalog update available die Liste der neuen Tools und klicke auf Apply update. Deine Zugangsdaten und selbst hinzugefügte Tools bleiben unverändert. Beachte außerdem: hrworks_list_travel_expense_reports braucht jetzt beginDate und endDate, und hrworks_list_working_times nimmt pro Aufruf höchstens 31 Tage in zwei Kalendermonaten.

Sandbox: Für Tests mit der HR-WORKS-Demo unter https://api.demo-hrworks.de stellst du die Base URL des Connectors und die Login-URL in seinen Auth-Einstellungen auf den Demo-Host um.

Limits: Die meisten Listen liefern 50 Einträge pro Seite; gibt es mehr, fragt die KI die nächste page ab. HR WORKS setzt Rate Limits pro Konto.

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

Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.

1. Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
2. Trag einen Server name ein (zum Beispiel AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft.
3. Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf X-API-Key und klicke auf Create.
4. Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
5. Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die HR WORKS-Tools braucht.
6. Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.

Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.

Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.

Verfügbare Tools

Beispiel-Prompts

• „Zeig mir den Überstundensaldo aller Mitarbeitenden der Organisationseinheit Vertrieb für September und Oktober 2026.“
• „Wie viele Urlaubstage haben Anna Becker und Jonas Weber dieses Jahr noch, und wie viele davon sind schon verplant?“
• „Wie viele Arbeitsstunden hat das Entwicklungsteam im November zur Verfügung, aufgeteilt nach Wochen?“
• „Zähle die Krankheitstage und Homeoffice-Tage pro Person im Lagerteam für das dritte Quartal.“
• „Erfasse für Personalnummer 1042 gestern Arbeitszeit von 8:00 bis 16:30 Uhr mit Pause von 12:00 bis 12:30 Uhr und prüfe danach, ob HR WORKS sie übernommen hat.“
• „Welche lohnrelevanten Einträge sind dieses Jahr in die Personalakte von Jonas Weber gekommen?“

FAQ

Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.

Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.

Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit ChatGPT verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden