AI CodeOps مع Claude Code
اربط Claude Code بخادم MCP الخاص بـ AI CodeOps: سلّم المهام إلى جلسات خاضعة للبوابات، وافحص بوابة الإصدار قبل الدمج، واقرأ الملاحظات، من طرفيتك.
أداة Claude Code وكيل برمجة تشغله في طرفيتك. و AI CodeOps منصة تعمل في المتصفح، يخطط فيها وكلاء الذكاء الاصطناعي للتغيير ويكتبونه ويختبرونه ويراجعونه، ولا يصبح التغيير طلب سحب إلا بعد نجاح بوابات الجودة وموافقة شخص عليه. اربط الاثنين عبر خادم MCP الخاص بـ AI CodeOps، فيستطيع Claude Code تسليم مهمة إلى جلسة AI CodeOps خاضعة للبوابات، ومتابعتها، وقراءة ملاحظاتها، والسؤال هل يجوز إطلاق طلب سحب.
ما يخضعه AI CodeOps لبواباته، وما لا يخضعه
افهم هذا جيدا قبل أن تعد أي شيء. يطبق AI CodeOps بواباته على التغييرات التي تجري في جلساته هو. وطلب السحب الذي يفتحه Claude Code من تلقاء نفسه، من طرفيتك أو من Claude Code GitHub Actions، طلب سحب عادي: لا يراجعه AI CodeOps، ويرفضه فحص الإصدار برسالة "No workflow runs found for …"، لأن أي جلسة AI CodeOps لم تنشئه.
فهناك إذن طريقتان لإمرار عمل Claude Code عبر البوابات:
- سلّم المهمة. من Claude Code، استدع
start_sessionمع المهمة. فتكتب جلسة AI CodeOps التغيير، وتشغل اختباراتك، وتراجعه بعدة وكلاء، ولا تفتح طلب السحب إلا حين تنجح البوابة. - افحص قبل أن تدمج. اسأل
check_release_gateعن طلب سحب، أو شغّل الفحص نفسه في CI، فلا يدمج شيء دون حكم بالسماح.
ربط Claude Code
- في AI CodeOps، أنشئ مفتاح API لمساحة العمل من Configure → API Keys. يبدأ بـ
sk-ويعرض مرة واحدة. وليستطيع Claude Code بدء الجلسات، اختر Scope على المفتاح وضع علامة على Start sessions from the MCP server (/mcp). وضع علامة على Evidence packs from the MCP server (/mcp) أيضا إذا أردت حزم الأدلة. راجع مفاتيح API. - أضف الخادم. تعطي وثائق MCP لدى Claude Code هذه الصيغة لخادم HTTP بعيد مع ترويسة:
claude mcp add --transport http aicodeops https://console.aicodeops.dev/mcp \ --header "Authorization: Bearer sk-..." - شغّل
/mcpفي Claude Code. فيظهرaicodeopsمتصلا، مع تسع أدوات.
افتراضيا يضاف الخادم لك أنت، في المشروع الحالي فقط. ولمشاركته مع فريقك، أضف --scope project، فيكتب Claude Code الخادم في .mcp.json في جذر المستودع. ويوسع Claude Code متغيرات البيئة في ذلك الملف، فيبقى المفتاح خارج نظام إدارة النسخ:
{
"mcpServers": {
"aicodeops": {
"type": "http",
"url": "https://console.aicodeops.dev/mcp",
"headers": { "Authorization": "Bearer ${AICODEOPS_API_KEY}" }
}
}
}
ما يستطيع Claude Code فعله
| الأداة | ما تفعله |
|---|---|
list_projects | تسرد مشاريع مساحة العمل ومستودعاتها. |
start_session | تبدأ جلسة على مشروع بمهمة، وسير العمل الافتراضي هو plan-build-review-test. |
get_session | حالة الجلسة وخطواتها وطلب السحب الذي فتحته وتغييرها. |
check_release_gate | هل يجوز إطلاق طلب سحب أو إيداع، مع الأسباب. |
list_findings | ملاحظات الأمان والجودة، مصفاة حسب الخطورة أو التصنيف. |
get_evidence_pack | حزمة الأدلة الموقّعة لتغيير. |
list_builds | عمليات البناء الأخيرة: ما الذي بدأ كلا منها، وفرعها وإيداعها، وكيف انتهت. |
get_build | عملية بناء واحدة: الخطوة التي فشلت عندها ونهاية مخرجاتها. |
list_saved_builds | عمليات البناء التي تحتفظ بها مساحة العمل، وما يبدأ كلا منها. |
تتصرف كل أداة بصفة منشئ المفتاح، وتمر بالفحوص نفسها التي في لوحة التحكم: دوره، وميزانية مساحة العمل، وحد العمل الجاري للوكيل. والجلسة التي تبدأ من Claude Code تفتح طلب السحب كأي جلسة أخرى، فتبقى الموافقات وبوابة الإصدار سارية. والمرجع الكامل في دليل خادم MCP.
أشياء يمكنك طلبها من Claude Code بعد ربطه:
List my AI CodeOps projects, then start a session on the api project to add rate limiting to the login route.
Check on that session until it finishes, and tell me what the reviewers found.
Ask the AI CodeOps release gate whether https://github.com/acme/api/pull/42 may ship, and list the reasons.
إخضاع الدمج للبوابة في CI
فحص الإصدار متاح أيضا واجهة HTTP API، فيستطيع CI طرح السؤال نفسه قبل الدمج. وهذه مهمة GitHub Actions تفشل حين ترفض البوابة طلب السحب:
name: AI CodeOps release gate
on: pull_request
jobs:
gate:
runs-on: ubuntu-latest
steps:
- name: Ask the release gate
env:
AICODEOPS_API_KEY: ${{ secrets.AICODEOPS_API_KEY }}
PR_URL: ${{ github.event.pull_request.html_url }}
run: |
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 -r '.summary' gate.json
jq -e '.allowed == true' gate.json
تجيب نقطة النهاية بالحالة 200 مع allowed بقيمة true أو false، وملخص وأسباب. ويمكنك إضافة حد أدنى للتغطية، ومسارات سير عمل مطلوبة، وتراخيص محظورة، وعملية نشر مطلوبة في staging؛ والحقول موجودة في صفحة API. وتذكر معنى ذلك حين يكون فحصا مطلوبا: طلب السحب الذي لم تنشئه أي جلسة AI CodeOps يرفض، ومنه ما يفتحه Claude Code من تلقاء نفسه.
الحدود
- 120 طلب MCP في الدقيقة من العنوان الواحد؛ ويسمح فحص CI بـ 60 في الدقيقة لكل مساحة عمل.
- خادم MCP عديم الحالة ولا يرسل إشعارات، فيستطلع Claude Code الأداة
get_sessionدوريا لمتابعة الجلسة. - مفاتيح API لمساحة العمل فقط. وتسجيل الدخول عبر OAuth غير مدعوم بعد.
البدء
- أنشئ حسابا مجانيا: AI CodeOps في مرحلة بيتا المفتوحة ويعمل في متصفحك.
- اربط خدمة استضافة Git لديك وأنشئ مشروعا، مستعينا بدليل البدء السريع.
- أنشئ مفتاح API وأضف الخادم إلى Claude Code كما سبق.
تستخدم وكيل برمجة آخر؟ راجع AI CodeOps مع Codex أو Cursor أو GitHub Copilot. وللاتجاه الآخر، حيث تستدعي جلسات AI CodeOps خوادم MCP لديك، راجع AI CodeOps و MCP.
الأسئلة الشائعة
هل يراجع AI CodeOps طلبات السحب التي يفتحها Claude Code؟
لا. يطبق AI CodeOps بواباته على التغييرات التي تجريها جلساته هو. وطلب السحب الذي يفتحه Claude Code من تلقاء نفسه لا يراجع، ويرفضه فحص الإصدار لأن أي جلسة لم تنشئه. ولإخضاع العمل للبوابات، سلّم المهمة من Claude Code إلى جلسة AI CodeOps.
كيف يسجل Claude Code الدخول إلى AI CodeOps؟
بمفتاح API لمساحة العمل يرسل في ترويسة Bearer. ويتصرف المفتاح بصفة العضو الذي أنشأه، بدور ذلك العضو وميزانيته. وتسجيل الدخول عبر OAuth غير مدعوم بعد.
هل يستطيع Claude Code بدء جلسات دون أن يسألني؟
فقط بمفتاح يتضمن نطاقه Start sessions from the MCP server. والمفتاح الذي لا نطاق له يستطيع استخدام أدوات القراءة السبع ولا شيء غيرها.
هل يمكنني مشاركة الإعداد مع فريقي؟
نعم. أضف الخادم بالخيار --scope project فيكتبه Claude Code في .mcp.json داخل المستودع. وأبق المفتاح نفسه في متغير بيئة، لا في الملف.