Как бесплатно подключить ИИ-агента к TON через MCP

Вы просите Claude или Cursor «проверь баланс этого TON-кошелька и покажи последние транзакции» — и агент честно пытается. Дёргает публичный лайтсервер из глобального конфига, получает not ready, ретраит, ловит ADNL-таймаут. Или идёт в toncenter без ключа, упирается в лимит примерно один запрос в секунду и получает HTTP 429 Too Many Requests. Агент не умеет читать TON сам по себе — ему нужны инструменты. И большинство разработчиков на этом этапе думают, что придётся поднимать ноду, крутить конфиги, платить за доступ. На деле нет: подключить агента к TON можно бесплатно и без этих граблей — двумя разными способами, и оба не требуют карты.

Самый быстрый способ дать агенту руки в TON — это MCP. Model Context Protocol — это стандарт, по которому ИИ-агенты (Claude, Cursor, ChatGPT/Codex и любой MCP-клиент) вызывают внешние инструменты. Вместо того чтобы учить агента дёргать сырой JSON-RPC и разбирать ячейки, вы отдаёте ему набор готовых инструментов вроде get_balance или get_jetton_balance — а он сам решает, когда их вызвать. TONNode — это hosted MCP-сервер для TON (сайт tonnode.io), и подключить через него бесплатный TON MCP можно двумя путями, ни один из которых не требует карты. Разберём оба.

Бесплатный TON MCP: два пути — локальный npx и ключ Hobby

Чтобы подключить агента к TON бесплатно, у вас есть выбор:

1. Локальный запуск через npx на публичном конфиге — вообще без ключа и без регистрации. Пакет скачивается и запускается на вашей машине.
2. Бесплатный ключ Hobby — вход на сайт, ключ выдаётся сразу, без карты, 60 запросов в минуту через hosted-эндпоинт.

Разница между ними — не в наборе инструментов, а в том, где крутится процесс и откуда берётся пропускная способность. Начнём с самого простого.

Способ 1: локальный запуск через npx на публичном конфиге (без ключа)

Это буквально один блок в конфиге вашего MCP-клиента. Никакой предварительной установки — npx сам подтянет пакет.

{
  "mcpServers": {
    "ton": {
      "command": "npx",
      "args": ["-y", "@tonnode/mcp"]
    }
  }
}

Всё. При старте клиента поднимется локальный процесс @tonnode/mcp, подключится к TON по нативному протоколу и отдаст агенту полный набор инструментов чтения. Ключ не нужен, карта не нужна, аккаунт не нужен.

Важная деталь под капотом: пакет @tonnode/mcp — open source (MIT), лежит на npm и GitHub (tonnode/mcp), и работает по нативному ADNL-протоколу TON, без HTTP-прослоек между вашим агентом и сетью. То есть это не обёртка над чьим-то REST API, которая упрётся в чужой rate limit, — это прямой клиент к сети.

Куда класть этот конфиг

• Claude Desktop / Claude Code — в mcpServers файла конфигурации MCP.
• Cursor — в настройках MCP-серверов проекта или глобально.
• ChatGPT/Codex и другие MCP-клиенты — в их разделе подключения MCP.

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

Что доступно бесплатно: полный набор чтения TON

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

• get_masterchain_info — «голова» мастерчейна: текущее состояние сети, по которому агент понимает, «где сейчас находится» сеть.
• get_balance — баланс кошелька в GRAM (это переименованный в июне 2026 Toncoin; сама сеть по-прежнему называется TON).
• get_account_state — статус аккаунта, флаги, последняя транзакция. Полезно, чтобы понять, задеплоен ли контракт и активен ли кошелёк.
• get_transactions — история транзакций по адресу.
• run_get_method — вызов любого read-only get-метода произвольного контракта. Ваш универсальный «читатель чего угодно» для смарт-контрактов.
• get_jetton_balance — баланс жетона, включая USDT; адрес джеттон-кошелька вычисляется он-чейн, вам не нужно знать его заранее.
• get_jetton_info — метаданные жетона: имя, символ, эмиссия и, что критично для расчётов, decimals. У USDT decimals = 6, у большинства жетонов = 9 — без этого числа вы не пересчитаете сырые единицы в человеческие суммы.
• parse_address — конвертация и проверка адресов (EQ/UQ/raw), работает офлайн, без обращения к сети.

Практический пример. Классическая задача «покажи баланс USDT одним вызовом» решается связкой get_jetton_info (узнать decimals) + get_jetton_balance. Агенту достаточно промпта на человеческом языке:

Проверь баланс USDT на адресе UQAbc...xyz
и покажи его с правильным числом знаков после запятой.

Агент сам вызовет get_jetton_info, увидит decimals: 6, затем get_jetton_balance, и выдаст корректную сумму — без единой строчки вашего кода. Разбор в гайде по MCP для TON и отдельный пример, как узнать баланс USDT на TON одним вызовом.

Способ 2: бесплатный ключ Hobby — 60 запросов/мин без карты

Локальный npx хорош для разработки и одиночных задач, но у него есть предел: он ходит через публичные лайтсерверы из глобального конфига TON. Они общие и лимитированные, часто отвечают not ready или ADNL-таймаутом под нагрузкой и не хранят глубокой истории. Для прод-агента, который отвечает реальным пользователям, это лотерея.

Здесь включается второй бесплатный путь — тариф Hobby. Он бесплатен навсегда, даёт 60 запросов в минуту, и ключ выдаётся сразу после входа, без карты. Разница с локальным режимом в том, что запросы идут не с вашей машины через общую публичную инфраструктуру, а через hosted-эндпоинт TONNode с вашим личным ключом — то есть у вас предсказуемый лимит 60 запросов/мин, привязанный именно к вам.

Конфиг для hosted-подключения выглядит так:

{
  "mcpServers": {
    "ton": {
      "type": "http",
      "url": "https://mcp.tonnode.io/mcp",
      "headers": {
        "Authorization": "Bearer tn_live_…"
      }
    }
  }
}

Отличий от локального конфига два: type: "http" вместо запуска процесса и заголовок Authorization с вашим ключом tn_live_…. Сам агент разницы в работе не заметит — те же инструменты, те же имена, те же параметры.

Что важно: на Hobby, как и на всех остальных тарифах, доступны все 16 инструментов TONNode — не только чтение, но и свап, кроссчейн, генерация кошелька. Именно на hosted-ключе к восьми инструментам чтения добавляется, в частности, generate_wallet — создание нового TON-кошелька версий v3r2, v4, v5r1 или highload_v3: инструмент возвращает мнемонику, ключи и адрес прямо вам, сервер сгенерированные кошельки не хранит. Тариф ограничивает не функциональность, а пропускную способность. Вы платите только за throughput, если он вам понадобится.

Получить ключ Hobby (без карты): tonnode.io/dashboard?plan=hobby.

Локально или hosted: где бесплатного хватает, а где нужен throughput

Коротко: бесплатного хватает почти всегда, пока речь идёт о разработке, прототипах и невысокой частоте вызовов. Разница между режимами — не в наборе инструментов, а в пропускной способности.

Режим	Ключ / карта	Пропускная способность	Для чего
Локальный npx	Не нужны	Публичные лайтсерверы (общие, лимит)	Разработка, разовые задачи
Hobby (hosted)	Ключ, без карты	60 запросов/мин на вашем ключе	Пет-проекты, лёгкий прод
Pro / Scale (hosted)	Ключ + оплата	300 / 1200 запросов/мин	Нагруженный прод

Ключевой факт: на всех тарифах доступны все 16 инструментов — включая свап и кроссчейн. Платите вы только за пропускную способность, а не за «разблокировку» функций. Pro стоит $29/мес и даёт 300 запросов/мин, Scale — $199/мес и 1200 запросов/мин. Платный throughput нужен ровно тогда, когда вам мало 60 запросов в минуту или когда нужен предсказуемый собственный лимит на hosted-эндпоинте mcp.tonnode.io под реальной нагрузкой. Полная раскладка на странице тарифов и странице про инструменты.

Пошагово: подключаем агента и делаем первый вызов

Соберём всё вместе на примере с локальным запуском (для Hobby отличается только блок конфига).

Шаг 1. Добавьте сервер в конфиг MCP-клиента. Возьмите блок с npx -y @tonnode/mcp, показанный выше, и вставьте в конфиг вашего клиента (Claude, Cursor, Codex — путь зависит от клиента).

Шаг 2. Перезапустите клиент. Он поднимет процесс @tonnode/mcp и увидит инструменты. В большинстве клиентов список подключённых инструментов виден в интерфейсе — убедитесь, что ton появился.

Шаг 3. Дайте агенту задачу обычным текстом. Например:

Узнай текущую голову мастерчейна TON и заодно
баланс адреса UQAbc...xyz в GRAM.

Агент сам вызовет get_masterchain_info, затем get_balance и вернёт результат человеческим языком.

Шаг 4. Задачи посложнее — тоже одним промптом. Скажем:

Сколько USDT на кошельке UQAbc...xyz? Верни сумму с учётом decimals.

Здесь агент вызовет get_jetton_info, чтобы узнать decimals USDT (=6), затем get_jetton_balance, чтобы получить сырой баланс, и пересчитает его в человеческую сумму. Джеттон-кошелёк он вычислит он-чейн — вам не нужно передавать его адрес.

Шаг 5. Когда упрётесь в лимит публичных лайтсерверов (увидите not ready или таймауты) — замените блок на hosted-конфиг с ключом Hobby. Меняется только конфиг, промпты и логика агента остаются прежними.

Некастодиальность: почему бесплатный доступ безопасен

Логичный вопрос: если сервер бесплатный и он же генерирует кошельки и строит транзакции — не рискую ли я ключами? Нет, и это принципиальная позиция архитектуры. TONNode строго некастодиален.

Сервер никогда не подписывает и не хранит средства и приватные ключи. Инструменты чтения просто читают публичный ончейн-стейт. А инструменты, которые меняют состояние — свап и кроссчейн — не отправляют ничего от вашего имени: они возвращают неподписанные TonConnect-сообщения. Подписывает их кошелёк пользователя, локально, своим ключом. То же и с generate_wallet (он доступен на hosted-ключе): сгенерированный кошелёк и его мнемоника отдаются вам, сервер их у себя не оставляет.

Иными словами, бесплатный доступ ничем не рискованнее платного: подписывать транзакции физически может только владелец кошелька — у сервера нет ключей, чтобы что-либо подписать. Это принципиальное отличие от кастодиальной модели, где сервер держит operator-ключ и подписывает сам. Разбор двух подходов и их рисков — в отдельном материале про кастодиальный и некастодиальный MCP.

Итог

Чтобы дать ИИ-агенту руки в TON, не нужно поднимать ноду и не нужна карта. Локальный npx -y @tonnode/mcp даёт полный набор чтения без ключа прямо сейчас — идеально, чтобы попробовать. Бесплатный тариф Hobby добавляет предсказуемые 60 запросов/мин на вашем ключе через hosted-эндпоинт, тоже без карты, когда публичных лайтсерверов начинает не хватать. Оба режима некастодиальны, оба используют одни и те же инструменты, и в любой момент вы можете перейти на платный throughput, ничего не переписывая в логике агента.

Получить бесплатный ключ Hobby (без карты): tonnode.io/dashboard?plan=hobby