Coroid מציג שרת Model Context Protocol (MCP) מרוחק. עוזר חיצוני או סוכן, כגון Hermes, Codex או Claude Code, יכול להשתמש בו כדי לעבוד עם Coroid דרך אותו רישום כלים מנוהל שבו משתמש עוזר הצ'אט.
הגדר תחת הגדרות → חיבורים → Coroid MCP server, הכולל סקירה כללית, הגדרת לקוח, אסימוני גישה, אישורים ו־ מדיניות אוטומציה.
נקודת הקצה
שרת ה‑MCP פועל על שער API, בכתובת זו:
https://api.coroid.ai/mcpהתעבורה היא 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 ולא בקובץ התצורה שלו.
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 יכול לשלוח אסימון גישה כאסימון bearer בכותרת זו: 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 מקבל ערך SHA מלא של קומיט, ערך SHA קצר של קומיט недיין, או
latest, ומשאיר את הגרסה למקור הגרסה של הפרויקט אלא אם תציין אחת. get_release מדווח, לפי סביבה, על הבדיקות, הפריסה האחרונה, הגרסה שהפייפליין דיווח עליה והאם Coroid אישר את הגרסה הפועלת. אסימון המוגבל לפרויקטים מסוימים אינו יכול לגעת בגרסאות של פרויקטים אחרים. Release API עדיין מיישם את כללי האישור שלו, כך שאישור דרך MCP נספר בדיוק כמו אישור בפורטל.
list_release_pull_requests מחזיר את בקשות המשיכה הפתוחות של הפרויקט בסדר שהציע Coroid, יחד עם הסיבה לכל פריט שנשמט מהרשימה.
bundle_release_pull_requests יוצרת מהם גרסה: ענף גרסה
שבו ממוזגים ה-pull request-ים לפי הסדר, ו-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 מתוך הסביבה שבה אתם כבר עובדים – עורך טקסטים, עוזר וירטואלי או כלי פנימי – מבלי לעבור לפורטל. יצירת משימה מהטרמינל או בקשת עזרה מהעוזר לגבי משימות חסומות הופכת לפעולה מקומית.