פעולות MCP

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

ברוב השירותים החיבור בלחיצה אחת. פתחו פעולות ו־MCP, לחצו + הוספת פעולה ובחרו MCP.

בדקו חיבור MCP לדוגמה לתיעוד Cloudflare או Microsoft Learn. הבדיקה שולחת רק בקשות אתחול ורשימת כלים, ללא כניסה או הרצת כלים.

כלי הגדרה אופציונליים

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

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

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

חיבור מהקטלוג

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

1. מצאו שירות בגלישה או בחיפוש.
2. לחצו על הכרטיס. Quickchat בודקת את השרת ומגלה כלים.
3. אם נדרשת כניסה, מופיע נדרשת הרשאה. לחצו חיבור עם <שירות>, אשרו בחלונית והמצב ישתנה למחובר.
4. הפעולה נוצרת ומופעלת, והכלים מוצגים. הסוכן יכול להשתמש בהם מההודעה הבאה.

Note

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

Tip

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

חיבור שרת שאינו בקטלוג

לחצו הזנת URL ידנית מתחת לקטלוג ואז:

1. הדביקו כתובת שרת MCP, שמתחילה ב-https://.
2. אם משתמשים באסימון סטטי ולא בכניסה, פתחו כותרות חיבור (אופציונלי) והוסיפו את הכותרת הנדרשת, למשל Authorization: Bearer <your-token>.
3. לחצו חיבור.

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

בחירת הכלים שה-AI יכול להשתמש בהם

אחרי החיבור מוצגים כל כלי השרת, לכל אחד מתג. כבו כלים שאינכם רוצים שה-AI יפעיל; למשל אפשר להשאיר חיפוש לקריאה בלבד בשרת הזמנות ולכבות ביטול.

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

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

Tip

שם פעולת MCP ותיאור פעולת MCP הם תוויות לצוות בלבד; ה-AI אינו קורא אותם. מה שמנחה אותו הוא תיאורי הכלים שהשרת מפרסם יחד עם הפרומפט הראשי. ציינו מתי להשתמש בכלים, למשל “ענו לכל שאלת פרויקט עם כלי Linear”, וקבעו ערכים שהמודל אחרת ינחש, למשל “חפשו תמיד בסביבת acme-eng”. בחיבור אותו שרת פעמיים, תנו לכל חיבור שם לפי תפקידו, כמו “מרכז עזרה Notion” ו”בקשות תמיכה Notion”, ולא רק לפי הספק.

זמני הזמנה עם Calendly

כשפעולה אחת מחוברת לשרת https://mcp.calendly.com ומפעילה את שני הכלים הבאים, Quickchat נותנת להם קלטי זמן מקומי. השמות נשארים ואין כלי המרה נוספים. אם רק אחד פעיל, הוא שומר על הקלט המקורי של Calendly.

• זמינות: event_types-list_event_type_available_times מקבל local_start_time, local_end_time ו-timezone מסוג IANA, למשל Europe/London. ספקו תאריכים ושעות מקומיים ב-YYYY-MM-DDTHH:MM:SS. Quickchat ממירה ל-UTC לפי כללי האזור לתאריכים, כולל ימים בני 23 או 25 שעות בהחלפת שעון.
• הזמנה: meetings-create_invitee מקבל את local_start_time של האפשרות שנבחרה ואת booking_timezone בתוך post_invitee_request. ‏invitee.timezone נשאר אזור הלקוח, שיכול להיות שונה מאזור הפגישה. למשל מוזמן ב-America/New_York יכול להזמין זמן המוצג ב-Europe/London.

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

הצעת מועד אינה שומרת אותו. לפני יצירת הפגישה Quickchat בודקת שוב זמינות ומעבירה את חותמת הזמן המתאימה ללא שינוי ל-Calendly. אם כבר אינו זמין, אין ניסיון הזמנה. התוצאה כוללת זמן מקומי לאישור הסוכן; שדות הספק המשמשים שמירה בזיכרון, כמו $.resource.event, נשארים זמינים.

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

שמירת תוצאת כלי MCP בזיכרון

הרחיבו כלי והשתמשו בשמירה בזיכרון כשערך מהתוצאה יידרש בהמשך. הוסיפו ביטוי JSONPath ומפתח זיכרון. אפשר לשמור עד 10 ערכים מכלי אחד.

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

הערך השמור הופך לחלק מנתוני השיחה שה-AI יכול לקרוא בהמשך. למשל כלי הזמנה יכול לשמור URI של אירוע כדי שכלי ביטול ידע איזו פגישה לבטל. כלי MCP אינם משתמשים ב-{{metadata_<key>}} של פעולות API, כי ה-AI מספק ארגומנטים ישירות.

הפעלת הכול והשבתת הכול משמרות כללי זיכרון. גם חיבור מחדש שומר בחירות כלים וכללים בזמן רענון הרשימה.

מה המבקרים רואים

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

חיבור מחדש וניתוק

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

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

פתרון בעיות

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

Note

פעולות MCP נספרות במכסת הפעולות המותאמות של התוכנית, כמו פעולות API.