MCP: اربط Claude Code بـ أدواتك
Model Context Protocol معيار مفتوح لربط الذكاء الاصطناعي بأدوات التطوير؛ ويستخدمه Claude Code لجلب البيانات والأدوات الخارجية إلى الجلسة.
ما هو MCP؟
MCP (Model Context Protocol) معيار مفتوح من Anthropic يتيح لمساعدي الذكاء الاصطناعي الاتصال بأمان بمصادر البيانات والأدوات الخارجية. وباستخدام MCP، يستطيع Claude Code الاستعلام مباشرةً من قواعد البيانات، والوصول إلى GitHub، والبحث في الوثائق، والتحكم بالمتصفحات دون نسخ ولصق يدوي.
تطبيق ذكاء اصطناعي
تطبيقات تشغّلها نماذج مثل Claude وتتصل بأدوات ومصادر بيانات خارجية عبر MCP. يقرأ Claude Code، موضوع هذا الدليل، قاعدة الكود لديك، ويعدّل الملفات، ويشغّل الأوامر، ويتكامل مع أدوات التطوير لديك.
الأدوات ومصادر البيانات
قدرات خارجية تُقدَّم عبر خوادم MCP. وتوفّر الخوادم الوظائف عبر ثلاثة مكوّنات أساسية: أدوات يمكن للنموذج استدعاؤها، وموارد قابلة للقراءة، وقوالب prompt مهيكلة.
مفاهيم MCP الأساسية: المضيف والعميل والخادم
يقسّم MCP المنظومة إلى مضيفين وعملاء وخوادم: ينسّق تطبيق المضيف الوصول، ويحتفظ كل عميل باتصال مخصص بخادم واحد، وتحوّل الخوادم البيانات والأدوات الخارجية إلى قدرات بروتوكولية.
مضيف MCP
تطبيق الذكاء الاصطناعي الذي تستخدمه مباشرة: ينسّق ويدير عميل MCP واحدًا أو عدة عملاء MCP وعمليات وصولهم.
عميل MCP
المكوّن البروتوكولي الذي ينشئه المضيف لكل خادم: يحتفظ باتصال مخصص ويحوّل احتياجات التطبيق إلى طلبات واستجابات.
خادم MCP
برنامج مستقل يوفّر السياق للعملاء ويعرّض قدرات خارجية عبر العناصر الأولية: الأدوات والموارد وprompts.
خوادم MCP الشائعة
تشمل منظومة MCP بالفعل الملفات والمستودعات وقواعد البيانات والمتصفحات ومراقبة الأخطاء والتعاون بين الفرق. وإضافة إلى الخوادم المرجعية التي تديرها مجموعة توجيه MCP (تم التحقق في 2026-10-20)، تستمر خوادم المجتمع والمزوّدين في النمو؛ وترد أدناه بعض الخوادم الشائعة.
خادم Filesystem
قراءة/كتابة الملفات المحلية، والبحث في بنى المجلدات وإدارتها
خادم GitHub
إدارة المستودعات وطلبات السحب والمشكلات، والبحث في الشيفرة
خادم قاعدة البيانات
الاستعلام من قواعد البيانات مباشرةً، وتحليل المخططات، وتوليد SQL
خادم المتصفح
التحكم بالمتصفحات للاختبار الآلي والتفاعل مع الويب
Sentry لمراقبة الأخطاء
عرض سجلات الأخطاء، وتحليل تتبعات المكدس، وتحديد موقع الأخطاء تلقائيًا
Slack للمراسلة
إرسال الرسائل، والبحث في سجل القنوات، وإدارة إشعارات سير العمل
تكوين MCP في Claude Code
تسرد الوثائق الرسمية عدة طرق: claude mcp add لأمر التشغيل، وclaude mcp add-json لإدخال JSON، أو تحرير .mcp.json (المشروع) و~/.claude.json (المحلي والمستخدم) مباشرةً.
نقل stdio: عمليات الخادم المحلية
مع stdio، يشغّل العميل الخادم كعملية فرعية ويتبادل الرسائل عبر الإدخال والإخراج القياسيين. يناسب الأدوات التي تحتاج إلى وصول مباشر إلى جهازك: ما عليك سوى تقديم أمر التشغيل ووسائطه، مثل مثال npx filesystem.
{
"mcpServers": {
"filesystem": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-filesystem",
"/path/to/project"
]
}
}
}نقل SSE للخوادم البعيدة
SSE يربط العملاء بخوادم بعيدة عبر HTTP. تصنّف وثائق Claude Code نقل SSE على أنه مهمل وتوصي بنقل HTTP حيث يتوفر؛ ومع ذلك، تعرّض بعض الخدمات نقطة نهاية SSE فقط، وهو ما يضبطه هذا المثال (تم التحقق في 2026-10-20). يحاول Claude Code نقل HTTP أولًا ويبدّل إلى SSE عندما لا يقبله الخادم؛ يتطلب التبديل التلقائي Claude Code v2.1.265 أو أحدث.
{
"mcpServers": {
"remote-server": {
"type": "sse",
"url": "https://mcp.example.com/sse",
"headers": {
"Authorization": "Bearer your-token"
}
}
}
}أفضل ممارسات أمان MCP
تمتلك خوادم MCP وصولًا قويًا إلى النظام — لذا يعد تكوين الأمان المناسب أمرًا بالغ الأهمية
الحد الأدنى من الامتيازات
امنح فقط الحد الأدنى من الأذونات اللازمة — وتجنب حسابات root أو admin
التحقق من مصادر الخوادم
استخدم فقط خوادم رسمية أو موثوقة يديرها المجتمع — وراجع الشيفرة المصدرية والاعتماديات
عزل الشبكة
قيّد وصول الخادم إلى الشبكة — وامنع الاتصالات بنقاط نهاية خارجية غير موثوقة
تسجيل التدقيق
فعّل تسجيل استدعاءات MCP، وراجع بانتظام سجلات استدعاء الأدوات بحثًا عن الحالات الشاذة
الأسئلة الشائعة
هل يجب أن أكتب شيفرة لاستخدام خادم MCP موجود؟
لا يتطلب استخدام خادم موجود كتابة أي شيفرة: تبدأ الخوادم المرجعية التي تُصان في المستودع الرسمي بأمر npx يُضاف إلى إعداداتك. لا تكتب خادمًا إلا عندما تريد تعريض أنظمتك الخاصة عبر SDK.
أي ملف يحتوي على إعدادات خادم MCP؟
توجد الإدخالات المحلية وإدخالات المستخدم في .claude.json داخل دليلك الرئيسي؛ أما إدخالات المشروع فتوضع في .mcp.json عند جذر المستودع، حيث يمكن لنظام التحكم بالإصدارات مشاركتها. يكتب claude mcp add النطاق المحلي افتراضيًا، لذا اختر نطاقًا آخر باستخدام --scope. تم التحقق مقابل الوثائق الرسمية في 2026-10-20. في إدخال JSON، يقبل الحقل type القيمة streamable-http كاسم بديل لـ http، لكن url بدون type خطأ في الإعداد: يتجاوز Claude Code ذلك الخادم ويبلغ بأن الإدخال يحتوي على url لكن دون type.
HTTP أم SSE لخادم MCP بعيد؟
اختر HTTP للاتصالات البعيدة الجديدة: تُدرج الوثائق خوادم HTTP كطريقة موصى بها للوصول إلى خوادم MCP البعيدة. يُصنّف SSE على أنه مهمل في الصفحة نفسها، لذا أبقِه للخدمات التي لا تنشر أي شيء آخر. تم التحقق في 2026-10-20. يحاول Claude Code استخدام HTTP أولًا ويبدّل إلى SSE عندما لا يقبله الخادم، ويتطلب ذلك التبديل الإصدار v2.1.265 أو أحدث.
ما الذي يجب فحصه عندما لا يتصل الخادم
شغّل claude mcp list أولًا: تعني «Connected» أن الخادم يعمل، و«Needs authentication» تعني غياب تسجيل الدخول، و«Failed to connect» هو الفشل الفعلي. ثم يُظهر claude mcp get مع اسم الخادم، أو /mcp داخل جلسة، التفاصيل. إذا كان جانب النموذج لديك يمر عبر بوابة، فانتبه إلى أن البحث في أدوات MCP معطّل افتراضيًا ويحتاج إلى ضبط ENABLE_TOOL_SEARCH صراحةً. تم التحقق في 2026-10-20. يظهر خادم ضمن نطاق المشروع من .mcp.json على أنه قيد الموافقة في جلسة تفاعلية، ولا يمكن لمستودع مستنسخ الموافقة على خوادمه الخاصة حتى تثق بمساحة العمل تلك.
هل MCP مخصص لـ Claude Code فقط؟
لا. MCP معيار مفتوح، وإدخالات الخادم ليست مرتبطة بعميل واحد. توضّح الوثائق كيفية نقل خادم مكتوب لـ Claude Desktop أو Cursor أو أي عميل MCP آخر: خذ URL الخاص به، أو أمر التشغيل، أو كتلة JSON. تم التحقق في 2026-10-20. تقدّم الوثائق أمرًا مخصصًا لذلك: يفتح claude mcp add-from-claude-desktop مربع حوار تختار فيه الخوادم المراد استيرادها.
فئات الأدوات التي يمكنك توصيلها
بحسب الغرض، تندرج الخوادم الشائعة في الفئات الأربع أدناه. وتظهر القوة الحقيقية لـ MCP عندما تعمل خوادم متعددة معًا، فتدمج قدراتها المتخصصة عبر واجهة موحّدة.
أدوات المطوّرين والكود
اربط Git ومنصات استضافة الكود لقراءة المستودعات والبحث فيها وإجراء عمليات عليها، وجلب عمليات الإيداع والفروع والمراجعات إلى المحادثة.
البيانات والتخزين
نفّذ عمليات ملفات آمنة مع ضوابط وصول قابلة للتهيئة، وأدِر المجلدات، واتصل بقواعد البيانات لاستعلام البيانات وفحص المخططات.
التعاون والمراسلة
اربط مساحات عمل Slack: اعرض القنوات، وانشر الرسائل، وردّ على السلاسل، وأضف التفاعلات، واقرأ سجل القنوات لإبقاء الفريق متزامنًا.
خدمات الويب والمعلومات
تتولى خوادم مثل Fetch جلب محتوى الويب وتحويله من أجل استخدام فعّال لـ LLM؛ وتُستخدم خوادم مماثلة عادةً للبحث والاطلاع على الوثائق.
استخدم MCP عبر QCode.cc
لا يحتاج MCP إلى ربط مختلف: المفتاح نفسه، ونقطة النهاية نفسها، وكتلة mcpServers توجد ببساطة في مشروعك
يبقى جانب الأدوات وجانب النموذج منفصلين
تُضاف خوادم MCP إلى إعدادات Claude Code الخاصة: الإدخالات المحلية وإدخالات المستخدم في .claude.json، وإدخالات المشروع في .mcp.json. أما المكان الذي تذهب إليه طلبات النموذج لديك فهو إعداد منفصل، لذا لا يستبدل أحدهما الآخر أبدًا. تم التحقق في 2026-10-20.
تبقى بيانات اعتماد النموذج لديك كما هي
عند إضافة خادم MCP يبقى المفتاح ونقطة النهاية الصادران عن QCode دون تغيير. يحتفظ الخادم بأسراره الخاصة في حقلي env أو headers، وتشير الوثائق إلى أن --env يقبل عدة أزواج KEY=value دفعة واحدة. لا يحل أي من نوعي بيانات الاعتماد محل الآخر أبدًا. تم التحقق في 2026-10-20.
مشاركة الخوادم عبر المستودع
يمكن للفريق أن يعمل بقائمة خوادم واحدة: أودِعها في .mcp.json في جذر المستودع. ولأغراض الأمان، يطلب منك Claude Code الموافقة على كل خادم مشروع قبل استخدامه في جلسة تفاعلية، ويمسح claude mcp reset-project-choices تلك الموافقات. تم التحقق في 2026-10-20.
QCode يدعم أيضًا OpenAI Codex / GPT-5.6
تعمل حصتك في QCode عبر Claude Code وOpenAI Codex CLI — رصيد واحد مشترك، دون أي إنفاق مكرر.
ابدأ استخدام MCP مع Claude Code
استمتع بالقوة الكاملة لمنظومة MCP بتكلفة منخفضة
آخر تحديث 2026-11-14
إنشاء حساب QCode
مفتاح واحد لـ Claude وGPT والنماذج الصينية، والفوترة حسب token — الأسعار المباشرة على /models.