קריאות כלים של Rex והתחברות עם Slack
Rex, הסוכן של Zaprex, משתמש באפליקציות המחוברות שלכם: הוא קורא לכלי ה-MCP שלהן, מציג כל קריאה בצ'אט ושואל לפני כל דבר שהוא שולח. Sign in with Slack מאפשר ל-Rex לשלוח הודעות ישירות ולפרסם בערוצים, עם Approve, Edit או Cancel על כל הודעה.


הפעלת Slack
Slack כבוי עד שמפעילים אותו. כל אחת מהדרכים האלה מפעילה אותו, באפליקציות Zaprex לרשת, למחשב ולטלפון:
- בצ'אט: הזכירו את Slack או בקשו מ-Rex לכתוב למישהו (פרסם את הערות הגרסה ב-Slack, DM @ana that the build is green). מתחת לתשובה מופיעה שורה עם Turn on Slack ו-×. Turn on Slack מפעיל אותו ופותח את Sign in with Slack. **×** מסתיר אותה לתמיד.
- סרגל הכלים: הלוגו של Slack ליד הדמות של Rex. כשהוא כבוי, לחיצה אחת מפעילה את Slack ומתחילה את ההתחברות.
- הגדרות › Features: ל-Slack (Connected apps) יש מתג הפעלה ו-Turn on and sign in.
- לוח הפקודות: ⌘K (Ctrl+K), ואז Connect Slack.
הפעלת Slack מפעילה גם את Connect apps; כיבוי Connect apps מכבה את Slack. כדי להפסיק הצעות בצ'אט לכל התכונות וההרחבות, כבו את Suggest extensions in chat בהגדרות.




התחברות עם Slack
Sign in with Slack פותח את הדף של Slack עצמו, שבו בוחרים את סביבת העבודה ומאשרים את Rex. Rex מבקש את ההרשאות האלה, גם לבוט וגם לכם: chat:write, im:write, channels:read ו-users:read.
כשחוזרים, Connect apps נפתח על Slack עם סביבת העבודה שהתחברתם אליה והכלים שלה: שליחת הודעה מסומנת asks first, וכלי הרשימות reads. הטוקנים נשמרים מוצפנים בשרת ולא נשלחים לאפליקציה. באפליקציות למחשב ולטלפון ההתחברות נפתחת בדפדפן וחוזרת לאפליקציה דרך zaprex://app?connect=apps&signed_in=slack.
Sign in again מחדש את ההתחברות, ו-Disconnect מוחק את הטוקנים.


אישור, עריכה או ביטול
כל מה ששולח, מפרסם, יוצר או מוחק מחכה לכם. הכרטיס מציג:
- To: בדיוק למי זה הולך, כמו
@anaאו#releases. - Message: הטקסט המדויק.
- Approve (Enter) שולח פעם אחת. Rex ישאל שוב בפעם הבאה.
- Edit משנה את הנמען ואת הטקסט (או, בכלים אחרים, את הארגומנטים כ-JSON), ואז Send edited.
- Cancel (Esc) לא שולח כלום, ו-Rex אומר את זה בצ'אט.


אחר כך כל קריאה מופיעה בצ'אט ככרטיס עם הלוגו של האפליקציה, הכלי, הארגומנטים שלו והתוצאה.


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


כלים לקריאה בלבד
כלים שרק קוראים (רשימת ערוצים, חיפוש אנשים, קריאת issue) רצים בלי לשאול כברירת מחדל. כדי לאשר גם אותם, כבו את Run read-only app tools without asking תחת הגדרות › Features › MCP servers (Connect apps). פעולות כתיבה תמיד שואלות, לא משנה מה ההגדרה.
אפליקציות אחרות ושרתי MCP משלכם
כל שרת MCP מחובר עובד אותו דבר: Rex רואה את הכלים שלו ואת ההוראות שלכם, קורא להם ושואל לפני כל כתיבה. ב-Connect apps, **+ Add custom MCP** מוסיף שרת לפי כתובת (Streamable HTTP או HTTP + SSE) בלי התחברות, עם טוקן, header משלכם או התחברות OAuth, או כפקודה מקומית (stdio) בשרתים באירוח עצמי. Test connection מציג את מספר הכלים, או סיבה ברורה, לפני השמירה.


בטלפון
כרטיס האישור נכנס במסך, ו-Approve, Edit ו-Cancel במרחק נגיעה. Sign in with Slack נפתח בחלון הדפדפן של המערכת ונסגר לבד כשחוזרים.


מגבלות
אישור אחד לכל כתיבה: Rex אף פעם לא זוכר "לאשר תמיד" לשליחה. עד 5 קריאות כלים בהרצה; כל אחת מחכה עד 30 שניות, ו-Rex שומר את 4,000 התווים הראשונים של התוצאה. שרתי פקודה מקומית (stdio) רצים רק בשרתי Zaprex באירוח עצמי שמפעילים אותם.
הגדרות
| הגדרה | ברירת מחדל | מה היא עושה |
|---|---|---|
| Slack (Connected apps) | כבוי | מציג את כפתור Slack בסרגל הכלים ומאפשר Sign in with Slack. ההפעלה מפעילה גם את Connect apps. |
| Run read-only app tools without asking | מופעל | כלים לקריאה בלבד רצים מיד; כשכבוי, גם הם שואלים. כל מה שכותב תמיד שואל. |
| Suggest extensions in chat | מופעל | מציג את ההצעה בשורה אחת (Turn on Slack) כשהודעה מזכירה את Slack או שליחת הודעה למישהו. הצעה שנסגרה לא חוזרת. |
שרתים באירוח עצמי מגדירים את משתני הסביבה האלה: SLACK_CLIENT_ID ו-SLACK_CLIENT_SECRET (אפליקציית Slack שלכם; בלעדיהם Sign in with Slack אומר שהוא לא מוגדר), SLACK_MCP_URL (שרת ה-MCP של Slack ש-Rex קורא לו), BOT_MCP_STDIO=on (מאפשר שרתי פקודה מקומית) ו-BOT_MCP_ALLOW_PRIVATE=on (מאפשר כתובות פרטיות ו-localhost, לפיתוח בלבד).
ההגדרות האלה מופיעות גם במדריך ההגדרות.
למפתחים
POST /api/bot/chat מתחיל הרצה שיכולה לקרוא לכלים. GET /api/bot/approvals מציג את האישורים; לאישור של קריאת כלי יש call עם השרת, הכלי, הארגומנטים, recipient ו-text. POST /api/bot/approvals/:id מקבל decision וגם args כדי לשלוח קריאה ערוכה. Sign in with Slack: GET /api/bot/slack/status ו-POST /api/bot/slack/connect; OAuth חוזר דרך /api/bot/oauth/callback. בדקו שרת לפני שמירה עם POST /api/bot/mcp/servers/test. ראו API › קריאות כלים של Rex.
פתרון בעיות
- Sign in with Slack isn't set up: לשרת Zaprex עדיין אין אפליקציית Slack. מנהל מוסיף
SLACK_CLIENT_IDו-SLACK_CLIENT_SECRET. - You cancelled the sign-in: לחצו שוב Sign in with Slack ואשרו את Rex.
- **
channel_not_found: הערוץ או האדם לא קיימים, או ש-Rex לא נמצא בערוץ. Edit** את הנמען ושלחו שוב. - Rex ענה במקום לשלוח: כתבו למי לשלוח ומה, למשל DM @ana on Slack: the build is green.
Beta קריאות כלים ו-Sign in with Slack נמצאים בבטא. ספרו לנו באילו אפליקציות Rex צריך להשתמש בהמשך בדף התמיכה.
ראו גם Rex tool calls בתיעוד של Zaprex ו-Slack עבור Ingot IDE.