TON MCP: ЖИ-агентке TON қолжетімділігін беру — толық нұсқаулық

Сізде ЖИ-агент бар — Cursor-дағы Claude, Codex-тегі скрипт, өз қолыңызбен жазған бот, — және оның TON-мен шынымен жұмыс істегенін қалайсыз: жіберер алдында әмиянның балансын тексерсін, транзакциялар тарихын оқысын, свап котировкасын есептесін, кроссчейн айырбасты дайындасын. Бірақ агент қаншалықты ақылды болса да, соқыр: оның блокчейнде көзі жоқ. Әдеттегі жол — оны toncenter немесе tonapi.io-ға HTTP арқылы баруға үйрету. Дәл осы жерден азап басталады: кілтсіз лимит секундына шамамен бір сұрау, жүктеме кезінде HTTP 429 Too Many Requests келеді, глобал конфигтегі ашық лайтсерверлер not ready деп жауап береді немесе ADNL-таймаутпен үзіледі, ал терең тарих оларда мүлдем жоқ. «Жай ғана балансты қарауы» тиіс агент инфрақұрылымға сүрініп қалады.

Шешім — агентті API-ға қолмен баруға үйрету емес, оған TON үшін MCP-сервер беру. Төменде — толық нұсқаулық: MCP деген не, ол агентке не үшін керек, бір командамен тегін қалай қосылуға болады және TONNode-тың 16 құралы нені істей алады.

MCP деген не және ол ЖИ-агентке не үшін керек

MCP (Model Context Protocol) — ЖИ-агенттер сыртқы құралдарды шақыратын ашық стандарт. Оны Claude, Cursor, ChatGPT/Codex және кез келген басқа MCP-клиент түсінеді: сіз құралдар жинағын жариялайсыз, агент олардың сипаттамасын көреді және қайсысын, қандай параметрлермен шақыруды өзі шешеді.

Аналогиясы қарапайым: агент үшін MCP — компьютер үшін USB-порт сияқты. Модельдің өз бетінше не желіге, не блокчейнге қолжетімділігі жоқ. Ал MCP-серверді қоссаңыз — агентте «розеткалар» жинағы пайда болады: балансты оқу, транзакция жинау, мәмілені қадағалау. Сіз «X әмиянында қанша USDT бар» дейсіз — модель get_jetton_balance құралы керегін түсінеді, мекенжайды қояды және құрылымдалған жауап алады.

«Агентке HTTP-эндпоинт бер» дегеннен айырмашылығы түбегейлі. Шикі API арқылы жұмыс істегенде агент сұрауларды қалай құруды, жауаптарды қалай талдауды, мекенжайлар мен raw-бірліктерді қалай конверттеуді контекстінде ұстауға мәжбүр. Мұның бәрі — галлюцинацияға орын. MCP бұл логиканы серверге шығарады: агент түсінікті сигнатурасы бар get_balance құралын көреді және дайын жауап алады. Қате азырақ, контексте токен азырақ, мінез-құлық болжамды.

TONNode (сайты tonnode.io) — TON (The Open Network) үшін дәл осындай дайын hosted MCP-сервер. Бір эндпоинт, оқуға, свапқа, кроссчейнге және әмияндармен жұмысқа арналған 16 құрал — аралық HTTP-қабаттарсыз, TON-ның нативті протоколының үстінде.

Агентке неге ашық HTTP-шлюздер емес, TON үшін MCP-сервер керек

Орынды сұрақ: toncenter пен tonapi.io тәрізді ашық API бола тұра, бөлек сервер не үшін керек? Мәселе мынада: ашық шлюздер бір реттік қолмен жасалатын сұрауларға жарайды, бірақ минутына ондаған шақыруды циклде жасайтын агенттің жүктемесіне есептелмеген.

• Лимиттер және 429. Кілтсіз toncenter пен tonapi.io секундына шамамен бір сұрау береді және асып кеткенде HTTP 429 Too Many Requests деп жауап қайтарады. «Күйді оқыды → шешім қабылдады → тағы оқыды» циклінде жүрген агент төбеге лезде тіреледі — және пайдаланушыға жауаптың орнына қате береді.
• Ашық лайтсерверлер сенімсіз. Глобал конфигтегі лайтсерверлер (егер TON-ға ADNL арқылы тікелей барсаңыз) — ортақ әрі лимитті. Жүктеме кезінде олар not ready деп жауап береді, ADNL-таймаутпен үзіледі және транзакциялардың терең тарихын сақтамайды.
• Шикі жауап ≠ агентке арналған жауап. Тіпті сәтті JSON да көбіне кейінгі өңдеуді талап етеді: жетон-әмиянның мекенжайын есептеу, raw-бірліктерді decimals бойынша қайта санау, мекенжайды форматтар арасында конверттеу. Модельге берілген әрбір осындай қадам — ықтимал қате және артық токен.

MCP-сервер осының бәрін жабады: кілтіңізге байланған тұрақты өткізу қабілеті, есептеулердің сервер жағында жүруі және дайын құрылымдалған жауаптары бар біртұтас интерфейс. Айтпақшы, чаттарда «228 қатесін» кездестірсеңіз — бұл TON-комьюнитидің мем-саны, API коды емес; лимиттің нақты коды — дәл 429.

Тегін жолдың толық талдауы бөлек жазбада бар: TON-ды агентке тегін қалай қосуға болады.

Қалай қосуға болады: npx арқылы тегін және hosted-кілтпен

Екі жол бар, әрі біріншісі — толықтай тегін.

1-нұсқа. Жергілікті, npx арқылы (тегін, оқу құралдарының толық жинағы)

Оқуға арналған құралдардың толық жинағы тіркеусіз әрі кілтсіз қолжетімді. @tonnode/mcp пакеті — open source (MIT), npm мен GitHub-та (tonnode/mcp) жатыр, TON-ның нативті ADNL-протоколы бойынша жұмыс істейді. MCP-клиенттің конфигіне қосыңыз:

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

Claude Desktop, Cursor немесе басқа клиентті қайта іске қосыңыз — құралдар өздігінен пайда болады. Нақты клиенттерге арналған қадамдық баптау — Claude мен Cursor-ды TON-ға қалай қосуға болады нұсқаулығында.

2-нұсқа. Hosted-кілт (кепілді өткізу қабілеті)

Агент продта жұмыс істеп, сұрау көп болғанда — өз кілтіңіз бен тұрақты арна керек:

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

Тегін Hobby кілті кірген бойда, картасыз беріледі, әрі онда 16 құралдың бәрі қолжетімді — tonnode.io/dashboard?plan=hobby.

TONNode-тың 16 құралы топтар бойынша

Барлық тарифтерде құралдардың бәрі қолжетімді — сіз тек өткізу қабілеті үшін төлейсіз. Топтар бойынша талдайық.

Оқу (8 құрал)

Желіні бақылап, ештеңені өзгертпейтін кез келген агенттің іргетасы:

• get_masterchain_info — мастерчейннің «басы», желінің ағымдағы нүктесі.
• get_balance — мекенжайдағы GRAM балансы.
• get_account_state — аккаунт статусы, жалаушалар, соңғы транзакция.
• get_transactions — мекенжайдың транзакциялар тарихы.
• run_get_method — контрактінің кез келген read-only get-әдісін шақыру.
• get_jetton_balance — жетон балансы (мысалы, USDT); жетон-әмиянның мекенжайы он-чейн есептеледі, оны алдын ала білудің қажеті жоқ.
• parse_address — мекенжайларды конверттеу және тексеру (EQ/UQ/raw), офлайн жұмыс істейді.
• get_jetton_info — жетонның метадеректері: аты, символы, эмиссиясы және ең бастысы — decimals. Decimals raw-бірліктерді қайта санау үшін өте маңызды: USDT-де ол 6, жетондардың көпшілігінде — 9.

TONNode қосылған агентке берілетін промпт мысалы:

UQ… әмиянындағы GRAM және USDT балансын тексер, соңғы 5 транзакцияны көрсет.

Агент get_balance, get_jetton_balance (алдын ала get_jetton_info арқылы decimals алып) және get_transactions құралдарын өзі шақырады — бірде-бір қолмен жасалатын HTTP-сұраусыз.

Свап (2 құрал)

TON ішіндегі айырбас — STON.fi мен DeDust өтімділігін біріктіретін Omniston протоколы арқылы:

• get_swap_quote — GRAM ⇄ жетон жұбы үшін DEX-тің нақты котировкасы.
• build_swap_tx — TonConnect арқылы қол қоюға дайын, қол қойылмаған свап транзакциясы.

«Қол қойылмаған» деген сөзге назар аударыңыз — оған кастодиалды еместік туралы бөлімде қайта ораламыз.

Кроссчейн (5 құрал)

TON әрқашан бастау көзі болады, ал айырбас атомарлық HTLC-эскроу арқылы жүреді — бұл қаражат құпияның хеші бойынша бұғатталып, тек екі желіде де шарттар орындалғанда ғана бұғаттан босайтын механизм. Қолдау көрсетілетін желілер: Ethereum, Arbitrum, Base, BNB Chain, Polygon, Avalanche. TRON әзірге қолдау таппайды.

• get_crosschain_quote — кроссчейн айырбастың котировкасы.
• build_crosschain_swap_tx — қол қойылмаған HTLC-эскроу транзакциясы және құпия.
• track_crosschain_swap — мәміленің екі желідегі фазалары.
• disclose_crosschain_secret — он-чейн дайындықты тексергеннен кейін есеп айырысу үшін құпияны ашу.
• build_crosschain_refund — мәміле ілініп қалса, эскроудан қаражатты қайтару.

HTLC-схема айырбастың не атомарлы түрде өтетінін, не refund арқылы қайтарылатынын білдіреді — қаражат делдалда тұрып қалмайды.

Әмиян (1 құрал)

• generate_wallet — v3r2, v4, v5r1 немесе highload_v3 нұсқаларындағы жаңа TON-әмиян жасайды әрі мнемониканы, кілттерді және мекенжайды қайтарады. Генерацияланған әмиянды сервер сақтамайды — ол бірден сізге беріледі.

Құралдардың параметрлерімен қоса толық шолуы — tonnode.io/mcp бетінде.

Кастодиалды еместік: сервер сіздің кілттеріңізді неге ешқашан ұстамайды

Бұл — түбегейлі айырмашылық, әрі оны агентті ақшаға жақындатпай тұрып түсініп алған жөн.

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

Аналогиясы: MCP-сервер — маршрут салып, төлем тапсырмасын толтыратын штурман. Ал «жіберу» түймесін басып, қол қоятын жалғыз адам — өз әмияныңыздың тұтқасын ұстап отырған сіз. Тіпті агент бұзып кірушінің қолына түссе немесе қателессе де, ол қаражатты әкете алмайды — қолында тек қол қойылмаған дайындамалар ғана.

Мұнда TON Foundation-ның ресми @ton/mcp-імен салыстыру пайдалы. Бұл — күшті әрі ресми пакет: ол оқи алады, GRAM/жетон/NFT жібере алады, DEX-агрегатор арқылы свап жасай алады, NFT мен DNS-пен жұмыс істей алады, агент-әмияндарды құрып, импорттай алады. Бірақ құрылымы жағынан бұл — split-key схемасындағы кастодиалды агент-әмиян: operator-кілтті агенттің өзі ұстайды әрі сонымен қол қояды, owner-кілт пайдаланушыда. Әрі оның кроссчейні жоқ — тек TON. Айырмашылық адал: ресми пакет агентке қаражатты автономды жұмсауға және NFT/DNS-пен жұмыс істеуге мүмкіндік береді; TONNode болса кастодиалды еместікке, кроссчейнге және hosted-нұсқаға басымдық береді. Егжей-тегжейлі талдау — TONNode vs ресми TON MCP және кастодиалды vs кастодиалды емес MCP мақалаларында.

Тарифтер және неден бастау керек

Барлық тарифтерде 16 құралдың бәрі қолжетімді — тек өткізу қабілеті ғана ерекшеленеді:

Тариф	Бағасы	Лимит
Hobby	мәңгілікке тегін	60 сұрау/мин
Pro	$29/ай	300 сұрау/мин
Scale	$199/ай	1200 сұрау/мин

Pro мен Scale-ді TON желісіндегі GRAM немесе USDT-мен TonConnect арқылы, не болмаса Telegram-дағы xRocket шоты арқылы BTC/ETH/SOL және басқа валюталармен төлеуге болады. Кілт есеп айырысудан кейін автоматты түрде беріледі. (Шатаспау үшін айта кетейік: GRAM — 2026 жылдың маусымында атауы өзгертілген Toncoin, ал желінің өзі бұрынғысынша TON деп аталады.)

Бастаудың практикалық жолы:

1. Тегін Hobby кілтін алыңыз — картасыз, кірген бойда, 16 құралдың бәрімен: tonnode.io/dashboard?plan=hobby.
2. Hosted-конфигті жазып қойыңыз (немесе npx -y @tonnode/mcp арқылы жергілікті бастаңыз).
3. Агентке оқуға арналған алғашқы промптты беріңіз — баланс, аккаунт күйі, тарих — және 429-бен not ready енді кедергі келтірмейтініне көз жеткізіңіз.

Әрі қарай, продта лимитке тірелгенде, тарифтерді және құралдарға шолуды қараңыз. Тегін кілттен бастаңыз да, агентті TON-ға бірер минутта қосыңыз.