Integration · Lohnabrechnung und Personalwesen

Claude & ChatGPT mit Oyster verbinden

Frage deine KI, welche Abwesenheitsanträge noch offen sind, welche Ausgaben geprüft werden müssen oder welche Gehaltsänderungen diesen Monat in Oyster erfasst wurden. Sie kann Beschäftigungsverhältnisse, Abwesenheiten, Stundenzettel, Ausgaben, Gehaltsänderungen, Gehaltsabrechnungsläufe, Gehaltsabrechnungen, Dokumente und Rechnungen auflisten und abrufen sowie Anträge genehmigen oder ablehnen. Routinemäßige Personalverwaltung lässt sich direkt im Chat erledigen.

Oyster kostenlos verbinden

Kostenloser Tarif, keine Kreditkarte erforderlich. Dauert etwa eine Minute.

Fragen Sie zum Beispiel

“Welche Abwesenheitsanträge warten auf meine Genehmigung?”
Die KI listet Abwesenheitsanträge mit Teammitglied, Art, Zeitraum und Status auf.
“Genehmige Marias Urlaubsantrag für den 10. bis 14. März.”
Sie findet den Antrag und genehmigt ihn. Maria wird benachrichtigt.
“Welche Ausgaben müssen noch geprüft werden?”
Sie listet Ausgaben nach Prüfstatus gefiltert mit Betrag und Kategorie auf.

Was Ihre KI tun kann

Team und Abwesenheiten

Beschäftigungsverhältnisse, Abteilungen, Dokumente und Gehaltsabrechnungen auflisten, Abwesenheitsansprüche und gesetzliche Feiertage abrufen sowie Abwesenheitsanträge erstellen, genehmigen oder ablehnen.

Ausgaben und Stundenzettel

Ausgaben und Stundenzettel auflisten und abrufen, Ausgaben einreichen, genehmigen oder ablehnen sowie Stundenzettel genehmigen.

Gehaltsabrechnung und Rechnungen

Gehaltsabrechnungsläufe und Gehaltsänderungen auflisten, Änderungen wie Boni erfassen und Oyster-Rechnungen mit Beträgen, Status und Fälligkeitsdatum abrufen.

“Füge für Tom einen Bonus von 500 EUR zur Gehaltsabrechnung im Juni hinzu.”
Sie findet Toms Beschäftigungsverhältnis und erfasst eine Gehaltsänderung für Juni mit Betrag und Währung.
“Wie viele Urlaubstage hat das Team noch übrig?”
Sie listet die Abwesenheitsansprüche deiner Teammitglieder mit Kontingenten und Restguthaben auf.
“Welche gesetzlichen Feiertage gibt es im Dezember in Deutschland?”
Sie listet die gesetzlichen Feiertage für dieses Land im angegebenen Zeitraum auf.

27 Tools für Oyster

Diese Tools werden beim Verbinden aktiviert. Sie können jedes einzelne deaktivieren oder festlegen, dass es vor der Ausführung Ihre Freigabe benötigt.

approve_expenseFür andere sichtbarEine Ausgabe anhand von `expense_id` genehmigen, damit sie dem Teammitglied über Oyster erstattet wird.
approve_time_off_requestFür andere sichtbarEinen ausstehenden Abwesenheitsantrag anhand von `request_id` genehmigen. Das Teammitglied wird benachrichtigt.
approve_time_sheetFür andere sichtbarEinen eingereichten Stundenzettel anhand von `time_sheet_id` bestätigen (genehmigen).
create_expenseÄndert DatenEine Ausgabe für ein Beschäftigungsverhältnis einreichen. Erfordert `engagement_id`, `name`, `category`, `incurred_on` (Datum), `receipt_url` und `receipt_amount` (decimal und currencyCode).
create_payroll_changeÄndert DatenEine Gehaltsänderung, etwa einen Bonus, für ein Beschäftigungsverhältnis im angegebenen Abrechnungsjahr `year` und -monat `month` erfassen. Erfordert `engagement_id`, `type` und `amount` (decimal und currencyCode). Dies verändert die Vergütung des Teammitglieds.
create_time_off_requestÄndert DatenEinen Abwesenheitsantrag für ein Beschäftigungsverhältnis erstellen. Erfordert `engagement_id`, `type` (VACATION, SICK_LEAVE, UNPAID_LEAVE, OTHER), `reason`, `start_date`, `end_date` und `request_by_admin` (true, wenn du den Antrag als Administrator stellst).
decline_expenseFür andere sichtbarEine Ausgabe anhand von `expense_id` ablehnen, optional mit einer Begründung in `reason`. Das Teammitglied wird benachrichtigt.
get_companyDie Daten deines Unternehmens in Oyster abrufen. Damit lässt sich prüfen, in welchem Unternehmen du arbeitest.
get_engagementEin einzelnes Beschäftigungsverhältnis (Teammitglied) anhand seiner als `project_id` übergebenen ID mit Rolle, Land, Datumsangaben und Vergütungsdetails abrufen.
get_expenseEine einzelne Ausgabe anhand von `expense_id` mit Betrag, Kategorie, Beleg und Prüfstatus abrufen.
get_invoiceEine einzelne Oyster-Rechnung anhand von `invoice_identifier` mit Beträgen, Status und Fälligkeitsdatum abrufen.
get_payroll_changeEine einzelne Gehaltsänderung anhand von `payroll_change_id` abrufen.
get_time_off_requestEinen einzelnen Abwesenheitsantrag anhand von `request_id` abrufen.
get_time_sheetEinen einzelnen Stundenzettel anhand von `time_sheet_id` mit seinen Einträgen und seinem Status abrufen.
list_departmentsDie Abteilungen deines Unternehmens auflisten.
list_engagement_documentsDie Dokumente eines Beschäftigungsverhältnisses, etwa Verträge, anhand von `engagement_id` auflisten.
list_engagement_payslipsDie Gehaltsabrechnungen eines Beschäftigungsverhältnisses anhand von `engagement_id` auflisten.
list_engagementsBeschäftigungsverhältnisse auflisten (deine über Oyster beschäftigten Teammitglieder, Angestellten und selbstständigen Auftragnehmer). Seitenweise mit `page` und `limit` abrufen. Dient zum Ermitteln der ID eines Beschäftigungsverhältnisses.
list_expensesAusgaben auflisten, optional mit `query` durchsuchen oder nach `review_states` filtern. Seitenweise mit `page` und `limit` abrufen.
list_invoicesOyster-Rechnungen auflisten, gefiltert nach `statuses`, `types`, `engagement_ids` oder einem Zeitraum für das Ausstellungsdatum (`issue_date_from`, `issue_date_to`).
list_payroll_changesGehaltsänderungen (Boni, Zulagen und andere einmalige Vergütungsbestandteile) auflisten, gefiltert nach `engagement_id` oder einem Zeitraum mit `from`/`to`.
list_payrollsGehaltsabrechnungsläufe auflisten, optional innerhalb eines Zeitraums mit `from`/`to`.
list_public_holidaysGesetzliche Feiertage zwischen `start_date` und `end_date` für einen `country_code` (und optional einen `subdivision_code`) oder für eine `engagement_id` auflisten.
list_time_off_entitlementsAbwesenheitsansprüche (Kontingente und Restguthaben) deiner Teammitglieder auflisten.
list_time_off_requestsAbwesenheitsanträge auflisten, optional nur für bestimmte `engagement_ids`. Seitenweise mit `page` und `limit` abrufen.
list_time_sheetsVon Teammitgliedern eingereichte Stundenzettel auflisten. Seitenweise mit `page` und `limit` abrufen.
reject_time_off_requestFür andere sichtbarEinen ausstehenden Abwesenheitsantrag anhand von `request_id` mit einer Begründung in `reason` ablehnen. Das Teammitglied wird benachrichtigt.

In drei Schritten einrichten

1
App auswählen
Erstellen Sie ein kostenloses PipMCP-Konto und wählen Sie Oyster aus der App-Liste.
2
Schlüssel einfügen
Erstelle deine eigene Oyster-Entwickler-App, füge ihren App-Code, die Client ID und das Client secret ein und melde dich anschließend einmal bei Oyster an. Du benötigst Zugriff als Unternehmensadministrator. Öffne in Oyster den Entwickler-Tab und erstelle eine neue Entwickler-App mit der Weiterleitungs-URL https://pipmcp.com/oauth/callback und den benötigten Berechtigungsbereichen (read, manage). Kopiere die Client ID und das Client secret aus dem Pop-up, da das Geheimnis später nicht erneut angezeigt wird. Kopiere auf der Seite für Entwickleranwendungen die Autorisierungs-URL und füge den Code an ihrem Ende, nach /oauth/authorize/, als deinen App-Code ein.
3
Link zu Ihrer KI hinzufügen
Sie erhalten einen persönlichen MCP-Link. Fügen Sie ihn in Claude, ChatGPT oder Cursor hinzu:
1. Klicken Sie auf Ihren Namen und dann auf Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen.
2. Fügen Sie Ihren Link als URL des Remote-MCP-Servers ein.
3. Aktivieren Sie den Konnektor über das +-Menü in einem Chat.

Fragen

Was kann die KI in Oyster tun?

Sie kann Beschäftigungsverhältnisse, Abteilungen, Dokumente, Gehaltsabrechnungen, Abwesenheitsanträge und -ansprüche, gesetzliche Feiertage, Stundenzettel, Ausgaben, Gehaltsänderungen, Gehaltsabrechnungsläufe und Oyster-Rechnungen auflisten und abrufen. Sie kann Abwesenheitsanträge, Ausgaben und Gehaltsänderungen erstellen, Abwesenheitsanträge genehmigen oder ablehnen, Ausgaben genehmigen oder ablehnen sowie Stundenzettel genehmigen.

Sieht die KI meine Oyster-Zugangsdaten?

Nein. Deine Client ID, dein Client secret und deine Anmeldetokens werden verschlüsselt gespeichert und der KI niemals angezeigt. Nach dem Speichern werden sie nicht erneut angezeigt, auch dir nicht. Die KI sieht nur die Ergebnisse der Tools, die sie aufruft.

Kann ich festlegen, was die KI tun darf?

Ja. Du entscheidest, welche Tools aktiviert sind, und kannst zunächst nur Informationen abrufen lassen. Genehmigte Ausgaben werden erstattet, Gehaltsänderungen verändern die Vergütung eines Teammitglieds, und Genehmigungen sowie Ablehnungen lösen Benachrichtigungen an das Teammitglied aus. Deshalb kannst du für diese Tools festlegen, dass sie vor der Ausführung deine Freigabe benötigen. Jeder Tool-Aufruf wird protokolliert.

Funktioniert das mit ChatGPT?

Ja. Öffne in ChatGPT Einstellungen › Apps & Konnektoren › Erweitert, aktiviere den Entwicklermodus und füge deinen PipMCP-Link hinzu. Der Entwicklermodus erfordert einen kostenpflichtigen ChatGPT-Tarif: Plus, Pro, Business oder Enterprise. Derselbe Link funktioniert auch in Claude (Einstellungen › Konnektoren › Benutzerdefinierten Konnektor hinzufügen), Cursor und anderen MCP-Clients.

Was kostet das?

Oyster wird über OAuth verbunden. OAuth-Verbindungen erfordern den PipMCP-Tarif Pro oder höher. PipMCP bietet auch einen kostenlosen Tarif ohne Kreditkarte an, diese Verbindung ist darin jedoch nicht enthalten. Kostenpflichtige Tarife werden pro abgeschlossener Aufgabe abgerechnet. Außerdem benötigst du ein eigenes Oyster-Konto.

Was ist ein Beschäftigungsverhältnis?

Ein Beschäftigungsverhältnis, in Oyster als „Engagement“ bezeichnet, steht für ein über Oyster beschäftigtes Teammitglied, entweder als Angestellter oder als selbstständiger Auftragnehmer. Die meisten Tools benötigen dessen ID. Du musst sie nicht selbst heraussuchen: Die KI listet zunächst deine Beschäftigungsverhältnisse auf und wählt das passende aus. Bei Unklarheiten fragt sie nach.