خادم MCP

يتيح خادم MCP (Model Context Protocol) من PolyTest لأداة ذكاء اصطناعي قراءة بيانات السوق في PolyTest مباشرة. يعمل مع Claude Code وCursor وVS Code وCodex وGemini CLI وClaude Desktop وغيرها من عملاء MCP. جميع أدواته للقراءة فقط.

الاتصال

الخادم المستضاف موجود على https://mcp.polytest.io/mcp ويستخدم Streamable HTTP. أمر Claude Code يضيف الخادم من دون مفتاح، ثم تسجّل الدخول بحسابك في PolyTest. أما بقية المقاطع فترسل مفتاح API من متغير البيئة POLYTEST_KEY. يشرح قسم المصادقة الطريقتين.

claude mcp add --transport http polytest https://mcp.polytest.io/mcp

شغّل سطرَي Claude Code وGemini CLI في الطرفية. ضع مقطع Cursor في ~/.cursor/mcp.json، ومقطع VS Code في .mcp.json، ومقطع Codex في ~/.codex/config.toml.

المصادقة

إذا كان عميلك يدعم OAuth، فسجّل الدخول بحسابك في PolyTest. في Claude Code، شغّل /mcp وحدّد polytest ثم اختر Authenticate. وإذا لم يكن /mcp متاحًا، كما في Claude Code داخل تطبيق سطح المكتب، فشغّل claude mcp login polytest في الطرفية بدلًا من ذلك، من المجلد الذي أضفت فيه الخادم. أما العملاء الآخرون فيطلبون منك تسجيل الدخول عند الاتصال أو عند أول استدعاء لأداة.

يفتح متصفحك رابط تسجيل دخول على qpzofvjvtdvdnvgpxplg.supabase.co، وهو عنوان Supabase Auth، الخدمة التي يستخدمها PolyTest لتسجيل الدخول. ثم ينتقل إلى www.polytest.io حيث توافق على الاتصال. يمكنك إزالته لاحقًا من الإعدادات، ضمن التطبيقات المتصلة.

يمكنك أيضًا إرسال مفتاح API في الترويسة Authorization: Bearer <key>. وتعمل الترويسة X-API-Key كذلك. أنشئ مفتاحًا من صفحة مفاتيح API، ولا تضعه في عنوان URL أبدًا.

في Claude Code يوضع المفتاح في الخيار --header:

Claude Code
claude mcp add --transport http polytest https://mcp.polytest.io/mcp --header "Authorization: Bearer $POLYTEST_KEY"

التشغيل محليًا

يشغّل npx -y @polytest/mcp الخادم على جهازك من حزمة npm @polytest/mcp. يتطلب Node 20 أو أحدث، ويقرأ مفتاحك من متغير البيئة POLYTEST_KEY.

claude mcp add --transport stdio --env POLYTEST_KEY=$POLYTEST_KEY polytest -- npx -y @polytest/mcp

ضع مقطع Claude Desktop في claude_desktop_config.json. ضع مفتاحك مكان pt_live_....

الأدوات

في الخادم خمس أدوات. يبيّن العمود الأخير عدد طلبات API التي يكلّفها الاستدعاء الواحد.

الأداةالقيمة المُرجعةطلبات API
polytest_list_marketsأسواق market_type واحد لعملة واحدة، الأحدث أولًا. يتضمن كل صف نافذة السوق وstatus وسعر العملة الفوري عند الافتتاح والإغلاق والفائز وحجم التداول.1
polytest_get_marketسوق واحد، بحسب market_id أو slug، مع معرّفات الرموز وحقول الحسم.1
polytest_get_snapshotsلقطات سوق واحد، الأقدم أولًا، وفي كل منها time وspot_price وprice_up وprice_down. مع include_orderbook يتضمن كل صف دفترَي الأوامر أيضًا.1
polytest_get_price_seriesنقاط سعر على فترات متساوية عبر سوق واحد، الأقدم أولًا.1 زائد طلب لكل عيّنة، أي 21 بالقيمة الافتراضية
polytest_get_limitsحدود خطتك: المستوى وحدود المعدل وحد التزامن والوصول إلى البيانات وحد عدد المفاتيح وميزانية الفترة التجريبية.1

price_up هو أدنى سعر بيع في دفتر أوامر Up، أي السعر الذي ستدفعه لشراء Up في تلك اللحظة. وprice_down هو الشيء نفسه لـ Down. تتراوح القيمتان بين 0 و1، وتكون كل منهما null عندما لا يعرض أحد ذلك الجانب للبيع. ولا تمثّل أيٌّ منهما سعرًا أوسط أو سعر آخر صفقة. ولأن القيمتين سعرا بيع، يزيد مجموع Up وDown عادةً على 1 بقليل.

في الجلسة المعتادة تُستدعى polytest_list_markets للعثور على سوق، ثم polytest_get_price_series لرؤية مسار ذلك السوق، ثم polytest_get_snapshots لتفاصيل كل تحديث أو لدفتر الأوامر في لحظة واحدة.

التغطية وحداثة البيانات

يوفّر PolyTest أسواق btc وeth وsol لأطر 5m و15m و1hr، أما أسواق 4hr و24hr فتقتصر على btc.

يحمّل PolyTest الأسواق الجديدة على دفعات، لذلك قد تتأخر أحدث الأسواق عن الوقت الفعلي بساعات أو أيام. ويختلف التأخير بحسب العملة ونوع السوق.

لكل صف سوق حقل status:

  • upcoming: لم تبدأ النافذة بعد.
  • open: النافذة ما زالت جارية.
  • resolved: الفائز معروف.
  • ended_no_result: أُغلقت النافذة وليست لدى PolyTest نتيجة لها.

عندما تسرد أحدث الأسواق، دون end_time، ويكون أحدثها قد بدأ قبل الوقت الحالي بفترة طويلة، تضيف polytest_list_markets ملاحظة بذلك. وفي سوق ما زال جاريًا، تتوقف polytest_get_price_series عند الوقت الحالي بدلًا من أخذ عينات من المستقبل. وعندما تعود آخر الفترات الزمنية (buckets) في السلسلة فارغة، تخبرك أين تنتهي البيانات. أما النطاق الذي يبدأ بعد الوقت الحالي، كسوق لم يبدأ بعد، فيُرجع خطأ.

الحدود والتكلفة

كل استدعاء لأداة يرسل طلبات API عادية، ولذلك يُحتسب ضمن حدود الخطة نفسها التي تُحتسب فيها طلبات REST.

  • حدود المعدل تُطبَّق على كل مفتاح، لذا أنشئ مفتاحًا مخصصًا لخادم MCP.
  • التزامن مشترك مع كل ما يعمل على حسابك. يعيد الخادم المحاولة لفترة قصيرة عندما لا توجد خانة متاحة.
  • تُرجع polytest_get_limits الحقل trial_budget لكل حساب، بما في ذلك الحسابات المدفوعة. وهو إجمالي الطلبات والسجلات والبايتات التي يمكن أن تستهلكها الفترة التجريبية المجانية خلال أيامها الثلاثة، ولا ينطبق إلا أثناء الفترة التجريبية. لا تعرض الأدوات ما تبقّى منه: فواجهة REST API لا تذكر الكميات المتبقية إلا في ترويسات الاستجابة، وعملاء MCP لا يرونها.
  • حجم النتائج مضبوط ليناسب نافذة سياق الذكاء الاصطناعي: الصفحات صغيرة ودفاتر الأوامر تُقتطع إلى عمق مختار. لسحب كميات كبيرة أو لإجراء اختبارات رجعية، اطلب من الذكاء الاصطناعي كتابة كود يستخدم حزمة TypeScript SDK أو REST API.

جرّبه

بعد اتصال الخادم، اطلب ما تريد بلغتك العادية. مثلًا:

  • اعرض أحدث خمسة أسواق BTC 5m على PolyTest، وبيّن كيف تحرّك سعر Up في أحدثها.

  • اعثر على أحدث سوق BTC 15m محسوم على PolyTest، واعرض دفترَي الأوامر قبل إغلاقه بثلاثين ثانية.

  • تحقق من حدود خطتي في PolyTest، ثم أخبرني كم طلب API تكلّف سلسلة أسعار من 40 عيّنة.

حل المشكلات

خطأ من الأداة يقول إن مفتاح API مفقود أو مرفوض
يوضح الخطأ طريقة الإصلاح في إعدادك: اضبط POLYTEST_KEY، أو أضف الترويسة Authorization، أو سجّل الدخول من جديد. مفاتيحك موجودة في صفحة مفاتيح API.
خطأ من الأداة يذكر خطتك
الخطة لا تشمل ذلك الطلب. اطلب من الذكاء الاصطناعي استدعاء polytest_get_limits لمعرفة ما تشمله.
العميل يقول إن الخادم يتطلب المصادقة
سجّل الدخول عندما يعرض العميل ذلك، أو أضف الترويسة Authorization المذكورة في المصادقة.
خطأ من الأداة يقول إنك بلغت حد المعدل
يوضح الخطأ مدة الانتظار قبل إعادة المحاولة.