خادم 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.