Coroid כשרת MCP

Coroid חושף שרת Model Context Protocol (MCP) מרוחק. עוזר חיצוני או סוכן, כגון Hermes, Codex, Claude Code או Cursor, יכול להשתמש בו כדי לעבוד עם Coroid דרך אותו רישום כלים מנוהל שהעוזר הצ'אט משתמש בו.

הגדירו תחת הגדרות → חיבורים → Coroid MCP server, המכסה על סקירה כללית, הגדרת לקוח, אסימוני גישה, אישורים ו מדיניות אוטומציה.

נקודת הקצה#

שרת ה-MCP פועל על שער API, בכתובת זו:

https://api.coroid.ai/mcp

התעבורה היא 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 מרוחקים דרך 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#

כלי השחרור הם אותם כלים שהמעוזר השיחתי משתמש בהם, והם עוברים דרך אותו Release API כמו הפורטל:

create_release מקבל SHA של קובץ מחויב שלם, SHA קצר של קובץ מחויב недרי, או latest, ומשאיר את הגרסה למקור הגרסה של הפרויקט אלא אם תציין אחרת. get_release מדווח, לפי סביבה, על הבדיקות, הפריסה האחרונה, הגרסה שהפייפליין דיווח עליה והאם Coroid אישר את הגרסה הפועלת. טוקן המוגבל לפרויקטים מסוימים לא יכול להגיע לשחרורים בפרויקטים אחרים. Release API עדיין מיישם את כללי האישור שלו, כך שאישור דרך MCP נחשב בדיוק כמו אישור בפורטל.

list_release_pull_requests מחזיר את Pull Requests הפתוחים של הפרויקט בסדר ש־Coroid מציע, עם הסיבה לכל אחד שהוא ישאיר בחוץ. bundle_release_pull_requests יוצר מהן גרסה: ענף גרסה שבו ממוזגים ה־pull requests לפי הסדר ו־pull request של הגרסה אחד. הוא דוחף ענף ופותח pull request, ולכן הוא תמיד ממתין לאדם. יש להשאיר מחוץ prNumbers כדי להשתמש בבחירה של Coroid.

אישורים ומדיניות אוטומציה#

אישורים הוא תור של פעולות הממתינות לאדם. מדיניות אוטומציה מחליט מה צריך להיות בתור הזה.

זהו הבקרה החשובה. לקוח חיצוני הפועל בשמך צריך להיות מסוגל לבצע פעולות שגרתיות בחופשיות ופעולות משמעותיות רק באישור אדם. הגדר את המדיניות לפני שתיתן טוקן לכל דבר שרץ באופן אוטומטי.

כאשר קריאה זקוקה לאישור, הלקוח מקבל מזהה אישור וקישור במקום תוצאה. בעלים או מנהל בודקים את הכלי והארגומנטים המדויקים, ואז מאשרים או דוחים את הקריאה. אישור מפעיל את הקריאה בדיוק כפי שהיא נעשתה, והלקוח לא יכול לשנות אותה לאחר מכן. קריאה שאיש לא מאשר בתוך 10 דקות פוקעת.

מדיניות אוטומציה מאפשרת לטוקן גישה להפעיל כלים המסומנים כ־Policy ללא המתנה לאישור. רק בעלים יכולים ליצור מדיניות ולצרף אותה לטוקנים. מדיניות מציינת את הכלים המדויקים, יכולה להיות מוגבלת לפרויקטים מסוימים, וקובעת כמה קריאות יתבצעו בשעה, ביום ובבת אחת. היא יכולה גם לפוג. ביטול מדיניות מבטל כל טוקן המחובר אליה. כלים המסומנים כ־Always לעולם אינם נכללים במדיניות.

חיבור OAuth אינו יכול לשאת מדיניות. דרך OAuth, כל כלי המסומן כ־Policy ממתין לאישור.

ניסיונות חוזרים, פעולות ומשאבים#

כל כלי המשנה דבר מה דורש את הפרמטר הזה: idempotencyKey. השתמש במפתח חדש לכל פעולה חדשה, ואותו מפתח כשאתה מנסה שוב. Coroid אז מחזיר את התוצאה הראשונה במקום לפעול פעמיים. מפתח שנעשה בו שימוש חוזר עם ארגומנטים שונים נדחה.

שינוי גם מחזיר פעולה המתעדת את הסטטוס והתוצאה שלו. ארבעת הכלים האלה פועלים עבור כל חיבור:

השרת מספק גם את המשאבים האלה:

הוא גם מציע שלושה קריאות: create_and_run_task, investigate_failure, prepare_release.

לכל כלי יש מגבלות לדקה, לשעה וליום. קריאה החורגת מהמגבלה נכשלת ומציינת כמה זמן לחכות לפני ניסיון חוזר.

מה שהוא בכוונה אינו חושף#

מרשם הכלים מנוהל, וההחרמות הן מכוונות. הוא אינו מספק אף אחד מהבאים:

• מעטפת פקודות
• גישה ל־Git
• מערכת הקבצים
• גישה גולמית לבסיס נתונים
• HTTP פנימי שרירותי
• כלי הניהול החיצוניים של MCP של Coroid

אתם מקבלים את היכולת לנהל עבודה — יצירה ובדיקה של משימות, תוכניות, פרויקטים וגרסאות — זה אינו סביבת ביצוע מרחוק. לקוח MCP אינו יכול להשתמש ב־Coroid כדי להריץ פקודות שרירותיות.

לאילו מטרות זה מתאים?#

הפעלת Coroid ממקום העבודה הקיים שלכם — עורך קוד, עוזר וירטואלי, כלי פנימי — ללא צורך לעבור לפורטל. יצירת משימה מהטרמינל, או בקשת מעוזר וירטואלי לבדוק מה חוסם את התקדמות העבודה, הן פעולות מקומיות.

קשור לכך#

• דרכים להתחיל לעבוד
• ייבוא והוצאה של הגדרות
• שרתי MCP חיצוניים
• עוזר צ'אט
• מקור