# تكامل MCP (/ar/docs/verdent-for-vscode/advanced-features/mcp)

> توسيع Verdent باستخدام خوادم وإضافات Model Context Protocol



### ما ستتعلمه [#ما-ستتعلمه]

نظرة عامة على تكامل Model Context Protocol (MCP) في Verdent for VS Code، بما في ذلك الإعداد والتهيئة وخيارات قابلية التوسع.

<Info>
  يجري حاليًا تطوير وثائق شاملة لـ MCP. تقدّم هذه الصفحة نظرة عامة على إمكانات MCP، وستتوفر أدلة تفصيلية قريبًا. للاستفسارات المحددة حول التكامل، تواصل مع [support@verdent.ai](mailto:support@verdent.ai).
</Info>

***

## ما هو MCP (Model Context Protocol)؟ [#ما-هو-mcp-model-context-protocol]

Model Context Protocol (MCP) هو نظام تكامل يوسّع قدرات Verdent من خلال الاتصال بأدوات ومصادر بيانات وخدمات خارجية.

**المفهوم الأساسي:**
يتيح MCP لـ Verdent التفاعل مع أنظمة تتجاوز مجموعة أدواته المدمجة، مما يسمح بالتكامل السلس مع:

* APIات وخدمات الويب الخارجية
* أنظمة قواعد البيانات
* المنصات السحابية (AWS و Azure و GCP)
* أدوات إدارة المشاريع
* خطوط أنابيب CI/CD
* الأدوات الداخلية المخصصة

**البنية:**
تعمل خوادم MCP كجسور بين Verdent والأنظمة الخارجية. يعرض كل خادم MCP قدرات محددة يمكن لـ Verdent استدعاءها خلال جلسات كتابة الكود، على غرار الأدوات المدمجة مثل `file_read` أو `bash`.

**تخزين التهيئة:**
يتم تخزين تهيئات خوادم MCP في `~/.verdent/mcp.json` وتُدار من خلال قائمة الإعدادات.

***

## مزايا تكامل MCP [#مزايا-تكامل-mcp]

### قدرات موسّعة [#قدرات-موسّعة]

**الوصول إلى الأنظمة الخارجية:**
اربط Verdent بأدوات وخدمات غير متاحة من خلال الوظائف المدمجة. استعلم عن قواعد البيانات، وتفاعل مع الخدمات السحابية، أو دمّج APIات خاصة بالمشروع دون مغادرة سير عمل كتابة الكود.

**تطوير أدوات مخصصة:**
أنشئ خوادم MCP مصممة خصيصًا لمتطلبات مشروعك الفريدة. أنشئ تكاملات متخصصة للأدوات الداخلية أو APIات الخاصة أو الأنظمة المتخصصة بمجال معين.

### قابلية التبادل [#قابلية-التبادل]

**الاستفادة من النظام البيئي:**
استفد من النظام البيئي المتنامي لـ MCP. توفر خوادم MCP التي طورها المجتمع تكاملات جاهزة للأدوات والخدمات الشائعة.

**بروتوكول موحّد:**
يوفر MCP واجهة متسقة لتكامل الأدوات، مما يضمن اندماج القدرات الجديدة بسلاسة مع نظام الأدوات الحالي في Verdent.

### أتمتة سير العمل [#أتمتة-سير-العمل]

**تكامل سلس:**
تصبح خوادم MCP جزءًا من مجموعة أدوات Verdent. يستخدم الوكيل أدوات MCP تلقائيًا عند الحاجة، أو يمكنك استدعاءها بشكل صريح لمهام محددة.

**عمليات مدركة للسياق:**
تفهم تكاملات MCP سياق قاعدة الكود الخاصة بك، مما يتيح تفاعلات ذكية مع الأنظمة الخارجية بناءً على حالة التطوير الحالية.

***

## إعداد خوادم MCP [#إعداد-خوادم-mcp]

### عملية التهيئة [#عملية-التهيئة]

**الوصول إلى إعدادات MCP:**

1. افتح قائمة الإعدادات في Verdent
2. انتقل إلى قسم **خوادم MCP**
3. اعرض أو عدّل تهيئة `~/.verdent/mcp.json`

**ملف التهيئة:**
تُهيَّأ خوادم MCP من خلال ملف `~/.verdent/mcp.json`، الذي يحدد اتصالات الخادم والمصادقة ومعاملات التكامل.

<Note>
  يجري حاليًا الانتهاء من مخطط تهيئة MCP التفصيلي وتعليمات الإعداد. للمساعدة الفورية في إعداد خادم MCP، راجع مواصفات بروتوكول MCP أو تواصل مع دعم Verdent.
</Note>

### إدارة التهيئة [#إدارة-التهيئة]

**إضافة خوادم:**
هيّئ خوادم MCP جديدة بإضافة إدخالات إلى `mcp.json` مع تفاصيل الاتصال وبيانات اعتماد المصادقة.

**خوادم متعددة:**
يدعم Verdent عدة خوادم MCP متزامنة، مما يتيح التكامل مع عدة أنظمة خارجية في الوقت نفسه.

**اختبار الاتصالات:**
تحقق من تهيئات خوادم MCP لضمان نجاح الاتصالات قبل استخدامها في سير عمل التطوير.

***

## إضافات وامتدادات MCP [#إضافات-وامتدادات-mcp]

### الإضافات المتاحة [#الإضافات-المتاحة]

توفر إضافات MCP تكاملات جاهزة للأدوات والخدمات الشائعة.

<Info>
  يجري حاليًا تجميع قائمة منسّقة من إضافات MCP المتاحة. راجع وثائق Verdent الرسمية أو موارد النظام البيئي لـ MCP لمعرفة الإضافات المتاحة حاليًا.
</Info>

**فئات الإضافات المتوقعة:**

* **تكاملات قواعد البيانات:** أدوات استعلام PostgreSQL و MySQL و MongoDB
* **الخدمات السحابية:** تفاعلات API لـ AWS و Azure و GCP
* **أدوات المطورين:** تكاملات GitHub و GitLab و Jira و Linear
* **منصات CI/CD:** Jenkins و GitHub Actions و CircleCI
* **خدمات المراقبة:** Datadog و New Relic و Sentry
* **التواصل:** إشعارات Slack و Discord و Microsoft Teams

### تثبيت الإضافات [#تثبيت-الإضافات]

**طرق التثبيت:**
تُثبَّت الإضافات وتُهيَّأ من خلال واجهة إعدادات MCP، وتتطلب عادةً:

* معرّف الإضافة أو مصدرها
* معاملات التهيئة
* بيانات اعتماد المصادقة (إن وُجدت)

**إدارة التبعيات:**
قد تحتوي إضافات MCP على تبعيات لخدمات أو مكتبات خارجية. تتعامل عمليات التثبيت مع حل التبعيات تلقائيًا عند الإمكان.

***

## تطوير خادم MCP مخصص [#تطوير-خادم-mcp-مخصص]

### إنشاء خوادم مخصصة [#إنشاء-خوادم-مخصصة]

يمكن للمستخدمين المتقدمين إنشاء خوادم MCP مخصصة لدمج أدوات خاصة أو أنظمة متخصصة بمجال معين.

**نهج التطوير:**
تنفّذ خوادم MCP المخصصة مواصفات بروتوكول MCP، معروضةً قدرات الأدوات التي يمكن لـ Verdent استدعاءها.

**حالات استخدام الخوادم المخصصة:**

* **التكامل مع API الداخلي:** الاتصال بـ APIات والخدمات الخاصة بالشركة
* **جسور الأنظمة القديمة:** تمكين Verdent من التفاعل مع البنية التحتية القديمة
* **مصادر البيانات المتخصصة:** الوصول إلى قواعد البيانات الخاصة أو مستودعات البيانات
* **أتمتة سير العمل:** تشغيل خطوط أنابيب البناء أو النشر أو الاختبار المخصصة

<Note>
  يجري حاليًا تطوير أدلة شاملة لتطوير خوادم MCP المخصصة، بما في ذلك متطلبات تنفيذ البروتوكول، ووثائق SDK، وأدوات الاختبار. لاحتياجات التكامل المخصص الفورية، راجع مواصفات بروتوكول MCP.
</Note>

### أنماط التكامل [#أنماط-التكامل]

**تهيئة على مستوى مساحة العمل:**
يمكن تهيئة خوادم MCP على مستوى مساحة العمل للتكاملات الخاصة بالمشروع، مما يتيح للفرق مشاركة تهيئات MCP من خلال التحكم في الإصدارات.

**قابلية التبادل بين الأدوات:**
تتكامل الأدوات المقدَّمة من MCP بسلاسة مع أدوات Verdent المدمجة (`file_read` و `bash` و `spawn_subagent`)، مما يتيح سير عمل معقد يجمع بين أنواع متعددة من الأدوات.

***

## أمثلة على سير عمل MCP [#أمثلة-على-سير-عمل-mcp]

### تكامل الاستعلام عن قاعدة البيانات [#تكامل-الاستعلام-عن-قاعدة-البيانات]

**السيناريو:** الاستعلام عن قاعدة بيانات الإنتاج لتصحيح مشكلات البيانات.

**نهج MCP:**

```
User: "Check the orders table for customer ID 12345"
Verdent: [Uses MCP database server to execute safe read-only query]
        Results: 3 orders found for customer 12345
        [Displays formatted results]
```

يتعامل خادم قاعدة بيانات MCP مع المصادقة والتحقق من الاستعلام وتنسيق النتائج.

### التفاعل مع الخدمات السحابية [#التفاعل-مع-الخدمات-السحابية]

**السيناريو:** فحص سجلات وظيفة AWS Lambda بحثًا عن الأخطاء.

**نهج MCP:**

```
User: "Show me recent errors from the payment-processor Lambda function"
Verdent: [Invokes MCP AWS integration]
        [Retrieves CloudWatch logs for specified function]
        [Filters for ERROR level entries]
        [Presents formatted error summaries]
```

يتولى خادم AWS في MCP إدارة المصادقة واستدعاءات API وتحليل السجلات.

### مراقبة خط أنابيب CI/CD [#مراقبة-خط-أنابيب-cicd]

**السيناريو:** فحص حالة البناء قبل نشر التغييرات.

**نهج MCP:**

```
User: "Is the main branch build passing?"
Verdent: [Queries MCP CI/CD integration]
        Build #245: ✓ Passed (2 minutes ago)
        All tests passed, ready for deployment
```

يتابع خادم CI/CD في MCP حالة خط الأنابيب ويوفر ملاحظات فورية.

***

## اعتبارات الأمان [#اعتبارات-الأمان]

### المصادقة والتفويض [#المصادقة-والتفويض]

**إدارة بيانات الاعتماد:**
تتعامل خوادم MCP مع المصادقة للخدمات الخارجية. تُخزَّن بيانات الاعتماد بأمان في تهيئة MCP ولا تُعرَض مطلقًا في سجل المحادثة أو الكود.

**تحديد نطاق الأذونات:**
هيّئ خوادم MCP بأقل الأذونات اللازمة. استخدم الوصول للقراءة فقط حيثما أمكن، وقيّد العمليات المدمرة.

### العمليات الآمنة [#العمليات-الآمنة]

**مراجعة الأوامر:**
يمكن مراجعة العمليات التي تتضمن أدوات MCP في Manual Accept Mode قبل التنفيذ، مما يوفر رؤية وضبطًا.

**تسجيل التدقيق:**
تظهر عمليات خادم MCP في سجل محادثة Verdent، مما ينشئ مسار تدقيق لتفاعلات الأنظمة الخارجية.

***

## استكشاف أخطاء تكامل MCP وإصلاحها [#استكشاف-أخطاء-تكامل-mcp-وإصلاحها]

### المشكلات الشائعة [#المشكلات-الشائعة]

**فشل الاتصال:**

* تحقق من الاتصال بالشبكة إلى خادم MCP
* افحص بيانات اعتماد المصادقة في `mcp.json`
* تأكد من أن خادم MCP قيد التشغيل وقابل للوصول
* تحقق من صحة بنية ملف التهيئة

**أخطاء الأذونات:**

* تأكد من أن مفاتيح API أو بيانات الاعتماد تملك الأذونات المطلوبة
* افحص حصص الخدمة أو حدود المعدل
* تحقق من أن قواعد جدار الحماية تسمح بحركة مرور MCP

**مشكلات استدعاء الأدوات:**

* تأكد من أن خادم MCP يعرض الأدوات المتوقعة بشكل صحيح
* افحص تطابق تنسيقات معاملات الأدوات مع توقعات الخادم
* راجع سجلات خادم MCP لمعرفة تفاصيل الأخطاء

### الحصول على المساعدة [#الحصول-على-المساعدة]

**قنوات الدعم:**

* دعم Verdent: [support@verdent.ai](mailto:support@verdent.ai)
* [وثائق بروتوكول MCP](https://modelcontextprotocol.io)
* [مجتمع Discord لـ Verdent](https://discord.com/invite/NGjXEZcbJq) للدعم في الوقت الفعلي

**معلومات التشخيص:**
عند الإبلاغ عن مشكلات MCP، قدّم:

* نوع وإصدار خادم MCP
* تفاصيل التهيئة (بعد إزالة بيانات الاعتماد)
* رسائل الأخطاء من سجل المحادثة
* سجلات خادم MCP (إن كانت متاحة)

***

## موارد وثائق MCP [#موارد-وثائق-mcp]

### الوثائق الرسمية [#الوثائق-الرسمية]

<Info>
  يجري حاليًا تطوير أدلة شاملة لتكامل MCP، تشمل:

  * مواصفات بروتوكول MCP الكاملة
  * وثائق SDK لتطوير الخوادم
  * سوق وسجل الإضافات
  * أمثلة وشروحات التكامل
  * مرجع API لتطوير الخوادم المخصصة
</Info>

**قريبًا:**

* أدلة إعداد خادم MCP خطوة بخطوة
* شروحات تثبيت وتهيئة الإضافات
* دروس تطوير الخوادم المخصصة
* أفضل الممارسات لتكامل MCP
* تحسين الأداء لسير عمل MCP

### موارد مؤقتة [#موارد-مؤقتة]

**معلومات MCP الحالية:**

* مواصفات بروتوكول MCP (خارجية)
* خوادم وأمثلة MCP التي طورها المجتمع
* مستودعات GitHub للنظام البيئي MCP

**للتواصل بخصوص التفاصيل:**
للمساعدة الفورية في تكامل MCP، تواصل مع [support@verdent.ai](mailto:support@verdent.ai) مع ذكر حالة الاستخدام ومتطلبات التكامل الخاصة بك.

***

## انظر أيضًا [#انظر-أيضًا]

<CardGroup cols="2">
  <Card title="مرجع الأدوات" icon="wrench" href="/docs/verdent-for-vscode/advanced-features/tool-reference">
    قدرات الأدوات المدمجة
  </Card>

  <Card title="قابلية التوسع" icon="puzzle-piece" href="/docs/verdent-for-vscode/advanced-features/extensibility">
    طرق التوسع الأخرى
  </Card>

  <Card title="التهيئة" icon="gear" href="/docs/verdent-for-vscode/configuration/settings">
    إعدادات وتفضيلات Verdent
  </Card>

  <Card title="أفضل الممارسات" icon="lightbulb" href="/docs/verdent-for-vscode/best-practices/prompts">
    تقنيات الحث الفعّالة
  </Card>
</CardGroup>