Подключить агента

Смысл всей затеи: агент в вашем редакторе кода читает документацию команды сам — не пересказом в окне чата, а как подключённый источник. Спросили «почему мы отказались от очереди» — он идёт в базу знаний и отвечает по документу, а не по догадке.

Связь идёт по протоколу MCP (Model Context Protocol). У каждого проекта свой адрес вида /mcp/{идентификатор проекта}: проект и есть база знаний, и выбирать её не должна модель.

Готовую команду с вашим идентификатором отдаёт сам продукт — карточка «Подключить агента» на дашборде проекта (она же в Настройки → Проект → Общее). Скопируйте оттуда кнопкой «Копировать команду», чтобы не подставлять значения руками.

Claude Code

Одна команда, выполняется по разу на проект:

claude mcp add --transport http --scope user \
  --client-id hivelore-mcp-agent \
  hivelore-{проект} https://hivelore.ru/mcp/{идентификатор проекта}

Дальше перезапустите сессию и проверьте командой /mcp — сервер должен быть в списке со статусом Connected. При первом обращении откроется браузер: вход тот же, что в веб-интерфейсе.

На карточке переключатель — где будет виден сервер:

Вариант	Флаг	Что значит
Отовсюду	`--scope user`	база знаний доступна в любой папке; выбран по умолчанию
В репозитории	`--scope project`	конфигурация ложится в репозиторий и едет к коллегам вместе с ним
Только здесь	без флага	сервер привязан к папке, из которой выполнена команда

Две вещи, на которых спотыкаются:

--client-id hivelore-mcp-agent обязателен. Без него клиент попытается зарегистрировать собственного OAuth-клиента, а такая регистрация закрыта намеренно — это лишняя дверь наружу.
Имя сервера своё на каждый проект. Карточка уже подставляет hivelore- и название проекта. Одинаковое имя не добавит второй сервер, а перезапишет первый.

Другие MCP-клиенты

Адрес и протокол общие, так что подключается любой клиент с поддержкой Streamable HTTP и OAuth.

Оговорка честная: клиенты, которые умеют только динамическую регистрацию OAuth-клиента и не дают указать готовый идентификатор, подключиться не смогут — такая регистрация закрыта. Напишите нам, если нужен конкретный клиент: это решается настройкой на нашей стороне, а не переделкой продукта.

Как этим пользоваться

Просто говорите агенту задачу словами — инструменты он выберет сам:

«Найди в базе знаний, как у нас устроен деплой, и сделай по этому README».
«Заведи постмортем по вчерашнему инциденту» — агент возьмёт шаблон проекта, заполнит разделы и пришлёт предложение на подтверждение. Шаблоны проекта клиент к тому же показывает слэш-командами.
«Обнови страницу про интеграцию — мы сменили адрес вебхука».
«Разбери этот постмортем и выпиши, что мы обещали сделать» — заведёт задачи со ссылкой на источник.

Полный перечень возможностей — Что агент умеет. Ничего из написанного агентом не попадает в базу молча: см. Проверка правок агента.

Права и вход

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

Warning

Выход из аккаунта в браузере не отключает агента Вход агента живёт в его клиенте отдельно от вкладки. Чтобы отозвать его, удалите сервер в клиенте (claude mcp remove <имя>) — или попросите владельца проекта исключить учётную запись из проекта.

Пока мы обновляем сервис, агент на несколько секунд получает ответ «подождите и повторите», а не «войдите заново»: клиент дождётся сам, и входить повторно не придётся.

Если не подключается

Сервер в списке, но не Connected — почти всегда пропущенный --client-id hivelore-mcp-agent. Удалите запись (claude mcp remove <имя> из того же каталога) и добавьте заново.
Сервера нет в /mcp вовсе — команда выполнена в варианте «Только здесь» из другого каталога.
Агент не видит новую страницу — она ещё индексируется, это несколько секунд.
Не видно нового шаблона или изменились права, а агент об этом не знает — список инструментов и команд клиент читает один раз за подключение. Переподключите сервер: /mcp → reconnect.
Агент не находит поиском то, что сам только что предложил — так и задумано: неподтверждённое в поиск не попадает, см. Проверка правок агента.