دليلك الشامل لإعداد خادم (MCP) للذكاء الاصطناعي لمنصة Capital.com

هل لديك أسئلة أخرى؟ إرسال طلب

يتيح لك خادم MCP من Capital.com ربط حساب التداول الخاص بك بأحد مساعدي الذكاء الاصطناعي، مثل: Claude Code، أو Codex، أو Claude Desktop، أو Cursor، أو Windsurf. وبمجرد إتمام الإعداد، ستتمكن من استخدام لغتك الطبيعية (اليومية) لتحليل الأسواق، والاطلاع على بيانات حسابك، ومراجعة صفقاتك المفتوحة وأوامرك النشطة، فضلًا عن معاينة الصفقات وتنفيذها مباشرة عبر مساعدك الذكي.

سيصحبك هذا الدليل خطوةً بخطوة، بدءًا من إنشاء بيانات اعتماد واجهة الربط البرمجي (API) وتثبيت الخادم، وصولًا إلى ربط مساعدك الذكي المفضل ومراجعة وتأكيد كل صفقة قبل تنفيذها بشكل فعلي. لا يشترط أن تكون مطورًا برمجيًا لتنفيذ ذلك، بل يكفي أن تكون ملمًا باتباع التعليمات التقنية. ونوصيك بشدة ببدء تجربتك على حساب تجريبي قبل الانتقال إلى بيئة التداول الحقيقي.

ما هو خادم (MCP) من Capital.com؟

خادم بروتوكول سياق النموذج (MCP) المقدم من Capital.com هو أداة مجانية ومفتوحة المصدر، تتيح لك ربط مساعدك الذكي بحساب التداول الخاص بك بسلاسة، وذلك باستخدام بيانات اعتماد واجهة الربط البرمجي (API) الخاصة بك مع تفعيل خاصية المصادقة الثنائية (2FA). ويعمل هذا الخادم كجسر يربط بين حسابك والذكاء الاصطناعي، ليمنح المساعد الذكي قدرة الوصول الفوري إلى بيانات الأسواق وتفاصيل حسابك، ومن ثم الاستجابة لتوجيهاتك لحظيًا.

وبمجرد إتمام الربط، سيتمكن مساعدك الذكي من أداء المهام الآتية:

  • البحث ضمن الأسواق المتاحة (مثل الفوركس، والأسهم، والسلع، والمؤشرات).

  • استعراض صفقاتك المفتوحة، وأوامرك النشطة، وتفاصيل حسابك.

  • سحب الأسعار التاريخية واستخلاص توجهات العملاء في السوق.

  • معاينة الصفقات وتنفيذها، مع اشتراط تأكيدك الصريح قبل أي تنفيذ فعلي للصفقات.

نود التنويه بأنك تظل المسؤول الأول والأخير عن أية قرارات تداول تتخذ عبر خادم (MCP). لذا، احرص دائمًا على مراجعة تفاصيل الصفقات ومعاينتها بدقة متناهية قبل تأكيد التنفيذ.

ما هي مساعدات الذكاء الاصطناعي المدعومة؟

يغطي هذا الدليل خطوات الإعداد الخاصة بكل من: Claude Code، و Codex، و Claude Desktop، و Cursor، و Windsurf.

مساعد الذكاء الاصطناعي مستوى صعوبة الإعداد الآلية المتوقعة
Claude Code سهل يعمل مباشرة عبر نافذة الأوامر (Terminal) بعد التثبيت. ولا يتطلب ملف تهيئة، غير أنك ستحتاج إلى صلاحية الوصول إلى نافذة الأوامر.
Codex سهل يضبط من خلال إعدادات Codex باستخدام نفس أمر الخادم، والمتغيرات، وبيئة التشغيل المتبعة في Claude Desktop.
Claude Desktop متوسط يتطلب تعديل ملف تهيئة واحد فقط على حاسوبك الشخصي.
Cursor متوسط يضبط من خلال إعدادات Cursor باستخدام أمر الخادم، والمتغيرات، وبيئة التشغيل ذاتها المستخدمة في Claude Desktop.
Windsurf متوسط يستلزم تعديل ملف تهيئة واحد فقط على جهازك.

وإذا ساورتك الحيرة حول نقطة البداية الأمثل؛ فقد يمثل Claude Code خيارًا عمليًا وممتازًا إذا كنت تجيد التعامل مع نافذة الأوامر (Terminal). أما إذا كنت تفضل التعديل المباشر على ملفات التهيئة، فقد يكون Claude Desktop هو الخيار الأنسب لك.

الخطوة 1: إنشاء بيانات اعتماد واجهة الربط البرمجي

في البداية، ستحتاج إلى إنشاء بيانات اعتماد واجهة الربط البرمجي"من داخل حسابك على منصة Capital.com؛ وهي عملية بسيطة وواضحة لن تستغرق سوى دقيقتين تقريبًا.

  1. سجل الدخول إلى حسابك في منصة Capital.com.

  2. فعّل خاصية المصادقة الثنائية (2FA).

  3. توجه إلى الإعدادات (Settings)، ثم اختر تكامل واجهة الربط البرمجي (API Integrations)، واضغط على "إنشاء مفتاح جديد" (Generate New Key).

  4. اختر اسمًا مميزًا للمفتاح لتسهيل التعرف عليه لاحقًا، مثل: MCP Server.

  5. ابتكر كلمة مرور مخصصة حصريًا لواجهة الربط البرمجي. تذكر أن هذه الكلمة مستقلة تمامًا عن كلمة المرور التي تستخدمها لتسجيل الدخول إلى حسابك.

  6. أدخل رمز المصادقة الثنائية (2FA) الخاص بك لتأكيد إصدار المفتاح.

  7. انسخ مفتاح واجهة الربط البرمجي فورًا؛ إذ لن يعرض لك النظام هذا المفتاح مرة أخرى للحفاظ على سريته.

احتفظ بالقيم التالية، فستحتاج إليها في الخطوات القادمة:

اسم المتغير وظيفته المحددة
CAP_API_KEY مفتاح واجهة الربط البرمجي الذي أنشأته
CAP_API_PASSWORD كلمة مرور واجهة الربط البرمجي المخصصة التي أنشأتها
CAP_IDENTIFIER عنوان البريد الإلكتروني المرتبط بحسابك على Capital.com
CAP_ENV اضبط هذا المتغير على الوضع التجريبي أثناء فترة الاختبار.*

* نوصي باختبار إعداداتك أولًا على حساب تجريبي قبل الانتقال إلى بيئة التداول الحقيقي.

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

الخطوة 2: تثبيت خادم MCP لمنصة Capital.com

تجرى عملية التثبيت هذه لمرة واحدة فقط لتجهيز بيئة عملك. وأمامك مساران لإتمامها، علمًا بأن المسار (أ) هو الخيار الأمثل والموصى به لمعظم المستخدمين.

المسار (أ): التثبيت السريع (الخيار الموصى به)

يأتي خادم MCP مزودًا بملف حزمة برمجية متكاملة تتيح لتطبيق Claude Desktop التكفل بعملية التثبيت آليًا بالنيابة عنك بالكامل، مما يوفر عليك عناء التعامل مع نوافذ الأوامر المعقدة أو التعديل اليدوي لملفات التهيئة.

تجهيزات ما قبل البدء: تأكد أولًا من تثبيت أداة uv على جهازك (كأن تستخدم أمر brew install uv في أجهزة ماك)، وتأكد كذلك من توفر بيئة Node.js لضمان عمل أمر حزم الملفات البرمجية (pack) بسلاسة.

  1. افتح نافذة الأوامر (Terminal) على حاسوبك، ثم استنسخ المستودع البرمجي وابن الحزمة عبر تنفيذ الأوامر المتسلسلة التالية:

git clone https://github.com/capital-com-sv/capital-mcp

cd capital-mcp

npx @anthropic-ai/mcpb pack . capital-mcp.mcpb

  1. شغل ملف `capital-mcp.mcpb` بالنقر المزدوج عليه، أو ببساطة اسحبه وأفلته مباشرة داخل واجهة تطبيق Claude Desktop.

  2. ستنبثق لك نافذة من تطبيق Claude Desktop تطلب منك إدخال بيانات اعتماد واجهة الربط البرمجي الخاصة بك. أدخلها بدقة وعناية، ثم اضغط على زر "تثبيت" (Install).

  3. أعد تشغيل تطبيق Claude Desktop، وتأكد من نجاح عملية الربط عبر طرح هذا السؤال على المساعد الذكي: "What Capital.com tools are available?" (ما هي أدوات Capital.com المتاحة؟).

المسار (ب): التثبيت اليدوي

إلجأ إلى هذا الخيار إذا كنت تفضل تخطي طريقة الحزمة البرمجية الجاهزة، أو في حال كنت ترغب في الربط مع أدوات ذكية أخرى مثل Codex، أو Cursor، أو Windsurf.

خطوات التنفيذ عبر نافذة الأوامر لأجهزة ماك

1. تنزيل ملفات الخادم

 cd ~/Desktop

git clone https://github.com/capital-com-sv/capital-mcp

cd capital-mcp

2. تهيئة بيئة Python معزولة وتثبيت الحزم التابعة لها

python3 -m venv venv

source venv/bin/activate

pip install -e ".[dev]"

3. تحديد مسار بيئة Python الخاصة بك

ستحتاج إلى هذا المسار لإتمام الخطوة التالية. وللوصول إليه، قم بتنفيذ الأمر التالي:

which python

سيظهر لك مسار تنفيذي يشبه هذا النسق:

/Users/you/Desktop/capital-mcp/venv/bin/python

انسخ هذا المسار واحتفظ به في مكان آمن؛ حيث ستحتاج للصقه لاحقًا ضمن إعدادات مساعدك الذكي في الخطوة الثالثة.

نصيحة عملية: في أجهزة ماك، يمكنك سحب أي ملف من نافذة الباحث (Finder) وإفلاته مباشرة داخل نافذة الأوامر (Terminal) ليظهر لك مساره الكامل على الشاشة فورًا.

4. التحقق من بدء تشغيل الخادم بنجاح

python -m capital_mcp.server

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

خطوات التنفيذ عبر موجه الأوامر لأجهزة ويندوز

  1. تنزيل ملفات الخادم

cd %USERPROFILE%\Desktop

git clone  https://github.com/capital-com-sv/capital-mcp

cd capital.com-public-api-mcp

نفذ الأوامر السابقة تباعًا لتنزيل المستودع البرمجي مباشرة إلى سطح مكتب حاسوبك وفتح مجلد المشروع.

  1. تهيئة بيئة افتراضية وتثبيت الحزم البرمجية

py -m venv venv

venv\Scripts\activate.bat

pip install -e ".[dev]"

تهدف هذه الخطوة إلى خلق بيئة عمل افتراضية تعزل الحزم البرمجية الخاصة بهذا المشروع عن بقية ملفات نظامك الأساسي. وبمجرد تفعيلها، ستضمن تثبيت كافة الحزم المطلوبة داخل هذه البيئة الآمنة حصرًا.

  1. تحديد مسار بيئة بايثون الخاصة بك

ستحتاج إلى هذا المسار لإتمام الخطوة التالية. وللوصول إليه، قم بتنفيذ الأمر التالي:

where python

سيظهر لك مسار تنفيذي يشبه هذا النسق:

C:\Users\you\Desktop\capital.com-public-api-mcp\venv\Scripts\python.exe

انسخ هذا المسار واحتفظ به في مكان آمن؛ حيث ستحتاج للصقه لاحقًا ضمن إعدادات مساعدك الذكي في الخطوة الثالثة.

  1. التحقق من بدء تشغيل الخادم بنجاح

python -m capital_mcp.server

إذا اجتزت هذه الخطوة دون ظهور أي رسائل خطأ، فهنيئًا لك؛ لقد تكللت عملية التثبيت بالنجاح. أما إذا واجهت عائقًا تقنيًا أو ظهر لك خطأ ما، فبادر بمعالجته فورًا قبل الانتقال إلى الخطوات التالية.

الخطوة 3. ربط مساعدك الذكي

تتطلب جميع المساعدات الذكية الثلاثة نفس البيانات الأساسية لإتمام عملية الربط بسلاسة. لذا، احرص على تجهيز المعلومات التالية قبل البدء:

البيانات المطلوبة كيفية الحصول عليها
مسار بيئة بايثون الافتراضية (venv) خلال أمر which python أو where python الذي نفذته في الخطوة الثانية
بيانات الاعتماد الأربعة الخاصة بواجهة الربط البرمجي استخرجتها واحتفظت بها مسبقًا في الخطوة الأولى
إعداد Claude Code 

افتح نافذة الأوامر ونفذ الأمر التالي:

claude mcp add capital-com -- /path/to/capital-mcp/venv/bin/python -m capital_mcp.server

استبدل الجزء /path/to/capital-mcp/venv/bin/python بمسار بايثون التنفيذي الذي نسخته واحتفظت به في الخطوة الثانية.

للتأكد من نجاح عملية الربط، اطرح هذا السؤال المباشر على المساعد الذكي Claude: "What Capital.com tools are available?" (ما هي أدوات Capital.com المتاحة؟).  ويفترض أن تستعرض لك الإجابة قائمة تضم 36 أداة.

إعداد Codex 

توجه إلى واجهة تطبيق Codex، وافتح قائمة الإعدادات (Settings)، ثم اختر خوادم MCP (MCP Servers)، وانقر على خيار "إضافة خادم" (Add Server)، ثم أكمل تعبئة الحقول المطلوبة وفقًا لما يلي.

الأمر (Command)

ألصق مسار بيئة بايثون الافتراضية الخاصة بك هنا، على سبيل المثال:

/Users/you/Desktop/capital.com-public-api-mcp/venv/bin/python

المتغيرات (Arguments)

أضف القيمتين التاليتين كمدخلين منفصلين تمامًا (يمنع دمجهما في سطر واحد):

  1. -m

  2. capital_mcp.server

متغيرات بيئة التشغيل

أضف كل متغير من المتغيرات التالية بشكل مستقل وفي حقل منفصل:

المتغير القيمة
CAP_ENV demo
CAP_API_KEY مفتاح واجهة الربط البرمجي الخاص بك
CAP_IDENTIFIER عنوان بريدك الإلكتروني
CAP_API_PASSWORD كلمة المرور المخصصة لواجهة الربط البرمجي
CAP_ALLOW_TRADING false

مسار دليل العمل (Working directory)

اضبط مسار دليل العمل ليكون: ~/code.

بمجرد الانتهاء، احفظ هذه الإعدادات وأعد تشغيل تطبيق Codex.

اكتب الأمر /mcp  في نافذة الدردشة، وستلاحظ ظهور capital-com ضمن قائمة الخوادم المدرجة.

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

"Check my Capital.com session status" (تحقق من حالة جلستي)

"Login to my Capital.com account" (سجل الدخول إلى حسابي على Capital.com)

"List my accounts" (استعرض قائمة حساباتي)

إذا تلقيت استجابات صحيحة ومكتملة لهذه الأوامر الثلاثة، فهذا يؤكد أن خادمك متصل ويعمل بكفاءة تامة وجاهز لتلقي تعليمات التداول.

إعداد Claude Desktop

خطوات التنفيذ عبر نافذة الأوامر لأجهزة ماك

افتح نافذة الأوامر ونفذ الأمرين التاليين تباعًا لإنشاء ملف التهيئة:

mkdir -p ~/Library/Application\ Support/Claude

nano ~/Library/Application\ Support/Claude/claude_desktop_config.json

خطوات التنفيذ عبر موجه الأوامر لأجهزة ويندوز

افتح موجه الأوامر (CMD) ونفذ ما يلي:

mkdir "%APPDATA%\Claude"

notepad "%APPDATA%\Claude\claude_desktop_config.json"

خطوات مشتركة لنظامي ماك وويندوز

ألصق القالب البرمجي أدناه داخل الملف الذي فتحته، مع الحرص التام على استبدال كافة العبارات المكتوبة بأحرف إنجليزية كبيرة (ALL CAPS) ببياناتك الفعلية:

{

  "mcpServers": {

"capital-com": {

   "command": "/PASTE/YOUR/VENV/PYTHON/PATH",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "PASTE_API_KEY",

     "CAP_IDENTIFIER": "PASTE_YOUR_EMAIL",

     "CAP_API_PASSWORD": "PASTE_API_PASSWORD",

     "CAP_ALLOW_TRADING": "false",

     "CAP_ALLOWED_EPICS": ""

   }

    }

  }

}

لحفظ الملف: اضغط على Ctrl + O، ثم Enter، تليها Ctrl + X. وبعد ذلك، أعد تشغيل تطبيق Claude Desktop.

للتأكد من نجاح عملية الربط، اطرح هذا السؤال المباشر على المساعد الذكي Claude: "What Capital.com tools are available?" (ما هي أدوات Capital.com المتاحة؟).

ويفترض أن تستعرض لك الإجابة قائمة تضم 36 أداة. وفي حال ظهور عدد أقل من الأدوات، يرجى مراجعة قسم استكشاف الأخطاء وإصلاحها أدناه.

إعداد Cursor

توجه إلى قائمة الإعدادات (Settings)، ثم اختر الأدوات وخوادم MCP (Tools & MCPs)، وأضف الكود التالي:

{

  "capital-com": {

"command": "/path/to/venv/bin/python",

"args": ["-m", "capital_mcp.server"],

"env": {

   "CAP_ENV": "demo",

   "CAP_API_KEY": "your_api_key",

   "CAP_IDENTIFIER": "your_email",

   "CAP_API_PASSWORD": "your_password",

   "CAP_ALLOW_TRADING": "false"

}

  }

}

أعد تشغيل تطبيق Cursor، واختبر نجاح الربط عبر إرسال أمر:

"List my accounts" (استعرض قائمة حساباتي)

إذا استجاب النظام بعرض تفاصيل حسابك المالي، فهذا يؤكد أن عملية الدمج تعمل بكفاءة تامة.

إعداد Windsurf

قم بإنشاء أو تعديل الملف الموجود في المسار ~/.windsurf/mcp/servers.json، وأضف إليه الكود التالي:

{

  "mcpServers": {

"capital-com": {

   "command": "/path/to/capital-mcp/venv/bin/python",

   "args": ["-m", "capital_mcp.server"],

   "env": {

     "CAP_ENV": "demo",

     "CAP_API_KEY": "your_api_key_here",

     "CAP_IDENTIFIER": "your_email@example.com",

     "CAP_API_PASSWORD": "your_custom_password"

     "CAP_ALLOW_TRADING": "false"

   }

    }

  }

}

تأكد من استبدال جميع القيم المؤقتة ببيانات الاعتماد الفعلية الخاصة بك والتي استخرجتها في الخطوة الأولى.

أعد تشغيل تطبيق Windsurf، واختبر جودة الربط عبر إرسال أمر: "List my accounts".

آلية تنفيذ صفقات التداول عبر خادم MCP

تمر أي صفقة تبرم عبر خادم MCP بعملية إلزامية تتألف من ثلاث مراحل متسلسلة. ويفرض الخادم هذه المنهجية بصرامة تامة، ولا يتيح لك تجاوزها بأي حال من الأحوال لضمان أقصى درجات الحماية لقراراتك.

الخطوة الأولى: معاينة تفاصيل الصفقة

اطلب من مساعدك الذكي معاينة الصفقة التي ترغب في إبرامها. سيقوم النظام برد عرض تفصيلي للصفقة، مرفقًا بمعرف معاينة فريد ومخصص لك (preview_id).

مثال تطبيقي:

"Preview buying 1.5 [instrument] with stop at 24.50" (معاينة شراء 1.5 من [اسم الأصل المالي] مع وقف خسارة عند 24.50).

الخطوة الثانية: مراجعة العرض

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

إذا كان حجم الصفقة المطلوب أقل من الحد الأدنى أو يتجاوز الحد الأقصى المسموح به لدى الوسيط لهذا الأصل، سيصدر الخادم رسالة خطأ. حينها، ستحتاج إلى تعديل حجم الصفقة وإجراء معاينة جديدة.

الخطوة الثالثة: التأكيد النهائي للتنفيذ

إذا رغبت في المضي قدمًا واعتماد الصفقة، أرسل رسالة ثانية لتأكيد التنفيذ على النحو التالي:

Execute position with preview_id abc123 confirm=true

لن يتم تمرير أو إبرام أي صفقة دون وجود معرف معاينة سارٍ (preview_id) ناتج عن عملية معاينة مكتملة. ويشترط الخادم استيفاء كلتا الخطوتين السابقتين قبل التنفيذ الفعلي في السوق.

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

ما يجب التحقق منه قبل الانتقال إلى حساب التداول الحقيقي

تأكد تمامًا من استيفائك لكافة النقاط التالية قبل المضي قدمًا:

  • اكتمال جميع اختباراتك بنجاح على الوضع التجريبي (CAP_ENV = demo).

  • الإبقاء على المتغير CAP_ALLOW_TRADING بقيمة false طوال مرحلة الإعداد.

  • عمل وظائف تسجيل الدخول للجلسة، واستعراض قائمة الحسابات، وتدفق بيانات الأسواق بكفاءة تامة ودون أي عوائق.

  • اختبار دورة معاينة الصفقات وتنفيذها بالكامل بنجاح على حسابك التجريبي.

  • اتخاذك قرارًا واعيًا ومدروسًا بتغيير المتغير CAP_ENV إلى live (الوضع الحقيقي)، والمتغير CAP_ALLOW_TRADING إلى true (تفعيل التداول).

ولإحكام السيطرة على الأسواق التي يسمح للخادم بالتداول فيها، يمكنك إضافة قائمة برموز الأصول المالية (مفصولة بفواصل) ضمن المتغير CAP_ALLOWED_EPICS. أما إذا أردت منحه صلاحية التداول المفتوح في كافة الأسواق المتاحة على حسابك، فاترك هذا الحقل فارغًا.

استكشاف الأخطاء وإصلاحها: المشكلات الشائعة وحلولها {#errors}

رسالة الخطأ السبب المرجح الحل المقترح
Session expired or invalid (الجلسة منتهية أو غير صالحة) استخدام كلمة مرور تسجيل الدخول العادية بدلًا من كلمة مرور واجهة الربط البرمجي المخصصة، أو وجود تعارض في إعداد المتغير CAP_ENV تحقق بدقة من أن CAP_API_PASSWORD يحتوي على كلمة المرور المخصصة لواجهة الربط البرمجي. وتأكد من تطابق CAP_ENV مع نوع حسابك: تجريبي (demo) أو حقيقي (live).
Rate limit exceeded (تجاوز الحد الأقصى للطلبات) إرسال عدد كبير جدًا من الطلبات في وقت قصير انتظر مدة تتراوح بين 30 و60 ثانية ثم حاول مجددًا. وإذا استمرت المشكلة، فقلل من وتيرة إرسال الطلبات الآلية.
zsh: event not found (تعذر العثور على الحدث) كلمة مرور واجهة الربط البرمجي تحتوي على علامة تعجب (!) ضع القيمة بين علامتي تنصيص مفردتين، على سبيل المثال: 'yourPassword!Here'
Server won't start (تعذر تشغيل الخادم) وجود خلل في عملية التثبيت أو إدخال مسار بايثون خاطئ شغل الأمر python -m capital_mcp.server مباشرة في نافذة الأوامر (Terminal) للاطلاع على رسالة الخطأ كاملة. وتأكد من أن مسار بايثون يشير فعليًا إلى البيئة الافتراضية (venv)، وليس إلى مسار التثبيت الأساسي في نظامك.
ظهور أقل من 36 أداة في تطبيق Claude عدم تشغيل الخادم بشكل صحيح نفذ الأمر tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log لمراجعة سجلات التشغيل. وتأكد من أن مسار بايثون يشير إلى البيئة الافتراضية، وأن ملف التهيئة منسق برمجيًا بصيغة JSON صحيحة.

ما هي الأوامر التي يمكنني توجيهها للمساعد الذكي؟ 

بمجرد إتمام عملية الربط بنجاح، يمكنك البدء باستخدام هذه النماذج من الأوامر المباشرة:

متابعة تفاصيل حسابك

"Check my session status" (تحقق من حالة جلستي)

"Login to my account" (سجل الدخول إلى حسابي)

"List my accounts" (استعرض قائمة حساباتي)

البحث وتحليل الأسواق

"Search for bitcoin markets" (ابحث عن أسواق البيتكوين)

"Show me [instrument] market details" (اعرض لي تفاصيل سوق [اسم الأصل المالي])

"Get 1-hour historical prices for [instrument]" (استخرج لي الأسعار التاريخية على إطار الساعة لـ [اسم الأصل المالي]) [instrument]

"What is client sentiment on [instrument]?" (ما هو توجه العملاء حيال [اسم الأصل المالي]؟)

مراجعة محفظتك الاستثمارية

"Show my open positions" (اعرض صفقاتي المفتوحة)

"List my working orders" (استعرض أوامري النشطة)

"Review my portfolio exposure" (راجع مستوى الانكشاف المالي لمحفظتي)

إبرام الصفقات (نوصي بالبدء في الوضع التجريبي أولًا)

"Create a trade proposal for [instrument] with 1% risk" (أنشئ لي مقترح صفقة لـ [اسم الأصل المالي] بمخاطرة قدرها 1%)

"Preview buying 1.5 [instrument] with stop at 24.50" (معاينة شراء 1.5 من [اسم الأصل المالي] مع وقف خسارة عند 24.50)

"Execute position with preview_id abc-123 confirm=true" (تأكيد تنفيذ الصفقة ذات معرف المعاينة abc-123)

"Close position DEAL_ID confirm=true" (إغلاق الصفقة ذات المعرف DEAL_ID)

رموز الأصول المالية حساسة لحالة الأحرف. تجنبًا لأي أخطاء، استخدم دائمًا أحرفًا إنجليزية كبيرة (مثال: SILVER وليس silver).

احرص دائمًا على المراجعة الدقيقة لتفاصيل معاينة الصفقات قبل تأكيد تنفيذها. فالمخرجات التي يولدها الذكاء الاصطناعي ما هي إلا أدوات مساعدة لدعم تحليلك؛ ولا يمكنها بأي حال أن تحل محل حكمك الشخصي أو تقصي المخاطر المرتبطة بتداول عقود الفروقات.

الأسئلة الشائعة

هل أحتاج إلى حساب تداول حقيقي على Capital.com لاستخدام خادم MCP؟

لا، ليس بالضرورة؛ إذ يدعم خادم MCP العمل بكفاءة تامة على الحساب التجريبي. ونحن نوصي بشدة بإتمام كافة خطوات الإعداد واختبارها في الوضع التجريبي أولًا، قبل اتخاذ خطوة الربط بحسابك الحقيقي.

هل كلمة مرور حسابي في منصة Capital.com هي ذاتها المطلوبة في حقل CAP_API_PASSWORD؟

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

هل يمكن للذكاء الاصطناعي إبرام الصفقات دون إذني المسبق؟

قطعًا لا. فتمرير أي صفقة يتطلب أولًا إجراء "معاينة"، يتبعها توجيه رسالة تأكيد صريحة ومستقلة تتضمن الأمر confirm=true. ولن يقوم الخادم بتنفيذ أي صفقة ما لم تكتمل هاتان الخطوتان. وبذلك، تبقى زمام المبادرة بيدك، حيث يشترط تأكيدك المباشر والصريح قبل إبرام أي صفقة.

ما هي وظيفة المتغير CAP_ALLOW_TRADING وهل يجب علي تفعيله؟

متغير CAP_ALLOW_TRADING هو مفتاح التحكم الذي يمنح الخادم صلاحية تنفيذ الصفقات أو يمنعه من ذلك. وننصحك بإبقائه معطلًا (على القيمة false) طوال فترة الإعداد والاختبار. ولا تقم بتفعيله (تغييره إلى true) إلا بعد تأكدك التام من نجاح عملية الربط على الحساب التجريبي، وإدراكك الكامل للمخاطر المرتبطة بتداول عقود الفروقات الفعلي.

ما الدور الذي يلعبه المتغير CAP_ALLOWED_EPICS؟

يعمل هذا المتغير كأداة حصر تقصر تداولات الخادم على أصول مالية محددة. فإذا تركته فارغًا، سيتمكن الخادم من التداول في كافة الأسواق المتاحة على حسابك. أما إذا أردت تقييد التداول وقصره على أسواق بعينها، فيمكنك إضافة قائمة برموز تلك الأصول (مفصولة بفواصل).

لقد أتممت جميع خطوات الإعداد، ولكن تطبيق Claude يعرض أقل من 36 أداة. أين يكمن الخلل؟

يشير هذا إلى عدم عمل الخادم بصورة صحيحة. بادر بتنفيذ الأمر tail -f ~/Library/Logs/Claude/mcp-server-capital-com.log لمراجعة سجلات التشغيل. وغالبًا ما يعود السبب في ذلك إلى وجود خطأ في البنية البرمجية (Syntax) لملف التهيئة بصيغة JSON، أو أن مسار تشغيل بايثون يشير إلى نسخة النظام الأساسية بدلًا من بيئة العمل الافتراضية (venv).

إخلاء مسؤولية –استخدام واجهة الربط البرمجي العامة لمنصة Capital.com مع أدوات خارجية

عمليات الربط مع الأدوات الخارجية

توضح هذه الصفحة الآلية التي يمكن لعملائنا من خلالها ربط واجهة الربط البرمجي (API) العامة لمنصة Capital.com ببرمجيات وأدوات وتطبيقات خارجية، بما في ذلك تلك المدعومة بالذكاء الاصطناعي أو النماذج اللغوية الكبيرة (LLMs). ويرجى العلم بأن أي برمجيات أو أدوات أو عمليات ربط خارجية من هذا القبيل تعد كيانات مستقلة تمامًا عن منصة Capital.com، ولا تشكل بأي حال جزءًا من حزمة خدماتها المعتمدة. وعليه، فإن منصة Capital.com لا تمارس أي سيطرة على هذه البرمجيات الخارجية، ولم تساهم في تطويرها، ولا تقدم أي مصادقة عليها؛ كما تخلي مسؤوليتها القانونية والتامة عن كفاءة عملها، أو المخرجات الناتجة عنها، أو أي عواقب أو نتائج قد تترتب على استخدامها. إن قرارك باستخدام أدوات أو تطبيقات خارجية وربطها بواجهة الربط البرمجي العامة لمنصة  Capital.com يقع على مسؤوليتك الشخصية بالكامل. وأنت تتحمل وحدك مسؤولية مراجعة الشروط والأحكام، وسياسات الخصوصية، وآليات معالجة البيانات الخاصة بأي أداة خارجية تختار الاعتماد عليها.

استخدام واجهة الربط البرمجي العامة

يخضع استخدامك لواجهة الربط البرمجي (API) العامة لمنصة  Capital.com لتقديرك الشخصي ومسؤوليتك الكاملة.تتيح منصة  Capital.com هذه الواجهة لأغراض التداول والاطلاع على المعلومات، إلا أنها لا تُزكّي، أو تدعم، أو تشجع أي آلية استخدام، أو طريقة ربط، أو استراتيجية تداول بعينها. وتقع على عاتقك وحدك مسؤولية كيفية الوصول إلى الواجهة واستخدامها، ويشمل ذلك تحديد معايير الأوامر المرسلة، وضبط إعدادات أي أدوات أو أنظمة متصلة بها، فضلًا عن كيفية قراءتك وتفسيرك للبيانات الواردة. لا تتحمل Capital.com أي مسؤولية قانونية عن أي خسائر أو نتائج غير مقصودة قد تنجم عن استخدامك للواجهة، سواء تم الوصول إليها مباشرةً أو عبر أدوات وسيطة تابعة لأطراف خارجية. كما نحتفظ بالحق الكامل في تعديل الواجهة، أو تقييد حجم الطلبات عبرها، أو تعليق عملها، أو إيقافها تمامًا في أي وقت ودون إشعار مسبق. يخضع استخدامك لهذه الواجهة للشروط والأحكام العامة لمنصة Capital.com وشروط التداول الإلكتروني، والتي نحثك بشدة على قراءتها بعناية قبل البدء في الاستخدام.

خدمة التنفيذ المباشر فقط وإخلاء المسؤولية عن الاستشارات الاستثمارية

تقدم Capital.com خدماتها على أساس التنفيذ المباشر فقط (أي تنفيذ أوامرك دون تقديم مشورة). وينطوي تداول الأدوات المالية على مخاطر كبيرة قد تؤدي إلى خسارة رأس المال. لا يمثل أي محتوى وارد في هذه الصفحة، أو ضمن واجهة الربط البرمجي، أو في أي برمجيات أو أدوات ربط خارجية، مشورةً استثمارية، أو توصيةً شخصية، أو دعوةً صريحة لشراء أو بيع أي أصل مالي. وينطبق هذا تمامًا على أي مخرجات، أو إشارات تداول، أو مقترحات، أو تحليلات يتم توليدها بواسطة الذكاء الاصطناعي، أو النماذج اللغوية الكبيرة (LLMs)، أو غيرها من أدوات التداول الآلي. إن جميع قرارات التداول التي تتخذها، بما في ذلك أي نشاط تداول آلي أو خوارزمي، تتم على مسؤوليتك الشخصية البحتة.

المخاطر المصاحبة للتداول الآلي والخوارزمي

يحمل دمج واجهة الربط البرمجي مع أدوات التداول الآلي أو الخوارزمي مخاطر إضافية تشمل على سبيل المثال لا الحصر: التنفيذ فائق السرعة للأوامر دون أي مراجعة أو تدخل بشري؛ والأعطال النظامية، أو الإخفاقات البرمجية، أو مشاكل الاتصال بالإنترنت؛ وتنفيذ الصفقات بأسعار قد تختلف جوهريًا عن الأسعار المتوقعة؛ بالإضافة إلى إرسال أوامر غير مقصودة أو خاطئة نتيجة خلل في ضبط إعدادات الأدوات أو معايير التداول. لا تتحمل Capital.com أي مسؤولية عن الخسائر الناجمة عن هذه المخاطر، أو عن التفاعلات التقنية بين أنظمتها وأي أدوات تابعة لأطراف خارجية. كما نؤكد على أن الأداء السابق، أو المخرجات التي تولدها الأدوات الآلية، لا تعد مؤشرًا موثوقًا لضمان تحقيق نتائج مماثلة في المستقبل.

الاستخدامات المحظورة

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

مسؤولياتك كمتداول

تقع على عاتقك مسؤولية ضمان توافق استخدامك لمنصة Capital.com، وواجهة الربط البرمجي العامة، وأي أدوات خارجية متصلة بها، مع الشروط والأحكام العامة، وشروط التداول الإلكتروني الخاصة بالمنصة، فضلًا عن التزامك بكافة القوانين واللوائح التنظيمية المعمول بها في نطاقك الجغرافي. يجب عليك أن تُقيّم بعناية فائقة ما إذا كانت أدوات التداول الآلي تتناسب مع ظروفك الشخصية، ومستوى خبرتك، وقدرتك على تحمل المخاطر، قبل الشروع في استخدامها. وتوصي Capital.com بشدة باختبار أي أدوات أو عمليات ربط آلية بشكل مكثف وشامل على حساب تجريبي أولًا، قبل دمجها في بيئة التداول الحقيقي.

مقالات في هذا الجزء

هل كان هذا المقال مفيداً؟
0 من 0 وجدوا هذا مفيداً