BambooHR集成工具

让克劳德完全访问你的BambooHR——员工、休假、招聘、福利、培训等等。

A. 模型上下文协议 将克劳德连接到BambooHR的服务器。安装一次，然后用简单的英语与您的人力资源数据交谈——没有仪表板，也没有手动导出。

"Who's out next week?"
"Onboard Sarah Chen starting Monday — Engineering, reports to Maria."
"Show training compliance for the Sales team."
"Approve all pending PTO requests for my team."
"What's our average time-to-fill for engineering roles?"

包含什么

快速入门

步骤1-获取BambooHR API密钥

1. 登录BambooHR
2. 单击您的个人资料图标（右上角）> API密钥
3. 点击 添加新密钥，命名并复制它

您的子域是BambooHR URL中的前缀，例如。 acme 从 acme.bamboohr.com.

步骤2--添加到Claude桌面

编辑您的配置文件：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• 窗户： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "bamboohr": {
      "command": "npx",
      "args": ["-y", "bamboohr-mcp"],
      "env": {
        "BAMBOOHR_API_KEY": "your-api-key-here",
        "BAMBOOHR_SUBDOMAIN": "your-company-subdomain"
      }
    }
  }
}

重新启动克劳德桌面。

步骤3--或添加到Claude代码（CLI）

claude mcp add bamboohr \
  -e BAMBOOHR_API_KEY=your-api-key-here \
  -e BAMBOOHR_SUBDOMAIN=your-company-subdomain \
  -- npx -y bamboohr-mcp

步骤4——验证

打开克劳德，问： “显示BambooHR员工目录”

可用工具

技能——基于角色的工作流

技能是预先构建的提示，可以端到端地处理常见的人力资源工作流程。将它们复制到 ~/.claude/skills/ 在Claude Code中使用它们。

# Install all skills at once
cp -r skills/* ~/.claude/skills/

🗂️ 人力资源管理员

适用于负责日常人力资源运营的人员。

📈 人力资源经理/HRBP

用于战略性人力资源可见性、分析和报告。

🎯 招聘/人才招聘

用于管理职位空缺、候选人和招聘渠道。

👔 经理/团队负责人

用于团队级别的可见性和日常审批。

🙋 员工自助服务

适用于管理自己人力资源需求的员工。

💼 工资和福利管理

用于管理福利登记和薪酬数据。

🎓 培训与L&D

用于跟踪学习计划和合规性。

⚡ 自动化管理员

适用于通过webhooks将BambooHR与其他系统集成的团队。

发展

git clone https://github.com/acalder-techpm/bamboohr-mcp
cd bamboohr-mcp
npm install
npm run build

本地测试：

export BAMBOOHR_API_KEY=your-key
export BAMBOOHR_SUBDOMAIN=your-subdomain
node dist/index.js

与MCP Inspector的交互式测试：

npx @modelcontextprotocol/inspector node dist/index.js

认证

BambooHR使用HTTP基本Auth，并将您的API密钥作为用户名。此服务器自动处理它——只需设置 BAMBOOHR_API_KEY.

提示： API密钥继承创建它们的用户的权限。使用管理员用户密钥进行完全访问，或使用受限用户密钥进行只读集成。

要创建密钥，请执行以下操作： BambooHR>配置文件图标>API密钥>添加新密钥

例子

以下是三个真实世界的示例，展示了Claude如何使用此MCP服务器。

示例1：检查团队可用性

你说： “下周谁将加入工程团队？”

发生了什么： 克劳德打电话来 bamboohr_get_whos_out 使用下周的日期范围，然后与进行交叉引用 bamboohr_list_employees 已过滤到Engineering。它返回的摘要如下：

下周工程部门将有3人离职：

• 陈莎拉 -PTO周一至周三
• 詹姆斯公园 -周一病假
• Lisa Nguyen -PTO全周

15名团队成员中有12名可用。

示例2：新员工入职

你说： “从3月17日开始，Maria Torres将担任平台软件工程师，向奥斯汀办公室的Alex Kim汇报工作。”

发生了什么： 克劳德打电话来 bamboohr_create_employee 根据提供的详细信息，然后致电 bamboohr_assign_time_off_policies 设置标准PTO。它返回：

已为创建员工记录 玛利亚·托雷斯 （ID:4521）

• 部门：平台
• 职位名称：软件工程师
• 地点：德克萨斯州奥斯汀
• 主管：Alex Kim
• 开始日期：2026年3月17日
• 分配的PTO政策：标准PTO、病假、公司假期

示例3：培训合规性报告

你说： “告诉我谁在人力资源部的HIPAA培训上逾期了。”

发生了什么： 克劳德打电话来 bamboohr_list_employees 那么，请联系人力资源部成员 bamboohr_get_employee_trainings 每个人都要检查HIPAA完成状态。它返回：

HIPAA培训合规性-人力资源部

8名团队成员中有2名逾期：

• 汤姆·里维拉 -2026年2月15日到期（逾期22天）
• 艾米·沃尔什 -2026年3月1日到期（逾期9天）

现有6名成员。下次续约到期日：2026年6月（李）。

隐私政策

此MCP服务器充当Claude和您的BambooHR帐户之间的本地桥梁。以下是数据的处理方式：

• 没有数据收集。 此服务器不会收集、存储或向第三方传输任何数据。它不会给家里打电话、发送分析或登录外部服务。
• 仅限本地执行。 服务器作为本地stdio进程在您的计算机上运行。所有API调用都直接从您的机器转到BambooHR的API(api.bamboohr.com).
• 凭证保留在本地。 你的 BAMBOOHR_API_KEY 和 BAMBOOHR_SUBDOMAIN 从本地环境变量中读取，并且从不在BambooHR的API之外的任何地方进行持久化、日志记录或传输。
• BambooHR的隐私政策适用。 从BambooHR API返回的数据受 BambooHR的隐私政策。此服务器不缓存或保留任何API响应。
• 您控制访问权限。 BambooHR中API密钥的权限决定了此服务器可以访问哪些数据。使用受限权限密钥限制范围。

支持

• 问题： github/acalder-techpm/bamboohr-mcp/issues
• 电子邮件： adam.calder@bamboohr.com
• 讨论： github/acalder-techpm/bamboohr-mcp/discussions

贡献

PR欢迎。如果添加新工具或技能，请遵循中的现有模式 src/tools/ 和 skills/ 并打开一个带有用例简要描述的拉取请求。

许可证

麻省理工学院 --用☕ 和克劳德。