Huly MCP
Huly MCP — MCP-сервер сообщества (автор — dearlordylord). Полнофункциональная интеграция с Huly. Ставится через npx. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- dearlordylord
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- api_key
- ОС
- linux, macos, windows
- Языки
- typescript
Уровень риска: high
Около 470 операций Huly на чтение и запись с правами аккаунта; телеметрия по умолчанию включена.
Настройка клиентов
{
"code": "[mcp_servers.huly]\nstartup_timeout_sec = 120\ncommand = \"npx\"\nargs = [\"-y\", \"@firfi/huly-mcp@latest\"]\n\n[mcp_servers.huly.env]\nMCP_TRANSPORT = \"stdio-resident\"\nHULY_URL = \"https://your-huly-instance.example.com\"\nHULY_TOKEN = \"your-huly-api-token\"\nHULY_WORKSPACE = \"yourworkspace\"",
"file": "~/.codex/config.toml",
"lang": "toml",
"verified": "docs"
}
Что умеет
Huly MCP — полнофункциональный MCP-сервер для платформы Huly (трекер задач, документы, чаты, календарь и HR в одном рабочем пространстве). Опубликован в npm как @firfi/huly-mcp. Подключается к инсталляциям Huly Platform и, по словам автора, должен работать с форками Platform Collective и TraceX; совместимость с Intabia проверена, но поддержка форков остаётся неофициальной.
Охват. Около 470 инструментов, разбитых по категориям: проекты, задачи, комментарии, вехи, документы, хранилище и вложения, контакты, каналы, календарь, учёт времени, поиск, связи, активность, уведомления, согласования, доски и карточки, пользовательские поля, диск, HR, склад, метки, лиды, почта, шаблоны, планировщик, процессы, рекрутинг, тест-менеджмент, виртуальный офис и администрирование.
Как модель видит инструменты. Чтобы не отдавать клиенту список из 470 инструментов, в режиме HULY_TOOL_MODE=auto Claude Code получает нативные инструменты, а Codex, Cursor, Windsurf, Copilot, OpenCode, Claude Desktop и неизвестные клиенты — компактный прокси: list_tool_categories (карта категорий), search_tools (поиск по названию, категории и параметрам), get_tool_schema (точная схема) и invoke_tool (вызов операции чтения или записи). Режим native показывает все инструменты сразу, а переменные TOOLSETS и TOOLS ограничивают набор нужными категориями или конкретными инструментами.
Ресурсы и диагностика. Проекты и задачи доступны как ресурсы MCP только для чтения, например huly://issues/HULY-123. Инструмент get_version сообщает текущую и последнюю версию, get_huly_context — очищенный от секретов контекст сессии без подключения к Huly.
Транспорт: stdio (по умолчанию), stdio-resident (рекомендуется в примерах) и HTTP с необязательным токеном MCP_AUTH_TOKEN для защиты адреса. Рядом поддерживается Huly CLI с теми же операциями — для скриптов и терминала.
Кому подойдёт
Командам, которые ведут проекты в Huly и хотят создавать задачи, писать комментарии и искать документы из чата с ассистентом. Похожие серверы — в категории продуктивность.
Установка
Нужен Node.js 22.19.0 или новее в окружении, где работает клиент; на более старой версии сервер запускается только в диагностическом режиме и сообщает, что нужно обновить. Обязательные переменные: HULY_URL (адрес инсталляции), HULY_WORKSPACE и HULY_TOKEN. Автор советует управляемый API-токен из настроек аккаунта Huly: он привязан к одному рабочему пространству, имеет срок действия и отзывается без смены пароля. Почта и пароль (HULY_EMAIL, HULY_PASSWORD) — запасной вариант для старых версий.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add huly \
-e MCP_TRANSPORT=stdio-resident \
-e HULY_URL=https://your-huly-instance.example.com \
-e HULY_TOKEN=your-huly-api-token \
-e HULY_WORKSPACE=yourworkspace \
-- npx -y @firfi/huly-mcp@latestДля Codex блок кладут в ~/.codex/config.toml; 120 секунд на запуск учитывают скачивание пакета, подключение проверяется командой /mcp. Для VS Code — .vscode/mcp.json или команда MCP: Add Server.
Проверка
Спросите: «Какие проекты есть в моём рабочем пространстве Huly?»
Примеры задач
Создай задачу в проекте HULY: «Обновить документацию API», исполнитель — я, срок — пятница.Найди документы, где упоминается релиз 2.0, и перескажи их.Риски
- Изменения в Huly. Агент создаёт и меняет задачи, документы, сообщения и другие данные с полными правами аккаунта в рабочем пространстве; автор советует отдельный служебный аккаунт с минимальной ролью.
- Учётные данные — предпочитайте отзываемый токен, а не пароль.
- Телеметрия (агрегированная аналитика PostHog) включена по умолчанию; отключается
HULY_MCP_TELEMETRY=0илиDO_NOT_TRACK=1.
Частые вопросы
Почему клиент видит всего несколько инструментов?
Это прокси-режим: модель ищет нужный инструмент через search_tools и вызывает его через invoke_tool.
Работает ли сервер с self-hosted Huly?
Да, укажите адрес своей инсталляции в HULY_URL.
Можно ли ограничить набор инструментов?
Да, через TOOLSETS и TOOLS.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
CodeBurn
Учёт расходов, токенов и квот ИИ-инструментов программирования, включая Claude Code и Cursor.
google_workspace_mcp
Google Workspace: Календарь, Диск, Gmail, Документы, Формы, Чат, Презентации и Таблицы.
RevoGrid DataGrid MCP
Справка по RevoGrid DataGrid для агентов.
kordoc
Разбор корейских документов HWP, HWPX и офисных форматов в Markdown.