חיבור עוזרי AI (MCP)
DM Champ מספקת שרת MCP רשמי — נקודת קצה של פרוטוקול הקשר מודל (Model Context Protocol) המאפשרת לעוזרי בינה מלאכותית כמו Claude Code, Claude Desktop, ChatGPT, Cursor והאפליקציות שלכם לשלוט בחשבון ה-DM Champ שלכם ישירות. בקשו בשפה פשוטה (“הצג את הקמפיינים הפעילים שלי”, “הוסף את הליד הזה”, “כמה עלתה לי ה-AI השבוע?”) והעוזר יקרא עבורכם ל-API של DM Champ.
זהו אותו ממשק API v1 המתועד בסעיף ה-API, ומאומת באמצעות מפתח ה-API האישי שלך. שרת ה-MCP בונה כלי אחד עבור כל פעולה במפרט ה-API המפורסם שלנו, כך שהוא מכסה את רוב ה-API בגרסה v1, אך לא את כולו: אנשי קשר, הודעות, קמפיינים, סוכני AI, בסיס ידע, פגישות, ניתוח נתונים, תגיות, רשימות ותתי-חשבונות. שידורים, אוטומציות ועסקאות אינם זמינים עדיין ככלי MCP — השתמש ב-REST API ישירות עבורם. במסגרת מה שהוא חושף, אין הרשאות לכל כלי ואין ברירת מחדל של קריאה בלבד, לכן מפתח ה-API הוא בקרת הגישה המלאה.
- נקודת קצה:
https://mcp.youraiconnector.com/mcp - אימות: מפתח ה-API של DM Champ שלכם (נשלח ככותרת
X-API-Key) - דרישות: תוכנית עם גישת API. צרו מפתח API →
מפתח ה-API שלך פועל על החשבון שלך, עם אותן הרשאות כמו שאר ה-API — והוא יכול לקרוא את חשבונות הלקוחות שאתה מנהל, אם אתה נמצא בתוכנית סוכנות (ראה להלן). התייחס אליו כאל סיסמה. באפשרותך לבטל אותו בכל עת מתוך הגדרות → אינטגרציות → מפתח API, מה שינתק באופן מיידי את הגישה של העוזר.
Claude Code
claude mcp add --transport http dm-champ https://mcp.youraiconnector.com/mcp \
--header "X-API-Key: YOUR_API_KEY"
לאחר מכן הרץ את /mcp בתוך Claude Code כדי לוודא שהוא מציג dm-champ ✓ connected.
כברירת מחדל, השרת מתווסף בהיקף מקומי (רק עבורך, בפרויקט זה).
השתמש ב---scope user כדי להפוך אותו לזמין בכל הפרויקטים שלך, או ב---scope project to commit it to a repo’s .mcp.json עבור הצוות שלך:
{
"mcpServers": {
"dm-champ": {
"type": "http",
"url": "https://mcp.youraiconnector.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
Claude Desktop
ערוך את ה-claude_desktop_config.json שלך (הגדרות → מפתח → ערוך הגדרות) ו-
הוסף:
{
"mcpServers": {
"dm-champ": {
"type": "http",
"url": "https://mcp.youraiconnector.com/mcp",
"headers": { "X-API-Key": "YOUR_API_KEY" }
}
}
}
הפעילו מחדש את Claude Desktop. הכלים של DM Champ יופיעו בתפריט הכלים.
ChatGPT
מחברי MCP מותאמים אישית זמינים ב-ChatGPT Business, Enterprise ו-Pro. בעל סביבת עבודה או מנהל מערכת חייבים להפעיל תחילה את מצב מפתח / מחברים מותאמים אישית בהגדרות סביבת העבודה — ללא פעולה זו, האפשרות ליצור מחבר לא תופיע לעולם.
לאחר מכן צרו את המחבר עם:
- כתובת URL:
https://mcp.youraiconnector.com/mcp - אימות: כותרות מותאמות אישית
- שם כותרת:
X-API-Key - ערך כותרת: מפתח ה-API של DM Champ שלכם
ה-URL חייב להסתיים ב-/mcp. הדבקה של https://mcp.youraiconnector.com בלבד היא הטעות הנפוצה ביותר — ChatGPT בודק את הכתובת המדויקת הזו, לא מוצא שם דבר, ומציג את השגיאה “Unable to add connector URL”.
Cursor ולקוחות MCP אחרים
רוב העורכים התומכים ב-MCP משתמשים באותו מבנה .mcp.json המוצג לעיל (שרת HTTP
עם url וכותרת X-API-Key). הוסף שרת dm-champ המצביע
על https://mcp.youraiconnector.com/mcp והדבק את מפתח ה-API שלך בכותרת.
ה-API של Claude (בנייה לתוך האפליקציה שלך)
ניתן לחבר את שרת ה-MCP באופן תכנותי באמצעות מחבר ה-MCP של ה-API של Claude, כך שסוכן שתבנו יוכל להשתמש בכלים של DM Champ ללא צורך בלקוח נפרד:
{
"model": "claude-opus-4-8",
"messages": [{ "role": "user", "content": "List my live campaigns" }],
"mcp_servers": [
{
"type": "url",
"name": "dm-champ",
"url": "https://mcp.youraiconnector.com/mcp",
"authorization_token": "YOUR_API_KEY"
}
]
}
מה באפשרותך לעשות
בתוך החלק של ה-API בגרסה v1 ששרת ה-MCP חושף, העוזר בוחר את הכלי המתאים באופן אוטומטי:
- קמפיינים: הצגה, יצירה, עדכון, השהיה/המשך, בדיקת הגדרות הבוט.
- אנשי קשר: חיפוש, יצירה, תיוג, הוספה לרשימות, ייבוא.
- מאגר ידע / שאלות נפוצות: הוספה, עריכה, ייבוא מרוכז, אישור הצעות AI.
- הודעות: קריאת שיחות, שליחת הודעה לאיש קשר.
- פגישות: הצגה, קביעה, ביטול.
- משימות: יצירה, השלמה, הצגה.
- ניתוח נתונים: סטטיסטיקות הודעות, ניצול קרדיטים, עלות AI.
- ערוצים: בדיקת מצב חיבור, התחלת תהליך חיבור.
שאלות על חשבונות הלקוחות שלך (סוכנויות)
חיבור אחד מכסה את כל החשבונות שאתה מנהל. אינך צריך להוסיף חיבור שני לכל לקוח: בתוכנית סוכנות, העוזר יכול לקרוא כל חשבון לקוח שתחת ניהולך, כך שתוכל לשאול על כולם בשיחה אחת.
פשוט ציין את שם הלקוח:
- “כמה אנשי קשר יש ל-Bella’s Bistro?”
- “כמה עלה ה-AI לכל אחד מהלקוחות שלי השבוע?”
- “אילו קמפיינים פעילים עבור Northside Dental, ומה מצב הערוצים שלהם?”
זה מכסה קריאת אנשי קשר, הודעות, צ’אטים, קמפיינים, פגישות, משימות, תגיות, אירועים, שאלות נפוצות, מקורות בסיס ידע, מספרי טלפון, ערוצים, webhooks וניתוח נתונים. אנו מוודאים שהחשבון אכן שייך לך לפני שכל פעולה מתבצעת — בקשה עבור חשבון שאינו שלך תחזיר “לא נמצא”. אם לא תציין לקוח, העוזר יקרא את החשבון שלך, בדיוק כפי שהיה קודם.
שינוי חשבון של לקוח מוגבל יותר. הגדרת סוכני בינה מלאכותית, פונקציות מותאמות אישית, תבניות WhatsApp, נקודות כניסה, חיבורי ערוצים, סטטוס קמפיין ורכישת מספר עובדים כולם עבור לקוח בעל שם; רוב פעולות הכתיבה האחרות עדיין מבוצעות בחשבון שלך, לכן בצע אותן מהמפתח של אותו לקוח או מ-REST API, המכסה יותר אפשרויות.
זוהי גם התשובה עבור לקוח שמנהל מספר עסקים תחת התחברות אחת. תן לכל עסק חשבון משלו, ולאחר מכן הזמן את האימייל של הלקוח כחבר צוות בכולם: הם מתחברים פעם אחת ועוברים בין המותגים שלהם באמצעות בורר החשבונות בסרגל הצד.
מתן מסמכי העזרה לעוזר שלך
שרת ה-MCP מעניק לעוזר את ה-חשבון שלך; הוא לא מעניק לו את התיעוד הזה. אם ברצונך שהוא יענה נכון גם על שאלות “איך אני…”, כוון אותו אל https://docs.youraiconnector.com/llms.txt (אינדקס של כל דפי העזרה עם קישור לגרסת ה-Markdown של כל דף) או אל https://docs.youraiconnector.com/llms-full.txt (כל התיעוד בקובץ Markdown אחד). שניהם ציבוריים, אינם דורשים מפתח, ונבנים מחדש עם כל שינוי בתיעוד. ראה קריאת מסמכים אלו כ-Markdown.
מציאה או יצירה של מפתח ה-API שלך
מפתח ה-API שחיבור זה משתמש בו נמצא ב-הגדרות (Settings) ← אינטגרציות (Integrations) ← מפתח API — סעיף נפרד, שאינו קשור ל-Webhooks. עיין בגישת API עבור הצעדים המדויקים.
פתרון בעיות
- “Unable to add connector URL” (ChatGPT) / “connection refused” — בכתובת חסר
/mcpבסוף. השתמש ב-https://mcp.youraiconnector.com/mcp, לא ב-https://mcp.youraiconnector.com. Needs authentication/ 401 — מפתח ה-API שלך חסר או שגוי. הוסף מחדש את השרת עםX-API-Keyתקין.- כלי מחזיר
403— התוכנית או תפקיד הצוות שלך אינם מאפשרים פעולה זו; שרת ה-MCP אינו אוכף דבר נוסף, מדובר באותה בדיקת הרשאות כמו ב-API. - כלי לא נמצא — רשימת הכלים נוצרת בזמן אמת מה-API, לכן היא תמיד תואמת לגרסה הנוכחית; התחבר מחדש כדי לרענן.
- אזהרת אבטחה או תעודה בדומיין שלך — הפניית רשומת DNS אלינו אינה מספיקה כשלעצמה: יש לאמת את תת-הדומיין בלוח הבקרה לפני שיוכל לספק חיבור מאובטח. סוכנויות White-label יכולות להציב את כתובת ה-MCP בדומיין שלהן (למשל
mcp.youragency.com) מתוך כרטיס Custom domain תחת Settings → White Labeling — הוסף תחילה את ה-CNAME אצל הרשם שלך, לאחר מכן הזן את שם המארח בבלוק MCP domain (AI assistants) ולחץ על Verify, זהו אותו תהליך כמו בשאר תת-הדומיינים הממותגים שלך. עד לאימות, השתמש בכתובת הסטנדרטית שלעיל — היא אינה ממותגת, לכן בטוח לשתף אותה עם לקוחות.