hilan-mcp — MCP-сервер для Claude Code: расчётные листы Hilan
Достаёт расчётные листы и форму 106 из Hilan в любой ИИ-ассистент. Пригодится, если нужно спросить у агента, сколько вы заработали за месяц.
claude mcp add --env COMPANY_URL=<COMPANY_URL> --env COMPANY_TENANT=<COMPANY_TENANT> --env COMPANY_CODE=<COMPANY_CODE> --env HILAN_DB_KEY=<HILAN_DB_KEY> --env NODE_EXTRA_CA_CERTS=<NODE_EXTRA_CA_CERTS> --transport stdio hilan-mcp -- npx -y hilan-mcpЧто делает hilan-mcp
Официального API у Hilan нет, поэтому сервер поднимает headless Chromium через Playwright, логинится и дальше переиспользует уже авторизованную сессию для запросов к внутренним .asmx-эндпоинтам и скачивания PDF. Куки и заголовки наследуются от реальной загрузки страницы, а не собираются вручную.
Поля формы входа у разных работодателей отличаются: где-то два поля, где-то три. Сервер разбирает форму заново при первой загрузке учётных данных для каждого тенанта, поэтому привязки к одной компании нет. Данные лежат в SQLCipher-зашифрованной SQLite, ключ на диск в открытом виде не пишется. Хранить его можно в системном хранилище (Keychain, DPAPI, Secret Service) или в переменной HILAN_DB_KEY.
Учётные данные вводите сами в своём терминале, не в чате с ассистентом. Первый запуск ставит Chromium и просит задать ключ шифрования не короче 6 символов. Если у вас npm 12 или новее, установочные скрипты зависимостей заблокированы, а better-sqlite3-multiple-ciphers без них не соберёт нативный модуль: настройка как будто проходит, но потом падает каждый инструмент, работающий с базой. Разрешите скрипт заранее командой npm config set allow-scripts=better-sqlite3-multiple-ciphers --location=user.
Какие задачи решает
- вытащить расчётный лист за нужный месяц в структурированном виде
- скачать PDF формы 106 за год
- спросить у агента сумму заработка за июнь без похода в веб-интерфейс
- подключить несколько работодателей Hilan в одном клиенте
- хранить пароль от Hilan, не оставляя его в открытом виде на диске
Примеры запросов агенту
- Покажи мой расчётный лист за март, тенант amdocs
- Скачай форму 106 за прошлый год
- Сколько я заработал в июне?
Как установить hilan-mcp
Командой платформы
claude mcp add --env COMPANY_URL=<COMPANY_URL> --env COMPANY_TENANT=<COMPANY_TENANT> --env COMPANY_CODE=<COMPANY_CODE> --env HILAN_DB_KEY=<HILAN_DB_KEY> --env NODE_EXTRA_CA_CERTS=<NODE_EXTRA_CA_CERTS> --transport stdio hilan-mcp -- npx -y hilan-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add hilan-mcp --env COMPANY_URL=<COMPANY_URL> --env COMPANY_TENANT=<COMPANY_TENANT> --env COMPANY_CODE=<COMPANY_CODE> --env HILAN_DB_KEY=<HILAN_DB_KEY> --env NODE_EXTRA_CA_CERTS=<NODE_EXTRA_CA_CERTS> -- npx -y hilan-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"hilan-mcp": {
"command": "npx",
"args": [
"-y",
"hilan-mcp"
],
"env": {
"COMPANY_URL": "<COMPANY_URL>",
"COMPANY_TENANT": "<COMPANY_TENANT>",
"COMPANY_CODE": "<COMPANY_CODE>",
"HILAN_DB_KEY": "<HILAN_DB_KEY>",
"NODE_EXTRA_CA_CERTS": "<NODE_EXTRA_CA_CERTS>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"hilan-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hilan-mcp"
],
"env": {
"COMPANY_URL": "<COMPANY_URL>",
"COMPANY_TENANT": "<COMPANY_TENANT>",
"COMPANY_CODE": "<COMPANY_CODE>",
"HILAN_DB_KEY": "<HILAN_DB_KEY>",
"NODE_EXTRA_CA_CERTS": "<NODE_EXTRA_CA_CERTS>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e COMPANY_URL=<COMPANY_URL> -e COMPANY_TENANT=<COMPANY_TENANT> -e COMPANY_CODE=<COMPANY_CODE> -e HILAN_DB_KEY=<HILAN_DB_KEY> -e NODE_EXTRA_CA_CERTS=<NODE_EXTRA_CA_CERTS> hilan-mcp npx -y hilan-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о hilan-mcp
Как установить hilan-mcp в Claude Code?
Выполните claude mcp add hilan-mcp -e HILAN_DB_KEY=<HILAN_DB_KEY> -- npx -y hilan-mcp. Если нужны тенант и корпоративный CA, есть вариант с `--env COMPANY_URL=<COMPANY_URL> --env COMPANY_TENANT=<COMPANY_TENANT> --env COMPANY_CODE=<COMPANY_CODE> --env HILAN_DB_KEY=<HILAN_DB_KEY> --env NODE_EXTRA_CA_CERTS=<NODE_EXTRA_CA_CERTS> --transport stdio hilan-mcp -- npx -y hilan-mcp`.
Что делает hilan-mcp?
Забирает расчётные листы и форму 106 из личного кабинета Hilan и отдаёт их ассистенту: структурированные суммы и PDF. Инструмент query отвечает на вопросы по уже сохранённым локально данным, без обращения к сети.
Что нужно, чтобы сервер заработал?
Сначала сами запустите npx hilan-mcp setup --tenant amdocs в своём терминале: он поставит Chromium, определит поля входа вашего тенанта и спросит учётные данные. Ключ шифрования базы удобнее положить в системное хранилище через npx hilan-mcp setup-key.
