Blank white background with no objects or features visible.

تحية إلى منطقة أوروبا والشرق الأوسط وأفريقيا! توسع TrueFoundry نطاق حضورها في هذه المنطقة الحيوية. اقرأ المزيد ←

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

Updated: November 3, 2026

Published: July 2, 2026

المقدمة

تم تصميم 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 لفريق كامل، وليس لنفسك فقط؟

تمنح بوابة TrueFoundry's MCP Gateway كل مطور سجل الخوادم المعتمد نفسه — مع حفظ بيانات الاعتماد في خزينة آمنة، وتحديد نطاق الوصول لكل أداة، وبدون أي تباين في التكوين بين الأجهزة اللوحية والمحمولة.

احجز عرضًا توضيحيًا لمدة 30 دقيقةاستكشف MCP Gateway

ما تحتاجه قبل البدء

قبل إضافة خادم 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

كيفية تدفق العمليات

  1. تقوم بتحديد أداة أو مهمة في Claude Code
  2. يحدد Claude Code الأداة (خادم MCP) المطلوبة
  3. يقوم خادم MCP بتنفيذ الطلب
  4. تم إرجاع النتائج واستخدامها للخطوة التالية

على سبيل المثال:

  • "إصلاح 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 Code
  • type ← نوع الاتصال (HTTP/محلي)
  • url ← نقطة نهاية خادم MCP
  • auth ← تفاصيل المصادقة

الخطوة 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 الخاص بك جاهز للإنتاج بأمان؟

ضع علامة على ما قمت به بالفعل:

حدد الصناديق لترى مدى جاهزيتك.
تخطَّ عناء الإعداد — احجز عرضًا توضيحيًا ←

أفضل الممارسات لإضافة خوادم 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 هو ما يطلق العنان للإمكانيات، ولكن القيمة الحقيقية تأتي من مدى قدرتك على تشغيل وتوسيع تلك الإمكانيات في أنظمة العالم الحقيقي.

استغرق خادم MCP الأول 10 دقائق. وحوكمة خمسين منها لا ينبغي أن تستغرق ربع عام.

احجز عرضًا توضيحيًا ←

Try now.

One gateway for all your models, MCP servers, and agents. No credit card needed.

Start free
Table of Contents

One Gateway for Every LLM, Agent and MCP Server

Book a 30-min with our AI expert

Book a Demo

The fastest way to build, govern and scale your AI

Book Demo
Summarize with
ChatGPT logo by OpenAI
Perplexity AI logo
Blurry red snowflake on white background, symmetrical frosty design with soft edges and abstract shape.

Discover More

No items found.
Guide to Langgraph vs Langchain
November 16, 2026
|
5 min read

مقارنة بين LangChain وLangGraph: أيهما الأفضل لك؟

مقارنة
A detailed guide on Claude Fable 5
November 16, 2026
|
5 min read

كلود فيبل 5: واجهة برمجة التطبيقات، المعايير، التسعير وكيفية استخدامه

الهندسة والمنتج
openrouter vs litellm
November 16, 2026
|
5 min read

LiteLLM مقابل OpenRouter: أيهما الأنسب لك؟

مقارنة
November 16, 2026
|
5 min read

معمارية المحول في نماذج اللغة الكبيرة

مصطلحات LLM
No items found.

Recent Blogs

Black left pointing arrow symbol on white background, directional indicator.
Black left pointing arrow symbol on white background, directional indicator.

Frequently asked questions

كيفية إضافة خادم MCP إلى كلود كود؟

تتطلب إضافة خادم MCP إلى كلود كود تعديل ملف تكوين كلود، والذي يكون عادةً `claude_desktop_config.json` أو ملف `.claude/config.json` الخاص بالمشروع. داخل هذا الملف، يحدد المطورون كل خادم MCP بتحديد أمره ووسائطه وأي متغيرات بيئة مطلوبة. بعد حفظ التكوين، تؤدي إعادة تشغيل كلود كود إلى تحميل الخادم الجديد وإتاحة أدواته داخل الجلسة.

‍

هل يمكنني إضافة خوادم MCP إلى Claude Code؟

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

Take a quick product tour
Start Product Tour
Product Tour