Your AI Connector Docs

חיבור שרתי MCP לבוט שלך

שרתי MCP מאפשרים לבוט ה-AI שלך להשתמש בכלים ממערכת אחרת במהלך שיחות חיות — מבלי שתצטרך לבנות כל כלי בעצמך. אתה מפנה את הבוט לשרת MCP פעם אחת, וכל כלי שהשרת מציע הופך לזמין עבור הבוט באופן אוטומטי.

אם השתמשת ב-Custom Functions (פונקציות מותאמות אישית), מדובר באותו רעיון, צעד אחד קדימה: פונקציה מותאמת אישית היא כלי בודד שאתה מחבר בעצמך, בעוד ששרת MCP הוא חבילת כלים מוכנה שהבוט יכול לגלות ולהפעיל בעצמו.


מהו שרת MCP?

MCP (פרוטוקול הקשר מודל - Model Context Protocol) הוא תקן פתוח למתן גישה לעוזרי AI לכלים חיצוניים. אפליקציות ושירותים מודרניים רבים מפרסמים כיום “שרת MCP” — כתובת אינטרנט אחת שחושפת קבוצת כלים שה-AI יכול להפעיל: חיפוש מידע, שליפת רשומה, הרצת שאילתה, יצירת פריט.

במקום לתאר כל כלי לבוט, אתה מספק ל-Your AI Connector את כתובת השרת ומפתח גישה. Your AI Connector שואל את השרת “מה אתה יכול לעשות?”, מקבל בחזרה את רשימת הכלים, והופך אותם לזמינים עבור הבוט שלך. כאשר השרת מוסיף כלי חדש, הבוט שלך יכול להשתמש בו ללא צורך בהגדרה נוספת מצדך.

Custom Functions לעומת שרתי MCP — במה להשתמש:

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

ניתן להשתמש בשניהם בו-זמנית על אותו סוכן (Agent).


איך זה עובד (הגרסה הפשוטה)

  1. אתה רושם שרת MCP בדף שרתי MCP — את כתובת האינטרנט שלו ואת כותרת ההרשאה (בדרך כלל מפתח API).
  2. Your AI Connector מתחבר ומגלה את הכלים של השרת, ושומר את הרשימה.
  3. אתה מפעיל את השרת בסוכן (Agent).
  4. במהלך שיחה, כאשר הלקוח מבקש משהו שכלי יכול לענות עליו, הבוט קורא לכלי, קורא את התוצאה, ומשיב באופן טבעי.

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

מהי העלות של קריאת כלי MCP

קריאת כלי משרת MCP מחויבת בדיוק כמו קריאה לפונקציה מותאמת אישית, לפי רמת איכות ה-AI של הסוכן שלך:

רמת איכות AI קרדיטים לכל קריאת כלי MCP עם מפתח Anthropic משלך (BYOK) מחובר
Pro 1 קרדיט 0 קרדיטים — רץ על המפתח שלך
Economy (deprecated) 0.5 קרדיטים 0 קרדיטים — רץ על המפתח שלך
Max 0.25 קרדיטים עדיין 0.25 קרדיטים, מחויב גם עם מפתח משלך מחובר, מכיוון ש-Max רץ על המודל שלנו
Mini 0.15 קרדיטים עדיין 0.15 קרדיטים, מחויב גם עם מפתח משלך מחובר, מכיוון ש-Mini רץ על המודל שלנו

הוספת שרת MCP (צעד אחר צעד)

בסרגל הצד הראשי, תחת AI Studio, לחץ על MCP Servers. לאחר מכן לחץ על + Add Server.

מלא את הטופס:

שדה מה להזין דוגמה
שם תווית קצרה עבור השרת (משמשת גם למתן שמות לכלים שלו עבור הבוט). Order System
כתובת שרת (URL) כתובת ה-MCP של השרת (נקראת לעיתים “נקודת קצה”), המתחילה ב-https://. https://tools.mystore.com/mcp
שם כותרת אימות הכותרת שהשרת מצפה לה לצורך אימות. השאר כ-Authorization אלא אם התיעוד של השרת מציין אחרת. Authorization
ערך כותרת אימות פרטי האימות עצמם, בפורמט שהשרת מצפה לו. Bearer sk_live_abc123

בחירת אופן ההתחברות: מפתח API או OAuth

Your AI Connector תומך בשתי דרכים לאימות מול שרת. בחר את הדרך שתיעוד השרת מנחה אותך להשתמש בה, באמצעות האפשרות אימות (Authentication) בראש הטופס:

  • מפתח API / כותרת: השיטה המקורית שתוארה לעיל. אתה מדביק אישור קבוע (מפתח API או אסימון) בשדה ערך כותרת האימות (Auth Header Value), ו-Your AI Connector שולח אותו בכל בקשה. מתאים ביותר לשרתים שמספקים לך מפתח בעל תוקף ארוך.
  • OAuth (התחברות): עבור שרתים שמבקשים ממך להתחבר במקום להדביק מפתח. ב-OAuth אין מפתח להעתקה — אתה מאשר גישה על ידי התחברות, באותו אופן שבו “התחברות עם Google” עובדת באתרים אחרים.

כדי להתחבר באמצעות OAuth:

  1. בחר ב-OAuth כשיטת האימות. שדות כותרת האימות (Auth Header) ייעלמו ויוחלפו בכרטיס Connect — לא תזדקק למפתח.
  1. מלא את ה-שם ו-כתובת ה-URL של השרת, ולאחר מכן לחץ על שמור. השרת מתווסף לרשימה שלך, אך מוצג כ-לא מחובר לעת עתה.
  2. לחץ על התחבר בשרת. חלון התחברות מאובטח ייפתח שבו תאשר את הגישה.
  3. אשר, והחלון ייסגר מעצמו. השרת מוצג כעת כמחובר, ו-Your AI Connector טוען את הכלים שלו.

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

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

בדיקת החיבור

לפני השמירה, לחץ על בדוק חיבור. Your AI Connector יוצר קשר עם השרת ומציג לך את רשימת הכלים שהוא מציע. זו הדרך המהירה ביותר לוודא שכתובת ה-URL והמפתח שלך נכונים — אם החיבור נכשל, תראה את הודעת השגיאה במקום במקום לגלות זאת באמצע שיחה.

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

קריאת רשימת השרתים

כל שרת ברשימה מציג:

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

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

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

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

  1. לחץ על סמל העיפרון (עריכה) לצד השרת ברשימה.
  2. גלול אל המקטע כלים (Tools) — כל כלי שהשרת מציע מופיע ברשימה, עם מתג הפעלה/כיבוי משלו.
  3. כבה כל כלי שאינך רוצה שהבוט יפעיל, או השתמש ב-הפעל הכל / בטל הכל כדי להגדיר אותם בבת אחת.
  4. לחץ על שמור שינויים.

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

שני דברים שכדאי לדעת:

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

הגדרת מגבלות ביצוע לכל כלי

לצד מתג ההפעלה/כיבוי של כל כלי תמצאו פקד מגבלות (Limits). הוא פותח את אותן מגבלות ביצוע שניתן להגדיר ב-פונקציה מותאמת אישית, המוחלות רק על אותו כלי ספציפי — שימושי כאשר כלי של שרת קורא לשירות צד-שלישי בתשלום, או כאשר כלי אמור לפעול רק פעם אחת לכל שיחה. כל דבר כאן הוא אופציונלי; השאירו זאת ריק והכלי יתנהג בדיוק כפי שהתנהג קודם לכן.

  • לקריאה בלבד (Read-only). שרתים מסוימים מצהירים עבור כל כלי האם הוא רק קורא נתונים. אוטומטי (הגדרת שרת) סומך על הצהרה זו; ניתן לעקוף זאת לכל כיוון — סמנו כלי כלקריאה בלבד כאשר אתם יודעים שהוא לעולם לא יוצר או משנה דבר (זה מאפשר ל-AI לנסות שוב בבטחה תשובה שנקטעה במקום להשאיר את הלקוח ללא מענה), או כלא לקריאה בלבד כאשר אינכם סומכים על טענת השרת.
  • הגש תוצאה שמורה בקריאות חוזרות. כאשר ה-AI קורא לכלי שוב עם אותם קלטים, התוצאה הקודמת ממוחזרת (למשך עד 24 שעות) במקום לקרוא לשרת שוב.
  • מספר הרצות מרבי לשיחה ו-מספר הרצות מרבי לפרק זמן פועלים בדיוק כמו בפונקציות מותאמות אישית: הרצות מוצלחות בלבד, וכאשר מגבלה נכנסת לתוקף, ה-AI מקבל הסבר מדוע ועונה עם המידע שכבר יש לו — הלקוח לעולם לא נשאר תלוי באוויר. שיחות בדיקה פטורות מכך.

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


הפעלת שרת עבור סוכן

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

  1. פתח את ה-Agent ועבור ללשונית AI Abilities (יכולות בינה מלאכותית). (עבור קמפיין שעדיין מחזיק בהגדרות בינה מלאכותית משלו ישירות ולא דרך Agent נפרד, אותה רשימה תופיע בשלב ה-AI Abilities של אותו קמפיין).
  2. מצא את המקטע MCP servers.
  3. הפעל את המתג עבור כל שרת שברצונך שהבוט של ה-Agent יוכל להשתמש בו.
  4. לחץ על Save changes (שמור שינויים) — הבחירות יחולו רק לאחר השמירה.

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

בחירת הכלים שסוכן יכול להשתמש בהם

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

  1. בלשונית AI Abilities, תחת השרת המופעל, לחץ על השורה “… tools enabled for this agent” כדי להרחיב את רשימת הכלים.
  2. כבה כל כלי שסוכן זה לא אמור להשתמש בו, ולאחר מכן לחץ על Save changes.

שני כללים שומרים על התנהגות צפויה:

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

דוגמה מוכנה מראש: חיבור חנות Shopify

לכל חנות Shopify יש שרת MCP מובנה — אין צורך להתקין אפליקציה או ליצור מפתח. Shopify מארחת אותו בכתובת האינטרנט של החנות בתוספת /api/mcp בסוף.

מה הבוט מקבל ממנו:

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

כדי לחבר חנות, הוסף שרת עם הפרטים הבאים:

שדה מה להזין
שם Shopify Store (או שם החנות)
כתובת השרת (Server URL) כתובת האינטרנט של החנות בתוספת /api/mcp — לדוגמה https://mystore.com/api/mcp. גם הכתובת הטכנית של החנות עובדת: https://mystore.myshopify.com/api/mcp.
אימות (Authentication) השאר את API key / header נבחר והשאר את Auth Header Value ריק — שרת זה אינו דורש מפתח.

שמור, לחץ על Test Connection (בדיקת חיבור), והפעל את השרת בסוכן שלך — זה כל תהליך ההגדרה.

שני דברים שכדאי לדעת:

  • הזמנות אינן נמצאות בשרת זה. Shopify שומרת בכוונה את נתוני ההזמנות מחוץ לנקודת קצה ציבורית זו. עבור שאלות מסוג “איפה ההזמנה שלי?”, שלב שרת זה עם פונקציה מותאמת אישית אחת — ראה את דוגמת סטטוס הזמנה ב-Shopify.
  • זה עובד עבור כל חנות Shopify — כולל חנות של לקוח אם אתה מנהל חשבונות עבור אחרים. כל מה שצריך זה את כתובת האינטרנט של החנות.

אבטחה — חבר רק שרתים שאתה סומך עליהם

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

  • רשום רק שרתים שאתה שולט בהם או סומך עליהם לחלוטין. התיאור של כלי נכתב על ידי מי שמפעיל את השרת, והבוט קורא את התיאורים הללו כדי להחליט מתי להשתמש בכלי.
  • השתמש במפתח API ייעודי ומוגבל, לא בפרטי גישה של מנהל מערכת. המפתח שלך נשמר בצורה מאובטחת ולעולם אינו מוצג בייצוא נתונים. אותו הדבר תקף לכניסות OAuth — אסימוני הגישה נשמרים בצורה מאובטחת ומוסתרים מכל ייצוא.
  • כתובת ה-URL חייבת להיות כתובת https:// ציבורית. כתובות פנימיות, localhost וכתובות של רשתות פרטיות נדחות מטעמי אבטחה.
  • השבת שרת ברגע שאתה מפסיק לסמוך עליו — כבה אותו או מחק אותו, והוא ייעלם מכל סוכן (Agent) באופן מיידי.

פתרון בעיות

  • נקודה אדומה של סטטוס / חיבור נכשל: פתח מחדש את השרת ולחץ על Test Connection כדי לראות את השגיאה המדויקת. הסיבות הנפוצות ביותר הן מפתח שגוי או שפג תוקפו, שגיאת הקלדה ב-URL, או שהשרת דורש שם כותרת (header) שונה מ-Authorization.
  • שרת OAuth הפסיק לעבוד / מבקש ממך להתחבר מחדש: ניתן לבטל התחברויות OAuth או שהן עלולות לפוג בצד השרת. פתח את השרת ולחץ שוב על Connect כדי להתחבר מחדש. שים לב שהתחברויות OAuth לעולם אינן מועתקות בין חשבונות, לכן יש לחבר מחדש שרתים של סוכן (Agent) או קמפיין שהועתקו לחשבון שאליו העתקת אותם.
  • הבוט לא משתמש בכלי: ראשית, בדוק שהכלי מופעל בסעיף Tools של השרת (ערוך את השרת כדי לראות את הרשימה) — כלי כבוי אינו גלוי לבוט. לאחר מכן, ודא שהשרת מופעל עבור אותו סוכן ספציפי, ושהבקשה של הלקוח תואמת בבירור את מה שהכלי עושה. כמו בפונקציות מותאמות אישית, שמות ותיאורים ברורים של כלים בצד השרת עוזרים לבוט לבחור נכון.
  • כלי שהשרת מציע לא מופיע עבור הבוט: אם אצרת את הכלים של שרת זה, זכור שכל כלי שנוסף לאחר האצירה מגיע כשהוא כבוי. ערוך את השרת, פתח את סעיף Tools, והפעל אותו.
  • האם המחבר (connector) מטפל בהפעלות MCP HTTP? כן. אם השרת שלך מנפיק כותרת mcp-session-id בעת יצירת החיבור, אנו שומרים אותה ושולחים אותה בחזרה בכל בקשה עוקבת, יחד עם הכותרת MCP-Protocol-Version. שרתים בעלי מצב (Stateful) עובדים ללא הגדרה נוספת מצדך.
  • כלי דולג: סוכן יכול להשתמש לכל היותר ב-5 שרתים וב-40 כלי MCP בו-זמנית. אם שרת מציע מספר גדול מאוד של כלים, ייתכן שחלקם לא ייטענו — כבה את הכלים שאינך צריך בסעיף Tools של השרת, או שמור על כל שרת ממוקד בכלים שבהם אתה משתמש בפועל.

דרישות תוכנית

שרתי MCP הם חלק מערכת הכלים למפתחים, לצד פונקציות מותאמות אישית. אם אינך רואה את MCP Servers בקבוצת ה-AI Studio בסרגל הצד, התוכנית הנוכחית שלך אינה כוללת זאת — שדרג לתוכנית עם כלי מפתחים כדי להפעיל זאת.


צעדים הבאים