שַׁגֵּר בתוך Claude Desktop: מה עובד היום עם מחבר מותאם, ומה עושים אם אין כותרות

באפליקציית Claude Desktop מחברים את שַׁגֵּר כמחבר מותאם (custom connector): נכנסים לתפריט Customize ואז Connectors, מוסיפים מחבר עם הכתובת https://app.shager.ai/api/mcp, בוחרים באפשרות ללא התחברות, ומוסיפים תחת Request headers את הכותרת Authorization עם הערך Bearer ואחריו מפתח API. הבעיה היא שלפי התיעוד של Anthropic, אימות בכותרות נמצא כרגע בבטא וזמין רק לחלק מהארגונים. אם אצלכם אין את האזור הזה בחלון ההוספה, היום אין דרך רשמית לחבר את שַׁגֵּר דרך הממשק של Desktop, והמסלול העובד הוא Claude Code או קוד שמדבר עם ממשק API.

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

איך Claude Desktop מתחבר לשרתים מרוחקים?

הנקודה הראשונה שחשוב להבין: שרת MCP מרוחק כמו של שַׁגֵּר לא מוגדר באפליקציית Claude Desktop דרך קובץ על המחשב, אלא כמחבר בחשבון Claude שלכם. ההנחיות של Anthropic במדריך המחברים המותאמים מבחינות בין שני מנגנונים נפרדים. שרתים מקומיים מוגדרים בקובץ claude_desktop_config.json ורצים על המחשב. מחברים מרוחקים מוגדרים בהגדרות החשבון, והמודל Claude מתחבר אליהם מהתשתית בענן של Anthropic ולא מהמכשיר שלכם.

יש לזה שתי השלכות מעשיות. הראשונה היא שמחבר שהוספתם זמין גם באתר claude.ai בדפדפן, לא רק באפליקציה. השנייה היא שהשרת חייב להיות נגיש מהאינטרנט, וזה המצב אצל שַׁגֵּר, כך שאין צורך במנהרות או בהגדרות רשת.

הוספת שַׁגֵּר כמחבר מותאם, צעד אחר צעד

התהליך מתועד בעמוד Add a connector that isn't in the directory. בחשבון אישי (Free, Pro או Max) הוא נראה כך:

1. נכנסים לתפריט Customize ואז Connectors ולוחצים על Add custom connector.
2. בשדה הכתובת מזינים https://app.shager.ai/api/mcp.
3. באימות בוחרים No sign-in. התיעוד אומר במפורש שאם השרת עובד עם מפתח API, זו האפשרות הנכונה, והמפתח עצמו נכנס תחת Request headers.
4. פותחים את Request headers, בוחרים את שם הכותרת authorization מהרשימה, ובערך מזינים Bearer shgr_live_XXXXXXXX כולל המילה Bearer והרווח.
5. מסמנים את הכותרת כשדה Required ולוחצים Add.

הסעיף הרביעי הוא המקום שבו רוב הטעויות קורות. Claude שולח את הערך בדיוק כמו שהזנתם אותו ולא מוסיף לפניו כלום. אם תזינו רק את המפתח, השרת של שַׁגֵּר יקבל כותרת בלי Bearer ויחזיר 401.

בחשבון Team או Enterprise רק Owner מוסיף מחבר מותאם, דרך Organization settings ואז Connectors, וחברי הצוות מתחברים אליו אחר כך. כאן יש מלכודת: כותרות מתאימות לאישור משותף אחד לכל הארגון. אם תגדירו את שַׁגֵּר ברמת הארגון עם מפתח אחד, כל הצוות יעבוד דרך אותו מפתח, וביומן הביקורת של שַׁגֵּר כל הפעולות ייראו כאילו בוצעו על ידי אותו סוכן. לסוכנות שרוצה לדעת מי עשה מה, זו לא תמיד הבחירה הנכונה.

מה אם אין לי Request headers?

התיעוד של Anthropic ברור: אם האזור Request headers לא מופיע בחלון ההוספה, לארגון שלכם עוד אין גישה לפיצ'ר. אין עקיפה בממשק. אפשר להוסיף את שַׁגֵּר כמחבר בלי כותרת, אבל אז כל קריאה תיכשל על אימות.

מה כן אפשר לעשות היום:

1. לעבוד עם Claude Code. הוא תומך בכותרות מותאמות בפקודה אחת, והוא מתאים במיוחד לעבודה שגרתית של הפצה. ההגדרה המלאה נמצאת במדריך לחיבור שַׁגֵּר אל Claude Code.
2. לעבוד עם ממשק REST API מקוד. סקריפט קטן שמושך משימות מגיליון ושולח טיוטות לְשַׁגֵּר, כשהטקסטים נכתבים על ידי Claude דרך ממשק API של Anthropic. נקודת ההתחלה היא המדריך המהיר לממשק REST API.
3. לחכות להתחברות OAuth של שַׁגֵּר. התחברות OAuth לשרת MCP נמצאת בפיתוח. כשהיא תעלה, ההוספה באפליקציית Desktop תהיה כמו בכל מחבר אחר: כתובת, כניסה, אישור.

ומה עם גשרים מקומיים?

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

הגדרות בטיחות ששוות דקה

גם כשהחיבור עובד, Claude Desktop הוא סביבה שיחתית. אנשים מבקשים דברים בשפה חופשית, ולפעמים מבקשים יותר ממה שהתכוונו. שלוש הגדרות שאני ממליץ עליהן לכל מי שמחבר את שַׁגֵּר:

1. מפתח בלי publish בהתחלה. כך הסוכן יכול לקרוא חשבונות וליצור טיוטות, אבל לא לתזמן. בְּשַׁגֵּר יוצרים ומבטלים מפתחות בכתובת https://app.shager.ai/dashboard/agents.
2. חסימת כלים ספציפיים. התיעוד של Anthropic מאפשר לבחור מחבר בתפריט Customize ואז Connectors ולסמן כלי מסוים במצב Blocked. אם המפתח כן כולל publish אבל אתם רוצים שבצ'אט הסוכן רק יכין טיוטות, חסמו את schedule_post ואת cancel_post ברמת המחבר.
3. כיבוי המחבר כשלא צריך אותו. דרך כפתור ה + בצ'אט אפשר להפעיל או לכבות מחברים לשיחה בודדת. שיחה על נושא אחר לא צריכה גישה לארבעים עמודים של לקוח.

עוד פרט שכדאי לזכור: אחרי שמוסיפים מחבר, אי אפשר לערוך את הגדרות האימות שלו. כשמחליפים מפתח בְּשַׁגֵּר, למשל במסגרת סבב החלפה רבעוני, צריך להסיר את המחבר ולהוסיף אותו מחדש עם הערך החדש.

מה עושים עם החיבור באפליקציית Desktop

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

1. "תראה לי אילו פוסטים מתוזמנים לשבוע הבא בסביבה של הלקוח" (list_posts עם סינון לפי סטטוס).
2. "כמה לחיצות היו לכל סניף בחודש האחרון, ואיזה פוסט הביא הכי הרבה" (get_analytics).
3. "קח את הסרטון מהקישור הזה, העלה אותו, ותכין טיוטת Reel לקבוצת הסניפים בצפון עם כיתוב שונה לכל עמוד" (upload_media_from_url ואז create_post עם per_channel).
4. "שלח את הטיוטה הזו לאישור של מיכל מהלקוח" (request_approval).

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

המסקנה המעשית: אם יש לכם Request headers, חברו את שַׁגֵּר לאפליקציית Desktop עכשיו ותהנו מצ'אט שמכיר את כל החשבונות של הלקוחות. אם אין, אל תילחמו בזה. הגדירו את Claude Code לשגרה השבועית, והשאירו את Desktop לשאלות ולסקירות עד שהתחברות OAuth של שַׁגֵּר יעלה.

שאלות נפוצות

אפשר להגדיר את שַׁגֵּר בקובץ claude_desktop_config.json?

הקובץ הזה מיועד לשרתים מקומיים שרצים על המחשב. שַׁגֵּר הוא שרת מרוחק, והדרך הרשמית לחבר שרת מרוחק היא מחבר מותאם בהגדרות החשבון. גשרים מקומיים קיימים, אבל הם לא חלק מהמסלול שמתועד אצל Anthropic.

המחבר נוסף אבל כל קריאה נכשלת. מה בודקים?

ברוב המקרים הערך של כותרת authorization הוזן בלי המילה Bearer, או שהמפתח בוטל בְּשַׁגֵּר. מסירים את המחבר ומוסיפים אותו מחדש עם Bearer ואחריו המפתח המלא. אם אין לכם Request headers בכלל, החיבור לא יעבוד עד שהתחברות OAuth של שַׁגֵּר יעלה.

האם מחבר באפליקציית Desktop זמין גם באתר claude.ai בדפדפן?

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