MetronHR an eure eigenen Systeme anbinden

Es gibt drei Wege hinein und hinaus: eine offene REST-API mit OpenAPI-Dokument, signierte Webhooks für Ereignisse aus dem Betrieb und einen MCP-Server, über den ein KI-Assistent arbeiten kann. Alle drei gehören zum Professional-Tarif, ohne Aufpreis und ohne Mindestzahl an Lizenzen.

Die drei Zugänge

Sie teilen ein Berechtigungsmodell. Was ein Zugang darf, steht als Recht je Ressource, nicht als Rolle und nicht als Alles-oder-nichts.

  • REST-API

    Wofür er gedacht ist
    Ein System, das regelmäßig Daten holt oder schreibt: Lohnbuchhaltung, Projektcontrolling, eigenes Dashboard.
    Wie er sich ausweist
    API-Schlüssel als Bearer-Token, angelegt in den Unternehmenseinstellungen.

  • Webhooks

    Wofür er gedacht ist
    Ein System, das sofort erfahren will, wenn etwas passiert, statt im Takt nachzufragen.
    Wie er sich ausweist
    Signatur je Zustellung nach Standard Webhooks, Geheimnis rotierbar.

  • MCP-Server

    Wofür er gedacht ist
    Ein KI-Assistent wie Claude oder ChatGPT, der Fragen zum Betrieb beantworten soll.
    Wie er sich ausweist
    OAuth 2.1 mit PKCE, mit einem Freigabedialog, der die Rechte im Klartext nennt.

Stand 14. September 2026. Verbindlich ist das OpenAPI-Dokument unter app.metronhr.de/api/v1/openapi.json, nicht diese Übersicht.

Welche Daten die API führt

Jede Ressource lässt sich lesen. Geschrieben wird dort, wo ein Aufruf denselben Weg nimmt wie die Eingabe im Produkt, also durch dieselben Regeln: Sperrfristen, Kollisionsprüfung, Urlaubssaldo, Rechte am Kunden.

  • Mitarbeitende

    Lesen
    ja
    Ändern
    nein, eine Person entsteht durch eine Einladung

  • Abteilungen

    Lesen
    ja
    Ändern
    nein

  • Kunden

    Lesen
    ja
    Ändern
    ja

  • Leistungen

    Lesen
    ja
    Ändern
    ja

  • Projekte

    Lesen
    ja
    Ändern
    ja

  • Zeiteinträge

    Lesen
    ja
    Ändern
    ja

  • Abwesenheiten

    Lesen
    ja
    Ändern
    ja, beantragen und entscheiden

  • Schichten

    Lesen
    nur veröffentlichte
    Ändern
    nein, das beantwortet der Planer

  • Arbeitszeitmodelle und Verträge

    Lesen
    ja, ohne Gehalt und ohne Zulagen
    Ändern
    nein

  • Urlaubskonten und Feiertage

    Lesen
    ja
    Ändern
    nein

  • Schichtbereiche und Schichtarten

    Lesen
    ja
    Ändern
    nein

  • Kontingente und Leistungsnachweise

    Lesen
    ja
    Ändern
    nein

Stand 15. September 2026, 16 Ressourcen, davon fünf änderbar. Die Rechte heißen je Ressource „lesen“ oder „lesen und ändern“; das Recht zu ändern schließt das Lesen ein.

Was ein Webhook meldet

Ein Ziel abonniert einzelne Ereignisse, nicht alles. Die Nutzlast trägt dieselbe Form wie die Antwort der REST-API derselben Ressource, ein Empfänger hat also einen Typ und nicht zwei. Der vollständige Katalog, die Signatur und das Verhalten bei Zustellfehlern stehen auf der Seite zu den Webhooks.

  • Zeiteinträge

    Ereignisse
    angelegt, geändert, gelöscht. Sie melden aus allen fünf Erfassungswegen, auch vom Terminal und aus der App.

  • Abwesenheiten

    Ereignisse
    beantragt, genehmigt, abgelehnt, storniert, geändert. Geändert ist der Fall, den ein Lohnsystem sonst übersieht: der Zeitraum eines bereits genehmigten Urlaubs verschiebt sich.

  • Mitarbeitende

    Ereignisse
    angelegt, deaktiviert, Stammdaten geändert. Angelegt meldet aus jedem Weg, auch aus dem Import und aus der Bereitstellung über Microsoft Entra ID.

  • Schichten

    Ereignisse
    veröffentlicht, zugeteilt, abgezogen.

Stand 15. September 2026, 15 Ereignisse. Eine Zustellung, die nicht ankommt, wird bis zu sechs Mal mit wachsendem Abstand wiederholt.

Das bringt die Schnittstelle mit

  • Cursor-Blätterung mit `nextCursor`, damit auch fünfstellige Zeilenzahlen durchlaufen.
  • Fehler nach RFC 9457 als `application/problem+json`, mit Feldangaben bei Eingabefehlern.
  • Der Kopf `Idempotency-Key` bei schreibenden Aufrufen, damit ein Wiederholversuch nichts doppelt anlegt.
  • Ratengrenzen mit den Kopfzeilen `RateLimit` und `RateLimit-Policy`.
  • Jeder Aufruf steht im Protokoll des Betriebs, mit Schlüssel und Vorgang.

Das gibt es nicht

  • Lohn- und Gehaltsabrechnung. MetronHR erfasst Zeiten, es rechnet sie nicht ab.
  • Ein Schreibweg für Mitarbeitende. Eine Person entsteht hier durch eine Einladung, nicht durch einen Aufruf.
  • Ein Schreibweg für Schichten. Eine Schicht muss gegen Arbeitszeitmodell, Ruhezeit und Verfügbarkeit halten, und das beantwortet der Planer.
  • Eine zweite Fassung der Schnittstelle. Es gibt v1, und Erweiterungen sind additiv.

Die Lücken sind Entscheidungen und kein Rückstand. Wo ein Schreibweg fehlt, fehlt er, weil der Vorgang im Produkt mehr ist als eine Zeile in einer Tabelle.

Einen KI-Assistenten verbinden

Der MCP-Server spricht die Revision 2026-07-28 des Model Context Protocol und braucht im Client nur eine Adresse:https://app.metronhr.de/mcp. Es gibt keine Client-ID und kein Geheimnis zum Abtippen, der Client registriert sich selbst und führt danach den Anmeldefluss im Browser. Was der Server kann und wo er aufhört, steht auf der Seite zum MCP-Server; die Schritte je Assistent stehen bei ChatGPT, Microsoft Copilot und Claude.

  • KI-Verbindungen einschalten

    Wo er passiert
    Unternehmenseinstellungen, Bereich Integrationen. Die Vorgabe ist aus.

  • Rollen freigeben

    Wo er passiert
    Daneben: wer verbinden darf. Leer heißt niemand, auch bei eingeschaltetem Schalter.

  • Schreiben freigeben

    Wo er passiert
    Eigener Schalter mit eigener Rollenliste. Ohne ihn kann ein Assistent lesen und sonst nichts.

  • Im Client eintragen

    Wo er passiert
    Claude Desktop, Claude Code, ChatGPT oder GitHub Copilot: Adresse eintragen, im Browser freigeben. Der Dialog nennt die Rechte im Klartext.

Jeder Werkzeugaufruf steht im Protokoll des Betriebs, mit Werkzeug und Client, ohne den Inhalt der Antwort. Eine Verbindung lässt sich einzeln wieder trennen.

Fragen zur Schnittstelle

Was uns dazu am häufigsten gefragt wird.

Ja, im Professional-Tarif, ohne Aufpreis und ohne Mindestzahl an Lizenzen. Das gilt für alle drei Zugänge: REST-API, ausgehende Webhooks und den MCP-Server. Im Tarif Team sind sie nicht enthalten.

Mit einem API-Schlüssel als Bearer-Token. Die Geschäftsführung legt ihn in den Unternehmenseinstellungen an, hakt dort genau die Rechte an, die das System braucht, und wählt die Laufzeit. Der Klartext erscheint genau einmal; gespeichert wird nur seine Prüfsumme. Ein Schlüssel lässt sich jederzeit rotieren oder widerrufen.

Genau das, was angehakt wurde. Die Rechte sind je Ressource „lesen“ oder „lesen und ändern“, nicht alles oder nichts. Ein Schlüssel für die Lohnbuchhaltung bekommt damit Zeiteinträge und Abwesenheiten zu lesen und sonst nichts, und ein geleakter Schlüssel kann nur, was in seiner Liste steht.

Was eine Anbindung an Lohn, Projektzeit oder Verzeichnis braucht, und nicht mehr. Die Mitarbeitendenliste nennt Name, Rolle, Abteilung und Beschäftigungsstatus; Bankverbindung, Geburtsdatum, Sozialversicherungsnummer und der Grad einer Behinderung bleiben draußen. Bei Abwesenheiten geht die Art mit, nicht die Notiz, in der bei einer Krankmeldung regelmäßig steht, was jemand hat.

Jede Zustellung ist nach dem Standard-Webhooks-Verfahren signiert (HMAC-SHA256 über Kennung, Zeitstempel und Rumpf). Das Geheimnis lässt sich rotieren, das alte signiert 24 Stunden mit, damit der Empfänger Zeit für den Wechsel hat. Ziele werden beim Anlegen gegen interne Netze geprüft, und ein Ziel, das dauerhaft nicht annimmt, wird abgeschaltet; der Betrieb bekommt darüber eine Nachricht.

Nur wenn der Betrieb es ausdrücklich erlaubt. KI-Verbindungen sind standardmäßig aus. Wer sie einschaltet, sagt zusätzlich, welche Rollen verbinden dürfen. Das Schreiben ist eine eigene, dritte Entscheidung mit eigenem Schalter und eigener Rollenliste. Wird sie zurückgenommen, verliert eine laufende Verbindung das Schreiben mit der nächsten Anfrage.

Die 14 Tage Testphase sind sie. Ein Testbetrieb ist ein vollwertiger Betrieb mit eigenen Daten, eigenen Schlüsseln und derselben API; ein getrenntes Sandbox-System, das anders antwortet als die Produktion, gibt es bewusst nicht.

Steht deine Frage nicht dabei? Schritt für Schritt erklärt ist die Bedienung im Hilfezentrum.

Probiert es mit euren eigenen Daten aus

Den ersten Schlüssel legt ihr in den Unternehmenseinstellungen an, die Referenz steht danach unter app.metronhr.de/api/v1/docs.

Preise ansehen

Ohne Kreditkarte, jederzeit kündbar

Passt dazu

Wo es von hier aus weitergeht, und was dich dort erwartet.