Huly MCP — MCP-сервер для Claude Code: доступ к Huly из агента
MCP-сервер, который подключает агента к вашему развёртыванию Huly: задачи, проекты и рабочие пространства прямо из чата.
claude mcp add --env HULY_URL=<HULY_URL> --env HULY_EMAIL=<HULY_EMAIL> --env HULY_PASSWORD=<HULY_PASSWORD> --env HULY_WORKSPACE=<HULY_WORKSPACE> --env HULY_CONNECTION_TIMEOUT=<HULY_CONNECTION_TIMEOUT> --transport stdio huly-mcp -- npx -y @firfi/huly-mcpЧто делает Huly MCP
Huly MCP соединяет ИИ-клиент с платформой Huly через npm-пакет @firfi/huly-mcp. Сервер работает с развёртываниями Huly Platform, а также рассчитан на форки Platform Collective и TraceX. Совместимость проверяли на Intabia 0.8.33 с моделью 0.8.4, поддержка форков остаётся неофициальной.
По умолчанию (HULY_TOOL_MODE=auto) сервер не вываливает сразу список из 470 инструментов. Сессии claude-code получают нативные инструменты Huly, а Codex, Cursor, Windsurf, Copilot и другие клиенты — небольшой прокси-набор: list_tool_categories, search_tools, get_tool_schema и invoke_tool. Режим HULY_TOOL_MODE=native открывает все инструменты как первоклассные, а TOOLSETS и TOOLS закрепляют нужные.
Нужен Node.js 22.19.0 или новее: клиент не поставляет собственный рантайм, node и npx берутся из окружения. На старой версии сервер поднимает только диагностическую поверхность с инструментом get_huly_startup_diagnostic и пишет в stderr сообщение об unsupported Node.js runtime — операции Huly будут недоступны, пока рантайм не обновят. Для подключения нужен API-токен Huly, адрес инстанса и имя рабочего пространства.
Какие задачи решает
- создать задачу в Huly, не открывая браузер
- найти проекты и рабочие пространства из чата с агентом
- выгрузить список задач по фильтру
- проверить, какие инструменты Huly доступны в текущей сессии
- подключить Huly к агенту через один npm-пакет
Примеры запросов агенту
- Покажи мои задачи в Huly на эту неделю
- Создай задачу в проекте
Backendс описанием из этого файла - Найди в Huly все задачи со статусом
In Progress
Как установить Huly MCP
Командой платформы
claude mcp add --env HULY_URL=<HULY_URL> --env HULY_EMAIL=<HULY_EMAIL> --env HULY_PASSWORD=<HULY_PASSWORD> --env HULY_WORKSPACE=<HULY_WORKSPACE> --env HULY_CONNECTION_TIMEOUT=<HULY_CONNECTION_TIMEOUT> --transport stdio huly-mcp -- npx -y @firfi/huly-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
codex mcp add huly-mcp --env HULY_URL=<HULY_URL> --env HULY_EMAIL=<HULY_EMAIL> --env HULY_PASSWORD=<HULY_PASSWORD> --env HULY_WORKSPACE=<HULY_WORKSPACE> --env HULY_CONNECTION_TIMEOUT=<HULY_CONNECTION_TIMEOUT> -- npx -y @firfi/huly-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"mcpServers": {
"huly-mcp": {
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"HULY_URL": "<HULY_URL>",
"HULY_EMAIL": "<HULY_EMAIL>",
"HULY_PASSWORD": "<HULY_PASSWORD>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>",
"HULY_CONNECTION_TIMEOUT": "<HULY_CONNECTION_TIMEOUT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Файл настроек
{
"servers": {
"huly-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@firfi/huly-mcp"
],
"env": {
"HULY_URL": "<HULY_URL>",
"HULY_EMAIL": "<HULY_EMAIL>",
"HULY_PASSWORD": "<HULY_PASSWORD>",
"HULY_WORKSPACE": "<HULY_WORKSPACE>",
"HULY_CONNECTION_TIMEOUT": "<HULY_CONNECTION_TIMEOUT>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
Командой платформы
gemini mcp add -e HULY_URL=<HULY_URL> -e HULY_EMAIL=<HULY_EMAIL> -e HULY_PASSWORD=<HULY_PASSWORD> -e HULY_WORKSPACE=<HULY_WORKSPACE> -e HULY_CONNECTION_TIMEOUT=<HULY_CONNECTION_TIMEOUT> huly-mcp npx -y @firfi/huly-mcpВместо <…> подставьте свои значения. Ещё 4 переменные окружения — в README сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Huly MCP
Как установить Huly MCP в Claude Code?
Выполните `claude mcp add huly-mcp -e HULY_URL=<HULY_URL> -e HULY_EMAIL=<HULY_EMAIL> -e HULY_PASSWORD=<HULY_PASSWORD> -e HULY_WORKSPACE=<HULY_WORKSPACE> -- npx -y @firfi/huly-mcp`. Подставьте адрес инстанса, учётные данные и имя рабочего пространства.
Что делает Huly MCP?
Даёт агенту доступ к операциям Huly: задачи, проекты, рабочие пространства. В сессиях claude-code инструменты доступны нативно, остальным клиентам выдаётся прокси-набор для поиска и вызова.
Какая версия Node.js нужна?
Node.js 22.19.0 или новее. Если клиент запустит сервер на старом рантайме, тот включит только диагностическую поверхность и операции Huly останутся недоступны.
