ClaudeとBambooHRを連携する方法 — 休暇申請・目標・採用を会話で扱う
BambooHR公式のコネクタで、従業員情報・休暇・目標・採用応募をClaudeから扱えます。接続手順、56個のツールの分類、管理者が先に有効化する設定、書き込みを絞る方法をまとめます。
Claude BambooHR連携とは — 何ができるか
BambooHRコネクタは、人事システムのBambooHRをClaudeの会話につなぐ公式の連携です。提供元はBambooHR LLCで、ディレクトリ上では「Anthropic verified」の表示が付き、追加時期は2026年8月です。カテゴリは「Data & analytics」と「Productivity」に入っています。
BambooHR側の文書は、このコネクタを「ベータ」と位置づけています。土台になるのはBambooHRが運営するMCPサーバーで、Claudeのウェブ版とデスクトップアプリで動きます。
公式の例から、会話で頼める内容を拾うと次のとおりです。
- 今週の休暇者と、近い会社の祝日を確認する
- 自分の休暇残日数を聞く
- 部署ごとの人数を集計する
- 保存済みレポートを一覧し、1つ実行して要約する
- 募集中の求人と、応募者数を確認する
- 過去2週間に応募した候補者を絞り込む
- 進行中の目標と、期限を過ぎたものを確認する
- 「来月の最終週に休暇申請を作って」と頼む
- 従業員の勤務先電話番号を更新する
参照だけでなく、書き込みもできます。ここが、人事データを扱ううえで最初に押さえる点です。
前提 — 管理者の有効化が先に要る
Claude側の準備は、Claudeアカウントだけです。ウェブ版コネクタは、Claude・Cowork・Claude Desktop・Claude Mobileの全ユーザーが使えます。詰まりやすいのはBambooHR側です。
必要なものは3つあります。
| 必要なもの | 内容 |
|---|---|
| Claudeアカウント | 内容追加するユーザー本人のもの |
| AI Connectorsアプリ | 内容BambooHR管理者が有効化し、本人が対象の範囲に入っていること |
| BambooHRのサブドメイン | 内容BambooHRのURLで .bamboohr.com の前にある部分 |
管理者の作業は1回で済みます。
- BambooHRで「Settings」→「Apps」を開く
- 「AI Connectors」を見つけて有効にする
- 「Give access to」で、接続できる範囲を選ぶ
範囲の選択肢は、管理者のみ(既定)・特定のアクセスレベル・全従業員の3つです。既定が管理者のみなので、何もしなければ一般社員は接続できません。この設定が済んでいないと、接続しようとした人はサインインの段階で止められ、管理者に何を頼めばよいかがメッセージで表示されます。
接続手順 — サーバーURLはサブドメインごとに違う
BambooHRのMCPサーバーは、顧客ごとに別のエンドポイントを持ちます。BambooHR側がホストするため、手元に何かをインストールする必要はありません。
# Server URL(自社のサブドメインに置き換える)
https://{your-subdomain}.bamboohr.com/api/mcp手順は次のとおりです。
- Claudeの案内に従って、BambooHRコネクタを追加する
- 「Server URL」に、上のURLを自社のサブドメインで入力する
- 「Connect」を押す。BambooHRのサインイン画面に移る
- 普段どおりBambooHRにサインインする
- BambooHRが表示する要求内容を確認し、「Allow Access」を押す
- ベータ期間中は、コネクタの「Configure」から、使わせたくないツールをオフにする(公式が推奨)
- 新しいチャットを開き、最初の質問をする
認証はOAuthです。Claudeがパスワードを見ることはなく、「Allow Access」を押すまで何も共有されません。アクセストークンの有効期間は1時間ですが、自動で更新されるため、利用者が管理する必要はありません。
Team・Enterpriseプランでは、順序が1つ増えます。OwnerまたはPrimary Ownerが組織でコネクタを有効化しても、それだけでは誰も使えません。メンバーは各自でBambooHRに認証します。コネクタ全般の仕組みはClaude Connectorsとはにまとめています。
56個のツールを11の領域で見る
ディレクトリのページには「Show all 56 tools」と出ます。BambooHRのMCPサーバー文書は、同じツールを11の領域に分け、それぞれに読み取り・書き込み・削除の別を付けています。ツール名は、ディレクトリ上ではハイフン区切り、MCPクライアント上ではアンダースコア区切りで表示され、文書もこの違いに触れています。
| 領域 | ツール数 | 書き込み系の例 |
|---|---|---|
| 従業員・ディレクトリ | ツール数5 | 書き込み系の例update_employee(項目の更新) |
| 項目・メタデータ | ツール数3 | 書き込み系の例なし |
| データセット | ツール数4 | 書き込み系の例なし |
| レポート | ツール数2 | 書き込み系の例なし |
| 休暇 | ツール数8 | 書き込み系の例create_time_off_request、update_time_off_request_status |
| 目標 | ツール数12 | 書き込み系の例create_goal、close_goal、delete_goal |
| 目標コメント | ツール数4 | 書き込み系の例作成・編集・削除 |
| 採用 | ツール数5 | 書き込み系の例create_application_comment |
| グローバル雇用 | ツール数10 | 書き込み系の例なし |
| ファイル | ツール数2 | 書き込み系の例なし |
| ユーティリティ | ツール数1 | 書き込み系の例なし(日付計算のみ) |
大半は読み取り専用です。データを変更するツールには「Write」、完全に削除するものには「Delete」の印が付いています。
休暇 — 申請から承認まで
休暇の領域は、休暇者の一覧・申請の一覧・残日数・休暇の種類とポリシーの参照に加え、申請の作成と、申請の承認・却下・取消を含みます。「PTO」の呼び名は会社ごとに違います。「Vacation」など別の名前のことがあるため、まず「うちの休暇の種類は何がある?」と聞き、返ってきた名前で頼むのが公式の勧めです。
目標 — 作成から削除まで
目標の領域は12個で、最も数が多い領域です。作成、詳細の更新、マイルストーンの追加と削除、進捗率の設定、マイルストーンの完了・未完了、クローズ、再オープン、削除がそろっています。対象の単位は従業員です。会社全体の目標を一度に引く問い合わせはなく、チームについて聞くときは、先にメンバーを特定する必要があります。
採用 — 応募の確認とコメント
採用の領域は、求人の一覧と応募者数、応募の一覧と絞り込み、1件の応募の詳細(回答と選考状況の履歴を含む)、選考ステータスの一覧、応募へのコメント追加です。ここは全ツールがATS設定へのアクセスを必要とします。BambooHRの文書は、多くのマネージャーがこの権限を持たないと明記しています。
データセットとグローバル雇用
データセットの領域は、レポート機能のデータに対する臨時の問い合わせです。保存済みレポートにない切り口の質問は、ここで答えます。グローバル雇用の領域は、BambooHRの海外雇用サービスを使う会社向けで、該当しない会社ではデータが返りません。ディレクトリのページは、この領域で世界各国の従業員、未完了のオンボーディング手順、採用できる国を確認できると説明しています。
権限モデル — 結果が少ないときは権限を疑う
コネクタが、本人に許されていないアクセスを与えることはありません。すべての要求は、BambooHRにサインインしているときと同じ権限で実行されます。
- 人事管理者は、通常もっとも広い権限を持つ
- マネージャーは、自分と、アクセスレベルによっては直属の部下のデータを扱える
- 一般社員は、自分の情報を扱える。会社が従業員ディレクトリを公開していれば、同僚の基本情報も引ける
権限は職位でなくアクセスレベルに従います。休暇の残日数は、対象者の休暇を見る権限が必要で、その人のマネージャーであるだけでは足りません。同じ質問への答えが、人によって変わるのはこのためです。
一番の落とし穴は、権限で見えない分が黙って省かれる点です。MCPサーバーの文書には、ツールごとの挙動が書かれています。
get_employeeは、読めない項目を印なしで省くlist_employeesは、読めない値をnullにし、項目名を_restrictedFieldsに列挙するlist_employeesは、絞り込みや並べ替えに使う項目が読めないと、その従業員を結果から丸ごと落とす。件数も見える行だけで数えるget_data_from_dataset_v2は、読めない値を空にして、伏せた項目名を列挙する
空か少なめの答えは「あなたに見える範囲では該当なし」であり、「存在しない」ではありません。権限がなければ403が返るのであって、行がゼロ件の200は権限エラーではありません。人事の集計をClaudeに任せるとき、人数が合わなければ、同じ質問をBambooHR上で直接確かめるのが公式の手順です。
書き込みを絞る — 人事データで先に決めておくこと
人事データの書き込みは、取り消せないものを含みます。delete_goal は目標を完全に削除するツールです。BambooHRが挙げる安全策は5つで、Claude側の設定に落とすと次のようになります。
| 安全策 | Claude側でやること |
|---|---|
| ツールを絞る | Claude側でやることコネクタの「Configure」で、作成・更新・削除のツールをオフにする |
| 書き込みは承認する | Claude側でやること作成・更新・変更の直前に、Claudeが示す内容を読む |
| 「Always allow」を書き込みに付けない | Claude側でやること付けると、次回から確認なしで実行される |
| BambooHR中心の会話にする | Claude側でやること他のコネクタを混ぜると、データの行き先が読みにくくなる |
| 学習設定を確認する | Claude側でやることClaudeの設定で、会話がモデル改善に使われるかを確かめる |
参照だけで使いたいなら、まず書き込み系のツールを全部オフにして始める運用があります。
Team・Enterpriseプランでは、Ownerが組織全体で、コネクタの権限を「Always allow」「Needs approval」「Blocked」に分けられます。設定は組織の全員に効き、個人は上書きできません。書き込み系を組織の入口でBlockedにし、参照系だけを開ける設計が取れます。
使い方の例 — 休暇申請と採用の確認
実際の依頼文は、公式の例文に沿った形で書けます。次のように、種類の確認から始めると、名前の食い違いを避けられます。
うちの休暇の種類を一覧にして。
そのうえで、来月の最終週に、Vacation相当の種類で
私の休暇申請を作って。送信前に日付と種類を見せて。例えば、次のような流れになります(公式の例文にもとづく想定で、実際の出力は環境で変わります)。
- 休暇の種類を一覧する読み取りが走り、社内の呼び名が確認できる
- 申請の作成ツールが呼ばれる前に、承認の確認が出る
- 承認すると申請が作られる。承認ワークフローがある会社では、コネクタはそれを迂回しない
採用の確認も同じ要領です。求人の一覧と応募者数を出し、続けて直近2週間の応募を絞ります。応募へのコメントは書き込みなので、確認したいだけなら、コメント作成のツールはオフのままにします。
BambooHRのデータを、他のコネクタと組み合わせる使い方も公式が挙げています。採用の進捗を要約し、Google Docsに更新文を下書きする例です。ただし、上で述べたとおり、機微な人事作業は会話をBambooHRだけに絞るのが公式の勧めです。
つまずいたとき — 公式の切り分け
BambooHRの文書が挙げる症状と原因の対応は次のとおりです。
| 症状 | 原因と対処 |
|---|---|
| 「AI Connectors isn't enabled for your company yet.」 | 原因と対処管理者が「Settings」→「Apps」でアプリを入れる必要がある |
| 「Only administrators can connect…」 | 原因と対処アプリは入っているが管理者限定。「Give access to」を広げてもらう |
| 「Your access level does not have permission…」 | 原因と対処特定のアクセスレベルだけが対象で、自分の分が含まれていない |
| Claudeが接続できない | 原因と対処サーバーURLを確認する。自社のサブドメインで、api.bamboohr.com ではない |
| 接続できていたのに止まった | 原因と対処管理者がアプリを無効にしたか、対象の範囲が狭まった。復旧後に再接続する |
| 従業員・レポート・休暇の種類が少ない | 原因と対処権限による絞り込み。「該当なし」の意味である |
| 休暇の種類が存在しないと言われる | 原因と対処会社ごとの名前。種類の一覧を先に聞く |
| 書き込みが失敗した | 原因と対処BambooHR上で同じ変更をする権限があるか確認する。承認ワークフローは迂回されない |
管理者がAI Connectorsアプリを無効にすると、社内のすべての接続がまとめて失効します。個々の利用者が切断する必要はありません。対象の範囲を狭めた場合も、影響を受ける人のアクセスが外れます。
現在の制約とほかの連携との違い
MCPサーバー文書は、現在の制約を6つ挙げています。
- すべての機能は公開されておらず、一部のツールだけがある
- 事前組み込みのコネクタを使わないクライアントは、開発者ポータルでアプリを作って手動登録する。動的なクライアント登録はない
- 手動で作ったベアラートークンは1時間で失効し、取り替えが要る
- 目標は従業員単位で、会社全体への問い合わせはない
- 承認やワークフローが要る変更は、BambooHR既存の流れに従い、その場では完了しない
- 権限による一部の結果は、必ずしも明示されない
ベータ期間の仕様は変わりうるため、ツールの数や名前は、接続した時点のディレクトリの表示で確かめてください。
人事系のコネクタには、目的が違うものがあります。BambooHRは、社員の記録・休暇・目標・採用という日々の業務データを直接読み書きします。人事データの分析を主目的にするなら、ClaudeとVisierの連携が別の切り口です。営業側の記録を会話で更新するPipedriveやZoho CRMのコネクタと構造は似ており、共通点は、認証したユーザーの権限で動く点と、書き込みを組織側で絞れる点です。
まとめ
BambooHRコネクタで、Claudeは従業員情報・休暇・目標・採用応募を、認証した本人の権限の範囲で読み書きします。始める前の関門は、管理者によるAI Connectorsアプリの有効化です。既定が管理者のみなので、導入の最初の作業は、Claudeでなく管理画面にあります。
運用で先に決めておくのは、書き込み系のツールをどこまで開けるかです。休暇申請と目標の作成は便利ですが、delete_goal のように取り消せないものもあります。参照だけで始め、必要になった書き込みを1つずつ開ける順序が、無理のない進め方です。人数が合わないときは、バグより先に権限を疑ってください。