open-greenhouse-mcp

PyPI Python 3.10+ License: MIT open-greenhouse-mcp MCP server

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

Большинство MCP-серверов для Greenhouse просто зеркалируют API эндпоинт за эндпоинтом. Этот сервер создан специально для команд рекрутинга: безопасные настройки по умолчанию, профили на основе ролей и инструменты для рабочих процессов, которые превращают многошаговые операции API в единые действия.

Выбор профиля

Профиль	Инструменты	Можно записывать?	Рекомендуется для
`read-only`	97	Нет	Первичная настройка, отчетность, нанимающие менеджеры
`recruiter`	121	Да (безопасные операции)	Повседневная работа рекрутера
`full`	175	Да (все)	Администраторы, операционный отдел, продвинутая автоматизация

Быстрый старт

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"

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

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

Демо

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

Доступ ограничен правами вашего API-ключа Greenhouse
Для первой настройки рекомендуется профиль «только чтение»
Деструктивные действия требуют явного указания ID — сервер никогда не угадывает цели
Операции записи поддерживают аудит через GREENHOUSE_ON_BEHALF_OF
Массовые действия ограничены по частоте запросов, чтобы не превышать лимиты API

Совместимость

Клиент	Статус
Claude Desktop	Поддерживается
Claude Code	Поддерживается
Cursor	Поддерживается
Транспорт	stdio
Python	3.10+

Запуск

При запуске сервер логирует свою конфигурацию:

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

Что включено

Инструменты для рабочих процессов рекрутера — 13 составных инструментов для просмотра воронок, аналитики, поиска и массовых операций
Покрытие Harvest API — 148 инструментов для работы с кандидатами, заявками, вакансиями, офферами, собеседованиями и многим другим
Job Board API — 13 инструментов для публичных вакансий и подачи заявок
Опциональные вебхуки и загрузка данных — 14 инструментов для событийно-ориентированных рабочих процессов и интеграций с партнерами

Справочник

Составные инструменты

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

Инструмент	Что делает
`pipeline_summary`	Полный обзор воронки — кандидаты сгруппированы по этапам с именами и количеством дней на этапе
`candidates_needing_action`	Поиск зависших заявок и собеседований, по которым отсутствуют оценочные листы
`stale_applications`	Заявки без активности в течение N дней, отсортированные по давности
`pipeline_metrics`	Конверсия, показатели найма/отказов, время нахождения на этапе
`source_effectiveness`	Какие источники кандидатов дают лучшие показатели найма
`time_to_hire`	Среднее, медианное, мин/макс количество дней от заявки до найма
`bulk_reject`	Массовый отказ по нескольким заявкам за один вызов с учетом лимитов API
`bulk_tag`	Массовое добавление тегов кандидатам за один вызов
`bulk_advance`	Массовое продвижение заявок на следующий этап
`search_candidates_by_name`	Поиск кандидатов по имени или фамилии
`search_candidates_by_email`	Поиск кандидата по точному email
`read_candidate_resume`	Скачивание и возврат последнего резюме кандидата
`download_attachment`	Скачивание любого вложения Greenhouse по URL

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

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

Read-only пропускает все операции записи. GREENHOUSE_READ_ONLY=true также работает как сокращение.

Конфигурация

Переменная	Обязательно	Описание
`GREENHOUSE_API_KEY`	Да*	Ключ Harvest API
`GREENHOUSE_BOARD_TOKEN`	Да*	Слаг URL доски вакансий. *Требуется хотя бы один
`GREENHOUSE_TOOL_PROFILE`	Нет	`full` (по умолчанию), `recruiter` или `read-only`
`GREENHOUSE_ON_BEHALF_OF`	Нет	ID пользователя Greenhouse для аудита записи
`GREENHOUSE_LOG_LEVEL`	Нет	`debug`, `info`, `warning` (по умолчанию), `error`
`GREENHOUSE_LOG_FILE`	Нет	Путь к файлу логов (по умолчанию stderr)

Логирование

Структурированное 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 — Полный разбор инструментов по категориям
Примеры использования — Реальные диалоги с полным выводом
Продвинутая настройка — Приемник вебхуков, API загрузки, режим board-token
Разработка — Вклад в проект, тестирование, структура проекта

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

Баги и функции: Открыть issue
Вопросы: Начать обсуждение
Безопасность: См. SECURITY.md
Вклад в проект: См. CONTRIBUTING.md

Лицензия

Лицензия MIT -- Ben Monopoli. См. LICENSE.

Greenhouse MCP