Coroid كخادم MCP

Coroid يوفر خادمًا عن بُعد لبروتوكول Model Context Protocol (MCP). يمكن لأي مساعد أو وكيل خارجي، مثل Hermes أو Codex أو Claude Code أو Cursor، استخدامه للعمل مع Coroid عبر نفس سجل الأدوات المنظمة الذي يستخدمه مساعد الدردشة.

قم بالتكوين تحت إعدادات → اتصالات → Coroid MCP server، والذي يغطي نظرة عامة، إعداد العميل، رموز الوصول، عمليات الموافقة و سياسات الأتمتة.

نقطة النهاية#

يعمل خادم MCP على بوابة API، في هذا العنوان:

https://api.coroid.ai/mcp

وسيلة النقل هي بروتوكول Streamable HTTP عديم الحالة. قم بالمصادقة عبر OAuth أو رمز وصول شخصي.

ما الذي تم تفعيله؟#

يقوم Coroid بتفعيل إمكانيات MCP على مراحل، لكل مؤسسة دفعة واحدة.

حتى يتم تفعيل إمكانية ما، لا يرى العملاء أدواتها وترفض 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_TOKEN

Claude 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

Cursor#

أضف Coroid إلى ~/.cursor/mcp.json، أو إلى .cursor/mcp.json في مستودع لمشاركة الإعداد مع كل من يعمل عليه:

{
  "mcpServers": {
    "coroid": {
      "url": "https://api.coroid.ai/mcp"
    }
  }
}

يقوم Cursor بالتسجيل عبر OAuth: وافق على الاتصال في متصفحك عند طلبه. تحقق من النطاقات على تلك الشاشة، لأن الاتصال بدون نطاقات كتابة يمكنه فقط القراءة.

بدلاً من ذلك، باستخدام رمز وصول:

{
  "mcpServers": {
    "coroid": {
      "url": "https://api.coroid.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:COROID_MCP_TOKEN}"
      }
    }
  }
}

اضبط COROID_MCP_TOKEN في بيئة تشغيل Cursor. .cursor/mcp.json يتم إلحاقه بمستودع، لذا ضعه هناك وليس الرمز.

عملاء آخرون#

أي عميل يدعم خوادم MCP عن بُعد عبر بروتوكول Streamable HTTP يمكنه الاتصال. تنشر Coroid بيانات تعريف OAuth لنقطة النهاية وتدعم التسجيل الديناميكي للعملاء باستخدام PKCE. العميل الذي لا يدعم OAuth يمكنه إرسال رمز وصول كرمز حامل في هذا الرأس: Authorization.

قبل أن يغير الوكيل أي شيء، اطلب منه سرد أدوات Coroid وقراءة هذا المصدر: coroid://context. يوضح ذلك الشخص الذي يتصرف نيابة عنه الوكيل، مع النطاقات والمشاريع المستخدمة.

رموز الوصول#

تُنشأ رموز الوصول وتُدار تحت رموز الوصول. ومثل كل بيانات اعتماد أخرى، تُعرض مرة واحدة ولا تُعاد بعد ذلك.

انشئ رمزًا واحدًا لكل عميل بدلاً من مشاركة رمز واحد. وبذلك يكون إلغاء وصول عميل واحد إجراءً محدودًا وليس انقطاعًا للجميع.

يعمل الرمز نيابة عن الشخص الذي أنشأه، ولا يمكن إلا للشخص المسجل في البوابة إنشاؤه. لكل رمز نطاقاته الخاصة، وينتهي صلاحيته بعد 30 أو 90 أو 365 يومًا، ويمكنه الوصول إلى جميع المشاريع أو المشاريع التي تحددها فقط. كما يمكن للمالك إرفاق سياسة أتمتة به. يبدأ كل رمز بنفس البادئة: cmp_pat_.

احفظ الرمز في بيئة العميل أو مستودع بيانات الاعتماد. لا تضعه أبداً في مستودع أو في نص توجيهي.

النطاقات والأدوار#

يحدد النطاق ما يمكن للاتصال القيام به. تحدد دورك في المؤسسة الحد الأقصى: تحتاج الأداة إلى النطاق والدور على الأقل. تتحقق Coroid من دورك الحالي في كل مكالمة، لذا لا يحتفظ الاتصال بصلاحيات فقدتها.

لا يمكن إلا لمشرف أو مالك منح نطاق يكون أدنى دور فيه هو دور المشرف. كما لا يمكن إلا للمالك منح نطاق يكون أدنى دور فيه هو دور المالك.

الاتصال المحدود ببعض المشاريع لا يمكنه الوصول إلى أي شيء في مشاريع أخرى، حتى عبر معرف المهمة أو الخطة أو السباق أو التقرير أو الإصدار. كما لا يمكنه استخدام أدوات على مستوى المنظمة، مثل هذه: list_plans، get_capacity_dashboard.

أدوات#

تعرض قائمة العميل فقط الأدوات التي تم تفعيلها والتي تسمح بها نطاقاتك ودورك. يوضح عمود الموافقة ما يحدث عند استدعاء أداة ما:

قراءة#

تحتاج هذه الأدوات إلى دور المراجع ونطاق هذا: mcp.read. لا تحتاج أي منها إلى موافقة.

لمزيد من المعلومات عن أدوات الإصدارات، راجع إصدارات عبر بروتوكول MCP.

قواعد مكافحة الفوضى من محررك#

تسمح أداتا مكافحة الفوضى لوكيل المطور الخاص به بالالتزام بمعايير ضبط الجودة المطبقة على كل pull request، قبل وجود pull request.

• anti_slop_rules تُعيد النتيجة سياسة مكافحة الفوضى المنشورة للمشروع: القواعد والأجزاء التي تحظرها، والقواعد المخصصة، والقواعد المعزولة، واعتمادات Coroid الجديدة التي يمكنها البحث في السجلات العامة، بالإضافة إلى مقتطف لـ AGENTS.md الذي يوضح نفس القواعد لوكيل محلي. قم بلصق المقتطف في AGENTS.md، أو في قاعدة في .cursor/rules لبرنامج Cursor.
• anti_slop_scan تتحقق من فرع أو علامة أو التزام قام Coroid بمزامنته مع الفرع الأساسي، وهو الفرع الافتراضي ما لم تحدد فرعًا آخر. تقوم فقط بقراءة المحتوى؛ فهي لا تغير ملفات ولا تشغل أوامر ولا تثبت أي برامج ولا تستدعي نماذج. يقتصر عدد استدعاءاتها على 5 مرات في الدقيقة.

الفحص عبارة عن معاينة فقط. لا يزال ضبط الجودة يتحقق من pull request، وقراره هو الذي يُحتسب. راجع فحوصات مكافحة الفوضى.

إنشاء العمل وتغييره#

تحتاج هذه الأدوات إلى دور العضو ونطاق هذا: mcp.work.write.

العمل المنشأ عبر بروتوكول MCP لا يمر عبر مرحلة التأهيل. يصبح طلب بحجم خطة مُرسل إلى أداة المهام مسودة خطة بدلاً من مهمة. تبدأ الخطط المنشأة عبر بروتوكول MCP كمسودات.

تشغيل العمل#

تحتاج هذه الأدوات إلى دور العضو ونطاق هذا: mcp.execute.

التسليم#

تحتاج هذه الأدوات إلى دور العضو ونطاق هذا: mcp.delivery. توجد قسم خاص بإصدارات البرامج أدناه.

الإدارة#

تغيّر هذه الأدوات طريقة إعداد المنظمة ومشاريعها.

إعدادات المنظمة#

يمكن لوكيل مثل Hermes أن يقوم بتهيئة المؤسسة من لقطات شاشة أو ملفات أو وصف. يقرأ هذا الوكيل تنسيق إعدادات Coroid، ويكتب ما تم جمعه في حزمة، ثم يعرض معاينة للحزمة قبل تطبيقها. تتطلب هذه الأدوات دور مالك ونطاقًا كالتالي: mcp.organization.admin.

تحتوي الحزمة على مكانيات احتلال بدلًا من قيم سرية، ويرفض Coroid أي حزمة تحتوي على عنصر سري. انظر إلى تصدير واستيراد الإعدادات.

إصدارات عبر بروتوكول MCP#

أدوات الإصدار هي نفسها التي يستخدمها مساعد الدردشة، وتمر عبر عملية إصدار API نفسها كما في البوابة:

create_release تقبل رمز التزام كامل، أو رمز تزام مختصر لالتزام حديث، أو latest، وتترك تحديد الإصدار لمصدر الإصدار الخاص بالمشروع ما لم تحدده أنت. get_release تُبلغ، لكل بيئة، عن عمليات التحقق والنشر الأخير والإصدار الذي أبلغت عنه خطوة التنفيذ وما إذا كان Coroid قد تحقق من الإصدار الجاري. لا يمكن لرمز وصول محدود لبعض المشاريع الوصول إلى الإصدارات في مشاريع أخرى. ولا تزال عملية إصدار API تطبق قواعد الموافقة الخاصة بها، لذا فإن الموافقة عبر بروتوكول MCP تعتبر مساوية تمامًا للموافقة في البوابة.

list_release_pull_requests تُرجع طلبات السحب المفتوحة في المشروع بالترتيب الذي تقترحه Coroid، مع سبب استبعاد أي منها. bundle_release_pull_requests تنشئ إصدارًا منها: فرعًا للإصدار تُدمج فيه طلبات السحب بالترتيب، وpull request للإصدار واحدًا. تدفع بفرع وتفتح pull request، لذا فهي تنتظر دائمًا شخصًا. استثنِ prNumbers لاستخدام اختيار Coroid.

عمليات الموافقة وسياسات الأتمتة#

عمليات الموافقة هو قائمة انتظار للإجراءات التي تنتظر تدخلًا بشريًا. سياسات الأتمتة تحدد ما يجب أن يكون في تلك القائمة.

هذا هو الضابط المهم. يجب أن يكون العميل الخارجي الذي يتصرف نيابة عنك قادرًا على القيام بالمهام الروتينية بحرية، والمهام ذات العواقب الوخيمة فقط بعد موافقة شخص. حدد السياسات قبل منح رمز الوصول لأي عنصر يعمل بشكل تلقائي.

عندما يحتاج طلب ما إلى موافقة، يحصل العميل على معرف موافقة ورابط بدلًا من النتيجة. يقوم المالك أو المسؤول بمراجعة الأداة والوسائط المحددة بدقة، ثم يوافق على الطلب أو يرفضه. الموافقة تُنفذ الطلب بالضبط كما تم تقديمه، ولا يمكن للعميل تغييره بعد ذلك. وينتهي مفعول أي طلب لا يتم الموافقة عليه خلال 10 دقائق.

تسمح سياسة الأتمتة لرمز الوصول بتشغيل الأدوات المُصنّفة ضمن فئة 'سياسة' دون انتظار موافقة. يُنشئ المالكون السياسات ويربطونها برموز الوصول. تحدد السياسة الأدوات المحددة، ويمكن تقييدها لبعض المشاريع، وتحدد عدد المرات التي يمكن تشغيلها فيها في الساعة واليوم وفي نفس الوقت. كما يمكن أن تنتهي صلاحيتها. وإلغاء السياسة يعني إلغاء كل رمز وصول مرتبط بها. الأدوات المصنّفة ضمن فئة 'دائمًا' لا تخضع أبدًا لسياسة ما.

لا يمكن لاتصال OAuth أن يحمل سياسة. عبر بروتوكول OAuth، تنتظر كل أداة مصنّفة ضمن فئة 'سياسة' الموافقة.

عمليات إعادة المحاولة والعمليات والموارد#

كل أداة تغير شيئًا تتطلب هذه المعلمة: idempotencyKey. استخدم مفتاحًا جديدًا لكل إجراء جديد، ونفس المفتاح عند إعادة محاولة إجراء سابق. ستُرجع Coroid النتيجة الأولى بدلًا من تنفيذ الإجراء مرتين. يُرفض استخدام مفتاح مكرر مع وسائط مختلفة.

كما تُرجع أي تغيير عملية تسجل حالتها ونتائجها. تعمل هذه الأدوات الأربع مع كل اتصال:

كما يوفر الخادم هذه الموارد:

كما توفر ثلاثة أوامر: create_and_run_task، investigate_failure، prepare_release.

لكل أداة حدود لكل دقيقة وكل ساعة وكل يوم. يفشل أي طلب يتجاوز الحد ويوضح المدة التي يجب الانتظارها قبل إعادة المحاولة.

ما لا تكشفه عمدًا#

يخضع سجل الأدوات للتنظيم، والاستثناءات مقصودة. لا يوفر أيًا من ما يلي:

• محرر أوامر
• وصول إلى مستودع Git
• نظام الملفات
• وصول مباشر إلى قاعدة البيانات
• طلبات HTTP داخلية عشوائية
• أدوات إدارة بروتوكول MCP الصادرة عن Coroid نفسه

يمكنك الآن إدارة العمل — إنشاء وفحص المهام والخطط والمشاريع والإصدارات — وليس بيئة تنفيذ عن بُعد. لا يمكن لعميل بروتوكول MCP استخدام Coroid لتشغيل أوامر عشوائية.

لأي غرض يُستخدم؟#

تشغيل Coroid من الأداة التي تستخدمها بالفعل — سواء كان محررًا أو مساعدًا أو أداة داخلية — دون الحاجة إلى التبديل إلى البوابة. إنشاء مهمة من الطرفية، أو طلب مساعدك للتحقق من العوائق، يصبح إجراءً محليًا.

ذات صلة#

• طرق بدء العمل
• تصدير واستيراد الإعدادات
• خوادم MCP الخارجية
• مساعد الدردشة
• المنشأ