Rippling zu MCP: Mitarbeitende, Organisationsstruktur, Vergütung, Abwesenheiten und Zeiterfassung in jedem KI-Agent

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

Rippling

Die HR-Plattform Rippling über ihre REST API: Worker und User, Abteilungen, Teams, Arbeitsorte, Levels, Jobtitel, Beschäftigungsarten und benutzerdefinierte Felder, Vergütung, Abwesenheitsarten, -salden und -anträge, Supergroups und Zeiteinträge. Dazu beantragt und genehmigt er Abwesenheiten, erfasst Zeiten, pflegt die Organisationsstruktur und legt Draft Hires an.

Einrichtung

Die Einrichtung dauert etwa 5 Minuten. Du brauchst einen Rippling-User mit der Berechtigung Create and manage API Tokens und Zugriff auf die Daten, die die KI lesen soll.

1. Öffne in Rippling Developer > API credentials (https://app.rippling.com/api-tokens/tokens) und klicke auf New API token.
2. Gib dem Token einen Namen und wähle seine Scopes. Das Token erreicht nur Daten, die sowohl seine Scopes als auch das Berechtigungsprofil seines Owners erlauben. Wähle, was du nutzt:
   • companies.read (Pflicht, die Installationsprüfung), dazu workers.read, users.read, departments.read, teams.read, work-locations.read, levels.read, titles.read, employment-types.read, job-codes.read, custom-fields.read, supergroups.read.
   • compensations.read nur, wenn die KI Gehälter sehen soll.
   • leave-types.read, leave-balances.read, leave-requests.read und leave-requests.read-write, um Abwesenheiten zu beantragen oder zu genehmigen.
   • time-entries.read und time-entries.read-write, um Zeiten zu erfassen (braucht Rippling Time).
   • departments.read-write, teams.read-write, work-locations.read-write und draft-hires.read-write für die passenden Schreibzugriffe.
3. Kopiere das Token sofort (es wird nur einmal angezeigt) ohne Bearer in RIPPLING_API_TOKEN. Installiere den Connector: rippling_list_companies ist die Installationsprüfung.

Anfragen laufen als Owner des Tokens. Rippling widerruft ein Token, das 30 Tage ungenutzt bleibt, sowie die Tokens eines Owners, der ausscheidet. Wähle also einen Owner mit stabilem Zugriff.

Personenbezogene Daten: Worker, User und Vergütungspakete enthalten persönliche und Gehaltsdaten: Namen, private E-Mail-Adressen, Telefonnummern, Wohnadressen, Geburtsdatum, Geschlecht und Gehalt. Frag nur nach den Feldern, die die Aufgabe braucht, kopiere sie nicht ohne Grund in andere Systeme und gib dem Token nur die Scopes, die das Team nutzt.

Was er liest: das Unternehmen (rippling_list_companies); Worker, also die Beschäftigungsdatensätze von Angestellten und Freelancern, mit Status, geschäftlicher und privater E-Mail, Eintritts- und Austrittsdatum, Titel, Abteilung, Vorgesetztem, Level, Teams, Standort, Beschäftigungsart und Land (rippling_list_workers, rippling_get_worker); User, die Login-Identität hinter der user_id eines Workers (rippling_list_users, rippling_get_user); Vergütungspakete mit Jahres-, Monats-, Wochen- und Stundenbeträgen, Bonuszielen und Provision (rippling_list_compensations sowie rippling_get_compensation mit der compensation_id des Workers); Definitionen benutzerdefinierter Felder (rippling_list_custom_fields), deren Werte mit expand=custom_fields bei Workern kommen; die Organisationsstruktur mit Abteilungen, Teams, Arbeitsorten, Levels, Titeln, Beschäftigungsarten und Job Codes; Supergroups und ihre Mitglieder; Abwesenheitsarten, Abwesenheitssalden in Stunden und Tagen sowie Abwesenheitsanträge; Zeiteinträge mit Job Shifts, Pausen, Dauer, Status und Abrechnungszeitraum. expand (zum Beispiel user,manager,department) bettet verknüpfte Objekte in einen einzigen Aufruf ein.

Was er schreibt:

• Abwesenheiten: rippling_create_leave_request beantragt eine Abwesenheit für einen Worker (PENDING durchläuft die normale Genehmigung, APPROVED erfasst bereits vereinbarte Abwesenheit); rippling_update_leave_request genehmigt, lehnt ab oder storniert über status oder ändert Daten und Kommentare.
• Zeit: rippling_create_time_entry erfasst Arbeitszeit als Job Shifts mit Start- und Endzeit oder als Dauer an einem Tag; ein idempotency_key verhindert, dass eine Wiederholung ein Duplikat anlegt. rippling_update_time_entry ändert einen Eintrag; die API verlangt worker_id auch dann, wenn sie sich nicht ändert.
• Organisationsstruktur: rippling_create_department, rippling_update_department, rippling_create_team, rippling_update_team, rippling_create_work_location und rippling_update_work_location. Updates ändern nur die gesendeten Felder.
• Neueinstellungen: rippling_create_draft_hires legt bis zu fünf Draft Hires an, die Ripplings Prüfung und Genehmigung durchlaufen, bevor jemand eingestellt wird.

Bei der Installation deaktiviert: rippling_delete_team (Worker verlieren die Teamzuordnung) und rippling_delete_time_entry. Beides lässt sich nicht rückgängig machen; ein Workspace-Admin schaltet sie ein, wenn das Team sie braucht.

Filter: filter nimmt einen Ausdruck im OData-Stil auf die Felder, die das jeweilige Tool nennt, zum Beispiel status eq 'ACTIVE', updated_at ge 2026-01-01T00:00:00 oder status in ('HIRED','ACCEPTED'), verknüpft mit and und or. Strings stehen in einfachen Anführungszeichen, ein Filter hat höchstens 64 Knoten. Salden eines Workers: worker_id eq '...'; offene Anträge: status eq 'PENDING'.

Datenformate: IDs sind 24-stellige Hex-Strings. Daten sind YYYY-MM-DD, Zeitstempel ISO 8601 mit Offset. Geldbeträge sind { "currency_type": "USD", "value": 120000 } in Haupteinheiten. Der Worker-status ist INIT, HIRED, ACCEPTED, ACTIVE oder TERMINATED. Ein Feld, das das Token nicht sehen darf, kommt als null zurück und steht mit Grund in __meta.redacted_fields. null beweist also nicht, dass das Feld leer ist: Prüfe zuerst Scopes und Berechtigungen des Owners.

Blättern: Listen antworten mit results und next_link, standardmäßig 50 Einträge, mit limit bis zu 100. Solange next_link nicht null ist, ruft die KI erneut auf, mit cursor gleich dem Cursor-Wert aus next_link.

Limits und häufige Fehler: 600 Anfragen pro 10 Sekunden je Endpunkt und Token, danach 429 (ein paar Sekunden warten und erneut versuchen). 400 bedeutet einen fehlerhaften Filter, ein nicht erweiterbares Feld oder limit über 100; 401 ein falsches oder widerrufenes Token; 403 einen fehlenden Scope oder eine Berechtigung, die dem Owner fehlt; 404 eine unbekannte ID.

Der Connector bearbeitet keine Worker-Datensätze und keine Vergütung, stellt niemanden direkt ein oder entlässt jemanden und führt keine Gehaltsabrechnung durch.

Voraussetzungen: RIPPLING_API_TOKEN

Connector lokal 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

Öffne http://localhost:3000/connectors/store, wähle Rippling und trage die unter Voraussetzungen aufgelisteten Variablen ein.

Verfügbare Tools

Beispiel-Prompts

• „Wer ist in den letzten 30 Tagen eingetreten? Liste Name, Titel, Abteilung, Vorgesetzten und Eintrittsdatum auf.“
• „Zeig mir alle offenen Abwesenheitsanträge mit Worker, Zeitraum, Stunden und Abwesenheitsart.“
• „Wie viel Urlaub hat Maria Lopez noch, in Tagen und in Stunden?“
• „Genehmige den offenen Urlaubsantrag von Maria Lopez für den 10. bis 14. November.“
• „Wie viele aktive Worker haben wir pro Abteilung und Arbeitsort?“

Nächste Schritte

• Mit Claude verbinden
• Mit ChatGPT verbinden