Coroid يوفر خادم بروتوكول سياق النماذج (MCP) عن بُعد. يمكن لأي مساعد أو وكيل خارجي، مثل Hermes أو Codex أو Claude Code، استخدامه للعمل مع Coroid عبر سجل الأدوات المنظمة نفسه الذي يستخدمه مساعد الدردشة.
قم بالتكوين تحت إعدادات → اتصالات → Coroid MCP server، والذي يشمل نظرة عامة، إعداد العميل، رموز الوصول، عمليات الموافقة و سياسات الأتمتة.
نقطة الاتصال
يعمل خادم MCP على بوابة API، في هذا العنوان:
https://api.coroid.ai/mcpالنقل يتم عبر بروتوكول Streamable HTTP غير المبني على الحالة. قم بالمصادقة باستخدام OAuth أو رمز وصول شخصي.
ما الذي تم تفعيله
يقوم Coroid بتفعيل قدرات MCP على مراحل، وذلك لكل منظمة دفعة واحدة.
| القدرة | على coroid.ai |
|---|---|
| تسجيل الدخول عبر OAuth | مفعّل |
| قراءة الأدوات | مفعّل |
| رموز الوصول الشخصية | مفعّل |
| أدوات إنشاء أو تغيير أو تشغيل أو تسليم المهام | مفعّل |
| أدوات الإدارة، بما في ذلك إعدادات المنظمة | لم يتم تفعيله بعد |
طالما أن الميزة غير مفعلة، لن يرى العملاء أدواتها وترفض Coroid استدعاءاتها. تصف بقية هذه الصفحة المجموعة الكاملة من الأدوات.
ربط عميل
استخدم بروتوكول OAuth إذا كان عميلك يدعمه. ستوافق على الاتصال في متصفحك ويمكنك إلغاؤه في أي وقت. تظل رموز الوصول صالحة لمدة 15 دقيقة بينما تظل رموز التجديد صالحة لمدة 30 يومًا، ويستبدل كل تجديد رمز التجديد القديم.
يطلب العميل النطاقات عند اتصاله. قبل الموافقة، سترى النطاقات وتحدد ما إذا كان العميل يمكنه الوصول إلى جميع المشاريع أو بعضها فقط. العميل الذي لا يطلب أي نطاقات يحصل على صلاحيات قراءة فقط، لذا اطلب النطاقات التي تحتاجها، كما في مثال Codex.
Hermes
hermes mcp add coroid --url https://api.coroid.ai/mcp --auth oauth
hermes mcp login coroid
hermes mcp test coroidبدلاً من ذلك، باستخدام رمز وصول:
hermes mcp add coroid --url https://api.coroid.ai/mcp --auth headerزود Hermes بالرمز عند طلبه إياه. احفظه في مستودع بيانات اعتماد Hermes بدلاً من ملف الإعدادات الخاص به.
Codex
codex mcp add coroid --url https://api.coroid.ai/mcp
codex mcp login coroid --scopes mcp.read,mcp.work.write,mcp.execute,mcp.deliveryبدلاً من ذلك، باستخدام رمز وصول:
export COROID_MCP_TOKEN="cmp_pat_…"
codex mcp add coroid --url https://api.coroid.ai/mcp --bearer-token-env-var COROID_MCP_TOKENClaude Code
claude mcp add --transport http --scope user coroid https://api.coroid.ai/mcp
/mcpنفّذ الأمر الأول في محطة الطرفية. ثم اكتب الثاني في Claude Code، واختر Coroid وسجّل الدخول في متصفحك.
بدلاً من ذلك، باستخدام رمز وصول:
export COROID_MCP_TOKEN="cmp_pat_…"
claude mcp add --transport http --scope user --header "Authorization: Bearer $COROID_MCP_TOKEN" coroid https://api.coroid.ai/mcpعملاء آخرون
يمكن لأي عميل يدعم خوادم MCP عن بُعد عبر بروتوكول HTTP القابل للتدفق أن يتصل.
تنشر Coroid بيانات تعريف OAuth للنقطة النهائية وتدعم تسجيل العميل الديناميكي باستخدام بروتوكول PKCE. العميل الذي لا يستخدم OAuth يمكنه إرسال رمز وصول كرمز حامل في هذا الرأس: Authorization.
قبل أن يغير الوكيل أي شيء، اطلب منه سرد أدوات Coroid وقراءة هذا المصدر: coroid://context. يعرض ذلك الشخص الذي يتصرف نيابة عنه الوكيل، والنطاقات والمشاريع المتاحة له.
رموز الوصول
يتم إنشاء الرموز وإدارتها تحت رموز الوصول. ومثل أي بيانات اعتماد أخرى، يتم عرضها مرة واحدة ولن تُعاد بعد ذلك.
قم بإصدار رمز لكل عميل بدلاً من مشاركة رمز واحد. وبذلك، يكون إلغاء وصول عميل معين إجراءً محدودًا وليس عطلًا يؤثر على الجميع.
يعمل الرمز نيابةً عن الشخص الذي أنشأه، ولا يمكن إنشاؤه إلا من قبل شخص مسجل الدخول إلى البوابة. لكل رمز نطاقاته الخاصة، وينتهي صلاحيته بعد 30 أو 90 أو 365 يومًا، ويمكنه الوصول إلى جميع المشاريع أو فقط المشاريع التي تحددها. كما يمكن للمالك ربط سياسة أتمتة به. يبدأ كل رمز بنفس البادئة:
cmp_pat_.
احتفظ برمز الوصول في بيئة العميل أو مستودع الاعتمادات. لا تضعه أبداً في مستودع أو موجه.
النطاقات والأدوار
يحدد النطاق ما يمكن للاتصال القيام به. وتحدد دورك في المنظمة الحدود: يحتاج الأداة إلى النطاق والدور على الأقل. تقوم Coroid بفحص دورك الحالي في كل مكالمة، لذا لا يحتفظ الاتصال بصلاحيات فقدتها.
| نطاق | ما الذي يفتحه | أدنى دور |
|---|---|---|
mcp.read | قراءة المشاريع، المهام، الخطط، دورات العمل، التقارير، التبعيات، السعة، تشغيل الوكلاء، مسارات المصنع، عمليات الترويج والإصدارات | مراجع |
mcp.work.write | إنشاء وتغيير المهام، الخطط، دورات العمل، التبعيات والتقارير | عضو |
mcp.execute | بدء العمل، إيقافه، إعادة محاولته، تعليقه، استئنافه وإلغاؤه | عضو |
mcp.delivery | الموافقة على الخطط، إغلاق دورات العمل، عمليات الترويج، التحقق من المسارات والإصدارات | عضو |
mcp.projects.admin | إنشاء المشاريع وتحديثها وأرشفتها واستعادتها، بالإضافة إلى ترقيم الإصدارات | مشرف |
mcp.schedules.admin | قراءة الجداول الزمنية وإنشاؤها وتحديثها وتشغيلها وحذفها | مشرف |
mcp.integrations.admin | قراءة التكاملات واختبارها وتفعيلها أو إلغاء تفعيلها وحذفها | مشرف |
mcp.secrets.write | إنشاء تكاملات تحتوي على اعتمادات | مالك |
mcp.organization.admin | الأعضاء، الدعوات، ملف تعريف المنظمة وإعدادات المنظمة | مالك |
mcp.billing.read | محجوز. لا تستخدمه أي أداة بعد | — |
mcp.billing.write | محجوز. لا تستخدمه أي أداة بعد | مالك |
لا يمكن لمشرف أو مالك منح نطاق يكون أدنى دوره مشرفًا. ولا يمكن لمالك منح نطاق يكون أدنى دوره مالكًا.
الاتصال المحدود ببعض المشاريع لا يستطيع الوصول إلى أي عناصر في مشاريع أخرى، حتى عبر معرف المهمة أو الخطة أو دورة العمل أو التقرير أو الإصدار. كما لا يستطيع استخدام أدوات على مستوى المنظمة، مثل هذه: list_plans،
get_capacity_dashboard.
أدوات
تعرض واجهة العميل فقط الأدوات التي تم تفعيلها والتي تسمح بها نطاقاتك ودورك. يوضح عمود الموافقة ما يحدث عند استدعاء أداة ما:
| موافقة | ما الذي يحدث |
|---|---|
| لا شيء | تُشغل الأداة فورًا |
| سياسة | تنتظر المكالمة الموافقة، ما لم تغطيها سياسة أتمتة |
| دائمًا | تنتظر المكالمة دائمًا موافقة المالك أو المشرف |
قراءة
تحتاج هذه الأدوات إلى دور المراجع وهذا النطاق: mcp.read. ولا تحتاج أي منها إلى موافقة.
| منطقة | أدوات |
|---|---|
| مشاريع | list_projects، get_project، get_project_dependencies، list_project_branches |
| مهام | list_tasks، get_task، get_workflow_status، get_execution_status، check_task_can_start |
| خطط | list_plans، get_plan، get_plan_progress، list_plan_tasks |
| دورات عمل | list_sprints، get_sprint، get_sprint_status |
| تبعيات | analyze_dependencies، get_dependency_graph، get_global_dependency_graph، get_cross_project_blockers |
| تقارير | list_reports، get_report، export_report، explain_report_execution، list_report_folders، list_report_subscriptions، list_report_templates |
| السعة والنشاط | get_capacity_dashboard، get_queue_eta، get_mission_control_activity، get_global_execution_stats، get_global_execution_actions، list_global_execution_runs |
| تشغيل الوكلاء | list_agent_executions، get_agent_execution، get_agent_execution_state، get_execution_conversation، list_tool_executions |
| مسارات المصنع والعروض الترويجية | list_factory_lanes، get_factory_lane، list_factory_lane_tasks، get_factory_lane_gate_context، list_promotions، get_promotion |
| سجل الكود | explain_code |
للاطلاع على أدوات الإصدارات، اطلع على إصدارات عبر MCP.
إنشاء وتعديل العمل
تتطلب هذه الأدوات دور العضو ونطاق: mcp.work.write.
| منطقة | أدوات | موافقة |
|---|---|---|
| مهام | create_task، update_task | لا شيء |
| خطط | create_plan، update_plan | لا شيء |
| خطط | delete_plan | دائماً |
| دورات عمل | create_sprint، plan_sprint، add_task_to_sprint | لا شيء |
| دورات عمل | remove_task_from_sprint | دائماً |
| تبعيات | create_dependency | لا شيء |
| تقارير | create_report، update_report، create_report_folder، update_report_folder، create_report_subscription، update_report_subscription | لا شيء |
| تقارير | batch_update_reports، delete_report، delete_report_folder، delete_report_subscription | دائماً |
العمل الذي يتم إنشاؤه عبر MCP لا يمر بمرحلة التأهيل. طلب بحجم خطة يُرسل إلى أداة المهام يتحول إلى خطة مسودة بدلاً من مهمة. الخطط التي تُنشأ عبر MCP تبدأ كمسودات.
تشغيل العمل
تتطلب هذه الأدوات دور العضو ونطاق: mcp.execute.
| منطقة | أدوات | موافقة |
|---|---|---|
| مهام | start_task_execution، retry_task_execution | سياسة |
| مهام | stop_task_execution | دائماً |
| خطط | start_planning_workflow، execute_plan، retry_plan_task_integration | سياسة |
| خطط | cancel_plan | دائماً |
| دورات عمل | start_sprint | سياسة |
| تقارير | pause_report، resume_report، cancel_report، retry_report_generation | سياسة |
| مصنع | start_global_execution، pause_global_execution، resume_global_execution، pause_factory_lane، resume_factory_lane | سياسة |
| مصنع | cancel_global_execution، set_agent_execution_state | دائماً |
تسليم
تتطلب هذه الأدوات دور العضو ونطاق: mcp.delivery. توجد أقسام خاصة بالإصدارات أدناه.
| أدوات | موافقة |
|---|---|
approve_plan، close_sprint، create_promotion، approve_promotion، request_promotion_changes، validate_factory_lane | سياسة |
force_merge_promotion | دائماً |
إدارة
تغيّر هذه الأدوات طريقة إعداد المنظمة ومشاريعها.
| أدوات | نطاق | أدنى صلاحية | مراجعة |
|---|---|---|---|
create_project، update_project، restore_project | mcp.projects.admin | مشرف | لا شيء |
archive_project | mcp.projects.admin | مشرف | دائماً |
list_schedules، get_schedule، create_schedule، update_schedule | mcp.schedules.admin | مشرف | لا شيء |
trigger_schedule | mcp.schedules.admin | مشرف | سياسة |
delete_schedule | mcp.schedules.admin | مشرف | دائماً |
list_integrations، get_integration | mcp.integrations.admin | مشرف | لا شيء |
test_integration | mcp.integrations.admin | مشرف | سياسة |
set_integration_status، delete_integration | mcp.integrations.admin | مشرف | دائماً |
create_integration | mcp.secrets.write | مالك | دائماً |
list_organization_members، list_organization_invitations | mcp.organization.admin | مالك | لا شيء |
invite_organization_member، update_organization_member_role، remove_organization_member، revoke_organization_invitation، update_organization | mcp.organization.admin | مالك | دائماً |
إعدادات المنظمة
يمكن لوكيل مثل Hermes أن يقوم بإعداد المنظمة من خلال لقطات شاشة أو ملفات أو وصف. يقرأ هذا الوكيل تنسيق إعدادات Coroid، ثم يكتب ما تم اكتشافه في حزمة، ويُعرض معاينة للحزمة قبل تطبيقها. تتطلب هذه الأدوات دور المالك والنطاق التالي: mcp.organization.admin.
| أداة | وظيفتها | عمليات الموافقة |
|---|---|---|
describe_organization_settings_schema | تعيد تنسيق الإعدادات، بالإضافة إلى أقسامه وتلميحات التعيين الخاصة به | لا يوجد |
export_organization_settings | تصدّر الإعدادات الحالية مع وضع قيم السر كأماكن احتفاظ | لا يوجد |
preview_organization_settings_import | تُظهر التغييرات التي ستطرأ على الحزمة دون تطبيقها فعليًا | لا يوجد |
apply_organization_settings_import | تطبق الحزمة، حيث يتم دمجها مع الإعدادات الحالية بشكل افتراضي أو استبدالها | دائمًا |
تحتوي الحزمة على أماكن احتفاظ بدلاً من قيم السر، وترفض Coroid أي حزمة تحتوي على سر. اطلع على تصدير واستيراد الإعدادات.
إصدارات عبر MCP
أدوات الإصدار هي نفسها التي يستخدمها مساعد الدردشة، وتمر عبر نفس Release API كما في البوابة:
| أداة | نطاق | موافقة |
|---|---|---|
list_releases، get_release، list_release_commits، preview_release، get_release_settings، list_release_pull_requests | mcp.read | لا شيء |
create_release، update_release، run_release_checks، draft_release_notes | mcp.delivery | لا شيء |
approve_release، request_release_deployment، bundle_release_pull_requests | mcp.delivery | دائمًا |
update_release_versioning | mcp.projects.admin | لا شيء |
create_release يقبل رمز التزام كامل، أو رمز تزام مختصر لالتزام حديث، أو
latest، ويترك تحديد الإصدار لمصدر الإصدار الخاص بالمشروع ما لم تحدده أنت. get_release يُظهر، لكل بيئة، عمليات الفحص، آخر عملية نشر، الإصدار الذي أبلغت عنه خطوط الإنتاج، وما إذا كان Coroid قد تحقق من الإصدار الجاري. لا يمكن لرمز محدود لمشاريع معينة الوصول إلى إصدارات في مشاريع أخرى. ولا تزال قواعد الموافقة الخاصة بـ Release API سارية، لذا فإن الموافقة عبر MCP تعادل تمامًا الموافقة في البوابة.
list_release_pull_requests تُعيد طلبات السحب المفتوحة لمشروع ما بالترتيب الذي يقترحه Coroid، مع ذكر سبب استبعاد أي منها.
bundle_release_pull_requests ينشئ إصدارًا منها: فرع إصدار تُدمج فيه طلبات السحب بالترتيب وطلب pull request للإصدار واحد. ويدفع فرعًا ويفتح pull request، لذا ينتظر دائمًا تدخل شخص. استبعد
prNumbers لاستخدام اختيار Coroid.
عمليات الموافقة وسياسات الأتمتة
عمليات الموافقة هي قائمة انتظار للإجراءات التي تنتظر موافقة إنسان. سياسات الأتمتة تحدد ما يجب أن يوجد في تلك القائمة.
هذا هو الضبط المهم. يجب أن يكون العميل الخارجي الذي يعمل نيابة عنك قادرًا على القيام بأعمال روتينية بحرية، والأعمال ذات التأثير الكبير فقط بموافقة شخص. قم بضبط السياسات قبل منح الرمز لأي شيء يعمل بشكل تلقائي.
عندما تحتاج مكالمة إلى موافقة، يحصل العميل على معرف موافقة ورابط بدلاً من النتيجة. يقوم المالك أو المشرف بمراجعة الأداة والوسائط المستخدمة بالضبط، ثم يوافق على المكالمة أو يرفضها. الموافقة تؤدي لتنفيذ المكالمة بالشكل نفسه الذي تم طلبها به، ولا يمكن للعميل تغييرها لاحقًا. أما المكالمات التي لا تحصل على موافقة خلال 10 دقائق فتنتهي صلاحيتها.
تسمح سياسة الأتمتة لرمز الوصول بتشغيل الأدوات المُصنفة ضمن فئة 'Policy' دون انتظار موافقة. يقتصر إنشاء السياسات وربطها بالرموز على المالكين فقط. تحدد السياسة الأدوات الدقيقة، ويمكن تقييدها على مشاريع معينة، كما تحدد عدد المكالمات التي يمكن تشغيلها في الساعة واليوم وفي نفس الوقت، بالإضافة إلى تاريخ انتهائها. إلغاء السياسة يعني إلغاء كل الرموز المرتبطة بها؛ أما الأدوات المصنفة ضمن فئة 'Always' فلا تخضع أبداً للسياسات.
لا يمكن لاتصال OAuth أن يحمل سياسة؛ فعبر بروتوكول OAuth، تنتظر كل أداة مصنفة ضمن فئة 'Policy' موافقة.
عمليات إعادة المحاولة والعمليات والموارد
كل أداة تُحدث تغييرًا ما تتطلب هذه المعلمة: idempotencyKey.
استخدم مفتاحًا جديدًا لكل إجراء جديد، والمفتاح نفسه عند إعادة محاولة الإجراء. وبذلك تُرجع Coroid النتيجة الأولى بدلاً من تنفيذ الإجراء مرتين؛ أما استخدام مفتاح مكرر مع وسائط مختلفة فيتم رفضه.
كما تُرجع أي عملية تغيير نتيجة تسجل حالتها ونتائجها؛ وتعمل هذه الأدوات الأربع مع كل اتصال:
| الأداة | وظيفتها |
|---|---|
get_operation | تُرجع حالة العملية ونتائجها |
wait_for_operation | تنتظر حتى 25 ثانية لتغيير حالة العملية |
cancel_operation | تلغي عملية لم تبدأ بعد |
get_approval | تُرجع حالة عملية الموافقة ونتائجها |
كما يوفر الخادم هذه الموارد:
| المورد | محتوياته |
|---|---|
coroid://context | الهوية التي يعمل بها الاتصال، مع دوره ونطاقاته ومشاريعه |
coroid://capabilities | الأدوات التي يمكن لهذا الاتصال استخدامها |
coroid://operations/{operationId} | عملية واحدة |
coroid://approvals/{approvalId} | عملية موافقة واحدة |
كما يقدم ثلاثة مطالبات: create_and_run_task، investigate_failure،
prepare_release.
لكل أداة حدود محددة لكل دقيقة وساعة ويوم؛ وإذا تجاوزت المكالمة هذه الحدود، تفشل وتوضح المدة التي يجب الانتظارها قبل إعادة المحاولة.
ما لا يتم الكشف عنه عمدًا
سجل الأدوات خاضع للتنظيم، والاستثناءات مقصودة؛ فهو لا يوفر أيًا من هذه العناصر:
- محاكي طرفية
- وصول إلى Git
- نظام الملفات
- وصول مباشر إلى قاعدة البيانات
- طلبات HTTP داخلية تعسفية
- أدوات إدارة MCP الصادرة عن Coroid نفسها
ستحصل على القدرة على إدارة المهام — إنشاء المهام والخطط والمشاريع والإصدارات وفحصها — وليس بيئة تنفيذ عن بُعد. لا يمكن لعميل MCP استخدام Coroid لتشغيل أوامر تعسفية.
لأي غرض يُستخدم؟
يمكنك تشغيل Coroid من البيئة التي تعمل فيها حالياً — سواء كان محررًا، مساعدًا، أو أداة داخلية — دون الحاجة إلى التبديل إلى البوابة. إن إنشاء مهمة من الطرفية، أو طلب مساعدك للتحقق من العوائق، يصبح إجراءً محليًا.