ClaudeとBambooHRを連携する方法 — 休暇申請・目標・採用を会話で扱う
BambooHR公式のコネクタで、従業員情報・休暇・目標・採用応募をClaudeから扱えます。接続手順、56個のツールの分類、管理者が先に有効化する設定、書き込みを絞る方法をまとめます。
Claude BambooHR連携とは — 何ができるか
BambooHRコネクタは、人事システムのBambooHRをClaudeの会話につなぐ連携です。提供元はBambooHR LLCで、ディレクトリ上では「Anthropic verified」の表示が付き、追加時期は2026年8月です。カテゴリは「Data & analytics」と「Productivity」に入っています。
BambooHR側の文書は、このコネクタを「ベータ」と位置づけています。土台になるのはBambooHRが運営するMCPサーバーです。動作環境として、BambooHRの文書はClaudeのウェブ版とデスクトップアプリを挙げています。モバイルはこの記述に含まれていません。
BambooHRはAI連携を3つの経路で案内しています。Claudeコネクタが最も整った経路で、ChatGPTコネクタは一部のベータ参加者向けです。MCPサーバーは両方の土台で、自前のクライアントから使うときの入口になります。
BambooHRの文書にある例から、会話で頼める内容を拾うと次のとおりです。
- 今週の休暇者と、近い会社の祝日を確認する
- 自分の休暇残日数を聞く
- 部署ごとの人数を集計する
- 保存済みレポートを一覧し、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つから選びます。
接続できる範囲の3つの選択肢
管理者のみ(既定)
何も設定しなければこの状態です。一般社員は接続できません。
特定のアクセスレベル
選んだアクセスレベルの人だけが接続できます。自分のレベルが含まれていないと、サインインの段階で止まります。
全従業員
会社の全員が接続できます。接続できても、引けるデータは各自の権限の範囲です。
範囲の外にいる人は、サインインの段階で止められます。画面には、管理者に何を頼めばよいかのメッセージが出ます。
手順の数え方は、BambooHRの2つのページで違います。コネクタのページは上の3つで終わります。「BambooHRとAI」のページは、その後に「Save」を押す手順を加えて4つにしています。設定を変えたら、保存まで済ませたかを管理者に確かめると行き違いを避けられます。
接続手順 — サーバーURLはサブドメインごとに違う
BambooHRのMCPサーバーは、顧客ごとに別のエンドポイントを持ちます。BambooHR側がホストするため、手元に何かをインストールする必要はありません。
# Server URL(自社のサブドメインに置き換える)
https://{your-subdomain}.bamboohr.com/api/mcpBambooHRコネクタを追加する7ステップ
- 1
コネクタを追加する
Claudeの案内に従って、BambooHRコネクタを追加します。
- 2
サーバーURLを入れる
「Server URL」に、上のURLを自社のサブドメインで入力します。
- 3
Connectを押す
BambooHRのサインイン画面に移ります。
- 4
BambooHRにサインインする
普段どおりサインインします。パスワードを入れるのはBambooHRの画面だけです。
- 5
Allow Accessを押す
BambooHRが表示する要求内容を確認してから押します。押すまで、何も共有されません。
- 6
使わないツールをオフにする
ベータ期間中は、コネクタの「Configure」から、使わせたくないツールをオフにするよう勧められています。
- 7
新しいチャットで質問する
新しいチャットを開き、最初の質問をします。
認証はOAuthです。Claudeがパスワードを見ることはありません。アクセストークンの有効期間は1時間ですが、自動で更新されるため、利用者が管理する必要はありません。
接続を外す方法は2つあります。利用者がClaudeでコネクタを切断するか、管理者がAI Connectorsアプリを無効にします。後者は、社内のすべての接続をまとめて失効させます。範囲を狭めたときも、該当する人のアクセスが外れます。「BambooHRとAI」のページは、狭めた場合の反映を「通常は1時間以内」としています。
Team・Enterpriseプランでは、順序が1つ増えます。OwnerまたはPrimary Ownerが組織でコネクタを有効化しても、それだけでは誰も使えません。メンバーは各自でBambooHRに認証します。コネクタ全般の仕組みはClaude Connectorsとはにまとめています。
結果が少ないとき — 権限で黙って省かれる
コネクタが、本人に許されていないアクセスを与えることはありません。すべての要求は、BambooHRにサインインしているときと同じ権限で実行されます。
- 人事管理者は、通常もっとも広い権限を持つ。BambooHRはこの立場の体験を最優先で作ったと書いている
- マネージャーは、自分と、アクセスレベルによっては直属の部下のデータを扱える
- 一般社員は、自分の情報を扱える。会社が従業員ディレクトリを公開していれば、同僚の基本情報も引ける
権限は職位でなくアクセスレベルに従います。同じ質問への答えが、人によって変わるのはこのためです。一部の領域は、従業員の記録とは別に権限が決まります。
| 聞きたいこと | 必要な権限 | 足りないとき |
|---|---|---|
| 休暇の残日数 | 必要な権限対象者の休暇を見る権限(マネージャーでも自動では付かない) | 足りないとき明示的な403 |
| 採用(求人・応募) | 必要な権限ATS設定へのアクセス(多くのマネージャーは持たない) | 足りないとき採用の全ツールが対象(権限がなければ使えない) |
| 保存済みレポート | 必要な権限レポートへのアクセス | 足りないとき人によって件数が違い、ゼロ件もある |
| データセット | 必要な権限データセット自体に必要な高い権限 | 足りないとき見えない値は空になり、伏せた項目名が列挙される |
| 同僚の基本情報 | 必要な権限会社の従業員ディレクトリの公開設定 | 足りないとき引ける範囲が公開設定で決まる |
最後の行は、ディレクトリ用のツールの性質です。get_employees_directory は、会社が公開したディレクトリを読みます。従業員ごとの記録の権限ではなく、ディレクトリの共有設定に従うため、管理者でない人が同僚を調べる主な入口になります。
一番の落とし穴は、権限で見えない分が黙って省かれる点です。MCPサーバーの文書には、ツールごとの挙動が書かれています。
get_employeeは、読めない項目を印なしで省くlist_employeesは、読めない値をnullにし、項目名を_restrictedFieldsに列挙するlist_employeesは、絞り込みや並べ替えに使う項目が読めないと、その従業員を結果から丸ごと落とす。件数も見える行だけで数えるget_data_from_dataset_v2は、読めない値を空にして、伏せた項目名を列挙する
get_employee の「印なし」は、見分けにくい仕様です。項目が出てこないとき、頼んでいないのか、権限がないのかは、結果の見た目からは分かりません。
403と、行がゼロ件の200は別物
403が返る
アクセスが明示的に拒否されたことを表します。休暇の残日数で、対象者の休暇を見る権限がないときが例です。
行がゼロ件の200
エラーではありません。「あなたに見える範囲では該当なし」を意味し、「存在しない」とは違います。
人事の集計をClaudeに任せて人数が合わないときは、BambooHR上で同じ質問を直接確かめるか、管理者に尋ねるよう案内されています。
56個のツールを11の領域で見る
ディレクトリのページには「Show all 56 tools」と出ます。BambooHRのMCPサーバー文書は、同じツールを11の領域に分け、それぞれに読み取り・書き込み・削除の別を付けています。文書は、MCPクライアント上のツール名はアンダースコア区切りで、公開APIリファレンスのハイフン区切りの名前と異なることがあると書いています。ディレクトリ上の表示もハイフン区切りです。
| 領域 | ツール数 | 書き込み系の例 |
|---|---|---|
| 従業員・ディレクトリ | ツール数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」の印が付いています。
休暇 — 申請から承認まで
休暇の領域は、休暇者の一覧・申請の一覧・残日数・休暇の種類とポリシーの参照に加え、申請の作成と、申請の承認・却下・取消を含みます。残日数は、任意の日付時点で引けます。年5日の取得義務をExcelの管理簿で点検する場合は、年次有給休暇の管理簿の点検手順が参考になります。
「PTO」の呼び名は会社ごとに違います。「Vacation」など別の名前のことがあるため、まず「うちの休暇の種類は何がある?」と聞き、返ってきた名前で頼むのが勧められています。
目標 — 作成から削除まで
目標の領域は12個で、最も数が多い領域です。作成、詳細の更新、マイルストーンの追加と削除、進捗率の設定、マイルストーンの完了・未完了、クローズ、再オープン、削除がそろっています。マイルストーンのない目標の進捗率は設定でき、マイルストーン付きの目標は、マイルストーンごとに完了を付けます。
対象の単位は従業員です。会社全体の目標を一度に引く問い合わせはなく、チームについて聞くときは、先にメンバーを特定する必要があります。
採用 — 応募の確認とコメント
採用の領域は、求人の一覧と応募者数、応募の一覧と絞り込み、1件の応募の詳細(回答と選考状況の履歴を含む)、選考ステータスの一覧、応募へのコメント追加です。書き込みはコメントの追加だけで、選考ステータスを動かすツールはありません。
データセット・ファイル・グローバル雇用
データセットの領域は、レポート機能のデータに対する臨時の問い合わせです。保存済みレポートにない切り口の質問は、ここで答えます。1回の問い合わせで、保存済みレポートが答えない質問にも答えられる点が、会話での利用がいちばん効く場面とされています。
ファイルの領域は、一覧だけを返します。従業員に付いたファイルと会社のファイルの、存在と閲覧できる人を示し、中身は返しません。契約書の本文を読ませたい用途には、このツールは向きません。
グローバル雇用の領域は、BambooHRの海外雇用サービスを使う会社向けで、該当しない会社ではデータが返りません。このツール群は、BambooHRの公開REST APIには対応する窓口がなく、MCPサーバー経由でだけ使えます。ディレクトリのページは、この領域でグローバル雇用の対象者、未完了のオンボーディング手順、採用できる国を確認できると説明しています。
ユーティリティの領域には、日付計算のツールが1つあります。言語モデルは日付の計算が苦手なため、差・期間・勤続年数・次の記念日の計算をサーバー側に任せる設計です。
書き込みを絞る — 人事データで先に決めておくこと
人事データの書き込みは、取り消せないものを含みます。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にし、参照系だけを開ける設計が取れます。
使い方の例 — 休暇申請と採用の確認
実際の依頼文は、BambooHRの例文に沿った形で書けます。次のように、種類の確認から始めると、名前の食い違いを避けられます。
うちの休暇の種類を一覧にして。
そのうえで、来月の最終週に、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上で同じ変更をする権限があるか確認する。承認ワークフローは迂回されない |
| 旧いハイフン区切りのツール名が表示される | 原因と対処ツール一覧を更新する。直らなければ再接続するか、コネクタを追加し直す |
組織で管理されたコネクタでは、ツール一覧の更新に、管理者がコネクタのツールを更新する作業が要ることがあります。表の最後の行で直らないときは、管理者に頼みます。
現在の制約と、自前のMCPクライアントから使うとき
MCPサーバー文書は、現在の制約を6つ挙げています。
- すべての機能は公開されておらず、一部のツールだけがある
- 事前組み込みのコネクタを使わないクライアントは、開発者ポータルでアプリを作って手動登録する。動的なクライアント登録はない
- 手動で作ったベアラートークンは1時間で失効し、取り替えが要る
- 目標は従業員単位で、会社全体への問い合わせはない
- 承認やワークフローが要る変更は、BambooHR既存の流れに従い、その場では完了しない
- 権限による一部の結果は、必ずしも明示されない
自前のアプリやエージェントをつなぐ場合の入口は、開発者ポータルです。アプリを作ってリダイレクトURIを設定し、mcp スコープと、必要なデータの範囲を表すスコープ(例としてemployees・time_off・payroll・benefits)を要求します。mcp スコープは、新しいアプリにはすべて使えます。BambooHRの製品の中からアプリを作ることは、今のところできません。AI Connectorsアプリの有効化という関門も、他のクライアントにも広げる方針です。
文書が挙げる今後の方向は、ツール領域の追加、手作業の認証情報を要らなくする簡単な接続、現在のユーザーとその権限を返すユーティリティ、MCPアクセスに対する管理者の細かな制御の4つです。ベータ期間の仕様は変わりうるため、ツールの数や名前は、接続した時点のディレクトリの表示で確かめてください。
人事系のコネクタには、目的が違うものがあります。BambooHRは、社員の記録・休暇・目標・採用という日々の業務データを直接読み書きします。人事データの分析を主目的にするなら、ClaudeとVisierの連携が別の切り口です。営業側の記録を会話で更新するPipedriveやZoho CRMのコネクタと構造は似ています。共通点は、認証したユーザーの権限で動く点と、書き込みを組織側で絞れる点です。
まとめ
導入の最初の作業は、Claudeでなく管理画面にあります。AI Connectorsアプリが有効で、本人が対象の範囲に入っていなければ、Claude側では何も進みません。
運用では、参照だけで始め、必要になった書き込みを1つずつ開ける順序が無理のない進め方です。delete_goal のように取り消せないものがあるためです。人数が合わないときは、バグより先に権限を疑ってください。
参照した一次ソース
この記事の記述は、次の一次ソースと照合しています。更新時に参照先が変わった場合は一覧も更新します。