TON MCP тегін: ЖИ-агентті TON желісіне қосудың 2 жолы

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 — TON үшін hosted MCP-сервер (сайты — tonnode.io), және ол арқылы тегін TON MCP-ді екі жолмен қосуға болады, әрі екеуі де картаны талап етпейді. Екеуін де қарастырайық.

Тегін TON MCP: екі жол — локал npx және Hobby кілті

Агентті TON-ға тегін қосу үшін сізде таңдау бар:

1. npx арқылы локал іске қосу — ашық конфигте, мүлдем кілтсіз әрі тіркелусіз. Пакет сіздің машинаңызға жүктеліп, сонда іске қосылады.
2. Тегін Hobby кілті — сайтқа кіресіз, кілт бірден беріледі, картасыз, hosted-эндпоинт арқылы минутына 60 сұрау.

Олардың арасындағы айырмашылық — құралдар жинағында емес, процестің қай жерде орындалатынында және өткізу қабілетінің қайдан келетінінде. Ең қарапайымынан бастайық.

1-тәсіл: ашық конфигте npx арқылы локал іске қосу (кілтсіз)

Бұл — MCP-клиентіңіздің конфигіне қосылатын бір-ақ блок. Алдын ала ешнәрсе орнатудың қажеті жоқ — пакетті npx өзі жүктеп алады.

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

Болды. Клиент іске қосылғанда локал @tonnode/mcp процесі көтеріліп, TON-ға нативті протокол арқылы қосылады да, агентке оқу құралдарының толық жинағын береді. Кілт те, карта да, аккаунт та керек емес.

Техникалық жағынан маңызды деталь: @tonnode/mcp пакеті — open source (MIT), npm мен GitHub-та (tonnode/mcp) жатыр және сіздің агентіңіз бен желі арасында HTTP-қабаттарсыз, TON-ның нативті ADNL-протоколы бойынша жұмыс істейді. Яғни бұл — бөтен rate limit-ке тірелетін REST API үстіндегі қабықша емес, желіге тікелей қосылатын клиент.

Бұл конфигті қайда қою керек

• Claude Desktop / Claude Code — MCP конфигурация файлының mcpServers бөліміне.
• Cursor — жобаның MCP-серверлер баптауларына немесе глобал деңгейде.
• ChatGPT/Codex және басқа MCP-клиенттер — олардың MCP қосу бөліміне.

Әр клиент бойынша суреттермен берілген толық талдау — жеке нұсқаулықта: Claude мен Cursor-ды TON-ға қалай қосу керек.

Тегін не қолжетімді: TON-ды оқудың толық жинағы

Локал тегін режим — мүмкіндігі шектелген демо емес. Сізге оқудың толық жинағы ашық: агенттік тапсырмалардың басым көпшілігіне жететін сегіз құрал:

• get_masterchain_info — мастерчейннің «басы»: желінің ағымдағы күйі, агент осы арқылы желінің «қазір қай тұста тұрғанын» түсінеді.
• get_balance — әмиянның GRAM-дағы балансы (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 тізбегімен шешіледі. Агентке адам тіліндегі қарапайым промпт жеткілікті:

UQAbc...xyz мекенжайындағы USDT балансын тексер
және оны үтірден кейінгі дұрыс таңба санымен көрсет.

Агент get_jetton_info шақырып, decimals: 6 дегенді көреді, содан кейін get_jetton_balance шақырады да, дұрыс соманы шығарады — бұл үшін сіз бір жол да код жазбайсыз. Толық талдау — TON үшін MCP нұсқаулығында, ал жеке мысал — TON-дағы USDT балансын бір шақырумен қалай білуге болады.

2-тәсіл: тегін Hobby кілті — картасыз 60 сұрау/мин

Локал npx әзірлеуге және бір реттік тапсырмаларға жақсы, бірақ оның шегі бар: ол TON-ның глобал конфигіндегі ашық лайтсерверлер арқылы жүреді. Олар ортақ әрі лимитті, жүктеме кезінде жиі not ready немесе ADNL-таймаутпен жауап береді және терең тарихты сақтамайды. Нақты пайдаланушыларға қызмет көрсететін прод-агент үшін бұл — лотерея.

Дәл осы жерде екінші тегін жол — Hobby тарифі — іске қосылады. Ол мәңгі тегін, минутына 60 сұрау береді, ал кілт кірген бойда, картасыз беріледі. Локал режимнен айырмашылығы — сұраулар сіздің машинаңыздан ортақ ашық инфрақұрылым арқылы емес, TONNode-тың hosted-эндпоинті арқылы жеке кілтіңізбен жүреді, яғни сізде дәл өзіңізге бекітілген, болжамды 60 сұрау/мин лимиті болады.

Hosted-қосылымға арналған конфиг былай көрінеді:

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

Локал конфигтен екі айырмашылығы бар: процесті іске қосудың орнына type: "http" және кілтіңіз tn_live_… жазылған Authorization тақырыбы. Агенттің өзі жұмыста ешқандай айырмашылық байқамайды — сол құралдар, сол атаулар, сол параметрлер.

Маңыздысы: Hobby-де де, қалған барлық тарифтердегідей, TONNode-тың 16 құралының бәрі қолжетімді — тек оқу ғана емес, своп, кроссчейн, әмиян генерациясы да. Дәл hosted-кілтте сегіз оқу құралының үстіне, атап айтқанда, generate_wallet қосылады — v3r2, v4, v5r1 немесе highload_v3 нұсқаларындағы жаңа TON-әмиян жасау: құрал мнемониканы, кілттерді және мекенжайды тікелей сізге қайтарады, сервер генерацияланған әмияндарды сақтамайды. Тариф функционалды емес, өткізу қабілетін шектейді. Сіз тек 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 сұрау аз болғанда немесе нақты жүктеме кезінде mcp.tonnode.io hosted-эндпоинтінде болжамды өз лимитіңіз қажет болғанда. Толық ақпарат — тарифтер бетінде және құралдар туралы бетте.

Қадам-қадаммен: агентті қосып, алғашқы шақыруды жасаймыз

Локал іске қосу мысалында бәрін бір жерге жинайық (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-қадам. Күрделірек тапсырмалар да — бір промптпен. Айталық:

UQAbc...xyz әмиянында қанша USDT бар? Соманы decimals ескеріп қайтар.

Мұнда агент USDT-дің decimals мәнін (=6) білу үшін get_jetton_info шақырады, содан кейін шикі балансты алу үшін get_jetton_balance шақырады да, оны адам оқитын сомаға айналдырады. Жеттон-әмиянды ол он-чейн есептейді — оның мекенжайын беруіңіздің қажеті жоқ.

5-қадам. Ашық лайтсерверлердің лимитіне тірелгенде (not ready немесе таймаут көрсеңіз) — блокты Hobby кілті бар hosted-конфигке ауыстырыңыз. Тек конфиг қана өзгереді, промпттар мен агент логикасы бұрынғы күйінде қалады.

Кастодиалды еместік: тегін қатынау неге қауіпсіз

Заңды сұрақ: егер сервер тегін болса әрі сол сервер әмиян генерациялап, транзакция құрастырса — кілттерім қауіп астында қалмай ма? Жоқ, әрі бұл — архитектураның принципті ұстанымы. TONNode қатаң түрде кастодиалды емес.

Сервер ешқашан транзакцияға қол қоймайды және қаражат пен жабық кілттерді сақтамайды. Оқу құралдары жай ғана ашық он-чейн стейтті оқиды. Ал күйді өзгертетін құралдар — своп пен кроссчейн — сіздің атыңыздан ештеңе жібермейді: олар қол қойылмаған TonConnect-хабарламаларын қайтарады. Оларға пайдаланушының әмияны локал түрде, өз кілтімен қол қояды. generate_wallet да солай (ол hosted-кілтте қолжетімді): генерацияланған әмиян мен оның мнемоникасы сізге беріледі, сервер оларды өзінде қалдырмайды.

Басқаша айтқанда, тегін қатынау ақылысынан бір мысқал да тәуекелді емес: транзакцияға физикалық тұрғыда тек әмиян иесі ғана қол қоя алады — серверде бірдеңеге қол қоятын кілт жоқ. Бұл — сервер operator-кілтті ұстап, өзі қол қоятын кастодиалды модельден принципті айырмашылық. Екі тәсілдің және олардың тәуекелдерінің талдауы — кастодиалды және кастодиалды емес MCP туралы жеке материалда.

Қорытынды

ЖИ-агентке TON-мен жұмыс істейтін құрал беру үшін нода көтерудің де, картаның да қажеті жоқ. Локал npx -y @tonnode/mcp дәл қазір кілтсіз оқудың толық жинағын береді — сынап көру үшін тамаша. Ал ашық лайтсерверлер жетпей қалғанда, тегін Hobby тарифі hosted-эндпоинт арқылы кілтіңізде болжамды 60 сұрау/мин қосады — бұл да картасыз. Екі режим де кастодиалды емес, екеуі де бірдей құралдарды пайдаланады, әрі кез келген сәтте агент логикасында ештеңені қайта жазбай, ақылы throughput-қа көше аласыз.

Тегін Hobby кілтін алу (картасыз): tonnode.io/dashboard?plan=hobby