Claude Code لفرق الهندسة: إعداد MCP ودمجه في سير العمل

انتقل Claude Code من 4% من استخدام المطورين في مايو 2025 إلى 63% حتى فبراير 2026. ومعظم ذلك النمو حدث عضوياً: مهندس واحد يجرّبه، ويعجبه، وتنتشر الكلمة. وما لا ينتشر هو التهيئة.

فتنتهون إلى انحراف في التهيئة. ملفات CLAUDE.md مختلفة (أو لا شيء). وخوادم MCP مختلفة، أو لا شيء. وصلاحيات أدوات مختلفة. ولا سياق قاعدة شيفرة مشترك. والجميع «يستخدمون Claude Code» تقنياً والنتائج تتباين تبايناً شديداً.

ويغطي هذا الدليل طبقة التهيئة: كيف تحوّلون مجموعة متبددة من التثبيتات الفردية إلى شيء متسق يستفيد منه الفريق كله.

ما يعنيه إعداد فريق مُدار فعلاً#

الفجوة من الفرد إلى الفريق: لماذا يقتل انحراف التهيئة الإنتاجية#

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

وكلاهما سيقول لكم إنه «يستخدم Claude Code». والفجوة بينهما كبيرة، وتتضاعف بسرعة عبر فريق من عشرة أشخاص.

و73% من فرق الهندسة تستخدم الآن أدوات البرمجة بالذكاء الاصطناعي يومياً، صعوداً من 41% في 2025 (Developer Survey 2026, 15,000 developers). والفرق التي تحصل على نتائج متسقة تتعامل مع التهيئة كشأن مشترك، لا كتفضيل فردي.

الطبقات الثلاث التي تحتاج توحيداً: السياق، والأدوات، والسلوك#

بيئة Claude Code الموحّدة لفريق تحمل ثلاث طبقات:

1. السياق: ما يعرفه Claude عن قاعدة شيفرتكم؟ (CLAUDE.md)
2. الأدوات: بماذا يستطيع Claude أن يتصل؟ (خوادم MCP عبر .mcp.json وmanaged-mcp.json)
3. السلوك: ما يستطيع Claude فعله وكيف يفعله؟ (الصلاحيات، والمهارات، وسياسة المؤسسة)

ومعظم الفرق التي تقول «نحن نستخدم Claude Code» هيّأت الطبقة الأولى جزئياً ولم تمسّ الطبقتين الثانية والثالثة. وهذا الدليل يغطي الثلاث كلها.

ما الذي تبنون نحوه#

الحالة النهائية: كل مهندس يبدأ جلسة Claude Code بسياق المشروع نفسه، والأدوات الداخلية الموصولة نفسها، والمهارات المخصصة نفسها، وسياسة الصلاحيات نفسها. والتهيئة تسكن المستودع ونظام إدارة أجهزتكم، لا متبددة عبر أدلة المنازل.

الخطوة 1: ألّفوا ملف CLAUDE.md عندكم#

ما يفعله CLAUDE.md وأين يسكن#

CLAUDE.md ملف Markdown يقرأه Claude Code عند بداية الجلسة. يمنح Claude معرفة دائمة بمشروعكم دون تكرارها في كل جلسة.

ويمكنه السكن في مواضع متعددة، ويحمّلها Claude هرمياً:

• CLAUDE.md في الجذر (/your-repo/CLAUDE.md): يُحمّل لكل الجلسات في هذا المستودع
• CLAUDE.md في مجلد فرعي: يُحمّل حين يعمل Claude Code في ذلك المجلد
• CLAUDE.md على مستوى النظام (~/.claude/CLAUDE.md): يُحمّل لكل الجلسات، أياً كان المشروع

وملف CLAUDE.md في جذر المستودع المودَع في نظام الإصدارات هو ما يرثه كل مهندس تلقائياً. وذلك هو الذي عليكم إصابته.

ما ينتمي إلى CLAUDE.md لفريق#

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

نظرة عامة على البنية. كيف يُبنى النظام؟ ما المكوّنات الكبرى وحدود الخدمات؟ فقرتان إلى أربع تكفي عادةً.

خريطة المجلدات. أين تسكن مسارات واجهة البرمجة؟ والاختبارات؟ والتهيئة؟ سيكتشفها Claude باستكشاف نظام الملفات، لكن الخريطة توفّر عليه الوقت وتجعل نتائج التمريرة الأولى أقرب إلى الصحيح.

أعراف البرمجة. أي أعراف تسمية يستخدم فريقكم؟ وأي أنماط مفضّلة أو محظورة؟ وأي قواعد تنقيح غير قابلة للتفاوض؟

متطلبات الاختبار. التغطية المتوقعة. وأين تذهب اختبارات الوحدة مقابل التكامل. وما أدوات الاختبار الموجودة.

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

سير عمل التطوير. كيف تُجرى الاختبارات. وكيف يُشغّل خادم التطوير. وأي متغيرات بيئة مطلوبة.

كيف يحمّل Claude ملف CLAUDE.md عند بداية الجلسة#

محتوى CLAUDE.md يدخل سياق النموذج عند التهيئة، لا كاستدعاء أداة ولا كقراءة ملف. فهو حاضر دائماً في الجلسة دون أن يشير إليه المهندس.

والمضمون العملي: أبقوه مركّزاً. فكل ما في CLAUDE.md يستهلك مساحة من نافذة السياق في كل جلسة. والملف المنتفخ الذي يحاول تغطية كل حالة حدية يخفّف الإشارة لكل شيء آخر. استهدفوا ما بين 500 و1,500 كلمة من السياق المفيد فعلاً.

بنية CLAUDE.md عملية لفريق هندسة إنتاجي#

# [Project Name] -- CLAUDE.md

## What This Is
[2-3 sentences: what the system does, primary stack, who operates it]

## Architecture
[3-4 paragraphs: key components, service boundaries, data flow]

## Directory Structure
[Annotated directory listing of the important paths]

## Development Standards
- Language/framework conventions
- Naming rules
- Patterns to use / patterns to avoid

## Testing
- How to run tests
- Where unit vs integration tests live
- Required coverage for new code

## Do Not Touch Without Explicit Instruction
- [List specific files, directories, or systems]

## Running Locally
[Commands to start dev server, required env vars, dependencies]

الخطوة 2: هيّئوا خوادم MCP بنطاق المشروع#

نطاقات خوادم MCP: المحلي، والمشروع، والمؤسسة#

لـ Claude Code ثلاثة نطاقات لتهيئة خوادم MCP:

• المحلي (بنطاق المستخدم): يسكن ~/.claude.json. ويؤثر على ذلك المهندس وحده. وغير مودَع في المستودع.
• بنطاق المشروع: يسكن .mcp.json في جذر المشروع. ومودَع في المستودع. وينطبق على كل من يعمل في هذا المشروع.
• المؤسسة (مُدار): يسكن ملف managed-mcp.json على مستوى النظام يُنشر عبر نظام إدارة الأجهزة. وينطبق على كل نسخ Claude Code على الأجهزة المُدارة.

ولتوحيد الفريق، ملف .mcp.json بنطاق المشروع هو الرافعة الأساسية.

كيف تودعون ملف .mcp.json لتهيئة خوادم مشتركة دون كشف بيانات الدخول#

المشكلة: .mcp.json يعرّف أي خوادم تُوصَل، لكن خوادم MCP تحتاج بيانات دخول لتعمل. ولا تستطيعون إيداع الرموز في المستودع.

المعالجة: أودعوا تهيئة الخادم (الاسم، والأمر، والوسائط) في .mcp.json، ودعوا كل مهندس يضيف بيانات دخوله في ~/.claude.json تحت اسم الخادم نفسه. فيدمج Claude Code الاثنين عند بداية الجلسة: ملف مستوى المشروع يوفّر تعريف الخادم، وملف مستوى المستخدم يوفّر المصادقة.

مثال على .mcp.json (آمن للإيداع):

{
  "mcpServers": {
    "github": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"]
    },
    "jira": {
      "command": "npx",
      "args": ["-y", "@company/mcp-jira-server"]
    },
    "internal-api-docs": {
      "command": "node",
      "args": ["./tools/mcp-api-docs/server.js"]
    }
  }
}

وكل مهندس يضيف بيانات دخوله في ~/.claude.json:

{
  "mcpServers": {
    "github": {
      "env": { "GITHUB_TOKEN": "ghp_yourpersonaltoken" }
    },
    "jira": {
      "env": { "JIRA_API_TOKEN": "yourjiratoken" }
    }
  }
}

وأسماء الخوادم يجب أن تتطابق تطابقاً تاماً بين الملفين.

أي خوادم MCP تهم فرق الهندسة فعلاً#

GitHub. يستطيع Claude إدراج المسائل، وقراءة تعليقات طلبات السحب، وإنشاء الفروع، وفهم ما يُعمل عليه بنشاط. مفيد لمراجعة الشيفرة والتطوير المدفوع بالمسائل.

Jira أو Linear. يستطيع Claude قراءة التذكرة التي يُعمل عليها، وفهم معايير القبول، وكتابة شيفرة تطابق المواصفة. ويزيل التنقل الدائم بين التذكرة والتنفيذ.

توثيق واجهات البرمجة الداخلية. خادم MCP مخصص يقدّم مواصفات OpenAPI عندكم يمنح Claude معرفة دقيقة بعقودكم الفعلية. ودونه، يخمّن من أنماط عامة، وهو أمر مقبول حتى لا يصير كذلك.

قواعد البيانات (للقراءة فقط). خادم Postgres أو MySQL محدود النطاق باتصال للقراءة فقط يتيح لـ Claude الإجابة عن أسئلة البيانات، وتوليد استعلامات دقيقة، والتحقق من أن الشيفرة الجديدة تلائم مخططكم الفعلي. أبقوه للقراءة فقط.

اختيار النقل: stdio مقابل HTTP#

• stdio: الخادم يعمل كعملية ابنة، ويتواصل عبر stdin وstdout. أبسط في الإعداد، ويعمل محلياً، وبلا تهيئة شبكة.
• HTTP (SSE): الخادم يعمل على منفذ محدد. ضروري للخوادم المشتركة، وبيئات Docker، أو حين تحتاج جلسات Claude Code متعددة الاتصال بالنسخة نفسها.

فإن كان كل مهندس يشغّل عمليات خادمه محلياً، فـ stdio أبسط. وإن كان مهندسون متعددون يتصلون بخادم مركزي (مثلاً خادم قاعدة بيانات مشترك للقراءة فقط)، فاستخدموا HTTP.

الخطوة 3: ابنوا مهارات مخصصة لمسارات العمل المتكررة#

ما المهارات: ملفات SKILL.md تصير أوامر مائلة#

المهارات ملفات SKILL.md بترويسة YAML يحمّلها Claude Code كأوامر /slash-commands. فيكتب مهندس /pr-description، ويحمّل Claude Code سياق المهارة، ويشغّل سير العمل المعرّف.

مهارة في حدها الأدنى:

---
name: pr-description
description: Generate a pull request description from the current branch diff
---

Review the changes in the current branch against main. Write a concise PR description covering:
1. What changed and why
2. Key implementation decisions
3. Testing approach
4. Any follow-up items

Format as standard Markdown. Keep the summary under 200 words.

كيف تحمّل المهارات السياق عند الطلب#

CLAUDE.md محمّل دائماً. والمهارات تُحمّل عند الاستدعاء وحده. وذلك يعني أنه يمكن أن تكون لديكم مكتبة من 20 مهارة وأكثر دون إضافة أي عبء على الجلسات التي لا تُستخدم فيها. ابنوا منها ما تحتاجون.

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

ما الذي يستحق البناء#

توليد وصف طلب السحب. أكثر مهارات الفريق استخداماً. تأخذ الفرق، وتصوغ وصفاً منظماً. فيشغّلها المهندسون في 5 ثوانٍ بدل 5 دقائق.

هياكل الاختبارات. أعطوها اسم دالة أو صنف، فتولّد ملف اختبار بالاستيرادات الصحيحة، والبنية، والحالات الحدية الشائعة موضوعة كهياكل. مفيد بخاصة للفرق ذات أعراف اختبار محددة لا يعرفها Claude تلقائياً.

قائمة مراجعة الشيفرة. تحمّل معايير مراجعة فريقكم وتمرّ على الفرق مقابل كل بند. إشارة متسقة دون الاعتماد على أن من يراجع قد حفظها.

قائمة مراجعة النشر. قبل الدمج في main: الترحيلات، وتغييرات التهيئة، وحالات أعلام الميزات، وتنبيهات المراقبة. شغّلوها مرة واحدة وتوقفوا عن نسيان الأشياء.

توفير مهارات على مستوى المؤسسة في خطة Enterprise#

في خطط Enterprise، يستطيع مالكو الحساب توفير مهارات للمؤسسة كلها. فتظهر تلقائياً لكل المستخدمين دون إعداد فردي.

وهذا منطقي للمعايير على مستوى الشركة (خطوات المراجعة الأمنية، وفرض نمط الشيفرة) أو لمسارات ضم المهندسين التي ينبغي أن يشغّلها كل مهندس جديد. والمهارات الخاصة بالمشروع تبقى في المستودع إلى جانب CLAUDE.md و.mcp.json.

الخطوة 4: أغلقوا الصلاحيات#

كيف تعمل نوافذ صلاحيات Claude Code#

في أول مرة يجرّب Claude Code أداة جديدة أو نوع عملية جديداً في جلسة، يطلب موافقة المهندس. والصلاحيات الموافق عليها تدوم لتلك الجلسة، مخزّنة في ملف جلسة.

وللفرق، يخلق هذا انحرافاً: مهندسون مختلفون يوافقون على أشياء مختلفة، ولا أحد يتابع ما وافقوا عليه، وقدرات Claude Code الفعلية تتباين من شخص إلى شخص.

السماح والمنع على مستوى الأداة في settings.json#

عرّفوا قواعد صريحة في settings.json لإلغاء النوافذ للعمليات المتوقعة:

{
  "tools": {
    "allowed": ["Read", "Write", "Edit", "Bash", "Grep", "Glob"],
    "denied": ["WebFetch"]
  }
}

وملف settings.json مودَع في جذر المشروع ينطبق على كل المهندسين في ذلك المستودع. ابدأوا محافظين على مستوى المشروع. والصلاحيات الأوسع تنتمي إلى تهيئة مستوى المستخدم أو مستوى المؤسسة.

ضوابط مسؤولي المؤسسة#

حسابات Enterprise تضيف سياسة مُدارة من المسؤولين عبر آليتين:

managed-settings.json: يُنشر عبر نظام إدارة الأجهزة، ويتجاوز إعدادات المهندس الفردي للسياسات الحساسة أمنياً. استخدموه للمتطلبات التنظيمية التي لا ينبغي أن يستطيع المهندسون الأفراد تغييرها.

managed-mcp.json: يعرّف قائمة سماح وقائمة منع لخوادم MCP. فيستطيع المهندسون إضافة خوادم من قائمة السماح لكنهم لا يستطيعون الاتصال بأي شيء في قائمة المنع. وهنا تتحكمون في الخدمات الخارجية التي يستطيع Claude Code الوصول إليها.

مسارات نشر نظام إدارة الأجهزة:

• macOS (Jamf أو Kandji): /Library/Application Support/ClaudeCode/managed-mcp.json
• Windows (سياسة السجل): HKLM\Software\Anthropic\ClaudeCode\

الخطوة 5: ادمجوا مع التكامل والنشر المستمرين والأدوات المشتركة#

تشغيل Claude Code في النمط غير التفاعلي لحالات خطوط الأنابيب#

يدعم Claude Code النمط غير التفاعلي للتكامل والنشر المستمرين:

claude --no-interactive --prompt "Run the full test suite and report failures"

مفيد لـ:

• أوصاف طلبات السحب المؤتمتة عند الدفع
• تحليل أعطال الاختبارات بمعالجات مقترحة
• كشف انحراف البنية عن أعراف CLAUDE.md
• فحوص مراجعة الشيفرة على طلبات السحب المسودة

خزّنوا مفتاح واجهة البرمجة كسرّ في التكامل المستمر. لا في المستودع.

كيف تعمل جلسات فرق الوكلاء#

حين يستحدث Claude Code وكلاء فرعيين (عبر أداة Agent)، يحمّل كل وكيل فرعي سياق المشروع نفسه: CLAUDE.md، وخوادم MCP، والمهارات. ولهذا تهم التهيئة المشتركة بما يتجاوز الاستخدام الفردي. فجلسات الوكلاء تعمل ذاتياً، ومعرفتها بقاعدة شيفرتكم هي بالضبط ما وضعتموه في التهيئة المشتركة، لا أكثر.

ويستطيع وكيل قائد أن يسلّم عملاً متوازياً إلى رفاقه: واحد يعيد هيكلة وحدة، وآخر يكتب اختبارات، وآخر يحدّث التوثيق. واتساق المخرجات يعتمد على مدى جودة تعريف السياق المشترك. فإن كان السياق غامضاً، ينتج الوكلاء نتائج متضاربة حتى حين يكملون بنجاح.

وصل Claude Code بمراقبة أخطائكم ومتابع مسائلكم عبر MCP#

بعد GitHub، تكامل MCP الأعلى قيمة لمعظم فرق الهندسة هو مراقبة الأخطاء (Sentry، وDatadog، وHoneycomb) مقترنة بمتابع المسائل.

ومع وصل الاثنين، يستطيع Claude Code البحث في آثار الأخطاء عند كتابة معالجات العلل، وسحب سياق التذكرة دون أن يبدّل المهندس التبويبات، وتوليد أوصاف المسائل مباشرة من تحليل الشيفرة.

وكلاهما يتطلب خوادم MCP مخصصة أو مجتمعية. ومنظومة MCP فيها أكثر من 10,000 خادم منشور و97 مليون تنزيل شهري للمجموعة عبر Python وTypeScript (Anthropic / Linux Foundation, December 2025). تحققوا قبل البناء من الصفر.

أخطاء الإعداد الشائعة وكيف تتفادونها#

بيانات الدخول في .mcp.json المودَع في المستودع#

أشيع خطأ أمني. فالرموز أو كلمات المرور في كتلة env في .mcp.json تدخل تاريخ الإصدارات وتصير مرئية لكل من لديه وصول إلى المستودع، بمن فيهم أي شخص تمنحونه الوصول في المستقبل.

اقسموا التهيئة كما وُصف في الخطوة 2: تعريفات الخوادم في .mcp.json، وبيانات الدخول في ~/.claude.json. وأضيفوا ~/.claude.json إلى ملف .gitignore العام عندكم.

انتفاخ CLAUDE.md#

ملف CLAUDE.md يوثّق كل حالة حدية يصير ضجيجاً. فـ Claude Code يحمّل الملف كله في كل جلسة، فالمحتوى ضعيف الإشارة لا يفشل في المساعدة فقط، بل يُضعف النتائج فعلاً بتخفيف ما يهم.

استهدفوا ما بين 500 و1,500 كلمة. وإن كنتم توثّقون شيئاً يستطيع Claude اكتشافه بقراءة الشيفرة، فاحذفوه. والملف ينبغي أن يغطي قرارات البنية، والمعايير، وقواعد سير العمل التي ليست بديهية من قاعدة الشيفرة نفسها.

نطاقات MCP المفرطة في السماح#

خادم قاعدة بيانات بوصول كتابة يمنح Claude Code القدرة على تعديل بيانات الإنتاج. وخادم GitHub بصلاحيات مسؤول يستطيع دمج طلبات السحب وتعديل الإعدادات. ابدأوا بأدنى نطاق ووسّعوا فقط حين يتطلب مسار عمل محدد ذلك.

وللبيئات المنظّمة، وثّقوا النطاق المحدد لكل خادم MCP قبل النشر. ستحتاجونه لمراجعة الامتثال.

تخطي طبقة المهارات#

للمهارات عائد جيد على نحو غير معتاد على الوقت المستثمر. فمهارة وصف طلب السحب تستغرق 30 دقيقة لكتابتها وتوفّر من 5 إلى 10 دقائق لكل طلب سحب. وعند 10 طلبات سحب أسبوعياً لكل مهندس، يتضاعف الحساب بسرعة. ومعظم الفرق تتخطاها لأنها تبدو اختيارية. وهي ليست اختيارية إن كان اتساق المخرجات يهمكم.

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

كيف تتشاركون تهيئة خوادم MCP عبر فريق دون كشف بيانات الدخول؟

أودعوا تعريفات الخوادم (الأمر، والوسائط، والرابط) في .mcp.json. ويضيف كل مهندس بيانات دخوله في ~/.claude.json تحت أسماء الخوادم نفسها. فيدمج Claude Code الاثنين عند بداية الجلسة. وأسماء الخوادم يجب أن تتطابق تطابقاً تاماً.

ما هو CLAUDE.md وكيف يستخدمه Claude؟

CLAUDE.md ملف Markdown يقرأه Claude Code عند بداية الجلسة. ويُحمّل كمعرفة خلفية في سياق النموذج، حاضراً دائماً دون أن يُشار إليه صراحة. والفرق تودعه في جذر المستودع حتى يبدأ الجميع بسياق المشروع نفسه.

ما الفرق بين خوادم MCP المحلية وتلك بنطاق المشروع في Claude Code؟

الخوادم المحلية (المعرّفة في ~/.claude.json) تؤثر على المهندس الفرد وحده. والخوادم بنطاق المشروع (.mcp.json في جذر المستودع) تنطبق على كل من في المشروع. والخوادم المُدارة على مستوى المؤسسة تُنشر عبر نظام إدارة الأجهزة وتنطبق على كل أجهزة المؤسسة.

أي صلاحيات يمنحها Claude Code Enterprise للمسؤولين؟

يستطيع مسؤولو Enterprise نشر managed-mcp.json للتحكم في خوادم MCP المسموحة أو المحجوبة، وmanaged-settings.json لفرض صلاحيات على مستوى الأداة في المؤسسة كلها. وكلاهما يُنشر عبر نظام إدارة الأجهزة ويتجاوز إعدادات المهندس الفردي.

كيف تعمل المهارات المخصصة في خطة Enterprise؟

المهارات ملفات SKILL.md تصير أوامر /slash-commands. ويستطيع المهندسون الأفراد إنشاء مهارات محلياً. ويستطيع مالكو حساب Enterprise توفير مهارات في المؤسسة كلها: فتظهر لكل المستخدمين تلقائياً. والمهارات على مستوى المشروع تسكن المستودع إلى جانب CLAUDE.md.

هل تساعد Silverthread Labs في نشر Claude Code للفرق؟

نعم. تواصلوا معنا عبر صفحة التدقيق لمناقشة إعداد فريقكم.