חיבור עוזרי AI (MCP) #

Your AI Connector מספקת שרת MCP רשמי — נקודת קצה של Model Context Protocol המאפשרת לעוזרי בינה מלאכותית כמו Claude Code, Claude Desktop, Cursor, והאפליקציות שלכם להפעיל את חשבון ה-Your AI Connector שלכם ישירות. בקשו בשפה פשוטה (“הצג את סוכני ה-AI שלי”, “הוסף את הליד הזה”, “כמה עלה לי ה-AI השבוע?”) והעוזר יקרא ל-API של Your AI Connector עבורכם.

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

• נקודת קצה (Endpoint): https://mcp.youraiconnector.com/mcp
• אימות: מפתח ה-API ה-Your AI Connector שלך (נשלח ככותרת X-API-Key)
• דרישות: תוכנית עם גישת API. יצירת מפתח API ←

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

Claude Code #

claude mcp add --transport http ai-connector https://mcp.youraiconnector.com/mcp \
  --header "X-API-Key: YOUR_API_KEY"

לאחר מכן הרץ את /mcp בתוך Claude Code כדי לוודא שהוא מציג ai-connector ✓ connected.

כברירת מחדל, השרת מתווסף בהיקף מקומי (רק עבורך, בפרויקט זה). השתמש ב---scope user כדי להפוך אותו לזמין בכל הפרויקטים שלך, או ב---scope project to commit it to a repo’s .mcp.json עבור הצוות שלך:

{
  "mcpServers": {
    "ai-connector": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}

Claude Desktop #

הוסף את השרת כמחבר מותאם אישית. הוא מוגדר בחשבון ה-Claude שלך, כך שהוא עובד ב-Claude Desktop וב-claude.ai כאחד (חשבונות Claude בחינם יכולים להוסיף מחבר מותאם אישית אחד).

1. פתח את Customize → Connectors, לחץ על + Add, ולאחר מכן על Add custom connector.
2. תן לו שם והזן את https://mcp.youraiconnector.com/mcp ככתובת ה-URL.
3. תחת Authentication, בחר No sign in. לשרת ה-MCP אין דף התחברות: בחירה באפשרות התחברות תסתיים בשגיאה “Couldn’t register with … sign-in service”.
4. תחת Request headers, הוסף כותרת (header) בשם X-API-Key עם מפתח ה-API שלך כערך.
5. לחץ על Add. הכלים של Your AI Connector יופיעו בתפריט הכלים של צ’אט חדש.

אין שדה Request headers? גרסת ה-Claude Desktop שלך ישנה: עדכן אותה, או השתמש בקובץ ההגדרות במקום. קובץ ההגדרות (claude_desktop_config.json, Settings → Developer → Edit Config) מריץ תוכניות רק על המחשב שלך ומתעלם מכל ערך של url, לכן הוא זקוק לגשר mcp-remote קטן, הדורש Node.js בגרסה 18 ומעלה:

{
  "mcpServers": {
    "ai-connector": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.youraiconnector.com/mcp",
        "--header",
        "X-API-Key:${AI_CONNECTOR_KEY}"
      ],
      "env": { "AI_CONNECTOR_KEY": "YOUR_API_KEY" }
    }
  }
}

שמור על X-API-Key:${AI_CONNECTOR_KEY} בדיוק כפי שהוא כתוב, ללא רווח אחרי הנקודתיים (ב-Windows רווח מפריד את הכותרת), והכנס את המפתח שלך רק ב-env. לאחר מכן צא לחלוטין מ-Claude Desktop (ב-Windows, לחץ לחיצה ימנית על סמל המגש → Quit) ופתח אותו שוב.

ChatGPT #

ChatGPT אינו יכול להתחבר לשרת ה-MCP כרגע. טופס ה-connector המותאם אישית שלו מציע רק OAuth או ללא אימות, ושרת ה-MCP של Your AI Connector מתחבר עם מפתח ה-API שלכם, שנשלח ככותרת בקשה (request header). בחירה ב-OAuth נכשלת עם השגיאה “could not discover OAuth settings”, ו"ללא אימות" מסורבת מכיוון שכל בקשה זקוקה למפתח.

השתמשו בעוזר המאפשר לכם להגדיר כותרת בקשה במקום זאת: Claude Code, Claude Desktop, Cursor או לקוח MCP אחר, או ה-API של Claude.

ChatGPT עדיין יכול לקרוא את מסמכי העזרה ללא חיבור: ראו מסמכי העזרה מובנים בפנים עבור קבצי ה-llms.txt הציבוריים.

Cursor ולקוחות MCP אחרים #

רוב העורכים התומכים ב-MCP משתמשים באותו מבנה .mcp.json המוצג לעיל (שרת HTTP עם url וכותרת X-API-Key). הוסף שרת ai-connector המצביע על https://mcp.youraiconnector.com/mcp והדבק את מפתח ה-API שלך בכותרת.

ה-API של Claude (בנייה לתוך האפליקציה שלך) #

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

{
  "model": "claude-opus-4-8",
  "messages": [{ "role": "user", "content": "List my AI agents" }],
  "mcp_servers": [
    {
      "type": "url",
      "name": "ai-connector",
      "url": "https://mcp.youraiconnector.com/mcp",
      "authorization_token": "YOUR_API_KEY"
    }
  ]
}

מה באפשרותך לעשות #

בתוך החלק של ה-API בגרסה v1 ששרת ה-MCP חושף, העוזר בוחר את הכלי המתאים באופן אוטומטי:

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

שאלות על חשבונות הלקוחות שלך (סוכנויות) #

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

פשוט ציין את שם הלקוח:

• “כמה אנשי קשר יש ל-Bella’s Bistro?”
• “מה הייתה עלות ה-AI עבור כל אחד מהלקוחות שלי השבוע?”
• “מה מצב הערוצים של Northside Dental, וכמה צ’אטים התקבלו השבוע?”

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

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

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

בדיקת סוכן של לקוח #

בקשו מהעוזר לנסות סוכן של לקוח (“שלח ‘האם אתם מבצעים משלוחים בימי ראשון?’ לסוכן המאפייה של לקוח X והראה לי מה הוא עשה”). הוא שולח הודעת ניסיון (Try Out) עם מפתח הסוכנות שלכם ועם ה-sub_account_id של הלקוח, ממתין, וקורא בחזרה את התשובה בתוספת כל פעולה שהסוכן ביצע. אין צורך בעותק של הסוכן. אם העוזר מציין שאינכם חשבון סוכנות, סימן שהוא מחובר עם מפתח של לקוח: חברו אותו מחדש עם המפתח של חשבון הסוכנות שלכם. ראו Try Out.

לקוחות עם מגבלת כלים #

https://mcp.youraiconnector.com/mcp?tags=SubAccounts,Contacts,Messages

מסמכי העזרה מובנים בפנים #

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

• docs_search: מוצא את הסעיפים שעונים על שאלה ומחזיר אותם עם קישור לדף.
• docs_read: קורא דף אחד במלואו, או סעיף אחד מתוכו.
• docs_list: מפרט כל דף לפי אזור.

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

עוזר שאינו מחובר דרך MCP עדיין יכול לקרוא את המסמכים: כוון אותו אל https://docs.youraiconnector.com/llms.txt (אינדקס של כל דפי העזרה עם קישור לגרסת ה-Markdown של כל דף) או אל https://docs.youraiconnector.com/llms-full.txt (כל התיעוד בקובץ Markdown אחד). שניהם ציבוריים, אינם דורשים מפתח, ונבנים מחדש עם כל שינוי בתיעוד.

מציאה או יצירה של מפתח ה-API שלך #

מפתח ה-API שחיבור זה משתמש בו נמצא ב-הגדרות (Settings) ← אינטגרציות (Integrations) ← מפתח API — סעיף נפרד, שאינו קשור ל-Webhooks. עיין בגישת API עבור הצעדים המדויקים.

פתרון בעיות #

• “Connection refused” או “not found” — הכתובת חסרה את ה-/mcp בסוף. השתמש ב-https://mcp.youraiconnector.com/mcp, לא ב-https://mcp.youraiconnector.com.
• Needs authentication / 401 — מפתח ה-API שלך חסר או שגוי. הוסף מחדש את השרת עם X-API-Key תקף.
• “Could not discover OAuth settings” (ChatGPT) — ChatGPT תומך רק ב-OAuth או ללא אימות עבור מחברים מותאמים אישית, ומכיוון ששרת ה-MCP משתמש במפתח API, ChatGPT לא יכול להתחבר כרגע. ראה ChatGPT.
• “Couldn’t register with … sign-in service” או “add an OAuth Client ID” (Claude Desktop) — המחבר המותאם אישית נוסף עם אפשרות התחברות. אין מזהה לקוח OAuth להזנה: הסר את המחבר והוסף אותו שוב עם Authentication → No sign in ומפתח ה-API שלך ככותרת בקשה X-API-Key, כפי שמוסבר ב-Claude Desktop.
• Claude Desktop לא מציג כלים לאחר עריכת קובץ ההגדרות — קובץ ההגדרות מתעלם מערך "url"; השתמש במחבר המותאם אישית או בטופס mcp-remote ב-Claude Desktop, וצא לחלוטין מהאפליקציה ופתח אותה מחדש.
• כלי מחזיר 403 — התוכנית או תפקיד הצוות שלך אינם מאפשרים פעולה זו; שרת ה-MCP לא אוכף שום דבר נוסף, זו אותה בדיקת הרשאות כמו ב-API.
• כלי לא נמצא — רשימת הכלים נוצרת בזמן אמת מה-API, כך שהיא תמיד תואמת לגרסה הנוכחית; התחבר מחדש כדי לרענן.
• אזהרת אבטחה או תעודה בדומיין שלך — הפניית רשומת DNS אלינו אינה מספיקה כשלעצמה: יש לאמת גם את תת-הדומיין בלוח הבקרה לפני שיוכל להגיש חיבור מאובטח. סוכנויות White-label יכולות להציב את כתובת ה-MCP בדומיין שלהן (למשל mcp.youragency.com) מכרטיסיית Custom domain תחת Settings → White Labeling — הוסף תחילה את ה-CNAME אצל הרשם שלך, לאחר מכן הזן את שם המארח בבלוק MCP domain (AI assistants) ולחץ על Verify, באותו תהליך כמו שאר תת-הדומיינים הממותגים שלך. הכתובת הממותגת משמיטה את כלי הסוכנות; המשך להשתמש בכתובת הסטנדרטית, הלא-ממותגת עבורם. עד שהכתובת הממותגת שלך תאומת, השתמש בכתובת הסטנדרטית, הלא-ממותגת: בטוח לשתף אותה עם לקוחות.

צעדים הבאים #

• גישת API — יצירה או החלפה של המפתח שחיבור זה משתמש בו.
• Webhooks — המקביל מבוסס ה-push לחיבור ה-MCP מבוסס ה-pull הזה.