Подключите своего ИИ-агента

Вы можете подключить к аккаунту HOA.AM ИИ-агента, которым уже пользуетесь, например Claude Code, Claude Desktop, Cursor, Codex, claude.ai или ChatGPT, и спрашивать его о своём аккаунте, например о балансе или открытых заявках. Он видит и делает только то, что можете вы в приложении, и только пока действует его токен или подключение.

Откройте меню пользователя справа в шапке, выберите Мой аккаунт, затем вкладку ИИ-агенты.

Создайте токен

1. В карточке Токены выберите Новый токен.
2. Введите Название, по которому понятно, какой агент и на каком устройстве будет пользоваться токеном, например Claude Code на моём ноутбуке. До 80 символов.
3. В разделе Доступ оставьте Чтение, чтобы агент мог искать сведения. Добавьте Изменения, только если хотите, чтобы агент действовал за вас, например подавал заявки, когда портал предложит агентам такие действия.
4. Выберите Срок действия: 7, 30, 90 или 365 дней. Токены администраторов действуют не дольше 90 дней.
5. Введите Текущий пароль. Если включена двухфакторная аутентификация, введите также код из приложения или резервный код.
6. Выберите Создать токен.

Токен показывается только один раз. Выберите Копировать токен или скопируйте настройку под ним, прежде чем нажать Готово. Если вы его потеряете, отзовите его и создайте новый.

Добавьте HOA.AM в агента

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

• Claude Code: выполните скопированную команду в терминале.
• Claude Desktop: добавьте её в claude_desktop_config.json (Settings › Developer › Edit config) и перезапустите Claude Desktop. Нужен Node.js.
• Cursor: добавьте её в ~/.cursor/mcp.json или в .cursor/mcp.json проекта.
• Codex: добавьте её в ~/.codex/config.toml.

Карточка Подключить агента показывает ту же настройку с hpat_… вместо токена и Адрес сервера для любого другого агента, поддерживающего Model Context Protocol.

Подключите веб-приложение

Веб-приложения, такие как claude.ai и ChatGPT, не принимают токен. Вы добавляете в них HOA.AM по адресу сервера, а они отправляют вас в HOA.AM, чтобы разрешить подключение:

1. В веб-приложении добавьте пользовательский коннектор с адресом из поля Адрес сервера в карточке Подключить агента.
2. Приложение откроет HOA.AM. Войдите, если потребуется.
3. Страница Разрешить приложению доступ к аккаунту? показывает название приложения с пометкой Не проверено, адрес, на который вас вернут, и запрашиваемый доступ. Зарегистрировать приложение под любым названием может кто угодно, поэтому разрешайте доступ, только если вы сами только что начали его подключать.
4. Выберите Разрешить, чтобы подключить, или Запретить, чтобы отказать. В обоих случаях вас вернут в приложение. Если страница сообщает, что срок запроса истёк, вернитесь в приложение и начните подключение заново.

Отключите приложение

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

Отзовите токен

Выберите Отозвать рядом с токеном и подтвердите. Агент с этим токеном больше не сможет подключиться. Отозванный токен восстановить нельзя.

Полезно знать

• Давайте каждому агенту свой токен, чтобы можно было отозвать один, не затрагивая остальные. Можно иметь до 20 токенов.
• В списке видно только начало каждого токена (hpat_ и восемь символов), когда его использовали последний раз и когда он истекает.
• Смена пароля, его сброс или отключение двухфакторной аутентификации отзывает все токены и отключает все подключённые приложения.
• Токен работает только для вашего агента и никогда не подходит для входа в портал.
• Когда администратор просматривает портал от имени владельца, вкладка ИИ-агенты сообщает, что токены не показываются, и не выводит ни одного.
• Общие аккаунты публичного и частного демо не могут создавать токены и подключать веб-приложения.