Обновлено: 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. Предписанный им процесс покупки состоит из четырёх шагов:
tronsave_estimate_buy_resourceвозвращает цену за единицу, итоговую сумму (estimateTrx, в SUN) и доступный объём.- Покажите пользователю получателя, объём, срок, цену за единицу и итог в TRX и получите явное «да».
tronsave_create_orderс ценой и суммой оплаты из шага 1.- Проверьте результат через
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 и размещать заказы, — действительно полезный инструмент, если вы ведёте конвейер выплат или следите за ценами на энергию. Интеграция построена с правильными инстинктами: подпись остаётся на стороне клиента, браузерные инструменты не могут тратить средства, а семейство внутреннего баланса даёт естественный лимит. Начните с эндпоинта тестовой сети, научите агента перепроверять цену перед заказом и держите необратимые инструменты вне его досягаемости, пока не начнёте ему доверять.
Подключите агента: направьте свой MCP-клиент на https://mcp.tronsave.io/testnet/mcp для экспериментов, затем переключитесь на эндпоинт mainnet и посмотрите, как он рассчитывает цены на живом рынке энергии.
TronSave издаёт этот блог и управляет описанным здесь MCP-сервером. Названия инструментов, их количество и поведение соответствуют версии сервера 1.3.0 (проверено 2 ноября 2026 г.) и могут измениться — актуальный набор возвращает вызов tools/list. Предоставление ИИ-агенту доступа к инструментам, которые тратят средства, связано с риском; начните с тестовой сети и строго ограничьте учётные данные. Это не финансовая рекомендация.


