# تكامل MCP (/ar/docs/verdent-manager/configuration/mcp)

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



## ما هو 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`، الذي يحدد اتصالات الخادم والمصادقة ومعاملات التكامل. راجع قسم **تهيئة MCP** أدناه للحصول على المخطط الكامل.

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

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

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

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

### حالة الخادم [#حالة-الخادم]

راقب حالة الاتصال في لوحة إعدادات MCP:

| الحالة          | الوصف                              |
| --------------- | ---------------------------------- |
| **ناجحة**       | الخادم متصل والأدوات متوفرة        |
| **فاشلة**       | خطأ في الاتصال (حدد لعرض التفاصيل) |
| **قيد التحميل** | الخادم قيد التهيئة                 |

**تحديث الأدوات:**
حدد زر التحديث لإعادة اكتشاف الأدوات المتوفرة من خادم بعد تغييرات التهيئة أو مشكلات الاتصال.

***

## تهيئة MCP [#تهيئة-mcp]

### الإعداد الأساسي [#الإعداد-الأساسي]

**الموقع:** `.mcp.json` في جذر المشروع أو `~/.verdent/mcp.json` (عام)

<CodeGroup>
  ```json PostgreSQL Server
  {
    "mcpServers": {
      "postgres": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-postgres",
          "postgresql://localhost:5432/myapp_dev"
        ]
      }
    }
  }
  ```

  ```json GitHub Server
  {
    "mcpServers": {
      "github": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-github"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
        }
      }
    }
  }
  ```

  ```json Multiple Servers
  {
    "mcpServers": {
      "postgres": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-postgres",
          "postgresql://localhost:5432/myapp_dev"
        ]
      },
      "github": {
        "command": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/server-github"
        ],
        "env": {
          "GITHUB_PERSONAL_ACCESS_TOKEN": "${GITHUB_TOKEN}"
        }
      }
    }
  }
  ```
</CodeGroup>

**مفاتيح التهيئة:**

* `mcpServers` - مفتاح رئيسي مطلوب لتهيئة MCP
* `command` - الملف التنفيذي المطلوب تشغيله (عادةً `npx` لحزم Node.js)
* `args` - المعاملات الممرّرة إلى الأمر (اسم الحزمة، سلاسل الاتصال، إلخ)
* `env` - متغيرات البيئة للمصادقة/التهيئة

<Tip>
  **اعرف المزيد حول MCP:**

  * [مواصفات Model Context Protocol](https://modelcontextprotocol.io/specification)
  * [سجل خوادم MCP](https://mcp.so/servers) - استعرض خوادم MCP المتوفرة
  * [خوادم MCP الرسمية](https://github.com/modelcontextprotocol) - PostgreSQL وGitHub ونظام الملفات وغيرها
</Tip>

***

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

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

توفّر إضافات MCP تكاملات جاهزة للأدوات والخدمات الشائعة. استعرض سجل المجتمع على [mcp.so/servers](https://mcp.so/servers) أو [مستودع خوادم MCP الرسمي](https://github.com/modelcontextprotocol) للتوفر الحالي.

**فئات الإضافات الشائعة:**

* **تكاملات قواعد البيانات:** أدوات الاستعلام لـ 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 استدعاءها. راجع [مواصفات Model Context Protocol](https://modelcontextprotocol.io/specification) للحصول على تفاصيل التنفيذ ومجموعات تطوير البرامج (SDKs).

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

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

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

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

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

***

## ميزات MCP الخاصة بسطح المكتب [#ميزات-mcp-الخاصة-بسطح-المكتب]

### التهيئة لكل مشروع [#التهيئة-لكل-مشروع]

| مستوى التهيئة             | الموقع                     | النطاق            |
| ------------------------- | -------------------------- | ----------------- |
| **عام**                   | `~/.verdent/mcp.json`      | جميع المشاريع     |
| **المشروع**               | `.mcp.json` في جذر المشروع | مشروع واحد        |
| **شجرة العمل (Worktree)** | يرث من المشروع             | يرث تهيئة المشروع |

### MCP متعددة شجرة العمل [#mcp-متعددة-شجرة-العمل]

تعمل خوادم MCP عبر أشجار العمل (worktrees):

* **خوادم مشتركة:** تهيئة MCP الأساسية لمساحة العمل مشتركة بين جميع أشجار العمل
* **عمليات منعزلة:** تحافظ كل شجرة عمل على حالة جلسة MCP منفصلة
* **وصول متوازٍ:** يمكن لأشجار عمل متعددة استخدام نفس خوادم MCP في الوقت نفسه

### تبديل المشاريع [#تبديل-المشاريع]

عند تبديل المشاريع:

* يتم تحميل خوادم MCP الخاصة بالمشروع الحالي
* تظل خوادم MCP العامة متوفرة
* يتم الاحتفاظ باتصالات MCP للمشروع السابق في الخلفية

***

## أمثلة على سير عمل 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]
```

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

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

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

**نهج MCP:**

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

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

***

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

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

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

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

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

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

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

***

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

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

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

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

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

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

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

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

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

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

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

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

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

***

## الأسئلة الشائعة [#الأسئلة-الشائعة]

<AccordionGroup>
  <Accordion title="هل تستخدم خوادم MCP أرصدة؟">
    تستهلك عمليات خادم MCP أرصدة بناءً على المُوذج الذي يعالج النتائج. خادم MCP نفسه لا يستهلك أرصدة بشكل مباشر.
  </Accordion>

  <Accordion title="هل خوادم MCP خاصة بمشروع معين؟">
    لا. تتم تهيئة خوادم MCP على مستوى المستخدم، وليس لكل مشروع. جميع الخوادم المهيَّأة متوفرة عبر جميع مشاريعك.
  </Accordion>

  <Accordion title="هل بيانات اعتمادي آمنة في mcp.json؟">
    تُخزَّن بيانات الاعتماد في mcp.json محليًا على جهازك ولا تُرسَل مطلقًا إلى خوادم Verdent. استخدم متغيرات البيئة (`${VAR_NAME}`) للقيم الحساسة.
  </Accordion>

  <Accordion title="هل تعمل خوادم MCP بشكل مستمر؟">
    تبدأ خوادم MCP عند الحاجة وتعمل خلال جلستك. لا تستهلك الموارد عندما يكون Verdent مغلقًا.
  </Accordion>

  <Accordion title="هل يمكن لخوادم MCP تعديل ملفاتي؟">
    تمتلك خوادم MCP الأذونات التي تهيّئها. استخدم الوصول للقراءة فقط عند الإمكان وقيّد العمليات المدمّرة.
  </Accordion>

  <Accordion title="كيف أعرف أن خادم MCP الخاص بي يعمل؟">
    اطلب من Verdent استخدام أداة من خادم MCP. تشير الاستجابات الناجحة إلى أن الاتصال يعمل. راجع قسم استكشاف الأخطاء وإصلاحها إذا حدثت مشكلات.
  </Accordion>
</AccordionGroup>