TON MCP: دليل ربط وكيل الذكاء الاصطناعي بشبكة TON

لديك وكيل ذكاء اصطناعي — Claude داخل Cursor، أو سكربت على Codex، أو بوت خاص بك — وتريده أن يعمل فعليًا مع TON: أن يتحقّق من رصيد المحفظة قبل الإرسال، ويقرأ سجل المعاملات، ويحسب عرض سعر المبادلة، ويجهّز تبادلًا كروس-تشين. لكن الوكيل، مهما بلغ ذكاؤه، أعمى: لا عيون له داخل البلوكتشين. والطريق المعتاد هو تعليمه استدعاء toncenter أو tonapi.io عبر HTTP. وهنا يبدأ الوجع: بلا مفتاح يكون الحد نحو طلب واحد في الثانية، وتحت الحمل يصلك HTTP 429 Too Many Requests، واللايت-سيرفرات العامة من الإعداد العالمي تردّ بـ not ready أو تسقط بمهلة ADNL، ولا تحتفظ بسجل عميق للمعاملات أصلًا. فالوكيل الذي كل ما عليه فعله هو «إلقاء نظرة على الرصيد» يتعثّر في البنية التحتية.

الحل ليس أن تعلّم الوكيل الذهاب إلى الـ API يدويًا، بل أن تمنحه خادم MCP لشبكة TON. وفيما يلي الدليل الكامل: ما هو MCP، ولماذا يحتاجه الوكيل، وكيف تربطه مجانًا بأمر واحد، وما الذي تستطيع أدوات TONNode الـ16 فعله.

ما هو MCP ولماذا يحتاجه وكيل الذكاء الاصطناعي

MCP (Model Context Protocol) معيار مفتوح يستدعي عبره وكلاء الذكاء الاصطناعي أدوات خارجية. يفهمه Claude وCursor وChatGPT/Codex وأي عميل MCP آخر: تُعلن مجموعة من الأدوات، فيرى الوكيل أوصافها ويقرّر بنفسه أيّها يستدعي وبأي معاملات.

التشبيه بسيط: MCP بالنسبة إلى الوكيل مثل منفذ USB بالنسبة إلى الحاسوب. فالنموذج بمفرده لا يملك وصولًا إلى الشبكة ولا إلى البلوكتشين. لكن أوصِل خادم MCP، فيصير لدى الوكيل مجموعة «مقابس»: قراءة الرصيد، وتجميع معاملة، وتتبّع صفقة. تقول له «كم USDT في المحفظة X» — فيفهم النموذج أن الأداة المطلوبة هي get_jetton_balance، ويمرّر العنوان، ويستقبل ردًّا منظّمًا.

والفرق عن «أعطِ الوكيل نقطة نهاية HTTP» جوهري. فعند العمل عبر API خام يضطر الوكيل إلى أن يحتفظ في سياقه بكيفية تكوين الطلبات، وتحليل الردود، وتحويل العناوين والوحدات الخام. وكل ذلك مساحة خصبة للهلوسة. أما MCP فينقل هذا المنطق إلى الخادم: يرى الوكيل أداة get_balance بتوقيع واضح ويحصل على إجابة جاهزة. أخطاء أقل، وتوكنات أقل في السياق، وسلوك يمكن التنبؤ به.

TONNode (الموقع tonnode.io) هو تحديدًا خادم MCP مستضاف وجاهز لشبكة TON (The Open Network). نقطة نهاية واحدة، و16 أداة للقراءة والمبادلة والكروس-تشين والتعامل مع المحافظ، فوق بروتوكول TON الأصلي دون طبقات HTTP وسيطة.

لماذا يحتاج الوكيل إلى خادم MCP لـ TON بدل البوابات العامة على HTTP

سؤال وجيه: لماذا خادم منفصل ما دامت هناك واجهات عامة مثل toncenter وtonapi.io؟ المشكلة أن البوابات العامة تصلح لطلبات يدوية متفرّقة، لكنها ليست مصمَّمة للحمل الذي يولّده وكيل يستدعي عشرات النداءات في الدقيقة داخل حلقة.

• الحدود و429. بلا مفتاح يمنح toncenter وtonapi.io نحو طلب واحد في الثانية، وعند التجاوز يردّان بـ HTTP 429 Too Many Requests. والوكيل في حلقة «قرأ الحالة ← اتخذ قرارًا ← قرأ مجددًا» يصطدم بالسقف فورًا — فيعطي المستخدم خطأً بدل الإجابة.
• اللايت-سيرفرات العامة غير موثوقة. اللايت-سيرفرات من الإعداد العالمي (إن ذهبت إلى TON عبر ADNL مباشرة) مشتركة ومحدودة. تحت الحمل تردّ بـ not ready، وتسقط بمهلة ADNL، ولا تحتفظ بسجل عميق للمعاملات.
• الردّ الخام ≠ إجابة للوكيل. حتى JSON الناجح كثيرًا ما يحتاج معالجة لاحقة: حساب عنوان محفظة الجيتون، وإعادة حساب الوحدات الخام وفق decimals، وتحويل العنوان بين الصيغ. وكل خطوة من هذه تُترك للنموذج تعني احتمال خطأ وتوكنات ضائعة.

خادم MCP يتكفّل بهذا كله: سعة تمرير مستقرة مرتبطة بمفتاحك، وحسابات على جانب الخادم، وواجهة موحّدة بردود منظّمة جاهزة. وبالمناسبة، إن صادفت في المحادثات ذكرًا لـ«الخطأ 228»، فاعلم أنه رقم طريف متداول في مجتمع TON وليس كود API؛ أما كود الحد الحقيقي فهو 429 تحديدًا.

تجد شرحًا مفصّلًا للمسار المجاني في مقالة مستقلة: كيف تربط TON بوكيلك مجانًا.

كيف تربطه: مجانًا عبر npx، أو بمفتاح مستضاف

هناك مساران، والأول مجاني بالكامل.

الخيار 1. محليًا عبر npx (مجانًا، مجموعة القراءة الكاملة)

مجموعة أدوات القراءة الكاملة متاحة بلا تسجيل وبلا مفتاح. حزمة @tonnode/mcp مفتوحة المصدر (MIT)، وموجودة على npm وGitHub (tonnode/mcp)، وتعمل عبر بروتوكول ADNL الأصلي لشبكة TON. أضِف إلى إعداد عميل MCP لديك:

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

أعِد تشغيل Claude Desktop أو Cursor أو أي عميل آخر — وستظهر الأدوات من تلقاء نفسها. وتجد الإعداد خطوة بخطوة لكل عميل على حدة في دليل كيف تربط Claude وCursor بشبكة TON.

الخيار 2. مفتاح مستضاف (سعة تمرير مضمونة)

حين يعمل الوكيل في الإنتاج وتكثر الطلبات، تحتاج إلى مفتاح خاص بك وقناة مستقرة:

{
  "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 — «رأس» الـ masterchain، أي النقطة الحالية للشبكة.
• get_balance — رصيد GRAM على عنوان معيّن.
• get_account_state — حالة الحساب، والأعلام، وآخر معاملة.
• get_transactions — سجل معاملات العنوان.
• run_get_method — استدعاء أي get-method للقراءة فقط في أي عقد.
• get_jetton_balance — رصيد الجيتون (USDT مثلًا)؛ ويُحسب عنوان محفظة الجيتون على السلسلة، فلا حاجة إلى معرفته مسبقًا.
• parse_address — تحويل العناوين والتحقق منها (EQ/UQ/raw)، ويعمل دون اتصال.
• get_jetton_info — بيانات الجيتون الوصفية: الاسم، والرمز، والكمية المُصدَرة، والأهم decimals. وقيمة decimals حاسمة لإعادة حساب الوحدات الخام: في USDT تساوي 6، وفي معظم الجيتونات 9.

مثال على مطالبة لوكيل موصول بـ TONNode:

تحقّق من رصيد GRAM وUSDT في المحفظة UQ…، واعرض آخر 5 معاملات.

سيستدعي الوكيل بنفسه get_balance وget_jetton_balance (بعد أن يجلب decimals عبر get_jetton_info) وget_transactions — دون طلب HTTP يدوي واحد.

المبادلة (أداتان)

التبادل داخل TON عبر بروتوكول Omniston الذي يجمع سيولة STON.fi وDeDust:

• get_swap_quote — عرض سعر مؤكَّد من الـ DEX لزوج GRAM ⇄ جيتون.
• 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 — فالأموال لا تعلق لدى وسيط.

المحفظة (أداة واحدة)

• generate_wallet — تنشئ محفظة TON جديدة بأحد الإصدارات v3r2 أو v4 أو v5r1 أو highload_v3، وتعيد العبارة التذكيرية والمفاتيح والعنوان. والمحفظة المولَّدة لا يحتفظ بها الخادم — بل تُسلَّم إليك فورًا.

نظرة كاملة على الأدوات ومعاملاتها على صفحة tonnode.io/mcp.

عدم الاحتجاز: لماذا لا يحتفظ الخادم بمفاتيحك أبدًا

هذا فارق جوهري، ومن المهم استيعابه قبل أن تسمح للوكيل بالاقتراب من المال.

أدوات المبادلة والكروس-تشين وتوليد المحفظة غير احتجازية بصرامة. فخادم TONNode لا يوقّع المعاملات أبدًا، ولا يحتفظ بالأموال أو المفاتيح الخاصة أبدًا. وحين يستدعي الوكيل build_swap_tx أو build_crosschain_swap_tx، يستلم في المقابل رسالة TonConnect غير موقّعة — أي مسوّدة معاملة. وتوقّعها محفظة المستخدم لا الخادم. والمحافظ الناتجة عن generate_wallet تُسلَّم إليك كذلك ولا يبقى منها شيء على الخادم.

التشبيه: خادم MCP ملّاح يرسم المسار ويعبّئ أمر الدفع. أما الضغط على «إرسال» ووضع التوقيع فلا يقدر عليهما إلا أنت، وأنت خلف مقود محفظتك. وحتى لو اختُرق الوكيل أو أخطأ، فلا يمكنه سحب الأموال — إذ لا يملك سوى مسوّدات غير موقّعة.

ومن المفيد هنا المقارنة مع @ton/mcp الرسمي من TON Foundation. إنها حزمة قوية ورسمية: تدعم القراءة، وإرسال GRAM والجيتونات وNFT، والمبادلة عبر مجمّع DEX، والتعامل مع NFT وDNS، وإنشاء محافظ الوكلاء واستيرادها. لكنها من حيث البنية محفظة وكيل احتجازية بنظام split-key: مفتاح المشغّل (operator) يحتفظ به الوكيل نفسه ويوقّع به، ومفتاح المالك (owner) لدى المستخدم. وليس فيها كروس-تشين — TON فقط. والفارق صريح: الحزمة الرسمية تتيح للوكيل إنفاق الأموال باستقلالية والعمل مع NFT/DNS؛ بينما يراهن TONNode على عدم الاحتجاز والكروس-تشين والخيار المستضاف. تجد التحليل التفصيلي في مقالتَي TONNode في مواجهة TON MCP الرسمي وMCP الاحتجازي في مقابل غير الاحتجازي.

الخطط ومن أين تبدأ

على جميع الخطط تتوفر الأدوات الـ16 كلها — والفارق في سعة التمرير فقط:

الخطة	السعر	الحد
Hobby	مجانية إلى الأبد	60 طلبًا/دقيقة
Pro	29 دولارًا/شهر	300 طلب/دقيقة
Scale	199 دولارًا/شهر	1200 طلب/دقيقة

يمكن دفع اشتراكَي Pro وScale بـ GRAM أو USDT على شبكة TON عبر TonConnect، أو بـ BTC/ETH/SOL وعملات أخرى عبر فاتورة xRocket في Telegram. ويُصدر المفتاح تلقائيًا بعد تسوية الدفعة. (وللتنويه: GRAM هو Toncoin بعد إعادة تسميته في يونيو 2026، أما الشبكة نفسها فما زالت تُسمّى TON.)

مسار بداية عملي:

1. خذ مفتاح Hobby المجاني — بلا بطاقة، فور تسجيل الدخول، وبالأدوات الـ16 كلها: tonnode.io/dashboard?plan=hobby.
2. اكتب الإعداد المستضاف (أو ابدأ محليًا عبر npx -y @tonnode/mcp).
3. أعطِ الوكيل أول مطالبة قراءة — رصيد، حالة حساب، سجل — وتأكّد من أن 429 وnot ready لم يعودا يعترضان الطريق.

وبعدها، حين تصطدم بالحد في الإنتاج، اطّلع على الخطط وعلى نظرة عامة على الأدوات. ابدأ بالمفتاح المجاني، واربط وكيلك بـ TON في دقيقتين.