دليل خوادم MCP في Claude Code

تربط خوادم MCP في Claude Code المساعدَ بواجهات برمجة التطبيقات (APIs) وقواعد البيانات الخارجية عبر بروتوكول سياق النموذج (Model Context Protocol). فهي تتيح الوصول الفوري إلى خدمات مثل GitHub وقواعد البيانات وقنوات Slack، ما يسمح لـ Claude بالاستعلام عن بيانات حية بدلاً من الاعتماد على سياق ثابت.

يغطي هذا الدليل إضافة الخوادم عبر بروتوكولات نقل متنوعة (HTTP وstdio وSSE)، وإدارة الإعدادات بنطاقات مختلفة (محلي، مشروع، مستخدم)، واستخدام البحث عن الأدوات (tool search) لتحسين استهلاك السياق. ويتضمن أمثلة عملية لإعداد إعدادات متعددة الخوادم وتطبيق أفضل ممارسات الأمان مثل توسيع متغيرات البيئة (environment variable expansion) لبيانات الاعتماد.

خوادم MCP في Claude Code تربط المساعدَ بواجهات برمجة التطبيقات الخارجية وقواعد البيانات. تعلّم بروتوكولات النقل، والبحث عن الأدوات، والنطاقات، والإعداد متعدد الخوادم.

خوادم MCP في Claude Code

خوادم MCP في Claude Code: ما الذي ستتعلمه

في هذا الدليل إلى خوادم MCP في Claude Code، ستمرّ عبر خطوات عملية وتطبيقية مع أمثلة واقعية. تُشرح خوادم MCP في Claude Code من الأساس حتى تتمكن من تطبيقها فوراً في مشاريعك الخاصة.

يمنح بروتوكول MCP (Model Context Protocol) لـ Claude وصولاً فورياً إلى الخدمات الخارجية. وعلى خلاف ملفات الذاكرة التي تخزّن سياقاً ثابتاً، تتيح اتصالات MCP لـ Claude الاستعلام عن بيانات حية — مشكلات GitHub لديك، أو قاعدة بيانات الإنتاج، أو قنوات Slack، أو أي خدمة لها خادم MCP. تغطي هذه الوحدة إضافة الخوادم، وفهم النطاقات، واستخدام أدوات MCP بفاعلية.

مثال تطبيقي: ربط أول خادم MCP

أفضل طريقة لفهم خوادم MCP هي ربط خادم واحد فعليًا بدل قراءة الشرح فقط. ابدأ بخادم GitHub الرسمي لأنه يوضّح النطاقين المحلي والمشترك معًا.

نفّذ أولًا claude mcp add --transport stdio github -- npx @modelcontextprotocol/server-github لإضافة الخادم بنطاق محلي خاص بك فقط. افتح الجلسة واكتب /mcp للتحقق من ظهور الاتصال نشطًا، ولاحظ عدد الأدوات التي كشفها الخادم.

جرّب استعلامًا بلغة طبيعية مثل List all open PRs that haven't been reviewed in more than 3 days — يستعلم Claude من الخادم مباشرة ويعيد بيانات حية من مستودعك، لا من سياق ثابت.

بعد التأكد من عمل الخادم محليًا، انقله إلى نطاق المشروع كي يستفيد منه بقية الفريق. أنشئ ملف .mcp.json في جذر المشروع، وانسخ إعداد الخادم إليه، لكن استبدل أي رمز وصول مكتوب ثابتًا بصيغة توسيع متغير البيئة ${GITHUB_TOKEN}. أودِع الملف في git — فهو يحمل بنية الإعداد فقط دون أسرار فعلية.

عندما يسحب زميل في الفريق هذا الملف لأول مرة، سيظهر له تلقائيًا طلب موافقة أمنية قبل أن يثق Claude Code بخادم مشروع لم يُعرّفه هو بنفسه. هذا سلوك متعمَّد يمنع تشغيل خوادم MCP غير موثوقة بصمت.

أخيرًا، اضبط GITHUB_TOKEN في ملف تعريف الصدفة لدى كل عضو، لا في الإعداد نفسه. أعد فتح /mcp للتأكد من أن الخادم بنطاق المشروع يعمل بنفس الطريقة التي عمل بها محليًا، ثم أزل النسخة المحلية بـ claude mcp remove github كي لا يتكرر الاتصال بالخدمة نفسها مرتين.

إضافة خوادم MCP

أسرع طريقة لإضافة خادم هي الأمر claude mcp add. اختر بروتوكول النقل المطابق لنوع الخادم: http للخوادم البعيدة، وstdio للعمليات التي تعمل محلياً، وsse للخوادم البعيدة الأقدم التي لم تنتقل بعد إلى HTTP. ملاحظة: SSE مهمَل — استخدم خوادم HTTP بدلاً منه حيثما توفّرت. على نظام Windows الأصلي ستحتاج غالباً إلى cmd /c عند تشغيل خوادم stdio المعتمدة على npx.

# Add a remote HTTP server
claude mcp add --transport http notion https://mcp.notion.com/mcp

# Add a local Node.js server via stdio
claude mcp add --transport stdio github -- npx @modelcontextprotocol/server-github

# Add with an auth header
claude mcp add --transport http my-api https://api.example.com/mcp   --header "Authorization: Bearer TOKEN"

أدِر خوادمك باستخدام claude mcp list وclaude mcp get <name> وclaude mcp remove <name>. يعرض الأمر /mcp داخل الجلسة الاتصالات النشطة ويُطلق تدفقات OAuth للخوادم التي تتطلب مصادقة عبر المتصفح. ومن الأوامر المفيدة الأخرى claude mcp reset-project-choices وclaude mcp add-from-claude-desktop وclaude mcp serve عندما تريد أن يعمل Claude Code نفسه كخادم MCP.

تُخزَّن إعدادات MCP في ~/.claude.json (إعداد المستخدم المحلي لديك) أو في .mcp.json في جذر المشروع (المشترك مع الفريق). يُحفَظ ملف .mcp.json في git ويطلب موافقة زملاء الفريق عند أول استخدام. يعمل توسيع متغيرات البيئة في جميع حقول الإعداد — استخدم ${VAR:-default} للقيم الاحتياطية:

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

للجلسات لمرة واحدة — التجارب السريعة، أو عمليات تشغيل CI، أو إعادة الإنتاج المعزولة — يحمّل --mcp-config خوادم MCP من ملفات JSON دون المساس بإعدادك المحفوظ. يقبل هذا الخيار مساراً واحداً أو أكثر (مفصولة بمسافات)، فيمكن لأمر واحد أن يضع إعداداً مشتركاً فوق التجاوزات المحلية. اقرنه بـ --strict-mcp-config لتجاهل كل مصادر MCP الأخرى في تلك الجلسة، وهي أنظف طريقة لإعادة إنتاج خطأ ضد مجموعة خوادم معروفة:

# Load a single config file for this session only
claude --mcp-config ./ci-servers.json

# Combine multiple files (space-separated)
claude --mcp-config "./shared-servers.json ./local-overrides.json"

# Reproduce a bug against exactly one server, ignoring user/project config
claude --strict-mcp-config --mcp-config ./repro.json

تتصل خوادم MCP الآن بشكل متزامن افتراضياً. عندما تكون لديك عدة خوادم مُعدّة — خوادم stdio محلية وموصّلات claude.ai البعيدة معاً — فإنها تُهيّأ بالتوازي عند بدء التشغيل بدلاً من واحدٍ تلو الآخر. وهذا يقلّل بشكل ملحوظ من زمن بدء التشغيل للمشاريع التي تضم عدة تكاملات MCP.

اضبط مهلة بدء تشغيل خادم MCP باستخدام متغير البيئة MCP_TIMEOUT (على سبيل المثال، MCP_TIMEOUT=10000 claude يضبط مهلة قدرها 10 ثوانٍ).

يمكن أن تظهر موصّلات MCP المُعدّة في Claude.ai تلقائياً في Claude Code أيضاً. إذا أعددت خادماً عبر واجهة الويب، فإنه يصبح متاحاً في جلسات سطر الأوامر لديك دون إعداد محلي منفصل. وعندما يكون الخادم نفسه مُعدّاً محلياً وعبر Claude.ai معاً، تُزال التكرارات تلقائياً حتى لا ينتهي بك الأمر باتصالين بالخدمة نفسها.

النطاقات واكتشاف الأدوات

لإعدادات MCP ثلاثة نطاقات. النطاق المحلي (المُخزَّن في ~/.claude.json تحت مفتاح مشروعك) خاص — أنت فقط، وهذا المشروع فقط. نطاق المشروع (.mcp.json) مشترك مع الفريق عبر git. نطاق المستخدم (~/.claude.json عالمياً) يُطبَّق عبر جميع مشاريعك.

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

تظهر مطالبات MCP (prompts) كأوامر شرطة مائلة باستخدام النمط /mcp__servername__promptname. ويمكن الإشارة إلى موارد MCP بشكل مضمّن عبر @server:protocol://resource/path. البحث عن الأدوات مُفعَّل افتراضياً — تُؤجَّل تعريفات أدوات MCP وتُكتشَف عند الطلب، بحيث لا تدخل في السياق سوى الأدوات التي يستخدمها Claude فعلياً للمهمة (وهو معطَّل افتراضياً فقط على Vertex AI وعندما يشير ANTHROPIC_BASE_URL إلى وكيل ليس من الطرف الأول).

تجاوزه باستخدام متغير البيئة ENABLE_TOOL_SEARCH: القيمة true تفرض تفعيله دائماً، وfalse تحمّل كل تعريف مقدماً في كل دور، وauto تفعّل البحث عن الأدوات فقط عندما تتجاوز تعريفات الأدوات 10% من نافذة السياق (auto:N تضبط نسبة مئوية مخصصة). يُحدَّد سقف كل وصف لأداة MCP وكل تعليمات خادم بمقدار 2KB لمنع الخوادم المُولَّدة من OpenAPI من تضخيم السياق. ويظهر تحذير في وقت التشغيل عندما يتجاوز خرج أداة MCP عشرة آلاف رمز (token). لزيادة هذا الحد، اضبط متغير البيئة MAX_MCP_OUTPUT_TOKENS (القيمة الافتراضية 25,000).

لتجاوز التأجيل لخادم محدد، أضِف alwaysLoad: true إلى إعداده — فستتخطى جميع أدوات ذلك الخادم تأجيل البحث عن الأدوات وستكون متاحة دائماً في الجلسة.

يتيح لك MCP المحدود بالوكلاء الفرعيين (subagent-scoped) منح وكلاء محددين وصولاً إلى خوادم لا يحتاجها باقي الجلسة:

---
name: data-analyst
description: Analyze production data
mcpServers:
  - database
  - playwright:
      type: stdio
      command: npx
      args: ["-y", "@playwright/mcp@latest"]
---

أنماط الاستخدام العملية

مع اتصال GitHub MCP، يمكنك التعامل مع طلبات السحب (PRs) والمشكلات والـ commits باستخدام اللغة الطبيعية. يستعلم Claude من الخادم، ويحصل على بيانات حية، ويستجيب:

List all open PRs that haven't been reviewed in more than 3 days.
Create an issue for the login timeout bug with medium priority.
/mcp__github__pr_review 456

يتيح خادم قاعدة البيانات MCP استعلامات باللغة الطبيعية دون أن تكتب SQL بنفسك:

Find all users who placed more than 5 orders in the last 30 days.
What's the average order value by country for Q1 2026?

للمهام المعقدة، تتكامل عدة خوادم MCP بشكل طبيعي. قد يقوم سير عمل تقرير يومي بما يلي: جلب مقاييس طلبات السحب من GitHub MCP، والاستعلام عن بيانات المبيعات من قاعدة البيانات MCP، وكتابة تقرير باستخدام نظام الملفات MCP، ونشره عبر Slack MCP — كل ذلك في جلسة واحدة.

يتيح استدراج MCP (elicitation) للخادم أن يوقف سير العمل مؤقتاً ويطلب مدخلات منظمة من المستخدم. عندما يحتاج خادم إلى معلومات لا يستطيع الحصول عليها بنفسه — تفويض OAuth، أو تأكيد قبل إجراء مُدمِّر، أو نموذج بمعاملات خاصة بالمشروع — فإنه يُطلق حواراً تفاعلياً. يرى المستخدم حقول نموذج أو رابط متصفح، ويقدّم استجابته، ويستأنف الخادم من حيث توقّف. تتيح لك خطّافات (hooks) Elicitation وElicitationResult اعتراض هذه الحوارات أو تخصيصها برمجياً.

أفضل ممارسات الأمان: استخدم دائماً متغيرات البيئة لبيانات الاعتماد، ولا تُودِع الرموز (tokens) أبداً في git، واستخدم رموزاً للقراءة فقط عندما تحتاج فقط إلى الاستعلام عن البيانات، وقيّد نطاق وصول الخادم إلى الحد الأدنى اللازم. وللنشر في المؤسسات، يتيح managed-mcp.json للمسؤولين فرض قائمة سماح بالخوادم المسموح بها على مستوى المؤسسة بأكملها.

قدرات MCP أخرى مهمة تستحق المعرفة: يمكن لخوادم MCP إرسال إشعارات list_changed لتحديث أدواتها ومطالباتها ومواردها المتاحة ديناميكياً دون الحاجة إلى إعادة اتصال. وإذا انقطع خادم HTTP أو SSE في منتصف الجلسة، يعيد Claude Code الاتصال تلقائياً مع تراجع أُسّي (exponential backoff) — حتى خمس محاولات، تبدأ بتأخير ثانية واحدة وتتضاعف في كل مرة. أما بالنسبة للاتصالات الأولية عند بدء التشغيل، فينطبق التراجع نفسه لكنه يعيد المحاولة حتى ثلاث مرات عند الأخطاء العابرة مثل استجابة 5xx أو رفض الاتصال أو انتهاء المهلة (اعتباراً من الإصدار v2.1.121).

القنوات: دفع الأحداث إلى جلسة قيد التشغيل

القنوات (Channels) هي خوادم MCP تدفع الأحداث إلى جلستك قيد التشغيل حتى يتمكن Claude من التفاعل بينما تكون بعيداً عن الطرفية. وعلى خلاف خوادم MCP القياسية التي يستعلم منها Claude عند الطلب، تسلّم القناة الرسائل بشكل استباقي — جسر دردشة من Telegram، أو خطّاف ويب (webhook) من CI، أو تنبيه مراقبة. لا تصل الأحداث إلا أثناء فتح الجلسة.

تُضمَّن ثلاثة إضافات قنوات في المعاينة البحثية (تتطلب الإصدار v2.1.80 من Claude Code أو أحدث): Telegram وDiscord وiMessage. كل منها يُثبَّت كإضافة ويُعَدّ ببيانات اعتمادك الخاصة. ثبّت إضافة قناة باستخدام /plugin install telegram@claude-code-plugins-official، وأعدّها باستخدام أمر الإضافة /telegram:configure <token>، ثم أعد التشغيل بخيار --channels لتفعيلها:

claude --channels plugin:telegram@claude-code-plugins-official

تحتفظ كل قناة بقائمة سماح للمرسلين — فقط المعرّفات التي أضفتها يمكنها دفع الرسائل. يستخدم Telegram وDiscord تدفق اقتران (pairing): راسِل بوتك، واستلم رمزاً، ثم وافِق عليه في Claude Code باستخدام /telegram:access pair <code> وأحكِم الإغلاق باستخدام /telegram:access policy allowlist. أما iMessage فيتجاوز الاقتران للدردشة الذاتية ويتيح لك إضافة جهات الاتصال عبر المعرّف (handle).

تتطلب القنوات مصادقة Anthropic (claude.ai أو مفتاح Console API) وهي غير متاحة على Bedrock أو Vertex AI أو Foundry. يجب على مؤسسات Team وEnterprise تفعيل القنوات عبر channelsEnabled في الإعدادات المُدارة — فهي محظورة افتراضياً. ويمكن لمستخدمي Pro وMax استخدام القنوات مباشرةً بالاشتراك لكل جلسة عبر --channels. كما يمكن للمسؤولين تقييد الإضافات المسموح بها عبر الإعداد المُدار allowedChannelPlugins.

عندما يردّ Claude عبر قناة، يظهر الرد على المنصة الخارجية (Telegram أو Discord وغيرهما) — تعرض طرفيتك استدعاء الأداة والتأكيد لكن ليس نص الرد نفسه.

أمثلة واقعية على خوادم MCP

المثال 1: إعداد خادم GitHub MCP

اربط Claude Code بمستودعات GitHub والمشكلات وطلبات السحب:

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

أو عبر سطر الأوامر: claude mcp add --transport http github https://api.github.com/mcp

المثال 2: خادم نظام الملفات MCP

امنح Claude Code وصولاً إلى الملفات في دليل محدد:

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-filesystem", "/home/user/projects"]
    }
  }
}

المثال 3: إعداد متعدد الخوادم

أعدّ عدة خوادم MCP في ملف .mcp.json واحد للوصول المحدود بنطاق المشروع:

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-github"],
      "env": { "GITHUB_TOKEN": "${GITHUB_TOKEN}" }
    },
    "database": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-database"],
      "env": { "DATABASE_URL": "${DATABASE_URL}" }
    },
    "slack": {
      "command": "npx",
      "args": ["@modelcontextprotocol/server-slack"],
      "env": { "SLACK_TOKEN": "${SLACK_TOKEN}" }
    }
  }
}

سيرى أعضاء الفريق مطالبة موافقة عند أول مواجهة لهذا الإعداد المحدود بنطاق المشروع.

نصائح احترافية

  • استخدم دائماً متغيرات البيئة لبيانات الاعتماد — لا تضع الرموز (tokens) مكتوبة بشكل ثابت في .mcp.json أبداً. استخدم صيغة ${GITHUB_TOKEN} وخزّن القيم في ملف تعريف الصدفة (shell profile) لديك. أودِع .mcp.json في git مع عناصر نائبة لمتغيرات البيئة فقط.
  • استخدم رموز القراءة فقط متى أمكن — امنح الحد الأدنى من الصلاحيات اللازمة لكل خادم MCP (أقل امتياز). دوّر الرموز شهرياً. استخدم OAuth للخدمات الخارجية عند توفّره.
  • انتبه لحدود وصف الأدوات — يفرض Claude Code سقفاً قدره 2KB لكل خادم MCP لأوصاف الأدوات. وعندما تتجاوز أوصاف الأدوات 10% من السياق، يُفعَّل البحث عن الأدوات تلقائياً لاختيار الأدوات ذات الصلة بكفاءة.
  • راقب حدود خرج MCP — تُظهر المخرجات التي تتجاوز عشرة آلاف رمز تحذيراً؛ ويُقتطع ما يبلغ 25 ألف رمز افتراضياً؛ وتُحفظ النتائج التي تتجاوز 50 ألف حرف على القرص. زِد الحد باستخدام export MAX_MCP_OUTPUT_TOKENS=*** عند الحاجة.
  • استخدم alwaysLoad: true باعتدال — ضع علامة على أدوات خادم بأنها متاحة دائماً فقط عند الحاجة إليها في كل دور. كل أداة محمّلة دائماً تستهلك سياقاً كان يمكن أن يُبرز أدوات أكثر صلة عبر البحث.

تحدٍّ تطبيقي

أنشئ إعداداً متعدد خوادم MCP يدمج الخدمات الخارجية في سير عملك في Claude Code.

المهمة: بناء إعداد MCP متعدد الخوادم

أعدّ مشروعاً بثلاثة خوادم MCP — GitHub وDatabase وFilesystem — واستخدمها معاً في سير عمل واقعي.

الخطوات

  1. أنشئ ملف .mcp.json في جذر مشروعك بثلاثة إعدادات لخوادم MCP: GitHub وDatabase (PostgreSQL) وFilesystem.
  2. استخدم توسيع متغيرات البيئة لجميع بيانات الاعتماد: "GITHUB_TOKEN": "${GITHUB_TOKEN}" — لا تكتب الأسرار بشكل ثابت في الإعداد أبداً.
  3. أضِف الخوادم عبر سطر الأوامر كنسخة احتياطية: claude mcp add --transport stdio github -- npx @modelcontextprotocol/server-github
  4. اضبط متغيرات البيئة في ملف تعريف الصدفة لديك: export GITHUB_TOKEN="ghp_...code> وexport DATABASE_URL="postgresql://..."
  5. شغّل claude /mcp للتحقق من اتصال الخوادم الثلاثة جميعها وإظهارها أعداد أدوات غير صفرية.
  6. اختبر التكامل بأن تطلب من Claude "List all open PRs and cross-reference them with database records for deployed features."
  7. احفظ .mcp.json في git (بعناصر نائبة لمتغيرات البيئة فقط) حتى يتمكن زملاء الفريق من استخدام الإعداد نفسه.

النتيجة المتوقعة

تظهر خوادم MCP الثلاثة جميعها متصلة في /mcp مع أعداد أدواتها. يمكن لـ Claude الاستعلام بسلاسة عن طلبات السحب في GitHub، والتحقق من قاعدة البيانات بحثاً عن سجلات النشر، وقراءة الملفات وكتابتها — كل ذلك في محادثة واحدة. وزملاء الفريق الذين يسحبون المستودع ويضبطون متغيرات البيئة الخاصة بهم يحصلون على الإعداد نفسه فوراً.

تلميح

استخدم صيغة ${VAR:-default} لتوسيع متغيرات البيئة مع قيم احتياطية افتراضية. وعندما تتجاوز أوصاف أدوات MCP نسبة 10% من السياق، يفعّل Claude Code البحث عن الأدوات تلقائياً. ضع علامة على الخوادم الحرجة بـ "alwaysLoad": true لتخطّي تأجيل البحث عن الأدوات. راجع مثال سير العمل متعدد MCP في دليل MCP للاطّلاع على نمط توليد تقرير يومي.

اختبار المعرفة

اختبر فهمك لخوادم MCP في Claude Code عبر هذه الأسئلة:

  1. ما بروتوكولات النقل المدعومة لخوادم MCP؟
    A) HTTP (موصى به للبعيد)، Stdio (موصى به للمحلي)، SSE (مهمَل) | B) WebSocket (موصى به)، REST، gRPC | C) TCP، UDP، HTTP | D) Stdio (موصى به)، HTTP، SSE
    الإجابة: A — يُوصى بـ HTTP للخوادم البعيدة. وStdio للعمليات المحلية (الأكثر شيوعاً حالياً). وSSE مهمَل لكنه ما زال مدعوماً.
  2. كيف تضيف خادم GitHub MCP عبر سطر الأوامر؟
    A) claude mcp install github | B) claude mcp add --transport http github https://api.github.com/mcp | C) claude plugin add github-mcp | D) claude connect github
    الإجابة: B — استخدم claude mcp add مع خيار --transport واسم وعنوان URL للخادم.
  3. ماذا يحدث عندما تتجاوز أوصاف أدوات MCP نسبة 10% من نافذة السياق؟
    A) تُقتطع | B) يُفعَّل البحث عن الأدوات تلقائياً لاختيار الأدوات ذات الصلة ديناميكياً | C) يعرض Claude خطأً | D) تُعطَّل الأدوات الزائدة
    الإجابة: B — يُفعَّل البحث عن أدوات MCP تلقائياً عند تجاوز الأدوات 10% من السياق. ويتطلب Sonnet 4 أو Opus 4 كحد أدنى.
  4. كيف تستخدم القيم الاحتياطية لمتغيرات البيئة في إعداد MCP؟
    A) ${VAR || "default"} | B) ${VAR:-default} | C) ${VAR:default} | D) ${VAR ? "default"}
    الإجابة: B — توفّر ${VAR:-default} قيمة احتياطية إذا لم يكن متغير البيئة مضبوطاً.
  5. ماذا يحدث عندما يواجه عضو في الفريق ملف .mcp.json محدوداً بنطاق المشروع لأول مرة؟
    A) يُحمَّل تلقائياً | B) يحصل على مطالبة موافقة للوثوق بخوادم MCP الخاصة بالمشروع | C) يُتجاهل ما لم يشترك عبر الإعدادات | D) يطلب Claude من المسؤول الموافقة
    الإجابة: B — يُطلق ملف .mcp.json المحدود بنطاق المشروع مطالبة موافقة أمنية عند أول استخدام لكل عضو في الفريق لمنع خوادم MCP غير الموثوقة.

اختبر معرفتك

/5

اختبار الدرس 8: بروتوكول سياق النموذج (MCP)

اختبر معرفتك بخوادم MCP وإعداداتها وتكاملها في Claude Code.

1 / 5

ما بروتوكولات النقل الثلاثة التي يدعمها Claude Code لـ MCP؟

2 / 5

كيف تضيف خادم GitHub MCP عبر واجهة سطر الأوامر (CLI)؟

3 / 5

ماذا يحدث عندما تتجاوز أوصاف أدوات MCP نسبة 10% من نافذة السياق؟

4 / 5

عندما يتطابق كل من allowedMcpServers وdeniedMcpServers مع خادم في الإعدادات المُدارة، أيهما يسود؟

5 / 5

ماذا يحدث عندما يصادف أحد أعضاء الفريق لأول مرة ملف ‎.mcp.json‎ على نطاق المشروع؟

Your score is

0%

موارد إضافية

الموردالوصف
توثيق MCP الرسميمرجع MCP الكامل لـ Claude Code
مواصفة بروتوكول MCPمواصفة البروتوكول الكاملة لبناء خوادم MCP
مستودع خوادم MCPتطبيقات خوادم MCP الرسمية والمجتمعية
تنفيذ الكود مع MCP (مدونة Anthropic)حل تضخم السياق عند توسيع اتصالات MCP
MCPorterزمن تشغيل وسطر أوامر بلغة TypeScript لاستدعاء خوادم MCP دون شيفرة نمطية
مرجع سطر أوامر Claude Codeأوامر سطر الأوامر بما فيها claude mcp add وclaude mcp list

خوادم MCP في Claude Code: أخطاء شائعة يجب تجنّبها

أغلب مشكلات خوادم MCP في الإنتاج ترجع إلى إعداد بيانات الاعتماد أو النطاقات، لا إلى الخادم نفسه.

  • كتابة الرموز (tokens) ثابتة في .mcp.json المرفوع إلى git بدل استخدام توسيع متغيرات البيئة ${VAR}.
  • الخلط بين نطاقي المشروع والمستخدم، فيظن المطور أن خادمًا معينًا متاح للفريق بينما هو محلي فقط.
  • تجاهل حدود وصف الأداة (2KB) وحجم المخرجات (عشرة آلاف رمز)، فتضخّم الاستجابات الطويلة من الخادم السياق دون داعٍ.
  • إبقاء alwaysLoad: true على خوادم كبيرة لا حاجة إليها في كل دور، فتستهلك سياقًا كان يمكن توفيره عبر البحث عن الأدوات.

خوادم MCP في Claude Code تمنحك سير عمل متيناً وقابلاً للتكرار. احفظ مرجعية هذا الدليل عن خوادم MCP في Claude Code وعُد إلى الخطوات كلما احتجت إليها.

المفاهيم الأساسية لخوادم MCP في Claude Code

خوادم MCP في Claude Code: أفضل الممارسات

  • أضِف فقط خوادم MCP التي تثق بها؛ فكل خادم يوسّع مدى ما يمكن أن يصل إليه المساعد.
  • استخدم البحث عن الأدوات حتى تكشف الخوادم الكبيرة فقط الأدوات التي تحتاجها المهمة.
  • حدّد نطاق الخوادم لكل مشروع عندما تختلف بيانات اعتمادها.
  • فضّل الخوادم الرسمية لواجهات برمجة التطبيقات الشائعة قبل بناء خادمك الخاص.
  • راجع صلاحيات الخادم بالطريقة نفسها التي تراجع بها أي تكامل من طرف ثالث.
أفضل الممارسات لخوادم MCP في Claude Code

خوادم MCP في Claude Code: أسئلة شائعة

ما هو MCP؟

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

ما بروتوكولات النقل المدعومة؟

يدعم MCP عدة بروتوكولات نقل حتى تتمكن الخوادم من العمل محلياً أو عن بُعد.

ما هو البحث عن الأدوات؟

يتيح لخادم كبير أن يكشف فقط الأدوات التي تحتاجها مهمة معينة، مع إبقاء السياق رشيقاً.

هل يمكنني تشغيل عدة خوادم؟

نعم — الإعداد متعدد الخوادم مدعوم، محدوداً بنطاق كل مشروع حسب الحاجة.

ماذا يحدث إذا انقطع اتصال خادم HTTP أثناء الجلسة؟

يعيد Claude Code الاتصال تلقائيًا بتراجع أُسّي حتى خمس محاولات، فلا تفقد الجلسة الخادم بسبب انقطاع مؤقت.