open-greenhouse-mcp

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

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

选择配置文件

Related MCP server: Greenhouse MCP Server by CData

快速入门

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 Credential Management 中。

您可以询问的内容

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

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

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

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

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

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

• “筛选这位后端工程师职位的候选人——给我完整的情况”

• “在我们的工程招聘流程中搜索任何具有 Rust 和分布式系统经验的人”

• “自昨天以来有哪些新的申请？”

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

查看实际操作

安全性

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

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

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

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

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

兼容性

启动

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

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

包含的内容

• 筛选与寻源工具 — 6 个用于候选人筛选、布尔关键词简历搜索、每日摘要和位置检测的工具

• 招聘人员工作流工具 — 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、Board-token 模式

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

反馈

• Bug 和功能： 提交 Issue

• 问题： 发起讨论

• 安全： 查看 SECURITY.md

• 贡献： 查看 CONTRIBUTING.md

许可证

MIT 许可证 -- Ben Monopoli。查看 LICENSE。