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 на чтение и запись с правами аккаунта; телеметрия по умолчанию включена.

Настройка клиентов

codex
{
    "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.

Риск: medium Лицензия: MIT ★ 11 762

google_workspace_mcp

Google Workspace: Календарь, Диск, Gmail, Документы, Формы, Чат, Презентации и Таблицы.

Риск: medium Лицензия: MIT ★ 3 495

RevoGrid DataGrid MCP

Справка по RevoGrid DataGrid для агентов.

Риск: medium Лицензия: MIT ★ 3 455

kordoc

Разбор корейских документов HWP, HWPX и офисных форматов в Markdown.

Риск: medium Лицензия: MIT ★ 2 938

Источники