MCP Academy · درس

ربط الخادم بـClaude Desktop

عدّلوا الإعدادات لكي يحمّل Claude خادمكم.

الدرس 2 من 413 خطوة

ربط الخادم بـClaude Desktop درس مجاني في MCP Academy على CoddyKit. هذا هو الدرس 2 من أصل 4. يمكنك قراءة الدرس كاملاً أدناه مجاناً — ثم تمرن عليه مباشرة في المتصفح باستخدام محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7. هذا الدرس جزء من مسار التعلم في MCP Academy، وتقدمك يتزامن عبر الويب وتطبيق CoddyKit. تتضمن دورة MCP Academy 4 دروس في المجموع.

من نص برمجي إلى مضيف حقيقي

يعمل خادمك، لكن لا أحد يتواصل معه بعد. لنوصله بمضيف حقيقي: Claude Desktop. 🖥️

يقرأ ملف إعدادات

يكتشف Claude Desktop الخوادم من ملف JSON واحد اسمه claude_desktop_config.json. وتدرج كل خادم فيه، ثم يحمّلها عند بدء التشغيل.

مكان وجود الملف

يوجد الملف في macOS ضمن Application Support، وفي Windows داخل مجلد AppData المتجول. افتحه من إعدادات التطبيق.

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

المفتاح mcpServers

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

{
  "mcpServers": {}
}

الأمر والوسائط

تحدد لكل خادم أمرًا لتشغيله ومصفوفة من args. وهما معًا يحددان بدقة كيفية تشغيل المضيف لعمليتك.

{
  "weather": {
    "command": "python",
    "args": ["/abs/path/server.py"]
  }
}

استخدم المسارات المطلقة

يشغّل المضيف من دليل العمل الخاص به، لذا تتعطل المسارات النسبية. احرص دائمًا على أن تشير args إلى مسار مطلق للنص البرمجي.

يجعل uv الأمر أسهل

إذا كان مشروعك يستخدم uv، فعيّن الأمر إلى uv ودعه يشغّل الوحدة في البيئة الصحيحة، من دون الحاجة إلى تثبيت عام.

{
  "command": "uv",
  "args": ["run", "server.py"]
}

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

توضع الأسرار، مثل مفاتيح API، في كائن env اختياري. يحقنها المضيف عند بدء تشغيل خادمك، فتظل خارج التعليمات البرمجية.

"env": { "API_KEY": "sk-..." }

أعد التشغيل لتطبيق التغييرات

يقرأ Claude ملف الإعدادات عند التشغيل فقط. وبعد أي تعديل، يجب أن تعيد تشغيل التطبيق بالكامل كي يحمّل خادمك الجديد.

أيقونة المطرقة

عند نجاح الإعداد، يظهر مؤشر صغير لـ tools في المحادثة. وبالنقر عليه تظهر الأدوات التي يوفّرها خادمك الآن لـ Claude. 🔨

اختر الاسم بعناية

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

تحقق سريع

ما التغيير الذي يحتاج إليه Claude Desktop قبل تحميل خادم أُضيف حديثًا؟

أجب عليها في الدرس التفاعلي

مراجعة

أضفت خادمك إلى claude_desktop_config.json باستخدام command وargs وenv، واستخدمت مسارات مطلقة، ثم أعدت التشغيل. أصبح الخادم يعمل في Claude! ✅

البدء مجانًا

تعلم Python مع معلم ذكاء اصطناعي — مجانًا

اكتب وقم بتشغيل أكوادك الفعلية في المتصفح، واحصل على مساعدة فورية من معلم ذكاء اصطناعي متاح 24/7، واستمر من حيث توقفت على الويب أو في التطبيق.

الدورات: 30
الدروس: 120

ابدأ التعلم مجانًا عرض الدورة الكاملة

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

هل درس «ربط الخادم بـClaude Desktop» مجاني؟

نعم — نص درس «ربط الخادم بـClaude Desktop» كامل متاح مجاناً هنا على الويب. لتمرينه بشكل تفاعلي (محرر أكواد مدمج ومدرس ذكاء اصطناعي متاح 24/7) وفتح باقي دورة MCP Academy، انتقل إلى CoddyKit PRO. تتضمن دورة MCP Academy 4 دروس في المجموع.

ماذا ستتعلم في «ربط الخادم بـClaude Desktop»؟

عدّلوا الإعدادات لكي يحمّل Claude خادمكم. تتمرن على MCP Academy مع أكواد عملية تشغلها مباشرة في المتصفح، ومدرس ذكاء اصطناعي متاح 24/7 يجيب على أسئلتك أثناء عملك.

هل أحتاج إلى خبرة سابقة لأبدأ MCP Academy؟

لا تُشترط خبرة سابقة. MCP Academy على CoddyKit منظم للمبتدئين حتى المتقدمين، لذا يمكنك البدء من هنا أو من البداية والتقدم بسرعتك الخاصة. هذا هو الدرس 2 من أصل 4.

كم من الوقت يستغرق درس «ربط الخادم بـClaude Desktop»؟

معظم دروس CoddyKit تستغرق حوالي 5–10 دقائق. كل منها موجز وتفاعلي، لذا تحرز تقدماً مستمراً وتستأنف من حيث توقفت عبر الويب والتطبيق.

هل يمكنني كتابة وتشغيل أكواد في درس MCP Academy هذا؟

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

جميع الدروس في هذه الدورة

← العودة إلى MCP Academy