open-greenhouse-mcp

Готовый к работе MCP-сервер для Greenhouse, разработанный для рекрутеров и команд найма.

Большинство MCP-серверов для Greenhouse просто зеркалируют 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: Settings > MCP):

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

Запустите в режиме «только чтение» (read-only), чтобы проверить подключение и работу инструментов, а затем переключитесь на recruiter или full, когда потребуется доступ к записи.

Ваш API-ключ находится в Greenhouse в разделе Configure > Dev Center > API Credential Management.

О чем можно спросить

• «Покажи мне воронку для вакансии Senior Engineer»

• «Кому нужно уделить внимание на этой неделе?»

• «Какова конверсия для вакансии Backend Intern?»

• «Найди Сару Чен и открой её резюме»

• «Какие источники действительно приносят нанятых сотрудников?»

• «Массово отклонить всех неактивных более 30 дней по вакансии Account Manager»

• «Проведи скрининг этого кандидата на вакансию Backend Engineer — дай мне полную картину»

• «Поищи в наших инженерных воронках кандидатов с опытом работы с Rust и распределенными системами»

• «Какие новые заявки поступили со вчерашнего дня?»

Смотрите больше примеров с полным выводом.

Посмотрите в действии

Безопасность

• Доступ ограничен правами вашего API-ключа Greenhouse

• Для первой настройки рекомендуется профиль «только чтение»

• Деструктивные действия требуют явного указания 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 инструментов для работы с кандидатами, заявками, вакансиями, офферами, собеседованиями и многим другим

• Job Board API — 13 инструментов для публичных вакансий и подачи заявок

• Опциональные вебхуки и загрузка данных — 14 инструментов для событийных рабочих процессов и интеграций с партнерами

Справочник

Инструменты скрининга и поиска

Инструменты для оценки кандидатов и проактивного поиска талантов.

Композитные инструменты

Инструменты высокого уровня, объединяющие несколько вызовов API в одну операцию.

Детали профилей

Recruiter включает все инструменты чтения, все инструменты скрининга/поиска, все композитные рабочие процессы и безопасные операции записи: отказ, перевод на этап, наем, перемещение, тегирование, заметки, вложения, собеседования, потенциальные кандидаты и массовые операции. Исключает создание вакансий, управление пользователями, настройку пользовательских полей, удаление кандидатов и управление вебхуками.

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 Reference — Полный разбор инструментов по категориям

• Usage Examples — Реальные диалоги с полным выводом

• Advanced Setup — Приемник вебхуков, API загрузки, режим board-token

• Development — Вклад в проект, тестирование, структура проекта

Обратная связь

• Баги и функции: Открыть issue

• Вопросы: Начать обсуждение

• Безопасность: См. SECURITY.md

• Вклад в проект: См. CONTRIBUTING.md

Лицензия

MIT License -- Ben Monopoli. См. LICENSE.