Humaans — MCP-сервер для Claude Code: HR-данные и установка
Подключает Humaans к MCP-хосту: агент получает профили сотрудников, роли, отпуска и сведения о компании. Нужен для работы с HR-данными из чата.
claude mcp add mcp-server-humaans -e HUMAANS_API_KEY=<HUMAANS_API_KEY> -- npx -y @mindstone/mcp-server-humaansЧто делает Humaans
Humaans подключает HR-платформу к MCP-хостам через пакет @mindstone/mcp-server-humaans. Сервер даёт 16 инструментов для профилей сотрудников, команд, истории ролей, отпусков, офисов и данных компании. Через него можно создавать, согласовывать, отклонять и отменять заявки на отсутствие.
Ответы со сведениями о людях ограничены разрешёнными полями, а чувствительные данные из профиля удаляются. Свободный текст из Humaans обёрнут в <untrusted-content>, чтобы модель воспринимала его как данные, а не инструкции. Для запуска нужны Node.js 20+, npm и токен доступа в HUMAANS_API_KEY.
Без HUMAANS_API_KEY сервер не получит доступ к Humaans. Подключение через npx подходит для хостов с поддержкой MCP; локальный запуск требует сборки проекта командой npm run build.
Какие задачи решает
- получить профиль сотрудника по ID
- показать список сотрудников и команд
- создать или отменить заявку на отпуск
- согласовать pending-заявку на отсутствие
- узнать офисы и данные компании
Примеры запросов агенту
- Покажи список сотрудников через
list_humaans_peopleи назови их команды. - Создай заявку на отпуск через
create_humaans_time_awayс указанными датами и причиной. - Получи данные компании и список офисов через
get_humaans_companyиlist_humaans_locations.
Как установить Humaans
Командой платформы
claude mcp add mcp-server-humaans -e HUMAANS_API_KEY=<HUMAANS_API_KEY> -- npx -y @mindstone/mcp-server-humaansВместо <…> подставьте свои значения
Командой платформы
codex mcp add humaans --env HUMAANS_API_KEY=<HUMAANS_API_KEY> -- npx -y @mindstone/mcp-server-humaansВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"humaans": {
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-humaans"
],
"env": {
"HUMAANS_API_KEY": "<HUMAANS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"humaans": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mindstone/mcp-server-humaans"
],
"env": {
"HUMAANS_API_KEY": "<HUMAANS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e HUMAANS_API_KEY=<HUMAANS_API_KEY> humaans npx -y @mindstone/mcp-server-humaansВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Humaans
Как установить Humaans в Claude Code?
Выполните claude mcp add mcp-server-humaans -e HUMAANS_API_KEY=<HUMAANS_API_KEY> -- npx -y @mindstone/mcp-server-humaans. Команда добавит MCP-сервер и передаст ему ключ Humaans.
Что делает Humaans?
MCP-сервер даёт агенту доступ к профилям сотрудников, ролям, командам, заявкам на отсутствие, офисам и данным компании через инструменты Humaans.
Какие данные защищает Humaans при ответе модели?
В деталях профиля удаляются налоговый идентификатор, личные контакты, домашний адрес, день рождения и фото. Свободный текст помечается как <untrusted-content> и передаётся как данные.
