Access PeopleHR mit Gemini verbinden — über MCP

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

Access PeopleHR + Gemini

Access PeopleHR, britische HR-Software: Mitarbeitende, Urlaub, Abwesenheiten, Urlaubsansprüche, Gehälter, gespeicherte Query-Builder-Berichte, Mitarbeitergespräche, Schulungen, Zeiterfassungsbögen, Arbeitszeitmodelle und offene Stellen. Integration API v4, der API-Key wird im JSON-Body jedes POST mitgesendet.

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:

PEOPLEHR_API_KEY

Schritt 1 — Zugangsdaten holen

Der Connector ruft die Access PeopleHR Integration API v4 mit einem API-Key auf. Er liest Mitarbeitende, Urlaub und Abwesenheiten, Gehälter, gespeicherte Berichte, Mitarbeitergespräche, Schulungen, Zeiterfassungsbögen und offene Stellen und kann Urlaub und Abwesenheiten buchen, wenn der Key das erlaubt.

1. Ein PeopleHR-Administrator öffnet Settings > API und erstellt einen Key (eine GUID wie 1a2b3c4d-...).
2. Beim Erstellen werden die Ressourcen und Aktionen angehakt, die der Key aufrufen darf: für die Lese-Tools mindestens Employee, Holiday, Absence, Holiday Entitlements, Salary, Query Builder, Appraisal, Training und ATS. Die Aktionen Add Holiday und Add Absence nur dann, wenn peoplehr_add_holiday und peoplehr_add_absence funktionieren sollen.
3. Trage den Key in PEOPLEHR_API_KEY ein. Hat der Key eine IP-Allowlist, werden Aufrufe von AnythingMCP abgewiesen, solange dessen Adresse nicht darauf steht.
4. Rufe zuerst peoplehr_get_company_information auf, um den Key zu prüfen, dann peoplehr_get_employee_directory, um die EmployeeId (etwa PW15) zu finden, die die Tools pro Mitarbeiter erwarten.

Gut zu wissen:

• Fehler kommen mit HTTP 200 zurück. Lies Status in der Antwort: 0 Erfolg, 10 keine Datensätze, 5 Validierungsfehler oder Access Denied., 6 Serverfehler. Access Denied. heißt, dass der Key diese Aktion oder dieses Schema nicht freigegeben hat.
• peoplehr_list_leavers braucht eine eigene Freigabe GetAllLeavers, und die Tools für Stellen und Bewerber brauchen das Recruiting-Modul (ATS). Ohne sie antworten sie mit Status 5.
• peoplehr_run_query führt eine gespeicherte Query-Builder-Abfrage über ihren exakten Namen aus. Die API kann Abfragen nicht auflisten, also nimm den Namen aus Reports > Query Builder.
• Datumsangaben sind yyyy-MM-dd. Das Rate Limit legt Access pro Unternehmen fest; ein gedrosselter Aufruf antwortet mit Status 5 und einer Meldung zum Minutenlimit. Warte eine Minute und versuche es erneut.

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 Access PeopleHR-Tools aufrufen.

Verfügbare Tools

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
• Verbinde mit Claude
• Verbinde mit ChatGPT
• Verbinde mit Cursor
• Verbinde mit Meta Muse