bamboohr-automation

Rube MCP による BambooHR の自動化

Rube MCP 経由で Composio の BambooHR ツールキットを使用し、人事業務を自動化します。

前提条件

• Rube MCP が接続されていること（RUBE_SEARCH_TOOLS が利用可能であること）
• RUBE_MANAGE_CONNECTIONS を使用し、ツールキット bamboohr で有効な BambooHR 接続があること
• 現在のツールスキーマを取得するため、必ず最初に RUBE_SEARCH_TOOLS を呼び出してください

セットアップ

Rube MCP の取得：クライアントの設定で https://rube.app/mcp を MCP サーバーとして追加します。API キーは不要です。エンドポイントを追加するだけで動作します。

1. RUBE_SEARCH_TOOLS が応答することを確認し、Rube MCP が利用可能であることを確かめます
2. ツールキット bamboohr を指定して RUBE_MANAGE_CONNECTIONS を呼び出します
3. 接続が ACTIVE でない場合は、返された認証リンクを開いて BambooHR の認証を完了します
4. ワークフローを実行する前に、接続ステータスが ACTIVE であることを確認します

人事データの取り扱い境界

曖昧な名前の一致だけに頼らず、会社 ID と従業員 ID が正確であることを確認してください。タスクに必要なフィールドのみを要求し、SSN、扶養家族・福利厚生の詳細、または従業員ディレクトリ全体を不必要にエクスポートしないでください。休暇の申請は、その承認権限を与えるものではありません。権限を持つ意思決定者から承認または却下が明示的に依頼されていない限り、申請の作成後に処理を止めてください。不確実な書き込みを再試行する前に、フィールドの変更内容をプレビューし、既存の申請 ID と照合してください。外部同期には、承認済みの同期先とデータ保持の境界が必要です。すべての変更と削除を永続的に照合した後にのみ、ウォーターマークを進めてください。

主なワークフロー

1. 従業員の一覧表示と検索

使用する場面：従業員を検索したい、または従業員ディレクトリ全体を取得したい場合

ツールの呼び出し順序：

1. BAMBOOHR_GET_ALL_EMPLOYEES - 従業員ディレクトリを取得します［必須］
2. BAMBOOHR_GET_EMPLOYEE - 特定の従業員の詳細情報を取得します［任意］

主なパラメーター：

• GET_ALL_EMPLOYEES の場合：必須パラメーターはありません。ディレクトリを返します
• GET_EMPLOYEE の場合：
  • id：従業員 ID（数値）
  • fields：返すフィールドをカンマ区切りで指定します（例：'firstName,lastName,department,jobTitle'）

注意事項：

• 従業員 ID は数値の整数です
• GET_ALL_EMPLOYEES は基本的なディレクトリ情報を返します。詳細情報を取得するには GET_EMPLOYEE を使用してください
• fields パラメーターで返されるフィールドを指定します。省略すると、最小限のデータしか返されない場合があります
• 一般的なフィールド：firstName、lastName、department、division、jobTitle、workEmail、status
• 退職・無効化された従業員が含まれる場合があります。status フィールドを確認してください

2. 従業員の変更を追跡

使用する場面：同期や監査のために、従業員データの最近の変更を検出したい場合

ツールの呼び出し順序：

1. BAMBOOHR_EMPLOYEE_GET_CHANGED - 最近変更された従業員を取得します［必須］

主なパラメーター：

• since：変更検出のしきい値を示す ISO 8601 形式の日時文字列
• type：確認する変更の種類（例：'inserted'、'updated'、'deleted'）

注意事項：

• since パラメーターは必須です。ISO 8601 形式を使用してください（例：'2024-01-15T00:00:00Z'）
• 変更された従業員の ID を返します。従業員の全データは返しません
• 変更された各従業員の詳細情報を取得するには、別途 GET_EMPLOYEE を呼び出す必要があります
• 差分同期のワークフローに便利です。前回の同期タイムスタンプをキャッシュしてください

3. 休暇を管理する

使用する場面：ユーザーが休暇残高の確認、休暇の申請、または申請の管理を希望する場合

ツールの手順：

1. BAMBOOHR_GET_META_TIME_OFF_TYPES - 利用可能な休暇タイプを一覧表示します［前提条件］
2. BAMBOOHR_GET_TIME_OFF_BALANCES - 現在の残高を確認します［任意］
3. BAMBOOHR_GET_TIME_OFF_REQUESTS - 既存の申請を一覧表示します［任意］
4. BAMBOOHR_CREATE_TIME_OFF_REQUEST - 新しい申請を送信します［任意］
5. BAMBOOHR_UPDATE_TIME_OFF_REQUEST - 申請を変更、承認、または却下します［任意］

主なパラメーター：

• 残高の場合：employeeId、休暇タイプ ID
• 申請の場合：start、end（日付範囲）、employeeId
• 作成の場合：
  • employeeId：申請対象の従業員
  • timeOffTypeId：GET_META_TIME_OFF_TYPES から取得したタイプ ID
  • start：開始日（YYYY-MM-DD）
  • end：終了日（YYYY-MM-DD）
  • amount：日数または時間数
  • notes：申請に関する任意のメモ
• 更新の場合：requestId、status（'approved'、'denied'、'cancelled'）

注意点：

• 休暇タイプ ID は数値です。まず GET_META_TIME_OFF_TYPES で特定してください
• 開始日と終了日の形式は「YYYY-MM-DD」です
• 残高の単位は会社の設定により、時間または日数になります
• 申請ステータスの更新には適切な権限（マネージャー／管理者）が必要です
• 申請を作成しても自動承認されません。別途承認手順が必要です

4. 従業員情報を更新する

使用する場面：ユーザーが従業員プロフィールのデータ変更を希望する場合

ツールの手順：

1. BAMBOOHR_GET_EMPLOYEE - 現在の従業員データを取得します［前提条件］
2. BAMBOOHR_UPDATE_EMPLOYEE - 従業員のフィールドを更新します［必須］

主なパラメーター：

• id：従業員 ID（数値、必須）
• 更新するフィールドの名前と値の組み合わせ（例：department、jobTitle、workPhone）

注意点：

• リクエストに含まれるフィールドのみが更新され、その他のフィールドは変更されません
• 一部のフィールドは読み取り専用で、API 経由では更新できません
• フィールド名は BambooHR が想定する名前と完全に一致させる必要があります
• 更新は監査対象となり、変更は従業員の変更履歴に記録されます
• 上書きを避けるため、更新前に GET_EMPLOYEE で現在の値を確認してください

5. 扶養家族と福利厚生を管理する

使用する場面：ユーザーが従業員の扶養家族または福利厚生の適用状況を確認したい場合

ツールの手順：

1. BAMBOOHR_DEPENDENTS_GET_ALL - すべての扶養家族を一覧表示します［必須］
2. BAMBOOHR_BENEFIT_GET_COVERAGES - 福利厚生の適用内容を取得します［任意］

主なパラメーター：

• 扶養家族の場合：任意の employeeId フィルター
• 福利厚生の場合：スキーマによって異なります。現在のパラメーターは RUBE_SEARCH_TOOLS で確認してください

注意点：

• 扶養家族のデータには機微な個人情報が含まれます。適切に取り扱ってください
• 福利厚生の適用内容には、従業員ごとに複数のプランタイプが含まれる場合があります
• BambooHR のすべてのプランが福利厚生管理に対応しているわけではありません。アカウントの機能を確認してください
• データへのアクセスは API キーの権限によって異なります

一般的なパターン

ID の解決

従業員名 -> 従業員 ID：

1. Call BAMBOOHR_GET_ALL_EMPLOYEES
2. Find employee by name in directory results
3. Extract id (numeric) for detailed operations

休暇タイプ名 -> タイプ ID：

1. Call BAMBOOHR_GET_META_TIME_OFF_TYPES
2. Find type by name (e.g., 'Vacation', 'Sick Leave')
3. Extract id for time-off requests

増分同期パターン

外部システムを BambooHR と同期した状態に保つ場合：

1. Store last_sync_timestamp
2. Call BAMBOOHR_EMPLOYEE_GET_CHANGED with since=last_sync_timestamp
3. For each changed employee ID, call BAMBOOHR_GET_EMPLOYEE
4. Process updates in external system
5. Update last_sync_timestamp

休暇ワークフロー

1. GET_META_TIME_OFF_TYPES -> find type ID
2. GET_TIME_OFF_BALANCES -> verify available balance
3. CREATE_TIME_OFF_REQUEST -> submit request
4. Only if separately authorized: UPDATE_TIME_OFF_REQUEST -> approve/deny (manager action)

既知の落とし穴

従業員 ID：

• 常に数値の整数です
• GET_ALL_EMPLOYEES で名前から ID を特定します
• 退職した従業員も ID は保持されます

日付形式：

• 休暇の日付：'YYYY-MM-DD'
• 変更の検出：タイムゾーン付きの ISO 8601
• エンドポイントごとに形式が異なるため、各エンドポイントのスキーマを確認してください

権限：

• API キーの権限によって、アクセス可能なフィールドと操作が決まります
• 一部の操作には管理者またはマネージャーレベルのアクセス権が必要です
• 休暇の承認には、適切なロール権限が必要です

機密データ：

• 従業員データには PII（氏名、住所、SSN など）が含まれます
• すべてのレスポンスを適切なセキュリティ対策のもとで取り扱ってください
• 扶養家族のデータは特に機密性が高い情報です

レート制限：

• BambooHR API には API キーごとのレート制限があります
• 一括操作はスロットリングしてください
• GET_ALL_EMPLOYEES は、個別に GET_EMPLOYEE を呼び出すよりも効率的です

レスポンスの解析：

• レスポンスデータは data キーの下にネストされている場合があります
• 従業員フィールドは fields パラメーターによって異なります
• 空のフィールドは省略されるか、null として返される場合があります
• フォールバックを用意し、堅牢に解析してください

クイックリファレンス

タスク	ツールスラッグ	主なパラメーター
全従業員の一覧表示	BAMBOOHR_GET_ALL_EMPLOYEES	(なし)
従業員の詳細取得	BAMBOOHR_GET_EMPLOYEE	id, fields
変更の追跡	BAMBOOHR_EMPLOYEE_GET_CHANGED	since, type
休暇タイプ	BAMBOOHR_GET_META_TIME_OFF_TYPES	(なし)
休暇残高	BAMBOOHR_GET_TIME_OFF_BALANCES	employeeId
休暇申請の一覧表示	BAMBOOHR_GET_TIME_OFF_REQUESTS	start, end, employeeId
休暇申請の作成	BAMBOOHR_CREATE_TIME_OFF_REQUEST	employeeId, timeOffTypeId, start, end
休暇申請の更新	BAMBOOHR_UPDATE_TIME_OFF_REQUEST	requestId, status
従業員情報の更新	BAMBOOHR_UPDATE_EMPLOYEE	id, (フィールドの更新)
扶養家族の一覧表示	BAMBOOHR_DEPENDENTS_GET_ALL	employeeId
福利厚生の適用範囲	BAMBOOHR_BENEFIT_GET_COVERAGES	(スキーマを確認)

使用する場合

このスキルは、概要に記載されたワークフローまたはアクションを実行する場合に適用できます。

制限事項

• このスキルは、タスクが上記の適用範囲に明確に合致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功基準が不足している場合は、作業を止めて確認してください。