MCP في Claude Code: إضافة الخوادم والنطاق والاستخدام الآمن

MCP، أي Model Context Protocol، معيار مفتوح يربط Claude Code بأدوات خارجية مثل GitHub وقواعد البيانات وNotion. تضيف الخادم من الطرفية بالأمر claude mcp add، وتحدد من يستخدمه معك بالخيار --scope، ثم تتأكد من اتصاله بالأمر /mcp داخل الجلسة. وتعمل الخوادم بالطريقة نفسها مع مفتاح API.

ما هو MCP في Claude Code؟#

خادم MCP برنامج أو خدمة على الويب تمنح Claude قدرات جديدة، ويقدم ثلاثة أنواع من الإمكانات:

• الأدوات: أفعال ينفذها Claude، مثل فتح طلب دمج أو تشغيل استعلام على قاعدة بيانات.
• الموارد: بيانات تشير إليها بالعلامة @، مثل مشكلة مفتوحة في GitHub أو بنية جدول.
• التعليمات الجاهزة: نصوص معدة مسبقًا تظهر في صورة أوامر تبدأ بالشرطة المائلة.

والعميل في هذا البروتوكول هو Claude Code. فبعد اتصال الخادم تطلب ما تريد بلغتك العادية، ويختار Claude الأداة المناسبة. وتستطيع بهذه الطريقة ربط Claude Code بمئات الأدوات، أو كتابة خادمك الخاص.

ما نوع الخادم الذي لديك؟#

يتصل كل خادم بإحدى أربع طرق، ويذكر توثيق الخادم الطريقة التي يستخدمها.

وإذا دعم الخادم الطريقتين HTTP وSSE معًا، فاستخدم HTTP.

كيف تضيف خادم MCP؟#

خادم HTTP بعيد#

اكتب اسم الخادم وعنوانه. وإذا كان يطلب رمز وصول، فأرسله في ترويسة:

claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add --transport http secure-api https://api.example.com/mcp \
  --header "Authorization: Bearer your-token"

أما الخوادم التي تسجّل دخولك عبر OAuth فلا تحتاج إلى ترويسة. شغّل /mcp داخل Claude Code، واختر الخادم، ثم أكمل تسجيل الدخول في المتصفح. ويؤدي الأمر claude mcp login <name> المهمة نفسها من الطرفية.

خادم stdio محلي#

خادم stdio برنامج يشغّله Claude Code على جهازك. اكتب أمر تشغيله بعد العلامة --:

claude mcp add --env AIRTABLE_API_KEY=YOUR_KEY --transport stdio airtable \
  -- npx -y airtable-mcp-server

كل ما قبل العلامة -- خيارات يقرؤها Claude Code، مثل --transport و--env و--scope، وكل ما بعدها يشغّل الخادم كما هو دون تعديل. ويقبل الخيار --env عدة أزواج من الصيغة KEY=value، لذلك ضع خيارًا آخر بينه وبين اسم الخادم، مثل --transport stdio.

من JSON أو من Claude Desktop#

وإذا أعطاك توثيق الخادم كتلة JSON، فأضفها كما هي:

claude mcp add-json weather-api '{"type":"http","url":"https://api.weather.com/mcp","headers":{"Authorization":"Bearer token"}}'

وعلى macOS وWSL يستورد الأمر claude mcp add-from-claude-desktop الخوادم التي أعددتها سابقًا في Claude Desktop.

ثم شغّل /mcp. فالأمر claude mcp add يحفظ الإعدادات دون أن يختبرها، ولذلك لا يظهر رمز الوصول الخاطئ إلا هنا. تظهر علامة تحقق بجانب الخادم المتصل، وتظهر العلامة ✘ بجانب الخادم الذي فشل اتصاله مع رمز حالة HTTP، مثل 401.

أي نطاق تختار؟#

يحدد النطاق مكان حفظ الخادم ومن يستطيع استخدامه. اضبطه بالخيار --scope عند إضافة الخادم.

claude mcp add --transport http shared-server --scope project https://example.com/mcp

وإذا تكرر اسم الخادم في أكثر من نطاق، فالنطاق المحلي يتقدم على نطاق المشروع، ونطاق المشروع يتقدم على نطاق المستخدم. ويأخذ Claude Code الإدخال كاملًا من النطاق المتقدم، ولا يدمج الحقول.

أبعد الأسرار عن ملف المشروع#

يدخل الملف .mcp.json في Git مع بقية المشروع، فلا تكتب فيه رموز الوصول. استخدم ${VAR} لقراءة متغير بيئة، أو ${VAR:-default} لتستخدم قيمة افتراضية حين لا يوجد المتغير:

{
  "mcpServers": {
    "api-server": {
      "type": "http",
      "url": "${API_BASE_URL:-https://api.example.com}/mcp",
      "headers": {
        "Authorization": "Bearer ${API_KEY}"
      }
    }
  }
}

ويعمل هذا التعويض في الحقول command وargs وenv وurl وheaders، ويضبط كل شخص قيمة المتغير على جهازه.

كيف تدير خوادمك؟#

ينتظر Claude Code بدء الخادم 30 ثانية. وإذا احتاج خادمك إلى وقت أطول، فارفع المهلة بالمللي ثانية، مثل MCP_TIMEOUT=60000 claude لمهلة مدتها 60 ثانية.

ماذا تفعل بعد اتصال الخادم؟#

اطلب ما تريد بلغتك العادية#

خذ GitHub مثالًا. أنشئ رمز وصول شخصيًا محدود الصلاحيات، يقتصر على المستودعات التي سيعمل عليها Claude، ثم أضف الخادم:

claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

ثم اطلب ما تحتاج إليه، مثل:

Review PR #456 and suggest improvements
Show me all open PRs assigned to me

أشر إلى الموارد بالعلامة @#

اكتب @ لترى موارد خوادمك بجانب ملفاتك. استخدم الصيغة @server:protocol://path، مثل @github:issue://123، فيجلب Claude Code المورد ويرفقه برسالتك.

شغّل التعليمات الجاهزة في صورة أوامر#

تظهر التعليمات الجاهزة لكل خادم في قائمة / بالصيغة /server:prompt (MCP). وتستطيع أيضًا تشغيلها بكتابة اسمها، مثل /mcp__github__pr_review 456، مع فصل المدخلات بمسافات.

هل استخدام MCP آمن؟#

يستطيع الخادم أن يقرأ بياناتك وأن ينفذ أفعالًا نيابة عنك، فتعامل معه كما تتعامل مع أي برنامج تثبّته:

• ثق بالمصدر. لا تربط إلا الخوادم التي تثق بها. والخوادم التي تجلب محتوى خارجيًا، مثل صفحات الويب أو المشكلات المفتوحة، قد تحمل حقن تعليمات، أي نصًا مخفيًا يحاول توجيه Claude.
• امنح رموز الوصول أقل صلاحية ممكنة. مستخدم قاعدة بيانات للقراءة فقط، أو رمز GitHub يقتصر على مستودعات قليلة، يحدّ من ضرر أي خطأ.
• راجع خوادم أي مشروع تنسخه. افتح الملف .mcp.json فيه أولًا. في الجلسة التفاعلية يسألك Claude Code قبل أن يستخدم خوادم المشروع، أما وضع الطباعة claude -p فيحمّلها دون سؤال. لذلك أضف في السكربتات الخيار --strict-mcp-config مع --mcp-config لتحدد الخوادم بنفسك.
• مفتاحك لا يصل إلى طلبات الخوادم. في الحقلين url وheaders للخادم البعيد، يقرأ Claude Code المتغيرين ANTHROPIC_API_KEY وANTHROPIC_AUTH_TOKEN فارغين، فلا يستطيع ملف في مشروع أن يرسل مفتاحك إلى خادم بعيد بهذه الطريقة.

هل يعمل MCP مع مفتاح API؟#

نعم. تعمل خوادم MCP على جهازك أو على عناوينها الخاصة، ولا تذهب إلى عنوان الأساس إلا طلبات النموذج. ولأن 5abeer خدمة مستقلة متوافقة مع واجهة Anthropic Messages، تضبط عنوان الأساس والمفتاح في الملف ~/.claude/settings.json، وتعمل كل أوامر MCP السابقة كما يشرحها توثيق Anthropic:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.5abeer.ai",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_5ABEER_API_KEY",
    "ANTHROPIC_MODEL": "claude-sonnet-5.5"
  }
}

أنشئ المفتاح أولًا من لوحة التحكم (طريقة إنشاء المفتاح). ثم شغّل /status لترى عنوان 5abeer، و/mcp لترى خوادمك.

وهناك ثلاثة أمور تعرفها حين تستخدم مفتاحًا:

• موصلات claude.ai لا تُحمَّل. لا تظهر إلا حين تسجّل الدخول باشتراك claude.ai، ولا تظهر مع مفتاح API أو رمز وصول. أضف الخدمات نفسها بالأمر claude mcp add بدلًا منها.
• استخدام الأدوات يُحسب بالتوكنات. أسماء الأدوات والتعريفات التي يحمّلها Claude ونتائج الأدوات كلها تدخل في الطلب، فتستهلك رصيدك مثل أي مدخلات أخرى (الاستخدام والرصيد). ويقلل البحث عن الأدوات حجم التعريفات، لأنه لا يحمّلها إلا عند الحاجة. ويبلغ الحد الافتراضي لناتج الأداة 25,000 توكن، ويغيّر المتغير MAX_MCP_OUTPUT_TOKENS هذا الحد، وأي نتيجة نصية تتجاوز 50,000 حرف تُحفظ في ملف بدلًا من إدخالها في الطلب.
• يبقى البحث عن الأدوات مفعّلًا خلف عنوان الأساس. تعيد الإصدارات الحديثة المحاولة من دونه إذا رُفض الطلب بالخطأ 400 أو 422. ولتحميل كل الأدوات من البداية، اضبط ENABLE_TOOL_SEARCH على false في القسم env من ملف الإعدادات.

تستطيع تشغيل Claude Code على 5abeer بطريقتين:

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

وإذا رُفض طلب برمز خطأ، فالرمز INVALID_API_KEY يعني أن المفتاح خطأ أو محذوف، والرمز INSUFFICIENT_BALANCE يعني أن رصيدك لا يكفي للطلب. وكل الرموز في رموز الأخطاء وحلولها، وكل الإعدادات مشروحة في صفحة Claude Code في التوثيق.

أسئلة شائعة#

ما معنى MCP؟#

اختصار Model Context Protocol، أي بروتوكول سياق النموذج. وهو معيار مفتوح لربط أدوات الذكاء الاصطناعي بالخدمات الخارجية، لذلك يعمل الخادم الواحد مع أي تطبيق يدعم MCP، لا مع Claude Code وحده.

أين يحفظ Claude Code خوادم MCP؟#

تُحفظ خوادم النطاقين المحلي والمستخدم في ~/.claude.json، وخوادم المشروع في .mcp.json في جذر المشروع. ولترى تفاصيل خادم واحد، شغّل claude mcp get <name>.

لماذا لا يتصل خادم MCP؟#

راجع رمز الوصول أو الترويسة أولًا، لأن الأمر claude mcp add لا يختبرهما. وفي خادم stdio، شغّل أمره في الطرفية لترى رسالة الخطأ. وإذا كان الخادم بطيئًا في البدء فقط، فارفع قيمة MCP_TIMEOUT.

هل أستطيع استخدام موصلات claude.ai؟#

لا تظهر إلا حين تسجّل الدخول إلى Claude Code باشتراك claude.ai. أما مع مفتاح API في ملف الإعدادات فلا تُحمَّل، لذلك أضف الخدمات التي تحتاج إليها بالأمر claude mcp add.

هل يمكن أن يعمل Claude Code خادمَ MCP؟#

نعم. يشغّل الأمر claude mcp serve أداة Claude Code في صورة خادم MCP من نوع stdio، فيستطيع تطبيق آخر، مثل Claude Desktop، أن يستخدم أدواتها. ولا يعرض الأمر شيئًا وهو ينتظر اتصال العميل.

أي نموذج يناسب MCP؟#

ابدأ بالنموذج الافتراضي claude-sonnet-5.5، فهو يكفي أغلب مهام الأدوات. وانتقل إلى claude-opus-5.5 أو claude-fable-5.1 في المهام الطويلة التي تربط أدوات كثيرة. بدّل النموذج بالأمر /model، والقائمة كاملة بأسعارها في صفحة النماذج.

المصادر#

راجعناها في 2026-11-01:

• توثيق Claude Code: MCP
• توثيق Claude Code: CLI reference

ابدأ#

تعرّف على كل الأوامر في دليل أوامر Claude Code، واضبط نسخة المحرر بدليل Claude Code في VS Code، أو ثبّت الأداة بدليل تثبيت Claude Code على ويندوز.