MCP-сервер Huntflow
huntflow-mcp
MCP-сервер для ATS Huntflow: вакансии, кандидаты, резюме и этапы подбора через ИИ-агента вместо ручных карточек
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Все инструменты только читают данные, изменений в Huntflow нет
- Токен дает доступ к персональным данным кандидатов, храните его как секрет
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/huntflow-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio --env 'HUNTFLOW_TOKEN=<ваш HUNTFLOW_TOKEN>' huntflow -- npx -y @theyahia/huntflow-mcpИли добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"huntflow","type":"stdio","command":"npx","args":["-y","@theyahia/huntflow-mcp"],"env":{"HUNTFLOW_TOKEN":"<ваш HUNTFLOW_TOKEN>"}}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"huntflow": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Выполните в терминале
codex mcp add huntflow --env 'HUNTFLOW_TOKEN=<ваш HUNTFLOW_TOKEN>' -- npx -y @theyahia/huntflow-mcpИли добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.huntflow]
command = "npx"
args = ["-y", "@theyahia/huntflow-mcp"]
env = { HUNTFLOW_TOKEN = "<ваш HUNTFLOW_TOKEN>" }Если файл уже есть, допишите блок в конец.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"huntflow": {
"type": "local",
"command": [
"npx",
"-y",
"@theyahia/huntflow-mcp"
],
"environment": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"huntflow": {
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": [
"-y",
"@theyahia/huntflow-mcp"
],
"env": {
"HUNTFLOW_TOKEN": "<ваш HUNTFLOW_TOKEN>"
}
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Ключи и настройки
HUNTFLOW_TOKENсекрет, обязательнаяHUNTFLOW_REFRESH_TOKENсекрет, необязательная
Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.
Создай токен в разделе API-токены настроек Huntflow, задай переменные HUNTFLOW_TOKEN и HUNTFLOW_REFRESH_TOKEN, затем подключи сервер командой npx -y @theyahia/huntflow-mcp в конфигурации MCP клиента.
Другие способы из описания автора
{
"mcpServers": {
"huntflow": {
"command": "npx",
"args": ["-y", "@theyahia/huntflow-mcp"],
"env": {
"HUNTFLOW_TOKEN": "ваш-access-token",
"HUNTFLOW_REFRESH_TOKEN": "ваш-refresh-token"
}
}
}
}Конфигурация из README для Claude Desktop.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер обращается к API Huntflow по access и refresh токену и дает агенту 14 инструментов чтения: список аккаунтов, вакансии с фильтрами по статусу и своим вакансиям, карточка вакансии, поиск кандидатов и список кандидатов по вакансии, карточка кандидата, его резюме, этапы воронки подбора, сотрудники, справочники источников, причин отказа, подразделений и тегов. Два скилла для Claude Code показывают кандидатов на вакансию таблицей и статистику воронки. Сервер сам обновляет access-токен через refresh при истечении и сохраняет обновленную пару в файл состояния, чтобы не запрашивать токен заново после перезапуска.
Для кого. Для рекрутеров и HR-менеджеров, которые ведут подбор в Huntflow и хотят получать сводки по вакансиям и кандидатам через агента.
Подходит, если
- Нужно быстро узнать, кто из кандидатов застрял на определенном этапе воронки
- Нужна статистика по вакансии: сроки, конверсия, количество кандидатов
- Нужно прочитать резюме кандидата без входа в интерфейс Huntflow
Не подходит, если
- Нужно создавать вакансии, менять этапы кандидатов или другие данные: все 14 инструментов только читают
- В компании не используется Huntflow
Пример запроса к агенту
Покажи, кто из кандидатов на вакансию застрял на этапе технического интервью в HuntflowОграничения
Проект одного автора, часть серии WWmcp. Все инструменты только читают данные, писать в Huntflow сервер не умеет. Access-токен живет около недели, refresh-токен около двух недель, без refresh-токена потребуется вручную обновлять доступ. Клиентский лимит 10 запросов в секунду можно отключить переменной окружения.
Как отключить. Удалите сервер huntflow из конфигурации MCP клиента.
MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| HUNTFLOW_TOKEN обязательная, секрет | Access-токен API Huntflow. |
| HUNTFLOW_REFRESH_TOKEN секрет | Refresh-токен для автообновления доступа при истечении. |
Проверка безопасности
- Все инструменты только читают данные, изменений в Huntflow нет
- Токен дает доступ к персональным данным кандидатов, храните его как секрет
Коротко о README
README на русском описывает конфигурации для Claude Desktop, Streamable HTTP и установку через Smithery, дает таблицу из 11 переменных окружения и 14 инструментов с пометкой, что списки возвращают урезанный набор полей для экономии токенов, а полный ответ доступен флагом raw. Отдельно описан механизм автообновления токена и два скилла Claude Code. Часть серии WWmcp того же автора.
Частые вопросы
Что будет, если задать только access-токен без refresh?
Сервер проработает до истечения access-токена, примерно неделю, а затем потребуется новый токен.
Можно ли через сервер изменить этап кандидата?
Нет, все 14 инструментов только читают данные вакансий, кандидатов и справочников.
Похожие
Официальный MCP-сервер Salesforce DX: работа с org, метаданными, данными, пользователями и тестами Apex из агента
Официальный набор скиллов Яндекса: каталог, цены, остатки, заказы, витрина и еженедельная ревизия магазина на Яндекс.Кит через Claude Code или Codex
YouGile MCP от Indalo
YouGile MCP
Полное покрытие API YouGile из 65 операций с настраиваемыми правами, подтверждением записи и общим лимитом на компанию
Официальный MCP конкретного портала Битрикс24: внешний агент по OAuth или токену читает и меняет задачи, сделки, встречи и письма