تكامل MCP

ما ستتعلمه

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

ما هو 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.json مع تفاصيل الاتصال وبيانات اعتماد المصادقة.

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

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

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

الإضافات المتاحة

توفر إضافات 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 استدعاءها.

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

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

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

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

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

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

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

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

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

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

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

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

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

قنوات الدعم:

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

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

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

موارد وثائق MCP

الوثائق الرسمية

قريبًا:

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

موارد مؤقتة

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

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

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

انظر أيضًا