Huly MCP — задачи и документы Huly для агента

Huly MCP

MCP-сервер для платформы Huly: задачи, проекты, документы, календарь и десятки других разделов, плюс тот же набор в CLI

64 ★ репозитория
Последний коммит 11 нояб. 2026
MIT

dearlordylord/huly-mcpАвтор:dearlordylord

Установка

Работает в: Claude Code
Codex
Cursor
Windsurf
GitHub Copilot
OpenCode
Claude Desktop
SourceCraft
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/huly-mcp

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

Токен наследует права учетной записи и дает создавать, менять и безвозвратно удалять задачи, проекты и документы
Содержимое задач и документов попадает в контекст агента и может нести чужие инструкции

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер подключается к развертыванию платформы Huly по адресу, рабочему пространству и токену API и открывает агенту около 470 операций. Они сгруппированы по разделам: проекты, задачи, комментарии, вехи, документы, вложения, контакты, каналы, календарь, учет времени, поиск, уведомления, HR, рекрутинг, поддержка и другие. В репозитории заявлена совместимость с форками Platform Collective и TraceX, а Intabia проверена частично. Чтобы не загружать сотни инструментов в контекст, режим HULY_TOOL_MODE по умолчанию выбирается по клиенту. Claude Code получает нативные инструменты, а Codex, Cursor, Windsurf, Copilot, OpenCode и Claude Desktop получают четыре посредника: list_tool_categories, search_tools, get_tool_schema и invoke_tool. Переменные TOOLSETS и TOOLS закрепляют нужные инструменты постоянно. Транспорты stdio и HTTP, диагностические инструменты get_huly_context и get_huly_startup_diagnostic, ресурсы только для чтения. Рядом в том же репозитории лежит Huly CLI с общим реестром операций.

Для кого. Командам, которые ведут работу в Huly и хотят, чтобы агент заводил задачи, читал документы и менял статусы без ручных переходов.

Подходит, если

Агент должен завести пачку задач в проекте по тексту из планирования
Нужно найти задачи по меткам и вехе и сводкой показать состояние спринта
Документы и вложения проекта надо прочитать и пересказать для команды
Рутинные операции Huly хочется вынести в скрипты через CLI с теми же операциями
Перед удалением сущности надо посмотреть влияние через preview_deletion

Не подходит, если

Нужна платформа Huly: сервер работает только с ее развертыванием и токеном
Узкая задача из пары инструментов: 470 операций избыточны, лучше закрепить минимум через TOOLS
Агент не должен менять и удалять данные: токен наследует права аккаунта в рабочем пространстве

Пример запроса к агенту

Найди в проекте Backend все открытые задачи с меткой bug и вехой Q4, сгруппируй по исполнителям и покажи сводку.

MCP

Транспорт: stdio, http
Авторизация: API-ключ

Переменные окружения

HULY_URL обязательная: Адрес развертывания Huly
HULY_TOKEN обязательная, секрет: Токен API Huly, лучше управляемый и ограниченный сроком
HULY_WORKSPACE обязательная: Имя рабочего пространства Huly
HULY_TOOL_MODE: Режим показа инструментов: auto, native или proxy

Ограничения

Нужен Node.js 22.19.0 и новее: при более старой версии сервер запускается в диагностическом режиме и выполняет только отчет о версии. Управляемый токен API привязан к одному рабочему пространству и имеет срок действия, но дает все права аккаунта, поэтому заведите для агента отдельную учетную запись с минимумом ролей. Старые развертывания Huly могут не выдавать управляемые токены, тогда остается вход по почте и паролю. Некоторые клиенты вызывают только инструменты из tools/list, поэтому в режиме посредника пригодится закрепление через TOOLSETS. Совместимость с Intabia проверена частично.

Как отключить. Выполните claude mcp remove huly и отзовите токен API в настройках аккаунта Huly. Отдельную учетную запись агента удалите, если создавали ее для интеграции.

Частые вопросы

Сколько инструментов у сервера?

Около 470 операций по десяткам разделов. Чтобы не перегружать контекст, режим auto показывает Claude Code все нативные инструменты, а остальным клиентам четыре посредника для поиска и вызова.

Как закрепить нужные инструменты?

Перечислите разделы в TOOLSETS или точные имена в TOOLS через запятую, либо задайте HULY_TOOL_MODE=native, чтобы все инструменты стали нативными. Поиск через посредников при этом остается.

Какой токен использовать?

Предпочтителен управляемый токен API из настроек аккаунта Huly: он привязан к рабочему пространству, имеет срок и отзывается без смены пароля. Вход по почте и паролю остается запасным вариантом.

Работает ли сервер по HTTP?

Да, помимо stdio есть режим HTTP с поддержкой протокола MCP, общими профилями stdio и настройкой заголовков для размещенного сервера. Подробности в разделе HTTP Transport README.

Есть ли CLI вместо MCP?

Да, в том же репозитории лежит Huly CLI, пакет @firfi/huly-cli. Он построен на том же реестре операций, поэтому входы и выходы совпадают с MCP.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

Hycli

Hycli по адресу сайта и цели собирает типизированный CLI и MCP-инструменты, работая в вашей браузерной сессии без утечки куки.

CLIШирокий доступ470

Apideck MCP — учет, HRIS и CRM через единый API

Apideck MCP

Официальный

MCP-сервер Apideck: агент работает с более чем 200 бизнес-системами: бухгалтерией, HRIS, CRM и файлами через единый API

MCP-серверШирокий доступ21

hitl-mcp

MCP-сервер, через который агент задает вопросы человеку и ждет ответа; ответы приходят через MCP или HTTP API.

MCP-серверРасширенный доступ165

Horizon

MCP-сервер личного новостного конвейера: сбор, оценка, фильтрация и суммаризация новостей инструментами для агента

MCP-серверРасширенный доступ13,9 тыс.

Retinue

Самостоятельно размещаемая доска задач для людей и агентов: агенты берут карточки через MCP, а журнал записей нельзя переписать.

MCP-серверРасширенный доступ115

Mission Control