TON MCP مجانًا — اربط وكيلك الذكي بشبكة TON بلا بطاقة

تطلب من 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 خامًا ويفكّك خلايا TON (cells)، تسلّمه مجموعة أدوات جاهزة من نوع get_balance أو get_jetton_balance — ويقرّر هو متى يستدعيها. وTONNode خادم MCP مُستضاف لشبكة TON (الموقع tonnode.io)، ويمكنك عبره تشغيل TON MCP مجانًا بطريقتين، لا تحتاج أيٌّ منهما إلى بطاقة. لنستعرضهما معًا.

TON MCP مجانًا: طريقان — npx محلي ومفتاح Hobby

لربط الوكيل بشبكة TON مجانًا أمامك خياران:

1. تشغيل محلي عبر npx على الإعداد العام — بلا مفتاح إطلاقًا وبلا تسجيل. تُنزَّل الحزمة وتعمل على جهازك أنت.
2. مفتاح Hobby المجاني — تسجّل الدخول إلى الموقع فيُصدَر المفتاح فورًا، دون بطاقة، بواقع 60 طلبًا في الدقيقة عبر نقطة النهاية المُستضافة.

والفارق بينهما ليس في مجموعة الأدوات، بل في مكان تشغيل العملية ومصدر السعة التمريرية. لنبدأ بالأبسط.

الطريقة الأولى: تشغيل محلي عبر npx على الإعداد العام (بلا مفتاح)

إنه حرفيًا كتلة واحدة في إعداد عميل MCP لديك. لا تثبيت مسبق — فـ npx سيجلب الحزمة بنفسه.

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

هذا كل شيء. فعند تشغيل العميل تنطلق عملية @tonnode/mcp محليًا، وتتصل بشبكة TON عبر بروتوكولها الأصلي، وتسلّم الوكيل مجموعة أدوات القراءة كاملة. لا مفتاح، ولا بطاقة، ولا حساب.

وتفصيلة مهمة تحت الغطاء: حزمة @tonnode/mcp مفتوحة المصدر (MIT)، وموجودة على npm وGitHub (tonnode/mcp)، وتعمل عبر بروتوكول ADNL الأصلي في TON، دون طبقات HTTP وسيطة بين وكيلك والشبكة. أي إنها ليست غلافًا فوق واجهة REST تخصّ طرفًا آخر لتصطدم بحدّ استدعاءاته (rate limit)، بل عميل مباشر إلى الشبكة.

أين تضع هذا الإعداد

• Claude Desktop / Claude Code — في mcpServers ضمن ملف إعداد MCP.
• Cursor — في إعدادات خوادم MCP الخاصة بالمشروع أو على المستوى العام.
• ChatGPT/Codex وسائر عملاء MCP — في قسم ربط MCP لديهم.

وتفصيل كل عميل على حدة مع الصور في دليل منفصل: كيف تربط Claude وCursor بشبكة TON.

ما المتاح مجانًا: مجموعة قراءة TON كاملة

الوضع المجاني المحلي ليس نسخة تجريبية مبتورة. فأمامك مجموعة القراءة كاملة، ثماني أدوات تكفي للغالبية الساحقة من مهام الوكلاء:

• get_masterchain_info — «رأس» الـ masterchain: الحالة الراهنة للشبكة، وبها يفهم الوكيل «أين تقف» الشبكة الآن.
• get_balance — رصيد المحفظة بالـ GRAM (وهو Toncoin بعد إعادة تسميته في يونيو 2026؛ أما الشبكة فما زالت تُسمّى TON).
• get_account_state — حالة الحساب والأعلام وآخر معاملة. مفيدة لتعرف ما إذا كان العقد منشورًا والمحفظة نشطة.
• get_transactions — تاريخ المعاملات لعنوان معيّن.
• run_get_method — استدعاء أي get-method للقراءة فقط في أي عقد كان. إنه «قارئ كل شيء» العام لديك في العقود الذكية.
• get_jetton_balance — رصيد الجيتون، بما فيه USDT؛ ويُحسَب عنوان محفظة الجيتون على السلسلة، فلا حاجة إلى معرفته مسبقًا.
• get_jetton_info — البيانات الوصفية للجيتون: الاسم والرمز والمعروض الكلي، والأهم للحسابات: decimals. فالـ decimals في USDT = 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 باستدعاء واحد.

الطريقة الثانية: مفتاح Hobby المجاني — 60 طلبًا/دقيقة بلا بطاقة

الـ npx المحلي جيّد للتطوير وللمهام المفردة، لكن له سقفًا: فهو يمرّ عبر اللايت-سيرفرات العامة الموجودة في الإعداد العالمي لـ TON. وهذه مشتركة ومحدودة، وكثيرًا ما تردّ بـ not ready أو بمهلة ADNL تحت الحِمل، ولا تحتفظ بأرشيف تاريخي عميق. أما وكيلٌ إنتاجيّ يردّ على مستخدمين حقيقيين، فالاعتماد عليها معه رهانٌ على الحظّ.

وهنا يدخل الطريق المجاني الثاني — باقة Hobby. وهي مجانية إلى الأبد، وتمنح 60 طلبًا في الدقيقة، ويُصدَر المفتاح فور تسجيل الدخول، دون بطاقة. والفارق عن الوضع المحلي أن الطلبات لا تنطلق من جهازك عبر بنية تحتية عامة مشتركة، بل عبر نقطة نهاية TONNode المُستضافة بمفتاحك الشخصي — أي إن لديك حدًّا متوقَّعًا قدره 60 طلبًا/دقيقة، مرتبطًا بك أنت تحديدًا.

ويبدو إعداد الاتصال المُستضاف هكذا:

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

والفرق عن الإعداد المحلي في أمرين: type: "http" بدل تشغيل عملية، وترويسة Authorization بمفتاحك tn_live_…. أما الوكيل نفسه فلن يلحظ فرقًا في العمل — الأدوات ذاتها، والأسماء ذاتها، والمعاملات ذاتها.

والمهم أن الأدوات الـ16 كلها في TONNode متاحة على Hobby كما على سائر الباقات — لا القراءة وحدها، بل المبادلة والكروس-تشين وتوليد المحفظة أيضًا. وعلى المفتاح المُستضاف تحديدًا تُضاف إلى أدوات القراءة الثماني أدواتٌ أخرى، منها generate_wallet — إنشاء محفظة TON جديدة بإصدارات v3r2 أو v4 أو v5r1 أو highload_v3: تعيد الأداة العبارة السرية والمفاتيح والعنوان إليك مباشرة، والخادم لا يحتفظ بالمحافظ المولَّدة. فالباقة تُقيّد السعة التمريرية لا الوظائف. وأنت لا تدفع إلا مقابل السعة، إن احتجت إليها.

احصل على مفتاح Hobby (دون بطاقة): tonnode.io/dashboard?plan=hobby.

محليًا أم مُستضافًا: أين يكفي المجاني وأين تحتاج إلى سعة

باختصار: المجاني يكفي في جميع الأحوال تقريبًا ما دام الحديث عن التطوير والنماذج الأولية وتواتر استدعاءات منخفض. والفارق بين الوضعين ليس في مجموعة الأدوات، بل في السعة التمريرية.

الوضع	مفتاح / بطاقة	السعة التمريرية	لأي غرض
npx محلي	غير مطلوبين	لايت-سيرفرات عامة (مشتركة، محدودة)	التطوير والمهام المفردة
Hobby (مُستضاف)	مفتاح، بلا بطاقة	60 طلبًا/دقيقة على مفتاحك	مشاريع شخصية، إنتاج خفيف
Pro / Scale (مُستضاف)	مفتاح + اشتراك	300 / 1200 طلب/دقيقة	إنتاج تحت حِمل

والحقيقة الجوهرية: الأدوات الـ16 كلها متاحة في جميع الباقات — بما فيها المبادلة والكروس-تشين. فأنت تدفع مقابل السعة التمريرية وحدها، لا مقابل «فكّ قفل» الوظائف. فـPro يكلّف 29 دولارًا شهريًا ويمنح 300 طلب/دقيقة، وScale يكلّف 199 دولارًا شهريًا ويمنح 1200 طلب/دقيقة. والسعة المدفوعة تلزمك تحديدًا حين لا تكفيك الـ60 طلبًا في الدقيقة، أو حين تحتاج إلى حدّ خاص بك ومتوقَّع على نقطة النهاية المُستضافة mcp.tonnode.io تحت حِمل حقيقي. والتفصيل الكامل في صفحة الباقات وصفحة الأدوات.

خطوة بخطوة: نربط الوكيل وننفّذ أول استدعاء

لنجمع كل شيء معًا على مثال التشغيل المحلي (ولا يختلف الأمر في Hobby إلا في كتلة الإعداد).

الخطوة 1. أضف الخادم إلى إعداد عميل MCP. خذ كتلة npx -y @tonnode/mcp المعروضة أعلاه والصقها في إعداد عميلك (Claude أو Cursor أو Codex — والمسار يختلف باختلاف العميل).

الخطوة 2. أعد تشغيل العميل. سيشغّل عملية @tonnode/mcp ويرى الأدوات. وفي أغلب العملاء تظهر قائمة الأدوات المتصلة في الواجهة — تأكّد من ظهور ton فيها.

الخطوة 3. أعطِ الوكيل مهمة بنصّ عادي. مثلًا:

اعرف رأس الـ masterchain الحالي في 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 أو انتهاءَ المهلة) — استبدل الكتلة بإعداد مُستضاف يحمل مفتاح Hobby. لا يتغيّر سوى الإعداد، أما الموجّهات ومنطق الوكيل فيبقيان كما هما.

الطابع غير الاحتجازي: لماذا الوصول المجاني آمن

سؤال منطقي: إذا كان الخادم مجانيًا وهو نفسه يولّد المحافظ ويبني المعاملات — ألا أخاطر بمفاتيحي؟ لا، وهذا خيار مبدئي في تصميم المعمارية. فـ TONNode غير احتجازي بصرامة.

الخادم لا يوقّع ولا يحتفظ إطلاقًا بالأموال ولا بالمفاتيح الخاصة. فأدوات القراءة تقرأ الحالة العامة على السلسلة ليس إلا. أما الأدوات التي تغيّر الحالة — المبادلة والكروس-تشين — فلا ترسل شيئًا نيابةً عنك: إنها تعيد رسائل TonConnect غير موقّعة. ومحفظة المستخدم هي التي توقّعها، محليًا، بمفتاحه هو. والأمر نفسه في generate_wallet (المتاحة على المفتاح المُستضاف): المحفظة المولَّدة وعبارتها السرية تُسلَّمان إليك، ولا يُبقي الخادم نسخة منهما لديه.

بعبارة أخرى، الوصول المجاني ليس أخطر من المدفوع في شيء: فتوقيع المعاملات لا يقدر عليه تقنيًا إلا صاحب المحفظة — ولا يملك الخادم مفاتيح يوقّع بها أي شيء. وهذا فارق مبدئي عن النموذج الاحتجازي الذي يحتفظ فيه الخادم بمفتاح المشغّل ويوقّع بنفسه. وتحليل المقاربتين ومخاطرهما في مادة منفصلة عن MCP الاحتجازي وغير الاحتجازي.

الخلاصة

لكي تمنح وكيل الذكاء الاصطناعي يدين في TON، لا تحتاج إلى تشغيل عقدة ولا إلى بطاقة بنكية. فـ npx -y @tonnode/mcp المحلي يمنحك مجموعة القراءة كاملة بلا مفتاح، الآن حالًا — وهو مثالي للتجربة. وباقة Hobby المجانية تضيف 60 طلبًا/دقيقة متوقَّعة على مفتاحك عبر نقطة النهاية المُستضافة، دون بطاقة كذلك، حين لا تعود اللايت-سيرفرات العامة تكفيك. والوضعان كلاهما غير احتجازي، ويستخدمان الأدوات ذاتها، ويمكنك في أي لحظة الانتقال إلى سعة مدفوعة دون إعادة كتابة أي شيء في منطق الوكيل.

احصل على مفتاح Hobby المجاني (دون بطاقة): tonnode.io/dashboard?plan=hobby