Deputy über MCP mit Gemini verbinden

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

Deputy + Gemini

Deputy-Personaleinsatzplanung für eine Installation: Mitarbeitende, Standorte und Bereiche, Dienstpläne (Schichten) mit Kopieren und Veröffentlichen, Timesheets mit Ein- und Ausstempeln und Freigabe, Abwesenheiten und Nichtverfügbarkeit, Memos, Manager-Notizen und jeder andere Datensatz über die Resource-Query-API. Verbindet sich mit einem permanenten Token.

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:

DEPUTY_HOST, DEPUTY_ACCESS_TOKEN

Schritt 1 — Zugangsdaten holen

Die Einrichtung dauert etwa 5 Minuten und braucht einen Deputy-Systemadministrator.

1. Notiere dir die Adresse deiner Installation aus der Adresszeile des Browsers, wenn du eingeloggt bist, zum Beispiel mycompany.au.deputy.com (Regionen au, eu, uk und na für die USA). Trag sie ohne https:// und ohne Pfad in DEPUTY_HOST ein.
2. Öffne https://<deine Installationsadresse>/exec/devapp/oauth_clients, füge einen OAuth-Client hinzu (beliebiger Name und beliebige Beschreibung; die Client-ID selbst wird nicht genutzt) und klicke auf Get an Access Token.
3. Kopiere das permanente Token sofort (es wird nur einmal angezeigt) in DEPUTY_ACCESS_TOKEN. Installiere den Connector: deputy_get_me ist die Installationsprüfung.

Das Token funktioniert nur auf der Installation, die es ausgestellt hat, und handelt als der User, der es erstellt hat, mit dessen Berechtigungen. Ein Systemadministrator sieht jeden Standort.

Personenbezogene Daten: Mitarbeiterdatensätze enthalten Namen, Geburtsdaten, Kontaktdaten, Adressen und Lohndaten. Frag nur nach dem, was die Aufgabe braucht.

Deputys Begriffe: Ein Standort (Arbeitsplatz) heißt Company, ein Bereich (Abteilung) OperationalUnit, eine Schicht Roster, die tatsächlich gearbeitete Zeit Timesheet und eine Abwesenheitsart ist ein LeaveRules-Datensatz.

Was er liest:

• Der Token-User: deputy_get_me und seine eigenen Schichten, Timesheets, Abwesenheiten, Nichtverfügbarkeiten, Standorte und Kollegen (deputy_get_my_rosters, deputy_get_my_timesheets, deputy_get_my_leave, deputy_get_my_unavailability, deputy_get_my_locations, deputy_get_my_colleagues).
• Struktur und Personen: deputy_list_locations, deputy_list_areas (jeder Bereich gehört zu einem Standort; Schichten und Timesheets nutzen Bereichs-IDs), deputy_list_employees, deputy_get_employee, deputy_query_employees für Filter und deputy_get_employee_shift_status dafür, wer gerade arbeitet.
• Dienstplan: deputy_list_rosters deckt 12 Stunden zurück bis 36 Stunden voraus ab; deputy_query_rosters jeden Zeitraum, Mitarbeitenden oder Bereich (Filter auf Date, Employee, OperationalUnit).
• Zeit: deputy_query_timesheets und deputy_get_timesheet (Slots, Pausen, Lohnzeilen, Kommentare und Freigabestatus).
• Abwesenheit und Verfügbarkeit: deputy_query_leave, deputy_get_employee_leave, deputy_get_employee_unavailability und deputy_query_availability. Abwesenheitsarten liefert deputy_query_resource mit object LeaveRules.
• Alles andere (Teams, Feiertage, Events, Schulungen, benutzerdefinierte Felder, Umsatzdaten, Abrechnungszeiträume und mehr): deputy_get_resource_info listet die Felder eines Objekts, deputy_query_resource durchsucht es und deputy_get_resource liest einen Datensatz.

Was er schreibt:

• Dienstplan: deputy_save_shift legt eine Schicht an oder aktualisiert sie mit roster_id; deputy_copy_rosters kopiert einen Zeitraum einiger Bereiche nach vorn (zum Beispiel letzte Woche in diese Woche); deputy_publish_rosters veröffentlicht Schichten mit der gewählten Benachrichtigung (notify 1 SMS und E-Mail, 2 SMS, 3 E-Mail, 4 keine, 5 Bestätigung durch die Mitarbeitenden anfordern).
• Zeit: deputy_start_timesheet, deputy_pause_timesheet (ein zweiter Aufruf beendet die Pause) und deputy_end_timesheet stempeln Mitarbeitende ein und aus; deputy_save_timesheet legt ein abgeschlossenes Timesheet an oder korrigiert es; deputy_approve_timesheet gibt Zeit frei, damit sie in die Lohnabrechnung exportiert werden kann.
• Abwesenheit und Verfügbarkeit: deputy_add_leave (Status 0 wartet auf Freigabe durch den Manager, 1 erfasst bereits genehmigte Abwesenheit, die sich auf Timesheets und Salden auswirkt), deputy_update_leave (genehmigen, ablehnen oder stornieren mit status 1, 2 oder 3) und deputy_add_unavailability (einmalig oder wiederkehrend, zum Beispiel jeden zweiten Montag).
• Mitarbeitende: deputy_add_employee, deputy_update_employee, deputy_invite_employee (schickt eine Login-Einladung per E-Mail), deputy_terminate_employee (kein Login und keine Einplanung mehr; umkehrbar) und deputy_reactivate_employee.
• Notizen und News: deputy_post_journal fügt dem Profil eines Mitarbeitenden eine private Manager-Notiz hinzu; deputy_post_memo postet in den News-Feed eines Standorts, optional an ausgewählte User und mit Lesebestätigung.

Veröffentlichte Schichten, Einladungen und Memos erreichen echte Mitarbeitende. Prüfe also Schichten und Benachrichtigung, bevor du sie anforderst.

Bei der Installation deaktiviert: deputy_delete_employee, deputy_discard_rosters und deputy_discard_timesheet. Sie lassen sich nicht rückgängig machen; ein Workspace-Admin schaltet sie ein, wenn das Team sie braucht. Statt jemanden zu löschen, ist das Deaktivieren mit deputy_terminate_employee umkehrbar.

Query-Tools: deputy_query_* und deputy_query_resource senden POST, lesen aber nur. Der search-Body enthält Bedingungen, die alle zutreffen müssen, zum Beispiel {"s1":{"field":"Date","type":"ge","data":"2026-11-01"},"s2":{"field":"Date","type":"le","data":"2026-11-07"}}, mit den Operatoren eq, ne, gt, ge, lt, le, in, not in, starts, contains, is und is not. sort ({"Date":"asc"}) und join (["EmployeeObject"]) sind optional.

Datenformate: IDs sind Ganzzahlen. StartTime, EndTime und die Eingaben start und end sind Unix-Zeitstempel in Sekunden; Date-Felder sind lokale Daten des Standorts (2026-11-03T00:00:00+11:00), Zeiten werden also mit der Zeitzone des Standorts umgerechnet. Ein Roster mit Employee 0 ist eine offene Schicht, Published false ein Entwurf. Den Timesheet-Status zeigen TimeApproved, PayRuleApproved, Discarded und IsInProgress; TotalTime ist in Stunden. Abwesenheits-Status: 0 wartet auf Freigabe, 1 genehmigt, 2 abgelehnt, 3 storniert, 4 Lohn freigegeben. Das Anlegen oder Ändern einer Schicht antwortet mit 200 und leerem Body; die KI prüft das Ergebnis mit deputy_query_rosters.

Blättern: Eine Antwort enthält höchstens 500 Datensätze. Query-Tools nehmen max (bis 500) und start (Offset); ist eine Seite voll, ruft die KI erneut auf, mit start um max erhöht. Die Listen-Tools ohne Paging liefern alles, was Deputy erlaubt, in einer Antwort.

Häufige Fehler: 401 bedeutet ein falsches Token oder ein Token einer anderen Installation, 403 eine Berechtigung, die dem Token-User fehlt, 404 eine falsche Installationsadresse oder Datensatz-ID, 400 einen falschen Feldnamen in einem Filter (prüfe ihn mit deputy_get_resource_info).

Der Connector exportiert Timesheets nicht selbst in ein Lohnsystem, legt keine Standorte oder Bereiche an und löscht nichts, solange die Lösch-Tools deaktiviert sind.

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

Gemini CLI liest MCP-Server aus ~/.gemini/settings.json (unter Windows %USERPROFILE%\.gemini\settings.json). Füge hinzu:

{
  "mcpServers": {
    "anythingmcp": {
      "httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
      "headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
    }
  }
}

1. Erstelle in AnythingMCP unter MCP Servers → dein Server → API keys einen MCP-API-Key und setze ihn anstelle von YOUR_MCP_API_KEY ein.
2. Speichere die Datei und starte gemini neu.
3. Führe in der Gemini CLI /mcp aus (oder gemini mcp list im Terminal): anythingmcp sollte als verbunden erscheinen.
4. Leg los: Gemini CLI kann jetzt die Deputy-Tools aufrufen.

Verfügbare Tools

Beispiel-Prompts

• „Wer arbeitet gerade in der Filiale Sydney, und wer fängt als Nächstes an?“
• „Zeig mir den Dienstplan der nächsten Woche für den Bereich Küche, inklusive offener Schichten.“
• „Liste die Timesheets der letzten Woche auf, die noch nicht freigegeben sind, mit Mitarbeitendem und Gesamtstunden.“
• „Kopiere die Schichten der letzten Woche im Bereich Bar in diese Woche und zeig mir die Entwürfe vor dem Veröffentlichen.“
• „Welche Abwesenheitsanträge warten diesen Monat auf Freigabe?“

FAQ

Wo sucht Gemini CLI nach MCP-Servern? In ~/.gemini/settings.json für deinen Benutzer oder in .gemini/settings.json innerhalb eines Projekts. gemini mcp list zeigt jeden Server und ob er sich verbindet.

Nächste Schritte

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