Руководства по TRON

MCP-сервер TronSave: ИИ-агент покупает энергию TRON (2026)

Автор: TronSave Опубликовано 11 мин чтения
Содержание

Обновлено: 2 ноября 2026 г. — проверено на работающем сервере, версия 1.3.0 (добавлен вход через OAuth).

Коротко: у TronSave есть работающий MCP-сервер по адресу https://mcp.tronsave.io/mcp. На 2 ноября 2026 г. (версия 1.3.0) он давал ИИ-ассистенту 53 инструмента для работы с маркетом TronSave. 18 из них работают без входа в аккаунт — в том числе котировки, таблица цен и заказ с оплатой из вашего собственного кошелька. Ваш приватный ключ к серверу даже не приближается: каждая подпись выполняется в вашем кошельке.

С ним ассистент может рассчитать стоимость аренды, прочитать книгу заказов, создавать, отменять и продлевать заказы, настраивать автопокупку и автопродажу, а также управлять API-ключами и уведомлениями.

Что такое MCP — в одном абзаце

Model Context Protocol — это стандартный способ дать ИИ-ассистенту набор вызываемых инструментов. Модели не нужно угадывать API по документации: сервер публикует типизированные описания инструментов, а клиент их вызывает. На практике именно это превращает «объясни, как купить энергию TRON» в «купи мне 65 000 энергии на час, но сначала проверь цену».

У TronSave две отдельные интеграции. MCP-сервер — полная версия для десктопных ассистентов и фреймворков для агентов. Интеграция WebMCP — небольшой, намеренно доступный только для чтения набор инструментов, который веб-приложение предлагает агентам в браузере. Ниже они описаны отдельно, потому что модели безопасности у них разные.

Адреса (эндпоинты)

Сеть Эндпоинт
Mainnet POST https://mcp.tronsave.io/mcp
Testnet POST https://mcp.tronsave.io/testnet/mcp
Mainnet, вход через OAuth POST https://mcp.tronsave.io/oauth/mcp
Testnet, вход через OAuth POST https://mcp.tronsave.io/oauth/testnet/mcp

Сеть определяется тем, к какому эндпоинту вы подключаетесь, — параметра сети, в котором можно ошибиться, просто нет. Все четыре отвечают на стандартное MCP-рукопожатие initialize и предлагают одинаковый набор инструментов, так что агента можно разработать в тестовой сети, а затем перенести в mainnet, поменяв один URL.

В клиенте, который читает JSON-конфиг, вся настройка сводится к этому:

{
  "mcpServers": {
    "tronsave": {
      "url": "https://mcp.tronsave.io/mcp"
    }
  }
}

Новое в 1.3.0: вход через OAuth. Приложения вроде Claude, Claude Code и Cursor могут подключаться к /oauth/mcp. Приложение открывает страницу входа TronSave, где вы вводите API-ключ или подписываете вход в TronLink, — вставлять учётные данные в конфиг-файл не нужно. Пошаговая настройка для каждого приложения: Как подключить TronSave к Claude Code, Cursor и Claude.

Нужно ли входить в аккаунт?

Для рыночных данных — нет. Сервер 1.0.0, который описывала первая версия этого руководства, требовал сессию для каждого вызова; публичные рыночные инструменты появились в версии 1.1.0, а начиная с 1.2.0 каждый инструмент объявляет один из трёх уровней доступа (в поле _meta["io.tronsave/auth"]). Проверить свой текущий статус можно в любой момент через tronsave_get_session_status:

Уровень доступа Инструменты Что открывает
Публичный, без входа 18 Котировки, минимальная цена, книга заказов, таблица цен, обзор рынка, системная информация, ресурсы аккаунта, подсказки для заказа, котировки Flash Unstake, публичный список заказов, а также create_order с оплатой в блокчейне из вашего кошелька.
API-ключ 9 Инструменты внутреннего аккаунта: баланс, адрес депозита, внутренние заказы и продления с оплатой из внесённого депозита.
Подпись кошелька 26 Ваш профиль, изменение и отмена заказов, настройки автопокупки и автопродажи, API-ключи, уведомления, рефералы, статистика продавца и пакетные внутренние заказы.

API-ключ передаётся через tronsave_login {apiKey} или в заголовке клиента Authorization: ApiKey <key>. Вход через подпись кошелька работает так:

1. tronsave_get_sign_message        -> { message, timestamp }
2. (sign `message` in your own wallet, client-side)
3. tronsave_login { signature: "<signature>_<timestamp>" }
                                    -> { sessionId, walletAddress, ... }
4. the login is bound to this MCP connection; never put a session id in tool arguments

Обратите внимание на шаг 2. Сервер выдаёт сообщение, вы подписываете его в своём кошельке и отправляете обратно только подпись. Никогда не отправляйте приватный ключ на сервер — протокол его никогда не запрашивает, и любой инструмент или клиент, который это делает, не имеет отношения к TronSave.

Вход по API-ключу проще и подходит для фоновых задач без интерфейса, но открывает только инструменты внутреннего аккаунта, а не весь набор платформы.

Публичному заказу в блокчейне всё равно нужен ваш кошелёк: tronsave_create_order с paymentMethod=onchain принимает перевод TRX, который вы сами подписываете, на адрес депозита из котировки. Сервер никогда не подписывает ничего за вас.

Два семейства инструментов

Семейство Количество Основа К чему даёт доступ
tronsave_* 46 Маркет на GraphQL Рыночные данные, заказы в блокчейне и инструменты сессии с подписью: отмена и изменение заказов, автопокупка, автопродажа, API-ключи, уведомления.
tronsave_internal_* 7 REST, аккаунт с API-ключом Расчёт, создание, история, детали, книга заказов и продление — всё в пределах внесённого внутреннего баланса.

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

Что умеют 53 инструмента?

Область Инструменты
Сессия и авторизация get_sign_message, login, logout, get_session_status
Рыночные данные (публичные) get_market_overview, get_price_table, get_system_info, get_account_resources, suggest_create_order
Цены и глубина рынка get_min_price, list_order_books, estimate_buy_resource, internal_order_book, internal_order_estimate
Аккаунт get_user_info, get_user_permissions, get_internal_account, get_deposit_address, list_internal_transactions
Заказы (платформа) create_order, get_order, list_orders, cancel_order, update_order, list_delegations
Заказы (внутренние) internal_order_create, internal_order_history, internal_order_details, bulk_create_internal_orders
Продление list_extendable_delegates, list_extendable_receivers, internal_extend_delegates, internal_create_extend_request
Автопокупка list_auto_buy_settings, create_auto_buy_setting, update_auto_buy_setting, delete_auto_buy_setting
Продажа sell_order_manual, register_auto_sell, update_auto_sell_setting, get_user_auto_setting, get_seller_stats
Flash Unstake list_flash_unstake_orders, estimate_flash_unstake, get_flash_unstake_request
Уведомления и программы list_notifications, mark_notifications_read, get_telegram_notify_setting, update_telegram_notify_setting, get_referral, get_agency_bot
API-ключи generate_api_key, revoke_api_key

(У всех названий есть префикс tronsave_; в таблице он опущен ради ширины.) Об инструментах продления стоит знать до того, как агент начнёт регулярно покупать: продление существующего делегирования обычно обходится дешевле, чем новый заказ.

Два из них требуют особого внимания, прежде чем дать агенту свободу. revoke_api_key сразу ломает все последующие запросы с прежним ключом, а delete_auto_buy_setting навсегда останавливает все будущие срабатывания правила. У обоих именно такие побочные эффекты указаны в документации — повторный запуск инструмента их не отменит.

Как агенту правильно покупать?

Сервер публикует собственный сценарий действий: промпт buy_resource, промпт account_overview и полное руководство в виде ресурса tronsave://guide/agent. Предписанный им процесс покупки состоит из четырёх шагов:

  1. tronsave_estimate_buy_resource возвращает цену за единицу, итоговую сумму (estimateTrx, в SUN) и доступный объём.
  2. Покажите пользователю получателя, объём, срок, цену за единицу и итог в TRX и получите явное «да».
  3. tronsave_create_order с ценой и суммой оплаты из шага 1.
  4. Проверьте результат через tronsave_get_order или tronsave_list_orders.

Ошибки возвращаются в виде {"error":{"code","message","retryable","hint"}}. Агент должен следовать подсказке (hint), никогда не повторять запись, если retryable равно false, и проверять состояние заказа перед повтором после тайм-аута.

Берите итог из estimateTrx, а не умножайте цену за единицу самостоятельно: аренда на день и дольше тарифицируется посуточно, поэтому цена на 30 дней из таблицы цен — это дневная ставка.

Правило свежести цены, о которое легко споткнуться

Это самая важная эксплуатационная деталь: рыночные цены и доступный объём могут меняться от одного блока TRON к следующему, то есть примерно каждые 3 секунды. Повторяйте расчёт или чтение книги заказов непосредственно перед созданием или изменением заказа и никогда не используйте котировку старше нескольких секунд.

С ИИ-агентом это важнее, чем с обычным кодом: модель может потратить несколько секунд на рассуждения между чтением цены и действием. Агент, который получил котировку, подумал, объяснил свой план и только потом сделал заказ, работает с устаревшим числом. Если промпт пишете вы, сделайте «перепроверь цену прямо перед заказом» явной инструкцией, а не рассчитывайте, что это само собой разумеется.

И ещё два соглашения, о которых нельзя забывать: все цены указаны в SUN (1 TRX = 1 000 000 SUN), а все сроки — в секундах.

Сторона браузера: WebMCP

Веб-приложение TronSave отдельно предоставляет ИИ-агентам в браузере гораздо меньший набор инструментов через экспериментальный API navigator.modelContext. Здесь дизайн намеренно консервативный. Рабочее приложение предлагает шесть инструментов (октябрь 2026 г.):

  • Обзор — что такое TronSave, его ключевые страницы и как обратиться к API программно.
  • Цена ресурса — текущая расчётная минимальная цена за единицу в SUN и расчётная стоимость в TRX для нужного объёма. Только чтение.
  • Обзор рынка — доступные энергия и пропускная способность (bandwidth) в сравнении с общим предложением, а также APY, который получают продавцы. Только чтение.
  • Стоимость перевода USDT — сколько энергии и пропускной способности нужно для заданного числа переводов USDT, сколько TRX сгорит без них и сколько вместо этого стоит аренда энергии на час. Только чтение.
  • Открыть страницу — навигация на известную страницу на стороне клиента. Никогда не подписывает и не отправляет транзакции.
  • Подготовить перевод USDT — открывает инструмент Transfer USDT с заполненными получателем и суммой. Ничего не отправляет: вы проверяете форму и подписываете в своём кошельке.

В браузерном наборе нет инструментов, которые двигают деньги или что-то подписывают, — это осознанная граница, а не недосмотр. Любая трата требует явного действия в кошельке с вашей стороны. Кроме того, интеграция проверяет поддержку API: в браузере без него она просто ничего не делает, а при выгрузке страницы отзывает свои инструменты, а не оставляет объявленным устаревший набор.

Разумная модель безопасности

Если вы даёте агенту доступ к тому, что тратит деньги, границы стоит продумать заранее:

  • Начните с эндпоинта тестовой сети. Те же инструменты, никаких реальных TRX.
  • Подтверждение перед любой записью. Собственные инструкции сервера требуют от агентов спрашивать пользователя перед вызовом любого инструмента, который не только читает данные.
  • Для автономной работы выбирайте семейство внутреннего аккаунта. Пополненный баланс — жёсткий потолок того, что может потратить агент.
  • Используйте отдельный API-ключ, который можно отозвать, ничего больше не затронув.
  • Для крупных сумм оставляйте подпись ручной. Подпись по задумке остаётся в вашем кошельке — не пытайтесь это обойти.

FAQ: частые вопросы

Какие ИИ-клиенты могут этим пользоваться?

Любой MCP-клиент, который умеет подключаться к удалённому серверу по HTTP, — в том числе Claude Desktop и Claude Code, а также фреймворки для агентов с поддержкой MCP. Сервер работает по стандартному протоколу, поэтому на стороне клиента ничего специфичного для TronSave не нужно. Настройка для Claude Code, Cursor и Claude, включая вход через OAuth: Как подключить TronSave к Claude Code, Cursor и Claude.

Как агент найдёт сервер самостоятельно?

Через файлы обнаружения, которые публикует TronSave, — llms.txt, а также каталог API, карточку MCP-сервера и манифест навыков агента в /.well-known/. Они указывают агенту на этот эндпоинт без того, чтобы кто-то вставлял URL вручную.

Нужен ли API-ключ, или достаточно кошелька?

Для котировок и рыночных данных не нужно ни то, ни другое: 18 инструментов публичные. API-ключ открывает инструменты внутреннего аккаунта, а подпись кошелька — управление аккаунтом: изменение заказов, автопокупку, автопродажу и API-ключи. Создавать и отзывать ключи можно через сам сервер.

Может ли сервер подписывать транзакции за меня?

Нет, и в этом весь смысл. Подпись всегда выполняется на стороне клиента. Сервер выдаёт сообщение для подписи и принимает готовую подпись — с вашим ключом он никогда не работает.

Можно ли попробовать, не тратя реальные TRX?

Да. Подключитесь к эндпоинту тестовой сети вместо mainnet. Всё остальное в интеграции идентично.

Доступны ли рыночные данные без входа?

Да. На работающем сервере (версия 1.3.0, проверено 2 ноября 2026 г.) котировки, минимальная цена, книга заказов, таблица цен, обзор рынка и заказы в блокчейне с оплатой из вашего кошелька работают без входа. Сервер 1.0.0, который описывала первая версия этого руководства, требовал сессию для каждого вызова.

Может ли агент платить через x402?

В сети TRON пока нет. На 28 октября 2026 г. привязка x402 к TRON всё ещё остаётся открытым предложением; подробнее — в статье x402 в TRON: могут ли ИИ-агенты уже платить в USDT? Сегодня агент платит обычным переводом TRX, подписанным в кошельке пользователя, или с заранее пополненного внутреннего баланса.

Чем это отличается от SDK?

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

Итог

ИИ-ассистент, который умеет читать книгу заказов TronSave и размещать заказы, — действительно полезный инструмент, если вы ведёте конвейер выплат или следите за ценами на энергию. Интеграция построена с правильными инстинктами: подпись остаётся на стороне клиента, браузерные инструменты не могут тратить средства, а семейство внутреннего баланса даёт естественный лимит. Начните с эндпоинта тестовой сети, научите агента перепроверять цену перед заказом и держите необратимые инструменты вне его досягаемости, пока не начнёте ему доверять.

TronSave издаёт этот блог и управляет описанным здесь MCP-сервером. Названия инструментов, их количество и поведение соответствуют версии сервера 1.3.0 (проверено 2 ноября 2026 г.) и могут измениться — актуальный набор возвращает вызов tools/list. Предоставление ИИ-агенту доступа к инструментам, которые тратят средства, связано с риском; начните с тестовой сети и строго ограничьте учётные данные. Это не финансовая рекомендация.

TronSave
TronSave

Команда TronSave создаёт маркетплейс энергии и пропускной способности TRON на tronsave.io и пишет эти руководства по результатам проверок в основной сети TRON.

Похожие статьи

Мы используем Google Analytics, чтобы понимать, какие руководства полезны читателям. Файлы cookie устанавливаются, только если аналитика разрешена. Рекламы в блоге нет. Конфиденциальность