AI CodeOps

خوادم MCP

آخر تحديث

اربط خوادم MCP بعيدة ليستطيع وكلاء AI CodeOps استدعاء أدواتها: أضف خادما، وأبق ترويساته مشفرة، وقيد الأدوات لكل وكيل وبالسياسة.

بروتوكول Model Context Protocol (MCP) يتيح لوكيل ذكاء اصطناعي استدعاء أدوات على خدمة أخرى، مثل نظام تتبع المشكلات أو بحث في الوثائق. وفي AI CodeOps، تربط خوادم MCP بمساحة عملك فيستطيع الوكلاء في جلساتك استخدام أدواتها.

هنا AI CodeOps هو العميل: هو الذي يتصل بخوادم MCP التي تضيفها. ولاستخدام AI CodeOps من مساعد البرمجة الخاص بك، راجع خادم MCP الخاص بـ AI CodeOps.

دعم MCP في مرحلة بيتا.

الخوادم البعيدة والمحلية

النوعما تدخلههل تستخدمه الجلسات؟
Remote (HTTP/SSE URL)عنوان الخادم وترويسات HTTPنعم
Local (stdio command)أمر ومتغيرات بيئةلا. يسجل، لكن الجلسات لا تشغله.

تعمل الجلسات على المنصة، لا على حاسوبك، فلا تستطيع تشغيل برنامج على جهازك. استخدم خادما بعيدا لكل ما ينبغي أن يستدعيه وكلاؤك.

يجب أن تكون الخوادم البعيدة:

  • على عنوان HTTPS عام (وترفض الشبكات الخاصة و localhost)؛
  • تستخدم النقل Streamable HTTP في MCP (أي JSON-RPC عبر POST، مع رد بصيغة JSON أو بتدفق أحداث)؛
  • تقبل المصادقة في ترويسات ثابتة، مثل bearer token. والخوادم التي تحتاج إلى تسجيل دخول عبر OAuth غير مدعومة بعد، وكذلك النقل الأقدم المعتمد على SSE وحده.

أضف خادما

  1. افتح Configure → MCP Servers واختر Add MCP server (إضافة خادم MCP).
  2. أدخل اسما في Name، مثل "GitHub". يصنع AI CodeOps معرف الخادم منه، بأحرف صغيرة وشرطات: فالاسم "GitHub" يصير github، والاسم "Docs Search" يصير docs-search. وتستخدم أسماء الأدوات وقواعد السياسة هذا المعرف.
  3. اختر Remote (HTTP/SSE URL) وأدخل العنوان في Server URL.
  4. في Headers، أضف KEY=value واحدا في كل سطر، مثل:
    Authorization=Bearer <your token>
  5. اختر Save MCP server (حفظ خادم MCP).

يظهر الخادم ضمن Servers ومعه Disable و Remove. ولا يوجد نموذج تعديل بعد: لتغيير خادم، أزله وأضفه من جديد.

إدارة خوادم MCP تحتاج إلى الصلاحية MCP-manage: وهي لدى المالكين والمسؤولين ومسؤولي DevOps افتراضيا.

كيف تخزن الأسرار

الترويسات (للخوادم البعيدة) ومتغيرات البيئة (للمحلية) تشفر وهي مخزنة بخوارزمية AES-256-GCM. ولا ترسل إلى المتصفح مرة أخرى أبدا؛ وتعرض القائمة المفاتيح المضبوطة فقط، بنص مثل "1 header: Authorization". ولا يفك تشفيرها إلا حين تتصل جلسة بالخادم. وتسجل إضافة الخادم وتغييره وتفعيله وتعطيله وإزالته في سجل التدقيق.

كيف يحصل الوكلاء على الأدوات

حين تبدأ جلسة، يتصل AI CodeOps بكل خادم بعيد مفعل ويسرد أدواته. والخادم الذي يتعذر الوصول إليه يتخطى، وتعمل الجلسة دون أدواته.

  • تسمى الأدوات بالصيغة <server>__<tool>، مثل github__create_issue.
  • تستطيع الجلسة عرض حتى 32 أداة MCP في المجموع.
  • في كل خطوة وكيل، يستطيع الوكيل إجراء ما يصل إلى 6 جولات من استدعاءات الأدوات.
  • تنتهي مهلة كل استدعاء بعد 30 ثانية، وتختصر النتائج الطويلة.

ويمكنك تضييق الأدوات التي تصل إلى الوكلاء بطريقتين.

لكل وكيل

في Configure → Agents، للوكيل المخصص اختيار اسمه MCP tools this agent may use: وقيمه None (وهي الافتراضية للوكيل الجديد) أو Only the tools listed أو All tools the workspace allows. وللقائمة، أدخل أسماء خوادم أو أدوات أو أسماء بالصيغة server__tool، مفصولة بفواصل. والوكيل المحفوظ قبل وجود هذا الاختيار يحتفظ بكل الأدوات إلى أن تغيره.

بسياسة مساحة العمل

قاعدة سياسة على الإجراء mcp.invoke تطابق server/tool. والأداة التي لا تسمح بها السياسة لا تعرض على الوكلاء أبدا. فمثلا، لإبعاد كل أداة حذف على خادم GitHub عن جلساتك:

{ "id": "no-repo-deletes", "action": "mcp.invoke", "resource": "github/delete_*", "decision": "deny" }

قواعد mcp.invoke تستطيع استخدام allow أو deny، لا ask. ومع وضع الثقة None، ترفض أدوات MCP ما لم تسمح بها قاعدة.

استكشاف الأخطاء وإصلاحها

إذا لم تستخدم جلسة أدوات خادم:

  • تحقق من أن الخادم مفعل وأنه خادم من النوع Remote.
  • تحقق من أن العنوان HTTPS عام وأن الخادم يدعم Streamable HTTP، لا SSE وحده.
  • تحقق من الترويسات: فالرمز المنتهي الصلاحية يجعل الخادم يرفض الاتصال.
  • تحقق من الحقل MCP tools allowed في الوكيل المخصص ومن سياسة مساحة عملك.

الخطوات التالية

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

هل AI CodeOps نفسه خادم MCP؟

نعم، وذلك أمر منفصل عن هذه الصفحة. خادم MCP الخاص به يتيح لـ Claude Code أو Cursor أو عميل MCP آخر استخدام مساحة عملك؛ راجع دليل خادم MCP الخاص بـ AI CodeOps. وهذه الصفحة تتناول الاتجاه الآخر، أي الخوادم التي تتصل بها جلساتك.

هل تشغل الجلسات خوادم MCP المحلية (stdio)؟

لا. يمكنك تسجيل خادم محلي، لكن الجلسات لا تتصل إلا بالخوادم البعيدة عبر HTTPS.

هل يمكنني رؤية ترويسة بعد حفظها؟

لا. تشفر الترويسات ومتغيرات البيئة وهي مخزنة ولا تعرض مرة أخرى أبدا. وتعرض القائمة المفاتيح المضبوطة فقط.

هل كانت هذه الصفحة مفيدة؟