open-greenhouse-mcp

适用于 Greenhouse 的生产级 MCP 服务器，专为招聘人员和招聘团队设计。

大多数 Greenhouse MCP 服务器只是逐个镜像 API 端点。而此服务器专为招聘团队打造：提供安全默认设置、基于角色的配置文件，以及将多步 API 操作转化为单一动作的工作流工具。

选择配置文件

快速入门

pip install open-greenhouse-mcp

添加到您的 MCP 客户端配置中（Claude Desktop: ~/Library/Application Support/Claude/claude_desktop_config.json，Cursor: 设置 > MCP）：

{
  "mcpServers": {
    "greenhouse": {
      "command": "open-greenhouse-mcp",
      "env": {
        "GREENHOUSE_API_KEY": "your-harvest-api-key",
        "GREENHOUSE_TOOL_PROFILE": "read-only"
      }
    }
  }
}

建议先以只读模式启动以验证连接和工具行为，然后在需要写入权限时切换到 recruiter 或 full 模式。

您的 API 密钥位于 Greenhouse 的“配置 (Configure) > 开发中心 (Dev Center) > API 凭据管理 (API Credential Management)”中。

您可以询问的内容

• “显示我们高级工程师职位的招聘流程”

• “本周有哪些人需要我关注？”

• “后端实习生职位的转化率是多少？”

• “找到 Sarah Chen 并调出她的简历”

• “哪些渠道真正带来了录用？”

• “批量拒绝客户经理职位上所有超过 30 天未活动的申请”

查看 更多带有完整输出的示例。

查看演示

安全性

• 访问权限受限于您的 Greenhouse API 密钥权限

• 首次设置建议使用只读配置文件

• 破坏性操作需要明确的 ID — 服务器绝不会自动推断目标

• 写入操作支持通过 GREENHOUSE_ON_BEHALF_OF 进行审计归因

• 批量操作受速率限制，以确保在 API 限制范围内

兼容性

启动

服务器启动时会记录其配置：

open-greenhouse-mcp v0.3.0
Profile: recruiter | Tools: 121 | Writes: recruiter-safe | APIs: harvest, ingestion

包含内容

• 招聘人员工作流工具 — 13 个用于流程视图、分析、搜索和批量操作的复合工具

• Harvest API 覆盖 — 涵盖候选人、申请、职位、录用通知、面试等功能的 148 个工具

• 招聘门户 API — 13 个用于公共职位列表和申请提交的工具

• 可选的 Webhook 和数据摄取 — 14 个用于事件驱动工作流和合作伙伴集成的工具

参考

复合工具

将多个 API 调用组合为单一操作的高级工具。

配置文件详情

Recruiter 包含所有读取工具、所有复合工作流以及招聘人员安全写入操作：拒绝、推进、录用、移动、标记、备注、附件、面试、潜在候选人及批量操作。它不包含职位创建、用户管理、自定义字段配置、候选人删除和 Webhook 管理。

Read-only 跳过所有写入操作。GREENHOUSE_READ_ONLY=true 也可作为简写使用。

配置

日志记录

用于可观测性的结构化 JSON 日志。设置 GREENHOUSE_LOG_LEVEL=info 以启用：

{"ts": "2026-04-14T12:31:58", "level": "info", "event": "api_call", "method": "GET", "url": "...", "status": 200, "latency_ms": 245.0}

更多文档

• API 参考 — 按类别划分的完整工具说明

• 使用示例 — 带有完整输出的真实对话

• 高级设置 — Webhook 接收器、摄取 API、门户令牌模式

• 开发 — 贡献、测试、项目结构

反馈

• Bug 和功能建议： 提交 Issue

• 问题咨询： 发起讨论

• 安全性： 参阅 SECURITY.md

• 贡献： 参阅 CONTRIBUTING.md

许可证

MIT 许可证 -- Ben Monopoli。参阅 LICENSE。