hiring-mender-mcp

Hiring Mender MCP — 面向 AI Agent 的 BambooHR 和 Greenhouse ATS 写入工具

一款免费的本地 MCP 服务，可在 BambooHR 和 Greenhouse 中创建候选人、推进／移动申请并拒绝候选人——在两个平台上使用一致的工具术语，免去分别手动编写两套 ATS 集成。

如果你正在构建 AI 招聘工作流，却不断为 BambooHR 的 OAuth API 和 Greenhouse 的 Basic Auth Harvest API 重写相同的候选人创建／阶段推进逻辑，那么这款 MCP 服务正是为解决这个问题而设计的。

它解决的问题

BambooHR 的 Applicant Tracking API 和 Greenhouse 的 Harvest API 都支持实际写入操作——创建候选人、让候选人通过招聘流程阶段、拒绝申请——但两者使用完全不同的身份验证方案（OAuth 2.0 Bearer 令牌与密码为空的 HTTP Basic Auth），字段名称和端点结构也完全不同。目前没有免费的开源工具能通过一组调用统一这两个平台。这款工具正是为此而生。

工具

• create_candidate — 创建新的候选人／申请。BambooHR：firstName、lastName、jobId 等。Greenhouse：first_name、last_name、job_id 等。
• advance_application — 将候选人移至新的阶段／状态。BambooHR 使用数字状态 ID（先调用 list_statuses）。Greenhouse 使用 from_stage_id（必填，可防止基于过期信息进行移动）和 to_stage_id／to_job_id。
• reject_application — 拒绝候选人（仅限 Greenhouse；BambooHR 的拒绝操作需通过 advance_application 并使用拒绝状态 ID 完成）。
• list_statuses — 列出有效的 BambooHR 申请人状态 ID，或某个职位的 Greenhouse 候选人。
• list_candidates — 列出候选人／申请，可按职位 ID 筛选。

设置

1. 安装 Node.js（v18+）：https://nodejs.org

2. 克隆并安装：

git clone https://github.com/headlessherm-creator/hiring-mender-mcp.git
cd hiring-mender-mcp
npm install

3. 获取 API 凭据：

• **BambooHR：**需要具有 hiring:applications.write 范围的 OAuth 2.0 访问令牌。请参阅 BambooHR 的 OAuth 文档。
• **Greenhouse：**需要 Harvest API 密钥。该密钥须由拥有“Can manage ALL organization's API Credentials”权限的用户通过 Configure → Dev Center → API Credential Management 创建。请参阅 Greenhouse 的 Harvest API 文档。

4. 设置环境变量：

export BAMBOOHR_COMPANY_DOMAIN=yourcompany
export BAMBOOHR_ACCESS_TOKEN=your_oauth_token
export GREENHOUSE_HARVEST_API_TOKEN=your_harvest_token

你只需为所用的平台设置相应变量。

5. 将 MCP 客户端指向此服务：

{
  "mcpServers": {
    "hiring-mender": {
      "command": "node",
      "args": ["/path/to/hiring-mender-mcp/src/index.js"],
      "env": {
        "BAMBOOHR_COMPANY_DOMAIN": "yourcompany",
        "BAMBOOHR_ACCESS_TOKEN": "your_oauth_token",
        "GREENHOUSE_HARVEST_API_TOKEN": "your_harvest_token"
      }
    }
  }
}

常见客户端的设置文档：

• Claude Desktop：https://modelcontextprotocol.io/quickstart/user
• Cursor：https://docs.cursor.com/context/model-context-protocol
• Claude Code：https://docs.claude.com/en/docs/claude-code/mcp

安全说明

Greenhouse Harvest API 密钥在你授予的权限范围内不作细分——创建密钥时启用的每种端点类型都可通过该密钥访问，而不仅限于此工具使用的端点。请创建一个只包含此工具所需端点（候选人、申请）的 Harvest 密钥，而不要重复使用权限范围过广的现有密钥。BambooHR OAuth 范围也需同样谨慎——只请求 hiring:applications.write，不要申请更广泛的人力资源数据访问权限。

此服务会使用你提供的凭据，直接向 BambooHR 和 Greenhouse 的 API 发起真实网络请求。与完全本地的工具不同，你的数据会离开你的设备，直接发送给你正在使用的 ATS 供应商。此过程不涉及第三方、遥测或日志记录。

关键词

BambooHR MCP 服务、Greenhouse MCP 服务、ATS MCP 服务、申请人跟踪系统 AI Agent、招聘自动化 MCP、人力资源 MCP 服务、招聘流程自动化、候选人管理 MCP、Claude MCP 招聘工具。

相关工具

秉持相同的本地优先理念，解决不同问题：

• polymath-megablaster-mcp — 确定性数学运算、日期、单位换算、网络
• json-mender-mcp — 修复格式错误的 JSON、验证 JSON Schema、测试正则表达式
• helpdesk-mender-mcp — Zendesk + Freshdesk + Help Scout 写入工具，统一术语

许可证

MIT