اربط مساعد ذكاء اصطناعي عبر MCP

قبل أن تبدأ

1. حساب AlgoVesta. تجربة الـ7 أيام كافية — لا تحتاج إلى خطة مدفوعة لتجربة هذا.
2. عميل MCP: Claude على الويب أو الحاسوب أو الهاتف، أو Claude Code، أو Cursor، أو ChatGPT على خطة مدفوعة، أو Gemini CLI، أو أي شيء آخر يتحدّث Model Context Protocol.
3. مفتاح. لست بحاجة إلى منصة متصلة للبدء: مفتاح paper يشغّل مجموعة الأدوات الكاملة مقابل رصيد افتراضي 5,000$، فيمكنك إعداد كل شيء والتمرّن قبل إشراك أي حساب حقيقي.

1. أنشئ رابط MCP الخاص بك

1. افتح لوحة AlgoVesta واذهب إلى تبويب اتصال MCP
2. انقر إنشاء مفتاح، وامنحه تسمية توضّح أين سيُستخدم (مثلاً claude-desktop أو cursor-laptop)
3. اختر نطاقاً: read لأسئلة المحفظة فقط، أو paper لمجموعة الأدوات الكاملة مقابل الرصيد الافتراضي 5,000$، أو live للأوامر الحقيقية
4. انسخ العنوان الذي يظهر. يبدو هكذا:

https://api.algovesta.com/u/avmcp_<your-key>/mcp

2. أضِفه إلى Claude

1. في Claude، افتح الإعدادات → الموصلات
2. انقر إضافة موصل مخصّص
3. امنحه اسماً (AlgoVesta) والصق رابط MCP الخاص بك في حقل العنوان
4. احفظ، ثم ابدأ محادثة جديدة — ستظهر الأدوات في قائمة أدوات المحادثة

يتزامن هذا الموصل عبر Claude على الويب والحاسوب والهاتف، فإضافته مرة واحدة تغطّي هاتفك أيضاً. إذا كنت تفضّل عدم لصق عنوان سري، توفّر AlgoVesta أيضاً نقطة نهاية OAuth 2.1 قياسية على https://api.algovesta.com/mcp مع PKCE (S256) وDynamic Client Registration — وجّه الموصل إليها بدلاً من ذلك وستُمرَّر عبر شاشة موافقة متصفح عادية.

3. أضِفه إلى Claude Code

أمر واحد يسجّل الخادم عبر streamable HTTP:

claude mcp add --transport http algovesta https://api.algovesta.com/u/avmcp_<your-key>/mcp

شغّل claude mcp list بعد ذلك للتأكد من أن الخادم مسجَّل ويمكن الوصول إليه.

4. أضِفه إلى Cursor أو ChatGPT

Cursor يقرأ ملف إعدادات JSON. أضِف إدخالاً واحداً إلى mcp.json:

{"mcpServers":{"algovesta":{"url":"https://api.algovesta.com/u/avmcp_<your-key>/mcp"}}}

Gemini CLI يأخذ نفس الإدخال، لكنه يسمّي الحقل httpUrl بدلاً من url. كل شيء آخر مطابق.

ChatGPT يدعم موصلات MCP المخصّصة على الخطط المدفوعة، مع تفعيل وضع المطوّر في الإعدادات. أضِف الموصل هناك والصق نفس الرابط.

5. تحقّق من الاتصال

1. ابدأ محادثة جديدة في عميلك
2. اسأل: كيف حال محفظتي؟
3. يجب أن يستدعي المساعد أداة get_portfolio_context ويجيب بأرصدتك الفعلية ومراكزك المفتوحة — على مفتاح paper، برصيد افتراضي 5,000$

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

ما الذي يستطيع المساعد فعله بعد الاتصال

تُعرَض عشرون أداة. أربع عشرة منها تقرأ أو تتدرّب ولا تغيّر شيئاً: get_portfolio_context، وget_market_price، وget_trade_history، وcompare_venues، وsimulate_order، وlist_open_orders، وlist_strategies، وverify_receipt، وreplay_channel، وcompile_policy. وست منها تكتب: place_order، وclose_position، وmodify_position، وcancel_order، وcreate_strategy، وupdate_strategy.

لا تستدعيها بالاسم. اسأل بلغة عادية — "ماذا أملك؟"، "كم سيكلّفني 0.1 BTC الآن؟"، "أغلق نصف مركزي في ETH" — ويختار المساعد الأدوات ويربطها في سلسلة. وقف الخسارة إلزامي لكل مركز يفتحه، ولا توجد أداة لإزالته لاحقاً. المخططات الكاملة لكل أداة موجودة في وثائق المطوّرين.

401 unauthorized

تم إلغاء المفتاح، أو حذفه، أو أن العنوان مكتوب بشكل خاطئ. هذا هو الفشل الأكثر شيوعاً عندما يُلصَق الرابط يدوياً أو يُنسَخ مع مسافة زائدة. تحقّق من أن المفتاح لا يزال موجوداً في تبويب اتصال MCP؛ إذا كان موجوداً، احذفه وأنشئ آخر جديداً بدلاً من محاولة إصلاح النص.

insufficient_scope

الأداة التي حاول المساعد استدعاءها تحتاج نطاقاً أعلى مما يحمله المفتاح. مفتاح read لا يمكنه استدعاء place_order، ومفتاح paper لا يمكنه الوصول إلى حساب حقيقي. النطاقات مرتّبة، لذا أداة تتطلّب paper ترفض مفتاح read. إما أن تقبل الحد، أو تُصدر مفتاحاً جديداً بالنطاق الذي تحتاجه فعلاً — الانتقال إلى live يتطلّب عامل تحقق ثانٍ.

user_frozen

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

rate_limited

تجاوزت 60 طلباً في الدقيقة على ذلك المفتاح. تُطبَّق حدود أشدّ على الأدوات المكلِفة: place_order محدود بـ10 في الدقيقة وreplay_channel بـ5 في الساعة. انتظر وأعد المحاولة. رؤية هذا مراراً تعني غالباً أن وكيلاً يدور في حلقة لا أنك تتداول بسرعة — يستحق الأمر التحقّق مما يفعله المساعد فعلياً قبل رفع حد الطلبات.