API ВЕГА
English

Плагин HypAware

Подключите Claude Code, Cursor или любой агент, который поддерживает навыки, к размещённому

MCP-серверу HypAware. После этого агент сможет запрашивать историю работы вашей команды с AI-кодированием и применять рекомендации HypAware.

Плагин включает два компонента:

  • Подключение MCP к https://api.hypaware.ai/v1/mcp. Запросы отправляются с токеном агента в заголовке Authorization.

  • Два навыка: hypaware-query (как запрашивать историю и применять рекомендации) и hypaware-reference (что такое HypAware и как передаются данные). Это копии навыков из выпуска HypAware, к которому привязан плагин.

Плагин только читает данные и выполняет действия. В нём нет хуков, команд, агентов или бинарных файлов; он ничего не записывает и не запускает на вашем компьютере. За запись отвечает CLI hyp и команда hyp attach.

Получение токена

Плагин считывает токен из переменной окружения HYPAWARE_AGENT_TOKEN. Если вы ещё не создавали токен:

  • Установите CLI: npm install -g hypaware.

  • Войдите в систему только для выполнения запросов: hyp remote login --no-forward. Откроется страница входа в браузере; запись данных при этом не включается.

  • Создайте токен: hyp remote mint --scope query --label .

Срок действия токена по умолчанию — 21 день. Чтобы запросить более длительный срок, используйте --expires-days , но не превышайте установленный сервером лимит — по умолчанию 90 дней.

  • Укажите токен в окружении, из которого запускается клиент: например, добавьте export HYPAWARE_AGENT_TOKEN= в профиль оболочки или сохраните токен в хранилище секретов клиента. Не помещайте его в файлы, которые вы коммитите.

  • Когда токен больше не нужен, отзовите его: команда hyp remote tokens выводит список токенов, а hyp remote tokens revoke отзывает выбранный токен.

Возможности токена. Токен действует от имени создавшего его пользователя, пока не истечёт срок его действия или пока вы не отзовёте его. С его помощью можно читать записанную историю организации, менять статус рекомендации, публиковать отчёты и удалять их. Токен не позволяет изменять настройки, записывать или загружать сессии, управлять организацией или создавать другие токены. Любой, кто получит токен, сможет выполнять те же действия, поэтому храните его в секрете.

Установка

Claude Code

В Claude Code выполните:

/plugin marketplace add hyparam/hypaware-plugin
/plugin install hypaware@hypaware

Или выполните команды в оболочке:

claude plugin marketplace add hyparam/hypaware-plugin
claude plugin install hypaware@hypaware

Запускайте Claude Code из оболочки, в которой задана переменная HYPAWARE_AGENT_TOKEN. Если команда claude mcp list показывает сервер hypaware со статусом "Failed to connect" и HTTP 401, значит токен не задан или больше недействителен.

Cursor для команды

Администратор команды открывает панель управления Cursor, переходит в Plugins & MCPs, выбирает Add Marketplace, затем Import from Repo и вводит hyparam/hypaware-plugin. После этого администратор задаёт HYPAWARE_AGENT_TOKEN в разделе Plugins, Configure. В Cursor задавать переменные плагинов могут только администраторы команды.

Cursor для одного пользователя

В Cursor нельзя установить плагин для одного пользователя, поэтому настройте интеграцию в два этапа:

  • Добавьте блок удалённого сервера hypaware из раздела Cursor в руководстве по MCP в файл ~/.cursor/mcp.json (или .cursor/mcp.json проекта). Для токена используется переменная ${env:HYPAWARE_AGENT_TOKEN}, поэтому задайте её до запуска Cursor.

  • Добавьте навыки: npx skills add hyparam/hypaware-plugin -a cursor.

Другие агенты

Для любого агента, поддерживаемого CLI skills (Pi, Codex, OpenCode и других):

npx skills add hyparam/hypaware-plugin

Эта команда устанавливает только два навыка. Подключите MCP-сервер, следуя руководству по MCP для вашего клиента.

Если вы уже используете hyp attach

Команда hyp attach устанавливает те же навыки. В этом случае плагин нужен только для подключения MCP. В Claude Code обе копии загружаются параллельно (копии плагина называются hypaware:hypaware-query и так далее), поэтому существующие файлы не перезаписываются.

Запись в MCP Registry

В registry/server.json указаны два способа запуска сервера:

  • Удалённый сервер — размещённый сервер. Выберите этот вариант, если у вас есть токен агента.

  • Пакет npm запускает hyp mcp serve и использует локальные данные HypAware. Выберите этот вариант, если на вашем компьютере работает сборщик данных HypAware. Без него серверу нечего будет показывать.

Обновление навыков

Не редактируйте файлы в skills/ вручную. Измените навык в репозитории hypaware, выпустите новую версию, затем запустите здесь node scripts/sync-skills.js и закоммитьте результат. CI завершится ошибкой, если содержимое skills/ будет отличаться от соответствующего выпуска или не совпадёт хотя бы одно поле версии.

Лицензия

MIT. См. LICENSE.