إنتقل إلى المحتوى الرئيسي

خوادم MCP في Claude Code

متقدّم

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

What you'll learn
  • اشرح ما هو خادم MCP وكيف يستدعي Claude Code أدواته
  • ميّز بين وسيطتي النقل: stdio المحلية مقابل HTTP/SSE البعيدة
  • أضف خادمًا باستخدام claude mcp add واقرأ ملف JSON الذي يكتبه
  • اختر النطاق الصحيح (محلي، مشروع، مستخدم) لتحديد من يرى الخادم
  • اربط قاعدة بيانات حقيقية بـ Claude من البداية حتى النهاية
  • تجنّب أفخاخ الأمان والإعداد التي يقع فيها معظم الناس

الشكل العام​

تعلن عن الخوادم التي يجوز لـ Claude استخدامها؛ وينشر كل خادم مجموعة من الأدوات مع مخططاتها (schemas)؛ ويختارها Claude ويستدعيها مثل أي أداة أخرى.

مفردات MCP
اضغط Enter أو مفتاح المسافة لقلب البطاقة. استخدم مفتاحي السهمين الأيسر والأيمن للتنقل بين البطاقات.تم إظهار المصطلح.
1 / 5

وسائط النقل​

هناك طريقتان يصل بهما Claude إلى الخادم. اختر حسب المكان الذي يعمل فيه الخادم.

  • stdio — عملية محلية يطلقها Claude (رائعة للأدوات/الـ CLIs المحلية).
  • عن بُعد (HTTP/SSE) — خادم مستضاف، غالبًا مع OAuth.

إعداد الخوادم​

أسرع طريق هو أمر claude mcp add — فهو يكتب الإعداد نيابةً عنك. اتبع هذا التسلسل للانتقال من الصفر إلى خادم متصل.

Guided walkthrough1 of 4
  1. شغّل claude mcp add — كل ما يأتي بعد -- هو أمر التشغيل الذي يُنفّذه Claude نيابةً عنك.

أضف خادم stdio محليًا

# A local stdio server (everything after -- is the launch command)
claude mcp add github -- npx -y @modelcontextprotocol/server-github

أضف خادم HTTP بعيدًا (مشترك مع المشروع)

# A remote HTTP server, shared with everyone on the project
claude mcp add --transport http --scope project linear https://mcp.linear.app/mcp

تحت الغطاء، هذا مجرد JSON. الخادم ذو النطاق project يستقر في ملف .mcp.json في جذر المستودع — أدرجه في نظام التحكم بالإصدارات فيحصل فريقك كله على الأدوات نفسها:

{
  "mcpServers": {
    "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"] }
  }
}

النطاق يحدّد من يرى الخادم​

النطاقيوجد فياستخدمه لـ
local (الافتراضي)إعداداتك الشخصية، هذا المشروع فقطالتجارب الشخصية، الأسرار
project.mcp.json في المستودع (مُلتزَم به)الأدوات التي ينبغي أن يتشاركها الفريق كله
userإعداداتك الشخصية، كل المشاريعالخوادم التي تريدها في كل مكان

شغّل claude mcp list لمعرفة ما هو متصل، و/mcp داخل الجلسة لفحص الأدوات والمصادقة على الخوادم البعيدة. راجع إعداد MCP وهياكل الخوادم لنقاط بدء جاهزة للنسخ واللصق.

مثال عملي: امنح Claude قاعدة بياناتك​

لنفترض أنك تريد أن يجيب Claude عن الأسئلة بالاعتماد على قاعدة Postgres محلية بدلاً من أن تلصق أنت نتائج الاستعلامات. أضف الخادم (بنطاق المشروع، حتى يرثه زملاؤك):

أضف خادم Postgres بنطاق المشروع

claude mcp add --scope project db -- npx -y @modelcontextprotocol/server-postgres "postgresql://localhost/app"

الآن يمكنك في الجلسة أن تطرح السؤال بلغة طبيعية وتترك Claude يقوم بحلقة الاستعلام نيابةً عنك:

اطرح سؤالًا على قاعدة البيانات

How many users signed up last week? Check the DB.

يستدعي Claude أداة query الخاصة بالخادم، ويستعيد الصفوف، ويُجيب — دون حلقة نسخ ولصق. ولأنه بنطاق المشروع، فإن أي زميل يسحب المستودع يحصل على القدرة نفسها لحظة فتحه Claude Code. أبقِ سلسلة الاتصال للقراءة فقط إن كنت تريد عمليات القراءة فحسب.

الثقة والأمان​

Watch out
  • خادم MCP يشغّل شيفرة ويمكنه قراءة البيانات واتخاذ إجراءات — لا تتصل إلا بالخوادم التي تثق بها.
  • امنح كل خادم أقل صلاحية يحتاجها.
  • أي محتوى خارجي يعيده الخادم قد يحمل حقن المطالبات (prompt injection).
  • راجع خوادم الطرف الثالث قبل الاتصال بها.

:::warning عامِل خوادم MCP كتثبيت برنامج يشغّل خادم MCP شيفرة ويمكنه قراءة البيانات واتخاذ إجراءات. لا تتصل إلا بالخوادم التي تثق بها، وامنحها أقل صلاحية لازمة، وتذكّر أن أي محتوى خارجي تعيده قد يحمل حقن المطالبات (prompt injection). راجع خوادم الطرف الثالث أولًا — انظر مراجعة شيفرة الطرف الثالث. :::

MCP في التطبيقات أيضًا​

يشغّل MCP أيضًا الموصلات (Connectors) في تطبيقات Claude — المعيار نفسه، سطح مختلف. انظر الموصلات (MCP) في التطبيقات، وبالنسبة للـ API، MCP والاتصال بالأدوات.

الأخطاء الشائعة​

  • النطاق الخاطئ. الخادم المُضاف بنطاق local لن يظهر للزملاء؛ وما أردته لنفسك فقط لا ينبغي الالتزام به بنطاق project. اختر بقصد ووعي.
  • خوادم كثيرة جدًا، أدوات كثيرة جدًا. يضيف كل خادم متصل مخططات أدواته إلى السياق. اتصل بما تحتاجه المهمة، لا بكامل فهرسك.
  • اتصالات مُفرطة الصلاحيات. امنح خادم قاعدة البيانات دورًا للقراءة فقط ما لم يكن Claude بحاجة فعلية للكتابة. يجعل MCP القدرات حقيقية — فقلّص نطاقها.
  • نسيان خطر الحقن. أي شيء يعيده الخادم (صفحة ويب، نص مشكلة، صف بيانات) هو نص غير موثوق قد يحمل حقن المطالبات (prompt injection). لا تربط خادمًا قويًا قادرًا على الكتابة بجوار خادم غير موثوق قادر على القراءة دون تفكير متأنٍّ.

اختبر نفسك

0/3
  1. أيُّ وسيطة نقل هي عملية محلية يطلقها Claude بنفسه؟
  2. أين يُكتب الخادم ذو نطاق المشروع، وما الفائدة؟
  3. لماذا تُبقي اتصال قاعدة البيانات للقراءة فقط عندما يحتاج Claude إلى القراءة فحسب؟
Key takeaways
  • MCP معيار مفتوح؛ ويكشف خادم MCP عن أدوات يستدعيها Claude Code مثل أي أداة أخرى.
  • وسيطتا نقل: stdio المحلية (عملية يطلقها Claude) وHTTP/SSE البعيدة (مستضافة، غالبًا مع OAuth).
  • claude mcp add يكتب الإعداد نيابةً عنك؛ وتحت الغطاء هو JSON، ونطاق المشروع يقيم في ملف .mcp.json مُلتزَم به.
  • النطاق يتحكم في الظهور: محلي (أنت، هذا المشروع)، مشروع (مُلتزَم به للفريق)، مستخدم (أنت، في كل مكان).
  • عامِل الخوادم كتثبيت برنامج: الثقة، وأقل الصلاحيات، والحذر من حقن المطالبات في أي شيء تعيده.

التالي​