Installation überspringen. In unter 2 Minuten einsatzbereit.
Starte eine kostenlose Testphase auf cloud.anythingmcp.com, füge SmartHR mit einem Klick hinzu und richte deinen KI-Client (Claude, ChatGPT, Copilot oder Cursor) auf den erzeugten MCP-Endpoint. Kein Docker, kein git clone, keinerlei Entwicklungserfahrung nötig.
Zusammenfassung
Arbeite aus jedem KI-Agent mit SmartHR, der japanischen Cloud für Personal- und Arbeitsverwaltung: Mitarbeitende mit Abteilungen, Positionen, Beschäftigungsarten, Stufen, Arbeitsorten und eigenen Feldern, Angehörige und Elternzeiten, Benutzerkonten und Einladungen, Gehaltsläufe und Gehaltsabrechnungen. Legt Mitarbeitende und Abteilungen an und ändert sie, mit einem Zugriffstoken, das ein Administrator ausstellt; das Löschen von Mitarbeitenden ist bei der Installation aus.
Frag einfach
Beispiel-Prompts für SmartHR
Klick auf einen Prompt, um ihn zu kopieren. In Claude, ChatGPT, Cursor, Gemini, Copilot oder OpenClaw einfügen — und gegen diesen Connector laufen lassen.
Claude ist KI und kann Fehler machen. Bitte Antworten gegenprüfen.
💡 Keine Installation? Nutze cloud.anythingmcp.com direkt. Einloggen, Connectors → SmartHR klicken, Zugangsdaten einfügen, MCP-API-Key erzeugen, fertig. Kein Docker, kein
git clone, kein lokaler Server.
SmartHR + Microsoft Copilot
Arbeite aus jedem KI-Agent mit SmartHR, der japanischen Cloud für Personal- und Arbeitsverwaltung: Mitarbeitende mit Abteilungen, Positionen, Beschäftigungsarten, Stufen, Arbeitsorten und eigenen Feldern, Angehörige und Elternzeiten, Benutzerkonten und Einladungen, Gehaltsläufe und Gehaltsabrechnungen. Legt Mitarbeitende und Abteilungen an und ändert sie, mit einem Zugriffstoken, das ein Administrator ausstellt; das Löschen von Mitarbeitenden ist 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:
SMARTHR_HOST, SMARTHR_ACCESS_TOKEN
Schritt 1 — Zugangsdaten holen
Die Einrichtung dauert etwa 5 Minuten und braucht einen SmartHR-Administrator (管理者). Der Connector nutzt die SmartHR API v1 (https://<tenant>.smarthr.jp/api/v1); die Sandbox (<tenant>.daruma.space) funktioniert genauso.
- Melde dich als Administrator bei SmartHR an und öffne 共通設定 (Allgemeine Einstellungen), 外部システム連携 (Externe Integrationen), アクセストークン (Zugriffstokens), dann klick auf 新規発行 (Ausstellen).
- Gib dem Token einen Namen und wähle seine Berechtigungen: Lesen (参照) für die Daten, die die KI sehen soll (従業員, 部署, 役職, 雇用形態, カスタム項目, 家族, ユーザー, 給与明細 nach Bedarf), und Aktualisieren (更新) nur für die schreibenden Tools, die du eingeschaltet lässt. Weniger Berechtigungen heißt weniger offengelegte personenbezogene Daten.
- Kopiere das Token in
SMARTHR_ACCESS_TOKEN, ohne das Wort Bearer. Es wird nur einmal angezeigt, also halte es geheim. - Trag den Host deiner SmartHR-Adresse in
SMARTHR_HOSTein:example.smarthr.jpfür https://example.smarthr.jp oderexample.daruma.spacefür die Sandbox (Antrag unter https://developer.smarthr.jp/api/about_sandbox). - Installiere. Der Installationscheck ruft
smarthr_list_companiesauf.
Personenbezogene Daten: SmartHR enthält sensible personenbezogene Daten: Familienangehörige, Adressen, Geburtsdaten, Versicherungs- und Rentennummern, Bankverbindungen und Gehälter. Alle, die diesen Connector nutzen, erreichen, was das Token lesen darf, also gib dem Token nur die Berechtigungen, die das Team braucht. Die KI liest nur, was die Aufgabe erfordert: smarthr_list_crews liefert standardmäßig ein kurzes Profil, und fields begrenzt, was smarthr_get_crew zurückgibt. Sie kopiert keine personenbezogenen Daten in andere Systeme oder Nachrichten, außer du verlangst genau das.
Was er liest: Unternehmen (会社) mit Unternehmensnummer und Vertretung; Betriebsstätten (事業所) mit ihren Versicherungsnummern; Abteilungen (部署) mit Code, übergeordneter Abteilung und vollem Pfad; Positionen (役職), Beschäftigungsarten (雇用形態), Stufen (等級), Arbeitsorte (勤務地) und Vergütungsperioden (給与支給形態); eigene Mitarbeiterfelder (カスタム従業員項目) und ihre Gruppen. Mitarbeitende (従業員, in der API crews), gesucht nach Personalnummer, Status (employed, absent, retired), Beschäftigungsart, Abteilung, Position, Eintritts- oder Austrittsdatum, IDs oder Freitext. Angehörige (家族) mit den Verwandtschaftsarten (続柄) sowie Mutterschutz und Elternzeit (産休育休). Benutzerkonten (ユーザー) mit Rolle, Admin-Kennzeichen und Einladungsstatus: Ein User ist der Login, eine Crew der Personaldatensatz, und embed=crew verknüpft beide. Formulare zur Erfassung von Mitarbeiterdaten (従業員情報収集フォーム). Gehaltsläufe (給与明細グループ) und Gehaltsabrechnungen (給与明細) mit Zulagen, Abzügen, Anwesenheit und Summen; dafür braucht es die Gehaltsabrechnungsfunktion von SmartHR.
Was er schreibt: legt Mitarbeitende an (Namen, Lesungen, Geschlecht und Status sind Pflicht); ändert Mitarbeitende per Teilaktualisierung, bei der nur die gesendeten Felder sich ändern und ein ausgefüllter Name, eine Lesung, das Geschlecht, das Geburtsdatum oder die Adresse nicht geleert werden können; lädt Mitarbeitende per E-Mail ein, auf Wunsch mit einem Erfassungsformular (ein zweiter Aufruf lädt erneut ein); legt Abteilungen an, benennt sie um und verschiebt sie. Angelegte Mitarbeitende werden erst mit smarthr_invite_crew eingeladen. Ein Austritt ist eine Änderung (emp_status retired mit resigned_at), keine Löschung. Vor jedem Schreibvorgang und jeder Einladung zeigt dir die KI die Änderung und wartet auf dein Ja.
Bei der Installation deaktiviert: smarthr_delete_crew. Es löscht die Person mit allen ihren Daten endgültig, deshalb schaltet ein Admin es ein, wenn das Team es braucht.
Datenformate und Blättern: IDs sind UUID-Strings, Datumsangaben YYYY-MM-DD, Zeitpunkte ISO 8601. Listen nehmen page und per_page (höchstens 100, Standard 10); die Antwort enthält die Gesamtzahl in _headers.x-total-count und _pagination.nextCursor bis zur letzten Seite. Einen Filter für "geändert seit" gibt es nicht: Für Änderungen seit einem Datum sortiert die KI nach -updated_at und hört bei älteren Zeilen auf.
Limits: 10 Anfragen pro Sekunde und 5.000 pro Stunde je Token, 50.000 pro Minute je Mandant. Darüber antwortet SmartHR mit 429 too_many_requests: Warte und versuch es erneut.
Häufige Fehler: Fehler enthalten code, type, message und errors pro Feld. 401 unauthorized_token ist ein falsches oder widerrufenes Token oder eines für einen anderen Host. 403 ist eine Berechtigung, die das Token nicht hat, oder eine Funktion, die der Tarif nicht enthält (Gehaltsabrechnungen). 404 ist eine falsche ID oder ein falscher SMARTHR_HOST. 422 ist eine ungültige Eingabe: errors nennt das Feld.
Freitext in Personaldatensätzen und eigenen Feldern ist eine nicht vertrauenswürdige Eingabe und kann Anweisungen an die KI enthalten. Der Connector rechnet keine Gehälter ab, reicht keine Arbeits- oder Sozialversicherungsverfahren (手続き) ein und löscht mit den bei der Installation aktiven Tools keine Mitarbeitenden.
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 Microsoft Copilot 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 AnleitungYOUR_SERVER_IDzeigt.
Microsoft Copilot nutzt MCP-Server über Agents, die du in Copilot Studio baust: Du fügst AnythingMCP einem Agent als Tool hinzu und veröffentlichst den Agent dann in Microsoft 365 Copilot und Teams. Copilot Studio verbindet sich aus der Cloud von Microsoft per Streamable HTTP, das AnythingMCP unterstützt.
- Öffne in Copilot Studio deinen Agent (oder leg einen an), geh zu Tools und wähle Add a tool → New tool → Model Context Protocol.
- Trag einen Server name ein (zum Beispiel
AnythingMCP), eine Server description, die sagt, was der Connector kann, und die Server URLhttps://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID. Anhand der Beschreibung entscheidet Copilot Studio, wann es den Server aufruft. - Wähle bei der Authentifizierung API key, setze Type auf Header und den Header-Namen auf
X-API-Keyund klicke auf Create. - Wähle in Add tool die Option Create a new connection, füge einen MCP-API-Key aus AnythingMCP ein (MCP Servers → dein Server → API keys) und klicke auf Add to agent.
- Probier es im Test-Bereich des Agents aus: Bitte um etwas, wofür er die
SmartHR-Tools braucht. - Klicke auf Publish, dann auf Channels → Microsoft 365 and Microsoft Teams, lass Make agent available in Microsoft Copilot aktiviert und wähle Add channel. See agent in Teams installiert den Agent für dich; in Microsoft 365 Copilot tippst du @ und wählst den Agent aus.
Lieber eine Anmeldung pro Person? Wähle statt API key OAuth 2.0 → Dynamic discovery: Dann meldet sich jede Person beim ersten Aufruf des Agents bei AnythingMCP an.
Du hostest selbst? Nimm statt https://cloud.anythingmcp.com die öffentliche HTTPS-Adresse deiner Instanz. Copilot Studio verbindet sich aus der Cloud von Microsoft, localhost funktioniert deshalb nicht.
Verfügbare Tools
| Tool | What it does |
|---|---|
smarthr_list_companies | List the companies (会社) of the SmartHR tenant: id, name, corporate number, address and representative |
smarthr_list_biz_establishments | List the business establishments (事業所) used for social and labour insurance: id, name, address, insurance numbers and owner |
smarthr_list_departments | List departments (部署) with id, name, code, position (sort order), parent and full path |
smarthr_get_department | Read one department (部署) with its name, code, parent and position in the tree |
smarthr_create_department | Create a department (部署), optionally under a parent department |
smarthr_update_department | Rename or move a department (部署): name is always sent; code, parent and position only when given |
smarthr_list_job_titles | List job titles (役職, positions) with id, name and rank |
smarthr_list_employment_types | List employment types (雇用形態) with id, name and preset_type (full_timer, part_timer, contract_worker ...) |
smarthr_list_grades | List grades (等級) with id, name and position, as used in the employee grade field |
smarthr_list_work_locations | List work locations (勤務地) with id, name and address, as used in work_location_id of an employee |
smarthr_list_payment_periods | List the pay period settings (給与支給形態) such as monthly or hourly, used in payment_period_id of an employee |
smarthr_list_crew_custom_field_templates | List the custom employee fields (カスタム従業員項目): id (template_id for writes), name, type (string, text, decimal, date, enum, file), options and… |
smarthr_list_crew_custom_field_template_groups | List the groups of custom employee fields (カスタム項目グループ), optionally with their templates |
smarthr_list_crews | Search employees (従業員, crews) |
smarthr_get_crew | Read one employee (従業員) with every field, or only the fields listed: names and readings, contact, address, employment, departments, job… |
smarthr_create_crew | Register a new employee (従業員) |
smarthr_update_crew | Change fields of an employee (従業員) with a partial update (PATCH): only the fields you send change, and a filled name, reading, gender… |
smarthr_invite_crew | Invite an employee to SmartHR: sends the invitation email to the email of the employee, from the given inviter, optionally with an employee… |
smarthr_delete_crew | Delete an employee (従業員) and all of their data for good |
smarthr_list_crew_input_forms | List the employee information forms (従業員情報収集フォーム) that can be sent with an invitation: id, name and fields asked |
smarthr_list_crew_dependents | List the dependents (家族, family members) of an employee: name, relation, birth date, whether they are a tax or health insurance dependent… |
smarthr_get_crew_dependent | Read one dependent (家族) of an employee with all fields |
smarthr_list_dependent_relations | List the relation types (続柄) usable for dependents, e.g. spouse, child; filter spouse returns only spouse relations |
smarthr_list_crew_childcare_leaves | List maternity and childcare leaves (産休育休) of an employee with their periods |
smarthr_list_users | List SmartHR user accounts (ユーザー): id, email, role, admin flag, invitation state and, with embed crew, the linked employee |
smarthr_get_user | Read one SmartHR user account with role, admin flag and invitation dates |
smarthr_list_payrolls | List payroll runs (給与明細グループ): id, payment type (salary or bonus), paid date, period, status (fixed, published) and name |
smarthr_get_payroll | Read one payroll run (給与明細グループ) with its status, dates and settings |
smarthr_list_payslips | List the payslips (給与明細) of a payroll run: per employee the allowances, deductions, attendance and totals |
smarthr_get_payslip | Read one payslip (給与明細) with allowances, deductions, attendance and aggregates |
Beispiel-Prompts
- „Wie viele Mitarbeitende mit Status employed hat jede Abteilung gerade?“
- „Wer ist im Oktober eingetreten? Zeig nur Name, Abteilung, Beschäftigungsart und Eintrittsdatum.“
- „Leg die neue Mitarbeiterin 山田 花子 (ヤマダ ハナコ) an, weiblich, Vollzeit im 営業部 ab 1. November, und lade sie dann mit unserem Onboarding-Formular ein. Zeig mir vor dem Speichern alles.“
- „Personalnummer 1042 scheidet zum 30. November aus. Trag den Austritt ein.“
- „Zeig aus dem Gehaltslauf Oktober nur die Summe der Zulagen und Abzüge für Personalnummer 1042.“
FAQ
Für welchen Copilot gilt das? Für Microsoft 365 Copilot im Unternehmen, über Agents aus Copilot Studio. Die Microsoft-Copilot-App für private Konten bietet keine Möglichkeit, einen eigenen MCP-Server hinzuzufügen.
Was brauche ich? Ein Arbeitskonto mit Zugang zu Copilot Studio (Lizenz oder Testversion), um den Agent zu bauen. Wer ihn in Microsoft 365 Copilot oder Teams nutzen soll, braucht Zugriff auf den Agent: Teile ihn oder lass ihn von einem Admin für die Organisation veröffentlichen. Wendet deine Organisation Datenrichtlinien auf Power-Platform-Connectors an, gelten sie auch für MCP-Server.
Der Agent ruft die Tools nicht auf. Prüfe, dass der Header-Name genau X-API-Key lautet und der Schlüssel zum selben MCP-Server gehört wie die URL, und formuliere die Server description konkret: Copilot Studio entscheidet anhand der Beschreibung, wann es den Server aufruft. Veröffentliche den Agent nach jeder Änderung erneut; in einem offenen Chat holst du die neue Version mit „start over“.
Nächste Schritte
- Connector-Startseite
- Mit Claude verbinden
- Mit ChatGPT verbinden
- Mit Cursor verbinden
- Mit Gemini verbinden
- Mit Meta Muse verbinden
War dieser Guide hilfreich?