לקוח ה־AI שלכם יראה ויעדכן את שטח בשמכם, עם ההרשאות שלכם בלבד, בלי להעתיק טוקנים.
לפני שמתחילים
- מנהל הארגון הדליק את המתג „חיבורי MCP” בכרטיס המשתמש שלכם (הגדרות ← משתמשים).
- Claude Code, Claude Desktop, claude.ai, Cursor, VS Code או כל לקוח MCP שתומך ב־OAuth ו־Streamable HTTP.
שלבי העבודה
- 1
העתיקו את כתובת ה־MCP
בתפריט המשתמש ← „חיבורי MCP” מוצגת הכתובת של השרת: https://shetach.qct.co.il/api/v1/mcp. זו כל הקונפיגורציה שהלקוח צריך.
- 2
הוסיפו את השרת ללקוח
ב־Claude Code: claude mcp add --transport http shetach https://shetach.qct.co.il/api/v1/mcp. ב־Claude Desktop או claude.ai: Settings ← Connectors ← Add custom connector, ולהדביק את הכתובת. ב־Cursor, VS Code או לקוח אחר: הוסיפו שרת MCP מסוג HTTP עם אותה כתובת. אין client id או secret למלא.
הלקוח נרשם מול שטח לבד בפעם הראשונה. אם הוא שואל על שיטת אימות, בחרו OAuth. - 3
אשרו בדפדפן
בשימוש הראשון נפתח דפדפן עם ההתחברות הרגילה לשטח (סיסמה וקוד אימות אם מוגדר). אחריה מוצג מסך „‹לקוח› מבקש גישה לשטח בשמך” עם שם המשתמש שאיתו התחברתם. לחצו „אשר”.
אם המסך מציג „חיבורי MCP אינם מופעלים לחשבון זה” ואין כפתור אישור, המתג אצל המנהל עדיין כבוי. - 4
עבדו מתוך הלקוח
שאלו „מה פתוח מול דימה בפרויקט X?”, בקשו לפתוח משימה, לשנות סטטוס, להוסיף תגובה, לדווח או לסגור חסם, ולקבוע תזכורת. הלקוח משתמש באותם כלים של העוזר החכם, עם ההרשאות שלכם.
פעולות כתיבה מ־MCP מתבצעות מיד, בלי מסך אישור כמו בצ׳אט: הלקוח שאישרתם הוא אתם. כל פעולה נרשמת ביומן הביקורת. - 5
נהלו ובטלו חיבורים
כל חיבור מופיע ב„חיבורי MCP” בשם הלקוח, עם תאריך יצירה ותוקף. „בטל חיבור” מנתק את הלקוח מיד. הלקוח מרענן את הגישה לבד; אתם לא רואים ולא מטפלים בטוקנים.
כדאי לדעת
- • יציאה מהדפדפן אינה מנתקת חיבורי MCP. החלפת סיסמה כן מנתקת את כולם, ואז הלקוח יבקש אישור מחדש.
- • הלקוח רואה רק את הפרויקטים שאתם חברים בהם. כדי שיראה פרויקט נוסף, צרפו את עצמכם אליו כרגיל.
- • רוצים שהפעולות יירשמו בשם „בוט” ולא בשמכם? חברו את הלקוח עם משתמש ייעודי (ראו מדריך המנהל).
אם משהו לא עובד
הלקוח מציג 401 או „Unauthorized” ולא פותח דפדפן.
ודאו שהכתובת מסתיימת ב־/api/v1/mcp ושהלקוח תומך ב־OAuth ל־MCP. בלקוח ישן אפשר להשתמש בטוקן ידני מהמסך „חיבורי MCP” (המסלול המתקדם).
מסך האישור נטען אבל אין כפתור „אשר”.
המתג „חיבורי MCP” כבוי או שהתפקיד הוא „צופה”. פנו למנהל הארגון.
אחרי אישור הלקוח לא מציג כלים.
ב־Claude Code הריצו /mcp ובדקו את מצב החיבור. אם השרת מסומן כמנותק, הסירו והוסיפו מחדש. במקרה של „כלי לא זמין” מנהל כיבה את הכלי בהגדרות העוזר.
צריכים עזרה נוספת?
שלחו לנו את שם הפרויקט, המסך שבו עבדתם ומה ציפיתם שיקרה. צילום מסך יקצר את הטיפול.
פנייה לצוות שטח