تكامل MCP

ما هو 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

قدرات موسّعة

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

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

قابلية التشغيل المتبادل

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

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

أتمتة سير العمل

تكامل سلس: تصبح خوادم MCP جزءًا من مجموعة أدوات Verdent. يستخدم الوكيل أدوات 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.json في جذر المشروع أو ~/.verdent/mcp.json (عام)

{
  "mcpServers": {
    "postgres": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-postgres",
        "postgresql://localhost:5432/myapp_dev"
      ]
    }
  }
}

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

{
  "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}"
      }
    }
  }
}

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

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

إضافات وامتدادات MCP

الإضافات المتوفرة

توفّر إضافات MCP تكاملات جاهزة للأدوات والخدمات الشائعة. استعرض سجل المجتمع على mcp.so/servers أو مستودع خوادم MCP الرسمي للتوفر الحالي.

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

• تكاملات قواعد البيانات: أدوات الاستعلام لـ 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، وتعرض قدرات الأدوات التي يمكن لـ Verdent استدعاءها. راجع مواصفات Model Context Protocol للحصول على تفاصيل التنفيذ ومجموعات تطوير البرامج (SDKs).

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

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

أنماط التكامل

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

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

ميزات MCP الخاصة بسطح المكتب

التهيئة لكل مشروع

MCP متعددة شجرة العمل

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

• خوادم مشتركة: تهيئة 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

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

نهج 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.json
• تأكد من أن خادم MCP قيد التشغيل وقابل للوصول
• تحقّق من صحة بنية ملف التهيئة

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

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

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

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

الحصول على المساعدة

قنوات الدعم:

• دعم Verdent: support@verdent.ai
• وثائق بروتوكول MCP
• مجتمع Verdent على Discord

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

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

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