AI CodeOps

AI CodeOps مع Cursor

أضف خادم MCP الخاص بـ AI CodeOps إلى Cursor: ابدأ جلسات ذكاء اصطناعي خاضعة للبوابات، واقرأ الملاحظات، وافحص هل يجوز إطلاق طلب سحب، دون مغادرة المحرر.

محرر Cursor محرر كود بالذكاء الاصطناعي، له وكلاء يعملون في المحرر وفي السحابة. و AI CodeOps منصة تعمل في المتصفح، يخطط فيها وكلاء الذكاء الاصطناعي للتغيير ويكتبونه ويختبرونه ويراجعونه، ولا يصبح التغيير طلب سحب إلا بعد نجاح بوابات الجودة وموافقة شخص عليه. أضف خادم MCP الخاص بـ AI CodeOps إلى Cursor، فيستطيع الوكيل في محررك تسليم مهمة إلى جلسة AI CodeOps خاضعة للبوابات، ومتابعتها، وقراءة ملاحظاتها، والسؤال هل يجوز إطلاق طلب سحب.

ما يخضعه AI CodeOps لبواباته، وما لا يخضعه

يطبق AI CodeOps بواباته على التغييرات التي تجري في جلساته هو. أما وكلاء Cursor السحابيون فيعملون على فرع منفصل ويدفعون التغييرات إلى مستودعك للتسليم، ويستطيعون فتح طلبات سحب (الوكلاء السحابيون). وتلك طلبات سحب عادية: لا يراجعها AI CodeOps، ويرفضها فحص الإصدار لأن أي جلسة AI CodeOps لم تنشئها.

لإمرار عمل Cursor عبر البوابات، اطلب من الوكيل في Cursor أن يبدأ جلسة AI CodeOps بالمهمة. فتكتب الجلسة التغيير، وتشغل اختباراتك، وتراجعه بعدة وكلاء، ولا تفتح طلب السحب إلا حين تنجح البوابة. أو اسأل بوابة الإصدار قبل أن تدمج، من Cursor أو من CI.

ربط Cursor

  1. في AI CodeOps، أنشئ مفتاح API لمساحة العمل من Configure → API Keys. يبدأ بـ sk- ويعرض مرة واحدة. وليستطيع Cursor بدء الجلسات، اختر Scope على المفتاح وضع علامة على Start sessions from the MCP server (/mcp). راجع مفاتيح API.
  2. ضع المفتاح في متغير بيئة، مثل AICODEOPS_API_KEY.
  3. أضف الخادم إلى .cursor/mcp.json في مشروعك، أو إلى ~/.cursor/mcp.json لاستخدامه في كل مكان (وثائق MCP لدى Cursor)، كما يلي:
    {
      "mcpServers": {
        "aicodeops": {
          "url": "https://console.aicodeops.dev/mcp",
          "headers": { "Authorization": "Bearer ${env:AICODEOPS_API_KEY}" }
        }
      }
    }

يستبدل Cursor الصيغة ${env:NAME} بقيمتها في الحقلين url و headers، فيمكن إيداع الملف دون أن يكون المفتاح فيه.

ما يستطيع الوكيل في Cursor فعله

للخادم تسع أدوات: list_projects و start_session و get_session و check_release_gate و list_findings و get_evidence_pack و list_builds و get_build و list_saved_builds. وتتصرف كل منها بصفة منشئ المفتاح، بدوره وميزانية مساحة العمل وحد العمل الجاري للوكيل، تماما كما في لوحة التحكم. ولا تعمل الأداتان start_session و get_evidence_pack إلا لمفتاح يتضمن نطاقه صلاحيتهما. والتفاصيل في دليل خادم MCP.

أشياء تطلبها من الوكيل:

Start an AI CodeOps session on the web project: fix the date parsing bug in the invoice export, with a test.
What did the AI CodeOps reviewers find on that session? List anything high or critical.
Does the AI CodeOps release gate allow https://github.com/acme/web/pull/17? Give me the reasons.

الجلسة التي تبدأ من Cursor تفتح طلب السحب كأي جلسة أخرى، فتبقى الموافقات وبوابة الإصدار سارية قبل أن يدمج.

إخضاع الدمج للبوابة في CI

الفحص نفسه واجهة HTTP API يستطيع خط CI لديك استدعاءها قبل الدمج، على أي نظام CI يستطيع تشغيل curl، كما يلي:

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $AICODEOPS_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"pullRequestURL\":\"$PR_URL\"}" > gate.json
jq -e '.allowed == true' gate.json

يجيب بالحالة 200 مع allowed وملخص وأسباب. ومن الخيارات حد أدنى للتغطية، ومسارات سير عمل مطلوبة، وتراخيص محظورة، وعملية نشر مطلوبة في staging (API). وحين يكون فحصا مطلوبا، يرفض أي طلب سحب لم تنشئه جلسة AI CodeOps.

الحدود

  • 120 طلب MCP في الدقيقة من العنوان الواحد.
  • عديم الحالة: لا يرسل الخادم إشعارات، فيستطلع الوكيل الأداة get_session دوريا لمتابعة الجلسة.
  • مفاتيح API لمساحة العمل فقط. وتسجيل الدخول عبر OAuth غير مدعوم بعد.

البدء

  1. أنشئ حسابا مجانيا: AI CodeOps في مرحلة بيتا المفتوحة ويعمل في متصفحك.
  2. اربط خدمة استضافة Git لديك وأنشئ مشروعا، مستعينا بدليل البدء السريع.
  3. أنشئ مفتاح API وأضف الخادم إلى Cursor كما سبق.

تفاضل بين المنتجين بدل الجمع بينهما؟ اقرأ AI CodeOps مقابل Cursor. تستخدم وكيلا آخر؟ راجع AI CodeOps مع Claude Code.

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

هل يراجع AI CodeOps طلبات السحب التي يفتحها وكلاء Cursor؟

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

أين يوضع الإعداد؟

في .cursor/mcp.json داخل مشروعك، أو في ~/.cursor/mcp.json في مجلدك الرئيسي لكل المشاريع. ويقرأ Cursor المفتاح من متغير بيئة بالصيغة ${env:NAME}.

أي نقل يستخدمه خادم AI CodeOps؟

النقل Streamable HTTP، وهو مدعوم في Cursor، مع المفتاح في ترويسة Authorization Bearer.

هل Bugbot هو نفسه بوابة AI CodeOps؟

لا. يراجع Bugbot طلبات السحب على خدمة استضافة Git لديك. أما بوابة AI CodeOps فتحتجز تغييرا كتبه وكلاؤها إلى أن تنجح الاختبارات وتكتمل مراجعة الذكاء الاصطناعي ويوافق شخص.