📘 תיעוד 47

דחיפת אירועים לסשן פעיל באמצעות ערוצים

השתמש בערוצים כדי לדחוף הודעות, התראות ו-webhooks לתוך סשן ה-Claude Code שלך משרת MCP. העבר תוצאות CI, הודעות צ'אט ואירועי ניטור כדי ש-Claude יוכל להגיב בזמן שאינך ליד הטרמינל.

הערה: ערוצים נמצאים ב-תצוגה מקדימה למחקר (research preview). הם דורשים אימות של Anthropic דרך claude.ai או מפתח Console API, ואינם זמינים ב-Amazon Bedrock, ב-Google Cloud's Agent Platform או ב-Microsoft Foundry. ארגוני Team ו-Enterprise חייבים להפעיל אותם במפורש.

ערוץ הוא שרת MCP שדוחף אירועים לתוך סשן ה-Claude Code הפעיל שלך, כך ש-Claude יכול להגיב לדברים שקורים בזמן שאינך ליד הטרמינל. ערוצים יכולים להיות דו כיווניים: Claude קורא את האירוע ומשיב בחזרה דרך אותו ערוץ, כמו גשר צ'אט. אירועים מגיעים רק כאשר הסשן פתוח, לכן עבור הגדרה שפועלת תמיד אתה מריץ את Claude בתהליך רקע או בטרמינל עקבי (persistent terminal).

בניגוד לאינטגרציות שמייצרות סשן ענן חדש או ממתינות לביצוע תשאול (polling), האירוע מגיע לסשן שכבר פתוח אצלך: ראה השוואה בין ערוצים.

אתה מתקין ערוץ כתוסף (plugin) ומגדיר אותו עם פרטי האימות שלך. Telegram, Discord ו-iMessage כלולים בתצוגה המקדימה למחקר.

כאשר Claude משיב דרך ערוץ, אתה רואה את ההודעה הנכנסת בטרמינל שלך אך לא את טקסט התשובה. הטרמינל מציג את קריאת הכלי ואישור (כמו "sent"), והתשובה עצמה מופיעה בפלטפורמה השנייה.

אם אתה מנהל ארגון Team, Enterprise או Console, ראה הפעלת ערוצים עבור הארגון שלך. כדי לבנות ערוץ משלך, ראה את הפניית הערוצים (Channels reference).

#ערוצים נתמכים

כל ערוץ נתמך הוא תוסף שדורש את Bun. להדגמה מעשית של זרימת התוסף לפני חיבור פלטפורמה אמיתית, נסה את ההתחלה המהירה עם fakechat.

#Telegram

צפה בקוד המקור המלא של תוסף Telegram.

1. יצירת בוט ב-Telegram: פתח את BotFather ב-Telegram ושלח /newbot. תן לו שם תצוגה ושם משתמש ייחודי שמסתיים ב-bot. העתק את הטוקן ש-BotFather מחזיר.
2. התקנת התוסף: ב-Claude Code, הרץ:

/plugin install telegram@claude-plugins-official

אם ההתקנה נכשלת, התאם להודעה ש-Claude Code מדווח:

• Marketplace "claude-plugins-official" not found: הוסף את ה-marketplace באמצעות /plugin marketplace add anthropics/claude-plugins-official, ולאחר מכן נסה שוב את ההתקנה.
• התוסף לא נמצא ב-marketplace: בדוק את שם התוסף.

כאשר ההתקנה מבקשת טווח התקנה (installation scope), בחר באפשרות של טווח המשתמש (user scope) כך שהתוסף יהיה זמין בכל הפרויקטים שלך. בדוק את סיכום ההתקנה: אם מדווח בו Run /reload-plugins to activate., הרץ פקודה זו כדי להפעיל את פקודת ההגדרה של התוסף.

3. הגדרת הטוקן שלך: הרץ את פקודת ההגדרה עם הטוקן מ-BotFather:

/telegram:configure <token>

זה שומר אותו ב-~/.claude/channels/telegram/.env. אתה יכול גם להגדיר את TELEGRAM_BOT_TOKEN בסביבת ה-shell שלך לפני הפעלת Claude Code.

4. הפעלה מחדש עם ערוצים מופעלים: צא מ-Claude Code והפעל מחדש עם דגל הערוצים. פעולה זו מפעילה את תוסף Telegram, שמתחיל לבצע תשאול (polling) להודעות מהבוט שלך:

claude --channels plugin:telegram@claude-plugins-official

5. צימוד החשבון שלך: פתח את Telegram ושלח הודעה כלשהי לבוט שלך. הבוט משיב עם קוד צימוד.

הערה: אם הבוט שלך אינו מגיב, ודא ש-Claude Code רץ עם --channels מהשלב הקודם. הבוט יכול להשיב רק כאשר הערוץ פעיל.

בחזרה ב-Claude Code, הרץ:

/telegram:access pair <code>

לאחר מכן נעל את הגישה כך שרק החשבון שלך יוכל לשלוח הודעות:

/telegram:access policy allowlist

#Discord

צפה בקוד המקור המלא של תוסף Discord.

1. יצירת בוט ב-Discord: עבור אל Discord Developer Portal, לחץ על New Application, ותן לו שם. בחלק Bot, צור שם משתמש, לאחר מכן לחץ על Reset Token והעתק את הטוקן.
2. הפעלת Message Content Intent: בהגדרות הבוט שלך, גלול אל Privileged Gateway Intents והפעל את Message Content Intent.
3. הזמנת הבוט לשרת שלך: עבור אל OAuth2 > URL Generator. בחר בטווח bot והפעל את ההרשאות הבאות:

• View Channels
• Send Messages
• Send Messages in Threads
• Read Message History
• Attach Files
• Add Reactions

פתח את ה-URL שנוצר כדי להוסיף את הבוט לשרת שלך.

4. התקנת התוסף: ב-Claude Code, הרץ:

/plugin install discord@claude-plugins-official

אם ההתקנה נכשלת, התאם להודעה ש-Claude Code מדווח:

• Marketplace "claude-plugins-official" not found: הוסף את ה-marketplace באמצעות /plugin marketplace add anthropics/claude-plugins-official, ולאחר מכן נסה שוב את ההתקנה.
• התוסף לא נמצא ב-marketplace: בדוק את שם התוסף.

כאשר ההתקנה מבקשת טווח התקנה, בחר באפשרות של טווח המשתמש (user scope) כך שהתוסף יהיה זמין בכל הפרויקטים שלך. בדוק את סיכום ההתקנה: אם מדווח בו Run /reload-plugins to activate., הרץ פקודה זו כדי להפעיל את פקודת ההגדרה של התוסף.

5. הגדרת הטוקן שלך: הרץ את פקודת ההגדרה עם טוקן הבוט שהעתקת:

/discord:configure <token>

זה שומר אותו ב-~/.claude/channels/discord/.env. אתה יכול גם להגדיר את DISCORD_BOT_TOKEN בסביבת ה-shell שלך לפני הפעלת Claude Code.

6. הפעלה מחדש עם ערוצים מופעלים: צא מ-Claude Code והפעל מחדש עם דגל הערוצים. פעולה זו מחברת את תוסף Discord כך שהבוט שלך יוכל לקבל הודעות ולהשיב להן:

claude --channels plugin:discord@claude-plugins-official

7. צימוד החשבון שלך: שלח הודעה ישירה (DM) לבוט שלך ב-Discord. הבוט משיב עם קוד צימוד.

הערה: אם הבוט שלך אינו מגיב, ודא ש-Claude Code רץ עם --channels מהשלב הקודם. הבוט יכול להשיב רק כאשר הערוץ פעיל.

בחזרה ב-Claude Code, הרץ:

/discord:access pair <code>

לאחר מכן נעל את הגישה כך שרק החשבון שלך יוכל לשלוח הודעות:

/discord:access policy allowlist

#iMessage

צפה בקוד המקור המלא של תוסף iMessage.

ערוץ iMessage קורא את מסד הנתונים של Messages ישירות ושולח תשובות דרך AppleScript. הוא דורש macOS ואינו מצריך טוקן בוט או שירות חיצוני.

1. הענקת גישה מלאה לדיסק (Full Disk Access): מסד הנתונים של Messages בנתיב ~/Library/Messages/chat.db מוגן על ידי macOS. בפעם הראשונה שהשרת קורא אותו, macOS מציג בקשת גישה: לחץ על Allow. הבקשה מציינת את היישום שהפעיל את Bun, כגון Terminal, iTerm או ה-IDE שלך.

אם הבקשה אינה מופיעה או שלחצת על Don't Allow, הענק גישה באופן ידני תחת System Settings > Privacy & Security > Full Disk Access והוסף את הטרמינל שלך. ללא פעולה זו, השרת יוצא מיד עם authorization denied.

2. התקנת התוסף: ב-Claude Code, הרץ:

/plugin install imessage@claude-plugins-official

אם ההתקנה נכשלת, התאם להודעה ש-Claude Code מדווח:

• Marketplace "claude-plugins-official" not found: הוסף את ה-marketplace באמצעות /plugin marketplace add anthropics/claude-plugins-official, ולאחר מכן נסה שוב את ההתקנה.
• התוסף לא נמצא ב-marketplace: בדוק את שם התוסף.

כאשר ההתקנה מבקשת טווח התקנה, בחר באפשרות של טווח המשתמש (user scope) כך שהתוסף יהיה זמין בכל הפרויקטים שלך. אם סיכום ההתקנה מדווח Run /reload-plugins to activate., אתה יכול לדלג על כך כאן, מכיוון שההפעלה מחדש בשלב הבא תטען את התוסף.

3. הפעלה מחדש עם ערוצים מופעלים: צא מ-Claude Code והפעל מחדש עם דגל הערוצים:

claude --channels plugin:imessage@claude-plugins-official

4. שליחת הודעה לעצמך: פתח את Messages בכל מכשיר שמחובר ל-Apple ID שלך ושלח הודעה לעצמך. היא מגיעה ל-Claude מיד: צ'אט עצמי עוקף את בקרת הגישה ללא צורך בהגדרה.

הערה: התשובה הראשונה ש-Claude שולח מפעילה בקשת Automation של macOS ששואלת האם הטרמינל שלך יכול לשלוט ב-Messages. לחץ על OK.

5. התרת שולחים אחרים: כברירת מחדל, רק ההודעות שלך מועברות. כדי לאפשר לאיש קשר אחר לתקשר עם Claude, הוסף את המזהה שלו:

/imessage:access allow +15551234567

מזהים הם מספרי טלפון בפורמט +country או כתובות אימייל של Apple ID כמו [email protected].

#התחלה מהירה

Fakechat הוא ערוץ הדגמה נתמך רשמית שמריץ ממשק משתמש של צ'אט ב-localhost, ללא צורך באימות וללא שירות חיצוני להגדרה.

לאחר שתתקין ותפעיל את fakechat, תוכל להקליד בדפדפן וההודעה תגיע לסשן ה-Claude Code שלך. Claude משיב, והתשובה מופיעה בחזרה בדפדפן. לאחר שתבדוק את ממשק fakechat, נסה את Telegram, Discord, או iMessage.

כדי לנסות את הדגמת fakechat, תצטרך:

• Claude Code מותקן ומאומת עם חשבון claude.ai או מפתח Claude Console API
• Bun מותקן. תוספי הערוצים המובנים מראש הם סקריפטים של Bun. בדוק באמצעות bun --version; אם זה נכשל, התקן את Bun.
• ארגון Team, Enterprise או Console מנוהל: מנהל המערכת שלך חייב להפעיל ערוצים בהגדרות המנוהלות

1. התקנת תוסף ערוץ fakechat: התחל סשן של Claude Code והרץ את פקודת ההתקנה:

/plugin install fakechat@claude-plugins-official

אם ההתקנה נכשלת, התאם להודעה ש-Claude Code מדווח:

• Marketplace "claude-plugins-official" not found: הוסף את ה-marketplace באמצעות /plugin marketplace add anthropics/claude-plugins-official, ולאחר מכן נסה שוב את ההתקנה.
• התוסף לא נמצא ב-marketplace: בדוק את שם התוסף.

כאשר ההתקנה מבקשת טווח התקנה, בחר באפשרות של טווח המשתמש (user scope) כך שהתוסף יהיה זמין בכל הפרויקטים שלך. אם סיכום ההתקנה מדווח Run /reload-plugins to activate., אתה יכול לדלג על כך כאן, מכיוון שההפעלה מחדש בשלב הבא תטען את התוסף.

2. הפעלה מחדש עם הערוץ מופעל: צא מ-Claude Code, ולאחר מכן הפעל מחדש עם --channels והעבר את תוסף fakechat שהתקנת:

claude --channels plugin:fakechat@claude-plugins-official

שרת fakechat מופעל אוטומטית. מסך ההפעלה מציג הודעת ערוצים המציינת שהודעות מ-plugin:fakechat@claude-plugins-official מוזרקות ישירות לתוך סשן זה. אם התוסף אינו מותקן או אינו ברשימת המורשים המאושרת, שורת אזהרה המציינת את הבעיה תופיע מתחת להודעה זו.

טיפ: ניתן להעביר מספר תוספים אל --channels, מופרדים ברווח.

3. דחיפת הודעה פנימה: פתח את ממשק fakechat בכתובת http://localhost:8787 והקלד הודעה:

what's in my working directory?

ההודעה מגיעה לסשן ה-Claude Code שלך. הטרמינל מציג אותה כשורה של ערוץ נכנס כמו ← fakechat · web: what's in my working directory?, בעוד שהמודל מקבל אותה כאירוע <channel source="plugin:fakechat:fakechat">, תוך שימוש בשם השרת התחום (scoped) של התוסף. Claude קורא אותה, מבצע את העבודה וקורא לכלי ה-reply של fakechat. אם Claude Code מבקש הרשאה עבור התשובה הראשונה, אשר אותה. התשובה מופיעה בממשק הצ'אט.

אם Claude נתקל בבקשת הרשאה בזמן שאינך ליד הטרמינל, הסשן מושהה עד שתגיב. שרתי ערוצים שמצהירים על יכולת העברת הרשאות (permission relay) יכולים להעביר בקשות אלו אליך כדי שתוכל לאשר או לדחות מרחוק. לשימוש ללא השגחה, --dangerously-skip-permissions עוקף את רוב הבקשות, אך השתמש בו רק בסביבות שאתה סומך עליהן. גם אז, הפעולות שאינן מאושרות אוטומטית באף מצב עדיין חלות.

כאשר אתה מריץ ערוצים במצב לא אינטראקטיבי עם -p, כלים הזקוקים לקלט מהטרמינל, כגון שאלות רב ברירה ואישור מצב תוכנית (plan mode), מושבתים כך שהסשן לעולם אינו נתקע בהמתנה לקלט.

#אבטחה

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

Telegram ו-Discord מאתחלים את הרשימה באמצעות צימוד:

1. מצא את הבוט שלך ב-Telegram או ב-Discord ושלח לו הודעה כלשהי
2. הבוט משיב עם קוד צימוד
3. בסשן ה-Claude Code שלך, אשר את הקוד כאשר תוצג הבקשה
4. מזהה השולח שלך מתווסף לרשימת המורשים

iMessage עובד אחרת: שליחת הודעה לעצמך עוקפת את המחסום באופן אוטומטי, ואתה מוסיף אנשי קשר אחרים לפי מזהה באמצעות /imessage:access allow.

נוסף על כך, אתה שולט באילו שרתים מופעלים בכל סשן באמצעות --channels, והארגון שלך שולט בזמינות באמצעות channelsEnabled בתוכניות Team ו-Enterprise של claude.ai ובארגוני Console שפורסים הגדרות מנוהלות.

הימצאות ב-.mcp.json אינה מספיקה כדי לדחוף הודעות: השרת חייב להיות מצוין גם ב---channels.

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

#בקרות ארגוניות

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

• claude.ai Team ו-Enterprise: ערוצים חסומים עד שבעלים (Owner) מפעיל אותם.
• Anthropic Console עם אימות מפתח API: ערוצים מורשים כברירת מחדל. אתה זקוק להגדרה זו רק אם הארגון שלך פורס הגדרות מנוהלות.

בכל המקרים, אף ערוץ אינו פועל עד שמשתמש בוחר להפעיל אותו עבור הסשן באמצעות --channels.

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

#הפעלת ערוצים עבור הארגון שלך

הפעל ערוצים עבור הארגון שלך מתוך claude.ai > Admin settings > Claude Code > Channels, דבר הדורש תפקיד Owner, או על ידי הגדרת channelsEnabled כ-true בהגדרות המנוהלות.

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

#הגבלת תוספי הערוצים שיכולים לרוץ

כברירת מחדל, כל תוסף ברשימת המורשים המתוחזקת על ידי Anthropic יכול להירשם כערוץ. מנהלי מערכת בתוכניות Team ו-Enterprise יכולים להחליף את רשימת המורשים הזו ברשימה משלהם על ידי הגדרת allowedChannelPlugins בהגדרות המנוהלות. השתמש בזה כדי להגביל אילו תוספים רשמיים מורשים, לאשר ערוצים מה-marketplace הפנימי שלך, או שניהם. כל רשומה מציינת תוסף ואת ה-marketplace שממנו הוא מגיע:

{
  "channelsEnabled": true,
  "allowedChannelPlugins": [
    { "marketplace": "claude-plugins-official", "plugin": "telegram" },
    { "marketplace": "claude-plugins-official", "plugin": "discord" },
    { "marketplace": "acme-corp-plugins", "plugin": "internal-alerts" }
  ]
}

אם תגדיר מערך ריק, תחסום את כל תוספי הערוצים מרשימת המורשים, אך --dangerously-load-development-channels עדיין יוכל לעקוף חסימה זו עבור בדיקות מקומיות. כדי לחסום ערוצים לחלוטין כולל את דגל הפיתוח, השאר במקום זאת את channelsEnabled לא מוגדר.

הגדרה זו דורשת channelsEnabled: true. אם משתמש מעביר תוסף אל --channels שאינו ברשימה שלך, Claude Code מופעל כרגיל אך הערוץ אינו נרשם, והודעת ההפעלה מסבירה שהתוסף אינו ברשימה המאושרת של הארגון. אם תגדיר את MCP_PROTOCOL_NEGOTIATION ל-auto בסביבת הריצה של לקוח MCP בגרסה 2, ערוץ עלול להיכשל ברישום גם מכיוון ש-Claude Code אינו רושם שרת ערוץ שמנהל משא ומתן על גרסת פרוטוקול 2026-07-28.

#תצוגה מקדימה למחקר

ערוצים הם תכונה בתצוגה מקדימה למחקר (research preview). הזמינות נפרסת בהדרגה, ותחביר הדגל --channels וחוזה הפרוטוקול עשויים להשתנות בהתבסס על משוב.

לא --channels ולא --dangerously-load-development-channels מופיעים ב-claude --help בזמן שהתכונה נמצאת בתצוגה מקדימה. הדגלים פועלים אף על פי שאינם רשומים.

במהלך התצוגה המקדימה, --channels מקבל רק תוספים מרשימת מורשים המתוחזקת על ידי Anthropic, או מרשימת המורשים של הארגון שלך אם מנהל מערכת הגדיר את allowedChannelPlugins. תוספי הערוצים ב-claude-plugins-official הם קבוצת ברירת המחדל המאושרת. אם תעביר משהו שאינו ברשימת המורשים התקפה, Claude Code יופעל כרגיל אך הערוץ לא יירשם, והודעת ההפעלה תסביר מדוע.

כדי לבדוק ערוץ שאתה בונה, השתמש ב---dangerously-load-development-channels. ראה בדיקה במהלך התצוגה המקדימה למחקר למידע על בדיקת ערוצים מותאמים אישית שאתה בונה.

דווח על בעיות או משוב ב-מאגר ה-GitHub של Claude Code.

#השוואה בין ערוצים

מספר תכונות של Claude Code מתחברות למערכות מחוץ לטרמינל, כאשר כל אחת מהן מתאימה לסוג עבודה שונה:

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

• גשר צ'אט (Chat bridge): שאל את Claude משהו מהטלפון שלך דרך Telegram, Discord, או iMessage, והתשובה תחזור באותו צ'אט בעוד שהעבודה רצה במחשב שלך מול הקבצים האמיתיים שלך.
• מקלט Webhook (Webhook receiver): הודעת webhook מ-CI, ממערכת מעקב השגיאות שלך, מתהליך פריסה (deploy pipeline), או משירות חיצוני אחר מגיעה למקום שבו ל-Claude כבר יש את הקבצים שלך פתוחים והוא זוכר מה ניפית.

#השלבים הבאים

לאחר שיש לך ערוץ שפועל, חקור את התכונות הקשורות הבאות:

• בנה ערוץ משלך עבור מערכות שעדיין אין להן תוספים
• שלט רחוק (Remote Control) כדי לנהל סשן מקומי מהטלפון שלך במקום להעביר אירועים לתוכו
• משימות מתוזמנות (Scheduled tasks) כדי לבצע תשאול (poll) לפי טיימר במקום להגיב לאירועים שנדחפים