Подключить ИИ-помощника

Heth MCP даёт помощнику ограниченный доступ к вашему аккаунту, включая доступные ему бизнес-функции. Администрирование платформы через него недоступно. Открытие экрана подключения само по себе не выдаёт разрешений.

Как подключить помощника

1. В приложении Heth, где уже открыт ваш кошелёк, перейдите в Настройки → Подключения ИИ и нажмите Создать код подключения. Одноразовый код относится именно к этому аккаунту и действует пять минут.
2. В настройках подключений клиента ИИ добавьте https://mcp.heth.me/mcp, выберите OAuth и начните подключение.
3. В открывшемся окне введите только код из Heth. Входить в кошелёк в этом браузере не нужно. Код направляет запрос в создавший его аккаунт, но сам по себе доступа не даёт.
4. Откройте пуш в приложении Heth. Если он не пришёл, откройте Настройки → Подключения ИИ → Запросы на подключение. Сверьте код проверки запроса с кодом в окне подключения. Проверьте аккаунт, идентификатор клиента и адрес сервиса: одно название приложения не подтверждает его подлинность.
5. В Heth снимите лишние разрешения и нажмите Разрешить выбранный доступ ИИ либо Отказать в доступе ИИ. Само открытие пуша ничего не подтверждает.
6. Вернитесь в клиент ИИ: окно подключения завершит процесс автоматически после решения в Heth. Сессия кошелька и ключи подписи остаются в приложении Heth.

Использованный или истёкший код не подходит для повторной привязки. Создайте новый код в Heth: он заменяет предыдущий неиспользованный. Если истёк сам запрос подключения, начните его заново в клиенте ИИ.

В ChatGPT

Откройте Plugins → Add → Add custom MCP server, укажите название, например Heth.me, адрес сервера выше и оставьте OAuth. ChatGPT обнаружит настройки автоматически; API-ключ кошелька, client secret и фраза восстановления не нужны. Создайте личный плагин, нажмите Connect Heth.me и пройдите шаги с кодом и пушем выше. Запрашиваемые разрешения можно выбрать в Advanced OAuth settings, а окончательный выбор доступа к аккаунту подтверждается в приложении Heth.

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

Разрешения и инструменты

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

Разрешение	Инструменты и назначение
heth:wallets:read	get_wallet_balances: балансы своих кошельков
heth:transactions:read	list_transactions, get_transaction: своя история и исходный статус операции
heth:business:read	list_products, list_business_payment_links, list_business_subscriptions: свои товары, управляемые платёжные ссылки и подписки продавца; get_business_subscription, list_business_subscription_requests: условия отдельной подписки и исходящие запросы
heth:payments:prepare	prepare_transfer, get_transfer_request: подготовка перевода для подтверждения в Heth и проверка исходного результата
heth:business:manage	create_business_product, update_business_product, delete_business_product; create_business_payment_link, update_business_payment_link, delete_business_payment_link: обычные изменения с подтверждением в клиенте ИИ
heth:business:manage	request_business_subscription: запрос согласия плательщика в Heth; prepare_business_subscription_change: проверка приостановки, возобновления или отмены в Heth
heth:obs:read	get_obs_widget, list_obs_events: настройки и входящие события
heth:obs:configure	prepare_obs_connection, update_obs_widget: ссылка на проверку в Heth либо оформление с подтверждением в клиенте ИИ

prepare_obs_connection не выдаёт доступ и не возвращает токен OBS. Через изменение оформления нельзя менять валюту, сеть, получателя, ключи или права доступа. См. подключение и настройку OBS: там есть открытый проект и инструкции для ИИ, который помогает менять код.

Срок доступа

Разрешение подключения действует до вашего отзыва. Технические данные доступа имеют отдельные сроки: токен MCP — 15 минут; refresh-токен заменяется при обновлении и истекает после 30 дней без обновления. Если технический токен истёк, может понадобиться повторное подключение, даже если запись согласия ещё активна.

Каждый запрос проверяет текущее согласие и права аккаунта. Для обращения к API Heth используется отдельный ограниченный токен сроком не более 60 секунд; полная сессия кошелька в MCP не передаётся. Отзыв согласия или прав аккаунта блокирует последующие запросы, включая запросы с ещё не истёкшими токенами. Уже полученные клиентом данные отозвать невозможно.

Отзыв и повторное подключение

В Heth откройте Настройки → Подключения ИИ, проверьте идентификатор клиента, адрес сервиса, разрешения и статус. Нажмите Отозвать доступ ИИ и подтвердите действие в Heth. Отзыв не отменяет завершённые платежи и разрешения на списания по подпискам: ими нужно управлять отдельно в настройках подписок.

Если помощник просит подключиться заново, начните новую авторизацию из клиента ИИ. Доступ может прекратиться после отзыва, истечения токенов, изменения прав или обнаружения повторного использования refresh-токена. Не передавайте помощнику фразу восстановления, ключи кошелька или данные браузерной сессии для исправления подключения. Недоступность сервиса — ошибка, а не пустой аккаунт или успешное подтверждение.

Платежи и другие изменения

Heth требует отдельного подтверждения в Heth каждой денежной операции. Разрешение подключения не разрешает автоматические списания.

Обычные изменения товаров и платёжных ссылок требуют подтверждения в клиенте ИИ. Изменения прав, получателей выплат и разрешений на будущие списания подтверждаются в Heth. Оформление OBS подтверждается в клиенте ИИ. Одна аннотация инструмента не доказывает, что клиент получил согласие человека.

Вы также можете использовать приложение Heth или поддерживаемую интеграцию API.

Перевод с помощью ИИ

1. Укажите помощнику тип перевода, получателя, валюту, сеть и сумму. Между внутренними счетами (hot_hot), с внутреннего на блокчейн-адрес (hot_cold), с блокчейн-адреса на свой внутренний счёт (cold_hot) и между блокчейн-адресами (cold_cold) — разные операции. Для cold_hot получатель — self: зачисление идёт на ваш собственный счёт Heth.
2. prepare_transfer сохраняет условия и возвращает ссылку для проверки в Heth. Платёж при этом не создаётся. Сумма и max_debit передаются точными целочисленными строками в минимальных единицах токена. max_debit ограничивает списание токена вместе с комиссиями платформы. Для источника в блокчейне max_network_fee ограничивает сетевую плату за газ транзакции в wei (ETH/Base) или sun (TRON). В Base дополнительно возможна плата за данные L1.
3. Откройте Heth и проверьте аккаунт, клиента ИИ, получателя, источник, сумму, сеть и пределы комиссий. Нажимайте Подтвердить и отправить в Heth только при верных условиях. Само открытие ссылки ничего не подтверждает и не отправляет. Запрос действует 15 минут.
4. Heth подписывает показанное поручение и использует обычный механизм перевода. Блокчейн-транзакция подписывается на вашем устройстве или подключённом устройстве подписи. Открывайте Heth там, где доступна подпись источника; приватные ключи помощнику не передаются.
5. Помощник проверяет исходную транзакцию через get_transfer_request. Подтверждение или обработка ещё не означают оплату. После обрыва связи проверьте исходный результат; повторяйте подготовку с тем же request_id и теми же условиями. Не создавайте второй перевод ради выяснения результата первого.

Отзыв подключения запрещает начало нового перевода. Уже принятая к исполнению транзакция может завершиться: отзыв доступа ИИ не отменяет принятый блокчейн-перевод.

Товары, ссылки и подписки

Обычные изменения товаров и управляемых платёжных ссылок помощник показывает для подтверждения в клиенте ИИ. Цены и суммы ссылок — целочисленные строки в минимальных единицах валюты, количество товара — положительное целое число. Постоянный request_id защищает от повторного изменения при повторе запроса. Эти операции не меняют маршрутизацию платежей, получателей выплат, ключи и права доступа. Удаление ссылки или товара не отменяет прежние платежи.

request_business_subscription создаёт запрос для проверки плательщиком в Heth. Сам запрос не даёт права на будущие списания и не создаёт платёж. Плательщик проверяет сумму, периодичность и первое списание перед подписью в Heth. Запросы проверяются через list_business_subscription_requests, существующие соглашения — через get_business_subscription или list_business_subscriptions.

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