HiBob über MCP mit ChatGPT verbinden

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

HiBob + ChatGPT

Die HR-Plattform HiBob (Bob) über die öffentliche API mit einem Service User: Mitarbeitende suchen und lesen, Arbeits-, Beschäftigungs-, Lifecycle- und Gehaltshistorie, Custom Tables, Firmenlisten, Abwesenheiten mit Who's out, Anträgen, Salden und Richtlinien, Feiertage, gespeicherte Reports, Onboarding, Aufgaben und Dokumente. Schreibzugriffe auf Stammdaten sind bei der Installation aus.

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:

HIBOB_SERVICE_USER_ID, HIBOB_SERVICE_USER_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 10 Minuten und braucht einen Bob-Admin. Der Connector nutzt die öffentliche REST-API von Bob (https://api.hibob.com/v1) mit einem Service User.

1. Geh in Bob als Admin zu Settings > Integrations > Automation > Service Users, klick auf Manage und lege einen Service User mit Namen und Anzeigenamen an. Kopiere seine ID und sein Token sofort: Das Token wird nur beim Erzeugen angezeigt. Ein verlorenes Token lässt sich neu erzeugen, das alte wird dabei ungültig.
2. Lege für den Service User eine eigene Berechtigungsgruppe (permission group) an und füge ihn hinzu. Eine neue Gruppe hat keine Rechte; gib also nur, was du nutzt:
   • People's data > People's fields: View auf den Kategorien, die du liest (für hibob_search_people mindestens root, about, employment und work), View history auf den Historientabellen (work, employment, lifecycle, payroll), Edit dort, wo du änderst.
   • Access data for: Everyone oder eine Bedingung. Standardmäßig sind nur beschäftigte Personen erfasst; entferne die Bedingung Lifecycle status equals Employed, um Ausgeschiedene mit show_inactive zu lesen.
   • People's data > Time off: Anträge und Salden ansehen, und Anträge stellen oder stornieren, wenn du diese Tools nutzt; private Anträge ansehen für include_private.
   • Features > Reports: View reports according to people's data access rights.
   • People's data > Tasks and flow > People's tasks: View and mark selected people's tasks as complete.
   • People's data > Docs > [Ordner]: View pro Dokumentordner und Upload für den geteilten Ordner.
3. Füge die ID in HIBOB_SERVICE_USER_ID und das Token in HIBOB_SERVICE_USER_TOKEN ein. Beide werden als HTTP Basic Auth gesendet.
4. Installiere den Connector und rufe hibob_list_employee_fields auf, um den Zugriff zu prüfen.

Zuerst die Feld-IDs: hibob_list_employee_fields listet jedes Standard- und Custom-Feld mit seiner ID in Punktnotation (root.displayName, work.department, work.custom.field_123) und der Listen-ID von Listenfeldern. hibob_list_named_lists und hibob_get_named_list machen aus Listen-IDs Namen (Abteilungen, Standorte, Jobtitel, Kalender).

Was er liest:

• Personen: hibob_search_people liest viele Mitarbeitende in einem Aufruf (alle oder nur gefiltert nach root.id oder root.email; andere Filter werden abgelehnt), hibob_get_employee eine Person per ID oder Arbeits-E-Mail, hibob_list_profiles ein schnelles Verzeichnis. In einer großen Firma sucht die KI zuerst mit fields: ["root.id"] und liest dann 50 bis 200 IDs pro Aufruf.
• Historientabellen einer Person (work, employment, lifecycle, salary) und als Bulk für viele (work, lifecycle, salary).
• Custom Tables mit ihren Spalten und den Einträgen einer Person.
• Abwesenheiten: wer in einem Zeitraum oder an einem Tag fehlt, seit einem Zeitpunkt geänderte Anträge, ein Antrag mit seinen Tagen, der Saldo einer Person für einen Policy Type, Policy Types, Grund-Codes, Richtlinien sowie Feiertage und Schließtage mit hibob_search_calendar_events.
• Gespeicherte Reports, ausgeführt als JSON-Zeilen, CSV oder XLSX; große erzeugt hibob_request_report_download im Hintergrund, und hibob_download_report_by_name holt die Datei.
• Onboarding-Wizards, offene Aufgaben in der ganzen Firma, die Aufgaben einer Person, Dokumentordner und die Dokumente einer Person mit Download-Links.

Was er nach der Installation schreibt: hibob_submit_time_off_request (die KI prüft vorher mit hibob_get_policy_type die Einheit des Policy Types; der Antrag durchläuft den Genehmigungsweg der Richtlinie, außer ein Admin setzt skip_manager_approval), hibob_cancel_time_off_request und hibob_complete_task.

Bei der Installation deaktiviert: die Schreibzugriffe auf Stammdaten hibob_update_employee (nur Felder, keine Tabellenzeilen), hibob_create_work_entry (Beförderung, Versetzung, neue Führungskraft), hibob_create_custom_table_entry, hibob_add_named_list_item und hibob_upload_shared_document (öffentliche oder vorsignierte URL, höchstens 5 MB, für die Person sichtbar). Ein Workspace-Admin schaltet sie im Connector bewusst ein.

Datenformate: Mitarbeiter-IDs sind lange Zahlen, die als Strings kommen (3332883884017713238). Anfragen nutzen Punktnotation (work.department), Antworten Schrägstrich-Schlüssel (/work/department) und können denselben Wert zusätzlich nach Kategorie verschachtelt enthalten. Listenfelder enthalten Item-IDs; human_readable: APPEND oder REPLACE ergänzt die Namen oder setzt sie ein. Datumswerte sind YYYY-MM-DD; hibob_list_time_off_changes nimmt ISO-8601-Zeitpunkte. Salden sind in der Einheit des Policy Types (Tage oder Stunden), Gehälter haben ihre eigene Währung. Nach einer Änderung kann Bob bis zu 20 Sekunden lang noch den alten Wert liefern.

Stilles Weglassen: Ein Feld ohne Berechtigung oder mit falscher ID fehlt einfach in der Antwort, ohne Fehler. Fehlt etwas, prüf zuerst die Berechtigungsgruppe des Service Users, bevor du annimmst, dass der Wert leer ist.

Blättern: Personensuche, Profile, die Historie einer Person, offene Aufgaben (höchstens 5.000) und Who's out liefern alles auf einmal. Die Bulk-Historien und hibob_search_calendar_events blättern mit cursor gleich response_metadata.next_cursor; die KI hört auf, wenn er null ist.

Limits: Rate Limits gelten pro Endpunkt (die Personensuche erlaubt 50 Anfragen pro Minute) und antworten mit 429. Who's out und Kalenderzeiträume haben eine maximale Spanne, und Abwesenheitsänderungen reichen höchstens 6 Monate zurück.

Häufige Fehler: 401 bedeutet eine falsche ID oder ein falsches Token, 403 eine fehlende Berechtigung in der Gruppe des Service Users, 400 einen ungültigen Filter, ein ungültiges Feld oder einen ungültigen Zeitraum. Wiederholte 401- oder 403-Antworten kann die Firewall von Bob eine Weile blockieren; korrigiere also die Rechte, bevor du es erneut versuchst.

Der Connector macht keine Gehaltsabrechnung, ändert über hibob_update_employee keine Zeilen von Historientabellen und hat kein Tool, um offene Abwesenheitsanträge zu genehmigen oder abzulehnen.

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 ChatGPT 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.

ChatGPT fügt MCP-Server als Plugins auf seiner Seite Plugins hinzu, im Web und in den kostenpflichtigen Tarifen. Den Entwicklermodus brauchst du dafür nicht mehr. In einem Business-Workspace dürfen das nur Admins und Owner; in Enterprise und Edu kann ein Admin die Berechtigung Create plugins with MCPs vergeben.

1. Geh zu chatgpt.com/plugins, klicke auf Add und dann auf Add custom MCP server.
2. Gib einen Namen ein, z. B. Name: HiBob.
3. Trag unter Connection als Server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID ein und lass Authentication auf OAuth.
4. Wähle I understand and want to continue und dann Create as a plugin. Wenn ChatGPT danach fragt, meldest du dich bei AnythingMCP an und erlaubst den Zugriff.
5. Installiere das neue Plugin unter deinen persönlichen Plugins, tippe dann in einem Chat @ und wähle es aus.

Verfügbare Tools

Beispiel-Prompts

• „Wer ist nächste Woche abwesend, und mit welcher Abwesenheitsrichtlinie?“
• „Zeig die Arbeitshistorie von [email protected]: Titel, Abteilungen und Führungskräfte mit ihren Gültigkeitsdaten.“
• „Wie viele Urlaubstage hat Mitarbeiter 3332883884017713238 dieses Jahr noch übrig, und wie viele sind beantragt?“
• „Führ den gespeicherten Report „Headcount by department“ aus und fass ihn nach Standort zusammen.“
• „Liste alle offenen Onboarding-Aufgaben, die überfällig sind, mit Verantwortlichem und der neuen Person, zu der sie gehören.“

FAQ

Funktioniert der kostenlose ChatGPT-Tarif mit eigenen MCP-Servern? OpenAI dokumentiert eigene MCP-Server nur für kostenpflichtige Tarife; den Free-Tarif führt OpenAI nicht auf.

Nächste Schritte

• Connector-Startseite
• Mit Claude verbinden
• Mit Cursor verbinden
• Mit Gemini verbinden
• Mit Meta Muse verbinden
• Mit Microsoft Copilot verbinden