חיבורי MCP עבור סוכנים בהתאמה אישית

חיבורי MCP (Model Context Protocol) מאפשרים לסוכן בהתאמה אישית שלך להתחבר בצורה מאובטחת לאפליקציות חיצוניות. באמצעות חיבורי MCP, הסוכן שלך יכול לקרוא מידע ולבצע פעולות תוך שימוש בחיבורים מוגדרים מראש עם אפליקציות כמו Linear, Ramp, Figma ועוד—או להתחבר לכל אפליקציה על ידי הגדרת חיבורי MCP בהתאמה אישית.

הערה: חיבורי MCP זמינים בתוכניות Business ו-תוכנית Enterprise בלבד.

חיבורי MCP מאפשרים לסוכנים בהתאמה אישית ליצור אינטראקציה עם כלים ושירותים חיצוניים דרך פרוטוקול הקשר מודל. כלי MCP עובדים עם כל סוגי הטריגרים, כולל הרצות מתוזמנות, הרצות המופעלות על בסיס אירועי Notion או Slack, והרצה ידנית מתוך צ'אט או @mentions.

תכונות עיקריות:

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

• שרתים מותאמים אישית: התחבר לכל כלי התומך בשרת MCP מאוחסן באמצעות כתובות URL זמינות לציבור.

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

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

משמעות הדבר היא:

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

• יש להתחבר לכל שרת MCP עבור כל סוכן בהתאמה אישית אותו מגדירים.

• ביטול חיבור בסוכן אחד אינו משפיע על סוכנים אחרים.

באפשרותך להתחבר לאפליקציות הבאות ללא צורך בהגדרה נוספת:

• Amplitude

• Attio

• Box

• ClickHouse

• Figma

• GitHub

• HubSpot

• אינטרקום

• Linear

• מרקורי

• Miro

• Mixpanel

• n8n

• Ramp

• Stripe

• Sentry

• Wiz

1. יש לפתוח את ה-Settings של הסוכן בהתאמה אישית.

2. יש לעבור אל Tools & Access.

3. יש ללחוץ על Add connection → Add.

4. יש לבחור שרת מוגדר מראש.

5. יש לפעול לפי הנחיות האימות כדי לחבר את החשבון שלך.

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

7. יש ללחוץ על Connect.

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

כדי לאפשר שרתי MCP מותאמים אישית:

1. כמנהל סביבת עבודה, יש לעבור אל Settings → Connections.

2. בכרטיסייה Manage, יש להפעיל את האפשרות Enable custom MCP servers באמצעות הרשימה נפתחת.

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

1. כמנהל סביבת עבודה, יש לעבור אל Settings → Connections.

2. בכרטיסייה Manage, יש לאתר את המקטע Manage permissions.

3. לצמוד ל-Limit which connections members can install, יש לבחור אחת מהאפשרויות:

   • Approved & recommended: מאושר ומומלץ – הוא מאשר באופן אוטומטי את כל החיבורים המומלצים על ידי Notion.

   • Approved only: מאושר בלבד – בוחרים באופן ידני את כל החיבורים שחברים יכולים להתקין.

4. יש לבחור ב-Approved connections על מנת לסקור את האפשרויות להתקנה על ידי החברים.

5. יש לבחור ב-Add approved connection ולאחר מכן לקבוע את האפשרויות לאישור:

   • יש לחפש ב-Connections חיבור לפי שם או מזהה ולהוסיף אותו לרשימה המאושרת.

   • יש להוסיף ב-Custom MCP server כתובת URL ספציפית של שרת MCP מותאם אישית שברצונך לאפשר.

6. יש ללחוץ על Save.

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

כדי להוסיף MCP מותאם אישית לסוכן בהתאמה אישית:

1. יש לפתוח את Settings של הסוכן בהתאמה אישית.

2. יש לעבור אל Tools & Access.

3. יש ללחוץ על Add connection → Custom MCP server.

4. יש להזין את כתובת ה-URL של שרת MCP מהכלי או מהספק שאליו מתחברים (לדוגמה: צוות הכלים הפנימי של החברה).

5. יש לספק שם תצוגה עבור החיבור (אופציונלי).

6. יש להוסיף את כל פרטי האימות הנדרשים.

7. יש ללחוץ על Connect.

שרתי MCP מותאמים אישית עשויים לתמוך באחת או בשתי שיטות ההתחברות הבאות:

• OAuth

• אימות מבוסס כותרת (Header)

  (לדוגמה, מפתחות API או אסימוני נושא - bearer tokens)

שרתי OAuth מסוימים אינם תומכים ב-רישום לקוח דינמי (DCR). משמעות הדבר היא ש-Notion חייבת לרשום מראש אפליקציית לקוח בשירות הצד השלישי לפני שהתחברות OAuth תוכל לעבוד. אם השרת שבו ברצונך להשתמש אינו תומך ב-DCR, עיין בתיעוד שלו כדי לראות אם ניתן להשתמש במפתח API או באסימון נושא במקום זאת. אם אף אחת מהאפשרויות אינה זמינה, לא ניתן להשתמש בשרת ה-MCP עם סוכנים מותאמים אישית.

ניתן לקבוע כיצד סוכן בהתאמה אישית ישתמש בחיבור MCP באמצעות Settings תחת Tools & Access. יש להרחיב את פרטי חיבור MCP כדי לראות את הכלים הזמינים ולוודא כיצד הם פועלים. ניתן להפעיל או להשבית כלים באמצעות הרשימה נפתחת הסמוכה.

כלי קריאה וכתיבה

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

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

הפעלה אוטומטית או שאל תמיד

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

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

• אפשר תמיד מאשרת לצמיתות את כל הכלים משרת ומסירה בקשות אישור עתידיות.

כדי להסיר חיבור MCP

1. יש לפתוח את Settings של הסוכן שלך.

2. יש לעבור אל Tools & Access.

3. יש לאתר את חיבור ה-MCP וללחוץ על Disconnect.

4. יש ללחוץ על Disconnect כדי לאשר.

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

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

חיבורי MCP מכבדים את רמות הרשאות המשתמש שהוגדרו בסוכן המותאם אישית שלך. להלן מה שכל רמת הרשאה יכולה לעשות עם כלים המחוברים ל-MCP.

משתמשים בעלי הרשאות גישה מלאה ועריכה לסוכן מותאם אישית יכולים:

• להוסיף חיבורי MCP חדשים לסוכן המותאם אישית.

• לשוחח עם הסוכן ולהשתמש בכל הכלים המחוברים, גם אם אין להם גישה לכלי מחוץ לסוכן.

• הצג את יומן הפעילות של הסוכן ואת השימוש בכלי MCP.

• הסר חיבורי MCP קיימים.

• חבר מחדש או עדכן את אישורי שרת ה-MCP.

ועבור חיבורי MCP שהם מגדירים, משתמשים בעלי הרשאות "גישה מלאה" ו"יכול לערוך" יכולים:

• להגדיר אילו כלים מופעלים ואילו כלים בהשבתה, ולשנות הגדרות ביצוע של כלים (הרצה אוטומטית לעומת שאילת תמיד)

הערה: ברגע שחיבור MCP נוצר, רק האדם שמאמת את חיבור ה-MCP יכול להגדיר ולעדכן את הגדרות הכלי - גם אם לאחרים יש הרשאות "גישה מלאה" או "יכול לערוך" לסוכן המותאם אישית. הסוכן משתמש באישורים ובהרשאות של אותו אדם בעת גישה לשירות החיצוני.

משתמשים בעלי הרשאות "יכול לצפות ולקיים אינטראקציה" לסוכן מותאם אישית יכולים:

• לשוחח עם הסוכן המותאם אישית ולהשתמש בכל הכלים המחוברים, גם אם אין להם גישה לכלים מחוץ לסוכן המותאם אישית.

• הפעל פעולות קריאה וכתיבה דרך הסוכן, תוך שימוש בטריגר.

• אשר או בטל פעולות כתיבה כאשר נדרש אישור.

• הצג אילו שרתי MCP מחוברים (בהגדרות הסוכן המותאם אישית).

משתמשים בעלי הרשאות "יכול לצפות ולקיים אינטראקציה" אינם יכולים:

• להוסיף או להסיר חיבורי MCP.

• לשנות אילו כלים מופעלים.

• לשנות הגדרות ביצוע של כלים.

• הצג את יומן הפעילות המלא של הסוכן.

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

אם כלים אינם מופיעים לאחר החיבור:

• רענן את דף הגדרות הסוכן.

• בדוק ששרת ה-MCP עבר אימות בהצלחה (חפש סימן ביקורת ירוק או סטטוס "מחובר").

• וודא שהשרת מקוון ומחזיר מטא-נתונים של כלים.

• נסה לחבר מחדש את השרת, או לנתק אותו ולהוסיף אותו שוב.

אם הרצות של סוכן בהתאמה אישית נכשלות עם שגיאות MCP:

• בדוק את הכרטיסייה פעילות עבור הודעות שגיאה ספציפיות.

• וודא שהחיבור שלך עדיין תקף (ייתכן שהאסימונים פגו).

• וודא שהחיבור עדיין מופעל בהגדרות הסוכן.

• נסה לחבר מחדש את שרת ה-MCP כדי לרענן אישורים.

• עדכן את ההוראות של הסוכן בהתאמה אישית שלך כך שיציינו את שם השרת או הכלי שבו ברצונך להשתמש. לדוגמה: "השתמש ב-Linear MCP כדי לאחזר מטא-נתונים עבור מוק זה."