AI CodeOps

خادم MCP الخاص بـ AI CodeOps

آخر تحديث

اربط Claude Code أو Cursor أو أي عميل MCP مع AI CodeOps: ابدأ الجلسات، واقرأ الملاحظات، وافحص بوابة الإصدار، واجلب حزم الأدلة من محررك.

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

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

الربط

تحتاج إلى مفتاح API لمساحة العمل. أنشئ مفتاحا من Configure → API Keys؛ يبدأ بـ sk- ويعرض مرة واحدة. راجع مفاتيح API.

في Claude Code: أضف الخادم بالأمر التالي

claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \
  --header "Authorization: Bearer sk-..."

ثم شغّل /mcp في Claude Code، فيظهر aicodeops متصلا، مع أدواته التسع.

في Cursor، ضع ما يلي في الملف .cursor/mcp.json، وهذا محتواه:

{
  "mcpServers": {
    "aicodeops": {
      "url": "https://console.aicodeops.dev/mcp",
      "headers": { "Authorization": "Bearer sk-..." }
    }
  }
}

أي عميل آخر: العنوان هو https://console.aicodeops.dev/mcp، والنقل هو Streamable HTTP، ويوضع المفتاح في الترويسة Authorization: Bearer.

أبق المفتاح خارج الملفات التي تودعها: فمعظم العملاء يقرؤونه من متغير بيئة.

العميل أو السجل الذي يكتشف الخوادم من وصفها يستطيع قراءة وصف هذا الخادم على https://console.aicodeops.dev/server.json (وأيضا على /.well-known/mcp/server.json). ولا يحتاج إلى مفتاح، ويسرد العنوان والنقل والترويسة التي يوضع فيها المفتاح.

الأدوات

الأداةما تفعلهما يحتاج إليه المفتاح
list_projectsتسرد مشاريع مساحة العمل ومستودعاتها.workspace:read
start_sessionتبدأ جلسة على مشروع بمهمة. واختياريا: الحقل workflow (وقيمته الافتراضية plan-build-review-test) والحقل agent.workflow_run:manage
get_sessionحالة الجلسة وخطواتها وطلب السحب الذي فتحته وتغييرها.workspace:read
check_release_gateهل يجوز إطلاق طلب سحب أو إيداع، مع الأسباب. وهو الفحص نفسه الذي في واجهة API.workspace:read
list_findingsملاحظات الأمان والجودة، مصفاة حسب severity أو category.workspace:read
get_evidence_packحزمة الأدلة الموقّعة لتغيير، حسب changeID أو حسب الجلسة التي بدأته.workspace:audit.read
list_buildsعمليات البناء الأخيرة: ما الذي بدأ كلا منها (شخص، أو بناء محفوظ، أو دفع، أو طلب سحب، أو جدول زمني)، وفرعها وإيداعها، وكيف انتهت.workspace:read
get_buildعملية بناء واحدة: الخطوة التي فشلت عندها ونهاية مخرجاتها، لمعرفة سبب فشلها.workspace:read
list_saved_buildsعمليات البناء التي تحتفظ بها مساحة العمل، ومنها القادمة من ملف البناء في المستودع، وما يبدأ كلا منها.workspace:read

الأداة التي لا يجوز للمفتاح استخدامها تجيب بخطأ يذكر السبب، وتبقى الأدوات الأخرى تعمل. وتحتاج الأداتان start_session و get_evidence_pack أيضا إلى أن تكون صلاحيتهما مدرجة في نطاق المفتاح (انظر أدناه).

ما تستطيع الأداة فعله

تتصرف كل أداة بصفة منشئ المفتاح، وتمر بالفحوص نفسها التي في لوحة التحكم:

  • الأدوار: العضو الذي لا يستطيع بدء الجلسات في لوحة التحكم لا يستطيع بدءها هنا. ومفتاح المشاهد يستطيع القراءة، ولا شيء غيرها.
  • نطاق المفتاح: يستطيع استخدام أدوات القراءة السبع المفتاح الذي لا نطاق له، أو الذي يتضمن نطاقه Release gate check from CI, and read-only MCP tools. ولا تعمل الأداتان start_session و get_evidence_pack إلا لمفتاح يتضمن نطاقه صلاحيتهما: اختر Scope على المفتاح من Configure → API Keys وضع علامة على Start sessions from the MCP server (/mcp) أو Evidence packs from the MCP server (/mcp)، وأبق العلامة على Release gate check from CI, and read-only MCP tools لكي تبقى أدوات القراءة عاملة. والمفتاح الذي لا نطاق له لا يستطيع بدء الجلسات هنا، فالمفاتيح المنشأة من قبل لخطوط CI أو لبوابة النماذج لا تكتسب ذلك من تلقاء نفسها. وتحديد نطاق المفاتيح يعتمد على خطتك.
  • الإنفاق: تحتسب الجلسات من ميزانية مساحة العمل ومن حد العمل الجاري للوكيل، كما في لوحة التحكم.
  • التدقيق: تسجل الجلسة من بدأها، وهو منشئ المفتاح. ويسجل تصدير حزمة أدلة في سجل التدقيق.

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

الحدود

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

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

كيف يسجل خادم MCP الدخول؟

بمفتاح API لمساحة العمل يرسل في صورة Bearer token. ويتصرف المفتاح بصفة العضو الذي أنشأه، بدور ذلك العضو الحالي. وتسجيل الدخول عبر OAuth غير مدعوم بعد.

هل يستطيع خادم MCP تغيير كودي مباشرة؟

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

أي العملاء يعمل؟

أي عميل MCP يدعم النقل Streamable HTTP وترويسة مخصصة، ومنها Claude Code و Cursor.

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