hh-mcp-ru: 133 метода API hh.ru с гейтом на запись

hh-mcp-ru

MCP-сервер по официальному API hh.ru с каталогом из 133 методов, поиском метода словами и обязательным подтверждением перед записью или необратимым действием

MCP-серверРоссийский стек

ilyautov/hh-mcp-ruАвтор:Ilya Utov

Установка

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/hh-mcp-ru

Определит агенты на машине, проверит риск и зафиксирует версию.

Другие способы установки

Выполните в терминале

claude mcp add --transport stdio hh-mcp-ru -- uvx hh-mcp-ru==0.3.0

Или добавьте в файл .mcp.json, в проекте

{
  "mcpServers": {
    "hh-mcp-ru": {
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в Cursor

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Добавьте в файл ~/.cursor/mcp.json, для всех проектов

{
  "mcpServers": {
    "hh-mcp-ru": {
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Установить в VS Code

Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.

Выполните в терминале

code --add-mcp '{"name":"hh-mcp-ru","type":"stdio","command":"uvx","args":["hh-mcp-ru==0.3.0"]}'

Или добавьте в файл .vscode/mcp.json, в проекте

{
  "servers": {
    "hh-mcp-ru": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа servers.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

codex mcp add hh-mcp-ru -- uvx hh-mcp-ru==0.3.0

Или добавьте в файл ~/.codex/config.toml, для всех проектов

[mcp_servers.hh-mcp-ru]
command = "uvx"
args = ["hh-mcp-ru==0.3.0"]

Если файл уже есть, допишите блок в конец.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Выполните в терминале

gemini mcp add -s user hh-mcp-ru uvx hh-mcp-ru==0.3.0

Или добавьте в файл ~/.gemini/settings.json, для всех проектов

{
  "mcpServers": {
    "hh-mcp-ru": {
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов

{
  "mcpServers": {
    "hh-mcp-ru": {
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Бывший Windsurf.

Добавьте в файл cline_mcp_settings.json, для всех проектов

{
  "mcpServers": {
    "hh-mcp-ru": {
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .roo/mcp.json, в проекте

{
  "mcpServers": {
    "hh-mcp-ru": {
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Форк Roo Code, папки .roo те же.

Добавьте в файл opencode.json, в проекте

{
  "mcp": {
    "hh-mcp-ru": {
      "type": "local",
      "command": [
        "uvx",
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcp.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл ~/.config/zed/settings.json, для всех проектов

{
  "context_servers": {
    "hh-mcp-ru": {
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа context_servers.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Добавьте в файл .codeassistant/mcp.json, в проекте

{
  "mcpServers": {
    "hh-mcp-ru": {
      "command": "uvx",
      "args": [
        "hh-mcp-ru==0.3.0"
      ]
    }
  }
}

Если файл уже есть, добавьте сервер внутрь ключа mcpServers.

Ключи и настройки

HH_TOKENсекрет, необязательная: Токен приложения hh.ru (dev.hh.ru → Мои приложения).
HH_APP_NAMEнеобязательная: Имя приложения и контактный email для заголовка HH-User-Agent: без него hh отклоняет запросы.

Замените значения в угловых скобках своими. Ключи не попадают в ссылки установки и не хранятся у нас.

Понадобится: uv

Сверено с репозиторием 25 сент. 2026, коммит 1c6bf53.

Текст для агента

Получи токен на dev.hh.ru → Мои приложения → создать приложение, установи сервер командой uvx hh-mcp-ru, пропиши в конфиге MCP клиента переменные HH_TOKEN и обязательно HH_APP_NAME, затем ищи нужный метод через hh_search_methods и подтверждай запись через confirm_write при вызове hh_write_method.

Другие способы из описания автора

uvx hh-mcp-ru

Запуск без установки через uv, для клиентов с терминалом.

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Каталог из 133 методов собран напрямую из официальной OpenAPI-спеки hh.ru (api.hh.ru/openapi/specification/public) и лежит в репозитории файлом hh_mcp/endpoints.yaml, поэтому таблица методов не может разойтись с кодом: 92 на чтение, 32 на запись, 9 необратимых. Вместо 133 отдельных инструментов агенту доступно несколько универсальных: hh_search_methods ищет нужный метод по словам, hh_describe_method показывает параметры и класс доступа, hh_call_method читает без подтверждения, hh_write_method требует передать confirm_write, а необратимые действия требуют подтверждения дважды. Сервер умеет несколько кабинетов hh и хранит их в ~/.ru-mcp/cabinets.json с правами доступа 600 вне репозитория. Команда uvx hh-mcp-ru doctor проверяет установку и ключи без раскрытия секретов, а с флагом --live делает один дешевый реальный запрос на чтение.

Для кого. Для HR-менеджеров и рекрутеров с приложением hh.ru, которым нужен полный официальный API в чате с агентом, но с подтверждением перед любым изменением вакансии или откликом.

Подходит, если

Нужен полный официальный API hh.ru: вакансии, отклики, резюме, справочники, статистика зарплат, а не только его часть
Важно, чтобы запись и необратимые действия требовали явного подтверждения, а не выполнялись сразу
Нужно выгрузить свои вакансии и отклики за период или посмотреть зарплаты конкурентов перед публикацией

Не подходит, если

Нет доступа к dev.hh.ru и приложению hh.ru с токеном: сервер работает только по официальному API с токеном
Нужна автоматизация в обход официального API, например авто-отклик через эмуляцию браузера: этот сервер строго идет через API hh.ru
Нужен статичный список инструментов на каждый метод: здесь три-четыре универсальных инструмента вместо 133

Пример запроса к агенту

Выгрузи мои вакансии и отклики по ним за последний месяц и сведи в таблицу

Ограничения

Нужен токен приложения hh.ru с dev.hh.ru и обязательно заполненный HH_APP_NAME, иначе hh.ru отклоняет запросы с непонятным User-Agent ошибкой 400. Проект от одного автора, часть общей платформы из нескольких MCP-серверов (vk-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru, marketplaces-mcp-ru) на общем ядре schema-mcp-core. Из 133 методов 9 помечены как необратимые, и даже двойное подтверждение не защищает от ошибки в самом запросе.

Как отключить. Удалите блок hh-mcp из mcpServers в конфигурации клиента и файл ~/.ru-mcp/cabinets.json с сохраненными ключами.

MCP

Транспорт: stdio
Авторизация: API-ключ

Переменные окружения
Переменные окружения
HH_TOKEN обязательная, секрет	Токен приложения hh.ru, выдается на dev.hh.ru в разделе Мои приложения.
HH_APP_NAME обязательная	Имя приложения и контактный email для заголовка HH-User-Agent, обязателен: без него hh.ru отклоняет запросы ошибкой 400.

Проверка безопасности

Дает доступ к 32 методам записи и 9 необратимым действиям вроде удаления, хотя все они требуют подтверждения
Токен приложения hh.ru дает доступ к вакансиям, откликам и переписке с кандидатами и должен храниться как секрет

Коротко о README

README описывает каталог из 133 методов, собранный из официальной спеки hh.ru, с разбивкой на разделы и классами доступа для каждого. Показаны два способа установки: файл .mcpb для Claude Desktop без терминала и uvx для остальных клиентов, получение токена на dev.hh.ru, таблица переменных окружения и диагностическая команда doctor. Отдельный раздел безопасности объясняет три класса доступа и подтверждение перед записью, раздел privacy policy подтверждает отсутствие телеметрии. Автор ведет семейство похожих MCP-серверов для других российских сервисов на общем ядре. Лицензия MIT.

Частые вопросы

Может ли сервер опубликовать или удалить вакансию без спроса?

Нет, запись требует передать confirm_write, а необратимые действия вроде удаления требуют подтверждения дважды.

Почему hh.ru отвечает ошибкой 400 сразу после установки?

Скорее всего не заполнена переменная HH_APP_NAME: hh.ru отклоняет запросы без внятного заголовка HH-User-Agent.

SiYuan

Официальный

Самостоятельно размещаемая база знаний с блочными ссылками и встроенным MCP-сервером для подключения AI-агентов к заметкам

MCP-серверСредний риск46,5 тыс.

gws

Выбор редакции

CLI для всех API Google Workspace с выводом в JSON и набором скиллов для агентов: Drive, Gmail, Calendar, Sheets и другие

CLIВысокий риск31,2 тыс.

QMD

Выбор редакции

Локальный поиск по заметкам, документации и расшифровкам встреч в Markdown: ключевые слова, смысловой поиск и ранжирование, есть MCP

CLIСредний рискБез VPN30,1 тыс.

Taskmaster

Выбор редакции

Менеджер задач для AI-разработки: разбирает PRD на задачи с зависимостями и ведет агента по ним через MCP или CLI

MCP-серверСредний риск28,1 тыс.

Установка

Что делает

Подходит, если

Не подходит, если

Пример запроса к агенту

Ограничения

MCP

Проверка безопасности

Коротко о README

Частые вопросы

Похожие

SiYuan

gws

QMD

Taskmaster