كيفية إضافة خادم MCP إلى Claude Code (دليل خطوة بخطوة)

Built for Speed: ~10ms Latency, Even Under Load
Blazingly fast way to build, track and deploy your models!
- Handles 350+ RPS on just 1 vCPU — no tuning needed
- Production-ready with full enterprise support
المقدمة
تم تصميم Claude Code للقيام بأكثر من مجرد المساعدة في كتابة الكود؛ حيث يمكنه تحليل قواعد الكود بالكامل، والتخطيط للتغييرات متعددة الخطوات، وتنفيذ المهام عبر الملفات. ولكن بمفرده، يظل Claude Code محدودًا ببيئتك المحلية. تتضمن مسارات عمل التطوير الحديثة التفاعل مع:
- المستودعات (Repositories)
- قواعد البيانات
- واجهات برمجة التطبيقات (APIs)
- الأدوات الداخلية
وهنا يأتي دور خوادم MCP (بروتوكول سياق النموذج). يتيح MCP لـ Claude Code الاتصال بالأنظمة الخارجية واتخاذ إجراءات تتجاوز تحرير الكود، مما يمكن مسارات عمل مثل:
- دفع تغييرات الكود (Pushing code changes)
- الاستعلام عن قواعد البيانات
- تشغيل الأوامر
- تحفيز الخدمات (Triggering services)
بمعنى آخر، يحول MCP أداة Claude Code من مجرد أداة لكتابة الكود إلى وكيل تنفيذ كامل. ومع ذلك، قد يكون إعداد خوادم MCP في Claude Code مربكًا، خاصة إذا كنت تقوم بذلك للمرة الأولى. يوضح لك هذا الدليل بالضبط كيفية إضافة خادم MCP إلى Claude Code، خطوة بخطوة.
ما تحتاجه قبل البدء
قبل إضافة خادم MCP إلى Claude Code، تأكد من توفر ما يلي لديك.
إعداد هذه المتطلبات مسبقًا سيوفر الوقت ويمنع مشاكل التكوين الشائعة.
1. تثبيت Claude Code وعمله بنجاح
تأكد من تثبيت Claude Code وتشغيله بشكل صحيح في بيئتك.
يجب أن تكون قادرًا على:
- فتح قاعدة الكود والتنقل خلالها
- تشغيل الأوامر أو المطالبات (Prompts)
- الوصول إلى إعدادات التكوين
إذا لم يكن Claude Code مجهزًا بالكامل، فأكمل ذلك أولاً.
2. خادم MCP (محلي أو مستضاف)
لا يتضمن Claude Code خوادم MCP بشكل افتراضي، بل تحتاج إلى توصيل أحدها. يمكن أن يكون هذا:
- خادم MCP محلي يعمل على جهازك
- خادم MCP مستضاف (داخلي أو من طرف ثالث)
تشمل خوادم MCP الشائعة:
- GitHub (للمستودعات)
- Filesystem (لنظام الملفات وتطبيقاتها)
- PostgreSQL (لقواعد البيانات)
- REST APIs (للخدمات)
ابدأ بخادم واحد يناسب حالة الاستخدام الخاصة بك.
3. بيانات الاعتماد وحقوق الوصول
تتطلب معظم خوادم MCP المصادقة. قد تحتاج إلى:
- مفاتيح API keys
- رموز الوصول (Access tokens)
- بيانات اعتماد قاعدة البيانات
تأكد من:
- صلاحية بيانات الاعتماد
- تحديد الأذونات ونطاقها بشكل صحيح
- تخزين البيانات الحساسة بأمان
4. حالة استخدام واضحة
قبل إضافة خادم MCP، حدد ما تريد من Claude Code أن يفعله.
على سبيل المثال:
- إدارة الكود ← GitHub MCP
- الاستعلام عن البيانات ← Database MCP
- استدعاء الخدمات ← API MCP
يساعدك هذا على تجنب التعقيدات غير الضرورية.
5. بيئة آمنة للاختبار
من الأفضل تكوين خوادم MCP في بيئة تطوير أو بيئة اختبار (staging) أولاً.
يتيح لك ذلك:
- اختبار عمليات التكامل بأمان
- معالجة المشاكل وإصلاح الأخطاء بدون مخاطرة
- التحقق من صحة الأذونات ومسارات العمل
بمجرد أن يعمل كل شيء، يمكنك توسيع الإعداد ليشمل بيئة الإنتاج.
كيف يعمل MCP في Claude Code
قبل تكوين أي شيء، يفيد فهم كيفية تكامل MCP مع Claude Code. يكون Claude Code مسؤولاً عن:
- فهم قاعدة الكود الخاصة بك
- التخطيط للمهام
- اتخاذ القرار بشأن الإجراءات الواجب اتخاذها
بينما تكون خوادم MCP مسؤولة عن:
- تنفيذ تلك الإجراءات
- التفاعل مع الأنظمة الخارجية
- إعادة النتائج إلى Claude Code
كيفية تدفق العمليات
- تقوم بتحديد أداة أو مهمة في Claude Code
- يحدد Claude Code الأداة (خادم MCP) المطلوبة
- يقوم خادم MCP بتنفيذ الطلب
- تم إرجاع النتائج واستخدامها للخطوة التالية
على سبيل المثال:
- "إصلاح API الذي يفشل ونشره"
- يقوم Claude بتحليل الكود
- يستخدم MCP لتشغيل الاختبارات
- يستخدم MCP لدفع التغييرات
- يستخدم MCP لتحفيز عملية نشر التطبيق (Deployment)
دليل خطوة بخطوة: إضافة خادم MCP إلى Claude Code
دعنا نستعرض كيفية إضافة خادم MCP وتكوينه فعليًا.
الخطوة 1: إعداد خادم MCP الخاص بك
قبل إضافته إلى Claude Code، يجب أن يكون خادم MCP قيد التشغيل.
اعتمادًا على الخادم، قد يتضمن الإعداد ما يلي:
- تثبيت التبعيات (Dependencies)
- تشغيل خدمة محليًا
- ضبط متغيرات البيئة (Environment variables)
مثال (خادم MCP مستند إلى Node):
أو باستخدام Docker:
تأكد من:
- تشغيل الخادم
- معرفتك بنقطة النهاية (URL/port)
- تكوين بيانات الاعتماد المطلوبة
الخطوة 2: فتح تكوين Claude Code
في Claude Code:
- انتقل إلى ملف التكوين أو لوحة الإعدادات
- حدد موقع القسم الخاص بـ الأدوات / MCP / التكاملات (tooling / MCP / integrations)
(قد يختلف الموقع الدقيق اعتمادًا على الإعداد)
Step 3: إضافة إدخال خادم MCP
ستضيف الآن إدخال تكوين يخبر Claude Code بكيفية الاتصال بخادم MCP.
مثال للتكوين
معنى كل حقل
name← المعرف المستخدم بواسطة Claude Codetype← نوع الاتصال (HTTP/محلي)url← نقطة نهاية خادم MCPauth← تفاصيل المصادقة
الخطوة 4: تكوين المصادقة
إذا كان خادم MCP الخاص بك يتطلب المصادقة:
- أضف مفاتيح API keys أو الرموز (Tokens)
- تأكد من صحة الأذونات
- تجنب كشف الأسرار في نصوص صريحة
اعتمادًا على الخادم، قد يشمل ذلك:
- Bearer tokens
- مفاتيح API keys
- بيانات اعتماد OAuth
الخطوة 5: اختبار خادم MCP
بمجرد التكوين، اختبر التكامل.
جرب المطالبات مثل:
- "اعرض المستودعات من GitHub"
- "شغل الاختبارات في هذا المشروع"
- "اجلب البيانات من قاعدة البيانات"
إذا كان كل شيء يعمل بشكل صحيح:
- سيقوم Claude Code باستدعاء خادم MCP
- ستتلقى إجابة صالحة
إذا لم يكن كذلك:
- تحقق من السجلات (Logs)
- تحقق من بيانات الاعتماد
- تأكد من إمكانية الوصول إلى نقطة النهاية
المشاكل الشائعة وإصلاحها
1. تعذر الوصول إلى خادم MCP
المشكلة: يتعذر على Claude Code الاتصال
الإصلاح:
- تأكد من تشغيل الخادم
- تحقق من URL/port
- تحقق من الوصول عبر الشبكة
2. أخطاء المصادقة
المشكلة: تم رفض الوصول أو الرمز غير صالح
الإصلاح:
- قم بإعادة إنشاء بيانات الاعتماد
- تحقق من نطاق الأذونات
- تأكد من صيغة المصادقة الصحيحة
3. فشل الأذونات
المشكلة: يستجيب الخادم ولكن الإجراءات تفشل
الإصلاح:
- تحقق من مستويات الوصول
- تحقق من أذونات الخدمة
- اضبط الأدوار حسب الحاجة
4. أخطاء التكوين
المشكلة: لم يتم التعرف على خادم MCP
الإصلاح:
- صادق على بناء جملة JSON
- تأكد من وجود الحقول المطلوبة
- أعد تشغيل Claude Code إذا لزم الأمر
أفضل الممارسات لإضافة خوادم MCP إلى Claude Code
بمجرد توصيل خوادم MCP بـ Claude Code، يجب أن ينتقل التركيز إلى جعل الإعداد آمنًا وموثوقًا وسهل الصيانة.
1. البدء بحد أدنى من الأذونات
تجنب منح خوادم MCP وصولاً غير محدود.
بدلاً من ذلك:
- استخدم رموزًا ذات نطاق محدود (Scoped tokens)
- امنح الأذونات المطلوبة فقط
- وسع نطاق الوصول تدريجيًا
هذا أمر مهم بشكل خاص بالنسبة لـ:
- قواعد بيانات الإنتاج
- أنظمة نشر التطبيقات
- واجهات برمجة التطبيقات (APIs) الداخلية
2. استخدام بيئات منفصلة
اختبر دائمًا تكاملات MCP في بيئات التطوير أو الاختبار (staging) قبل الانتقال لبيئة الإنتاج.
يتيح لك ذلك:
- التحقق من صحة التكوينات بأمان
- معالجة الأخطاء دون التأثير على الأنظمة الحية
- تحسين مسارات العمل
بمجرد استقرار الإعداد، كرر العملية في بيئة الإنتاج باستخدام ضوابط أكثر صرامة.
3. التحقق قبل تنفيذ الإجراءات الحرجة
يمكن لـ Claude Code تنفيذ مسارات عمل متعددة الخطوات، ولكن لا ينبغي تشغيل جميع الإجراءات دون تحقق.
أفضل الممارسات:
- مراجعة التغييرات المخطط لها
- إضافة خطوات تحقق لمسارات العمل الحساسة
- تجنب الاستقلالية الذاتية الكاملة في البيئات عالية المخاطر
4. مراقبة استخدام MCP
الرؤية والشفافية أصلان رئيسيان عندما يتفاعل Claude Code مع أنظمة متعددة.
تتبع:
- خوادم MCP المستخدَمة
- الإجراءات المُنفَّذة
- سلوك مسارات العمل بمرور الوقت
يساعد هذا في:
- معالجة الأخطاء (Debugging)
- التدقيق (Auditing)
- تحسين الموثوقية
5. الحفاظ على تكوينات نظيفة وقابلة للتوسع
كلما أضفت المزيد من خوادم MCP، يزداد التعقيد.
لإدارة ذلك:
- استخدم تسميات موحدة ومعيارية
- نظم التكوينات بشكل واضح
- وثّق التكامُلات
يضمن ذلك بقاء إعدادك قابلاً للصيانة مع تطور نظامك.
اعتبارات بيئة الإنتاج: توسيع مسارات عمل MCP
إعداد خادم MCP واحد أمر بسيط. ولكن تشغيل مسارات عمل متعددة مدعومة بـ MCP في بيئة الإنتاج ليسكذلك.
1. إدارة التكامُلات المتعددة
مع نمو الاستخدام، تقوم الفرق بتكامل خوادم MCP متعددة:
- GitHub
- قواعد البيانات
- واجهات برمجة التطبيقات (APIs)
- الأدوات الداخلية
بدون هيكل محدد، يؤدي هذا إلى:
- تكوينات مجزأة
- ضوابط وصول غير متسقة
- مسارات عمل يصعب إدارتها
2. فرض الضوابط والأطر الأمنية
يمكن لـ Claude Code تنفيذ إجراءات قوية عبر الأنظمة.
بدون الضوابط المناسبة، يجلب هذا مخاطر:
- تغييرات غير مقصودة
- وصول غير مصرح به
- عدم استقرار النظام
تحتاج الفرق إلى:
- التحكم في الوصول المعتمد على الأدوار (RBAC)
- قيود على مستوى الإجراءات
- حدود تنفيذ واضحة
3. القابلية للملاحظة ومعالجة الأخطاء
قد تكون معالجة أخطاء مسارات عمل MCP صعبة بدون وجود رؤية واضحة.
تحتاج إلى فهم:
- ما الذي حاول Claude Code القيام به
- أي خادم MCP قام بتطبيقه والتعامل مع الطلب
- أين حدثت الأخطاء
بدون وجود إمكانية الملاحظة، يصبح استكشاف الأخطاء وإصلاحها بطيئًا وغير موثوق.
4. إدارة النماذج، والتكاليف، والأداء
تعتمد مسارات عمل MCP على النماذج الأساسية.
عند التوسع، يجب على الفرق إدارة:
- اختيار النموذج (زمن الاستجابة مقابل الجودة)
- التكلفة عبر عمليات التنفيذ المكررة
- اختناقات الأداء
يتطلب هذا تحكمًا مركزيًا.
تشغيل مسارات عمل MCP في بيئة الإنتاج باستخدام TrueFoundry
يعد تشغيل خادم MCP محليًا مع Claude Code أمرًا بسيطًا نسبيًا. تبدأ التحديات الحقيقية عندما تحاول تشغيل مسارات العمل نفسها عبر الفرق والبيئات وأنظمة الإنتاج.
في تلك المرحلة، تقع الفرق عادةً في عدة مشاكل:
- بيانات الاعتماد متناثرة عبر التكوينات والبيئات
- لا يوجد تحكم واضح في الإجراءات التي يمكن للوكيل اتخاذها
- تصبح معالجة الأخطاء عبر استدعاءات MCP أمرًا صعبًا
- يصعب تتبع استخدام النماذج وتكاليفها أو تحسينها
وهنا تصبح منصة مثل TrueFoundry مفيدة—ليس كإضافة جانبية، بل كـ لوحة تحكم (Control Plane) لمسارات العمل المدعومة بالذكاء الاصطناعي.
مركزية الوصول إلى MCP وبيانات الاعتماد
في معظم الإعدادات، تتطلب خوادم MCP مفاتيح APIs أو رموزًا أو بيانات اعتماد قواعد البيانات. وغالبًا ما تنتهي هذه إلى:
- كتابتها بشكل ثابت (Hardcoded) في التكوينات
- تخزينها في متغيرات البيئة
- إدارتها بشكل غير متسق عبر البيئات المختلفة
مع TrueFoundry، يمكنك إضفاء الطابع المركزي على كيفية إدارة بيانات الاعتماد هذه والوصول إليها، بحيث:
- لا يتم كشف الأسرار في التكوينات المحلية
- يكون الوصول متسقًا عبر بيئات التطوير والاختبار والإنتاج
- تصبح عمليات التدوير والتحديث أسهل في التعامل
تحديد ما يُسمح للوكلاء بالقيام به
يمكن لـ Claude Code تنفيذ إجراءات حقيقية—مثل دفع الكود، واستعلام البيانات، وتشغيل الأوامر.
في بيئة الإنتاج، لا تريد أن يتمتع كل وكيل بوجود وصول غير محدود.
مع TrueFoundry، يمكنك تحديد:
- خوادم MCP التي يمكن للوكيل استخدامها
- الإجراءات المسموح بها (القراءة مقابل الكتابة، النطاقات المحدودة، إلخ)
- المواضع التي تتطلب موافقات أو عمليات تحقق
يساعد هذا في منع الحالات التي يقوم فيها الوكيل بـ:
- تعديل الأنظمة الحساسة
- تنفيذ مسارات عمل غير مقصودة
- التسبب في تغييرات يصعب التراجع عنها
إمكانية الملاحظة عبر استدعاءات MCP
عندما يتعطل شيء ما في مسار عمل MCP، فإن الجزء الأصعب هو معرفة أين حدث الفشل.
هل كان السبب:
- منطق النموذج واستنتاجه؟
- استدعاء خادم MCP؟
- النظام الخلفي؟
توفر TrueFoundry رؤية شاملة حول:
- خطوات تنفيذ الوكيل
- تفاعلات خادم MCP
- المدخلات والمخرجات والأخطاء
هذا يجعل من الأسهل بكثير:
- معالجة الأخطاء وإصلاحها
- تدقيق السلوك
- تحسين مسارات العمل بمرور الوقت
إدارة النماذج والتكلفة عند التوسع
يعتمد Claude Code على النماذج الأساسية، وغالبًا ما تتضمن مسارات عمل MCP استدعاءات مكررة.
مع نمو الاستخدام، تحتاج الفرق إلى:
- توجيه الطلبات عبر النماذج المختلفة
- الموازنة بين التكلفة والأداء
- مراقبة الاستخدام عبر الفرق
تمنحك TrueFoundry طريقة مركزية لـ:
- التحكم في النماذج المستخدَمة
- تحسين استراتيجيات التوجيه
- تتبع التكاليف وإدارتها
من الإعداد المحلي إلى مسارات العمل على مستوى الفريق
ما يبدأ كإعداد بسيط:
"إضافة خادم MCP ← تشغيل المهمة"
سرعان ما يتحول إلى:
"وكلاء متعددون ← خوادم MCP متعددة ← بيئات متعددة"
تساعد TrueFoundry في توحيد هذا من خلال توفير طريقة متسقة لـ:
- تكوين التكاملات
- فرض السياسات
- توسيع مسارات العمل عبر الفرق
يتيح MCP لـ Claude Code التفاعل مع الأنظمة.
وتضمن TrueFoundry أن تكون هذه التفاعلات منظمة، وقابلة للملاحظة، وجاهزة للإنتاج.
الخاتمة
إن إضافة خادم MCP إلى Claude Code هي ما يُمكّنه من الانتقال من مجرد أداة برمجة قوية إلى شيء أكثر فائدة بكثير—وكيل يمكنه التفاعل فعليًا مع أنظمتك وتنفيذ مسارات عمل حقيقية.
باستخدام الإعداد الصحيح، يمكن لـ Claude Code الذهاب إلى ما هو أبعد من تحرير الكود ليقوم بـ:
- دفع التغييرات إلى المستودعات
- الاستعلام عن قواعد البيانات
- استدعاء واجهات برمجة التطبيقات (APIs)
- تشغيل الأوامر والتحقق من النتائج
ولكن بمجرد أن تبدأ في الاعتماد على مسارات العمل هذه إلى ما هو أبعد من التجريب المحلي، يتغير التحدي. لا يتعلق الأمر فقط بتشغيل خادم MCP، بل يتعلق بـ إدارة كيفية حدوث هذه التفاعلات عبر البيئات والأنظمة والفرق.
وهنا تبرز أهمية منصات مثل TrueFoundry. حيث توفر طريقة لإضفاء الهيكلية على مسارات العمل المستندة إلى MCP، مع التعامل مع التحكم في الوصول، وإمكانية الرؤية، والتوسع، حتى تتمكن الفرق من استخدام أدوات مثل Claude Code بملء الموثوقية في بيئة الإنتاج. في النهاية، MCP هو ما يطلق العنان للإمكانيات، ولكن القيمة الحقيقية تأتي من مدى قدرتك على تشغيل وتوسيع تلك الإمكانيات في أنظمة العالم الحقيقي.
TrueFoundry AI Gateway delivers ~3–4 ms latency, handles 350+ RPS on 1 vCPU, scales horizontally with ease, and is production-ready, while LiteLLM suffers from high latency, struggles beyond moderate RPS, lacks built-in scaling, and is best for light or prototype workloads.


Recent Blogs
Frequently asked questions
كيفية إضافة خادم MCP إلى كلود كود؟
تتطلب إضافة خادم MCP إلى كلود كود تعديل ملف تكوين كلود، والذي يكون عادةً `claude_desktop_config.json` أو ملف `.claude/config.json` الخاص بالمشروع. داخل هذا الملف، يحدد المطورون كل خادم MCP بتحديد أمره ووسائطه وأي متغيرات بيئة مطلوبة. بعد حفظ التكوين، تؤدي إعادة تشغيل كلود كود إلى تحميل الخادم الجديد وإتاحة أدواته داخل الجلسة.
هل يمكنني إضافة خوادم MCP إلى Claude Code؟
نعم، يدعم Claude Code بشكل أصلي إضافة خوادم MCP متعددة. يمكن لكل خادم أن يكشف عن مجموعة أدواته الخاصة مثل استعلامات قواعد البيانات، عمليات الملفات، أو استدعاءات واجهة برمجة التطبيقات (API)، وسيقوم Claude Code باكتشافها واستخدامها تلقائيًا خلال الجلسات الذكية. يمكن تهيئة خوادم متعددة في وقت واحد، مما يمنح Claude إمكانية الوصول إلى مجموعة أدوات غنية عبر أنظمة مختلفة.












.webp)





.webp)
.webp)
.png)

.png)
.png)
.png)
.png)
.png)
.webp)
.webp)






