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

<span data-t="appName">DM Champ</span> מספקת **שרת MCP** רשמי — נקודת קצה של פרוטוקול הקשר מודל (Model Context Protocol) המאפשרת לעוזרי בינה מלאכותית כמו **Claude Code**, **Claude Desktop**, **ChatGPT**, **Cursor** והאפליקציות שלכם לשלוט בחשבון ה-<span data-t="appName">DM Champ</span> שלכם ישירות. בקשו בשפה פשוטה ("הצג את הקמפיינים הפעילים שלי", "הוסף את הליד הזה", "כמה עלתה לי ה-AI השבוע?") והעוזר יקרא עבורכם ל-API של <span data-t="appName">DM Champ</span>.

זהו אותו ממשק API v1 המתועד ב[סעיף ה-API](../api/getting-started.md), ומאומת באמצעות מפתח ה-API האישי שלך. שרת ה-MCP בונה כלי אחד עבור כל פעולה במפרט ה-API המפורסם שלנו, כך שהוא מכסה את רוב ה-API בגרסה v1, אך לא את כולו: אנשי קשר, הודעות, קמפיינים, סוכני AI, בסיס ידע, פגישות, ניתוח נתונים, תגיות, רשימות ותתי-חשבונות. שידורים, אוטומציות ועסקאות אינם זמינים עדיין ככלי MCP — השתמש ב-REST API ישירות עבורם. במסגרת מה שהוא חושף, אין הרשאות לכל כלי ואין ברירת מחדל של קריאה בלבד, לכן מפתח ה-API הוא בקרת הגישה המלאה.

- **נקודת קצה:** `https://mcp.youraiconnector.com/mcp`
- **אימות:** מפתח ה-API של <span data-t="appName">DM Champ</span> שלכם (נשלח ככותרת `X-API-Key`)
- **דרישות:** תוכנית עם גישת API. [צרו מפתח API →](api-access.md#generating-your-api-key)

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

## Claude Code

```bash
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` עבור הצוות שלך:

```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` שלך (הגדרות → מפתח → ערוך הגדרות) ו-
הוסף:

```json
{
  "mcpServers": {
    "dm-champ": {
      "type": "http",
      "url": "https://mcp.youraiconnector.com/mcp",
      "headers": { "X-API-Key": "YOUR_API_KEY" }
    }
  }
}
```

הפעילו מחדש את Claude Desktop. הכלים של <span data-t="appName">DM Champ</span> יופיעו בתפריט הכלים.

## ChatGPT

מחברי MCP מותאמים אישית זמינים ב-ChatGPT Business, Enterprise ו-Pro. בעל סביבת עבודה או מנהל מערכת חייבים להפעיל תחילה את **מצב מפתח / מחברים מותאמים אישית** בהגדרות סביבת העבודה — ללא פעולה זו, האפשרות ליצור מחבר לא תופיע לעולם.

לאחר מכן צרו את המחבר עם:

- **כתובת URL:** `https://mcp.youraiconnector.com/mcp`
- **אימות:** כותרות מותאמות אישית
- **שם כותרת:** `X-API-Key`
- **ערך כותרת:** מפתח ה-API של <span data-t="appName">DM Champ</span> שלכם

ה-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, כך שסוכן שתבנו יוכל להשתמש בכלים של <span data-t="appName">DM Champ</span> ללא צורך בלקוח נפרד:

```json
{
  "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](../agency/api-for-agencies.md), המכסה יותר אפשרויות.

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

## מתן מסמכי העזרה לעוזר שלך

שרת ה-MCP מעניק לעוזר את ה-**חשבון** שלך; הוא לא מעניק לו את התיעוד הזה. אם ברצונך שהוא יענה נכון גם על שאלות "איך אני...", כוון אותו אל `https://docs.dmchamp.com/llms.txt` (אינדקס של כל דפי העזרה עם קישור לגרסת ה-Markdown של כל דף) או אל `https://docs.dmchamp.com/llms-full.txt` (כל התיעוד בקובץ Markdown אחד). שניהם ציבוריים, אינם דורשים מפתח, ונבנים מחדש עם כל שינוי בתיעוד. ראה [קריאת מסמכים אלו כ-Markdown](../api/getting-started.md#reading-these-docs-as-markdown).

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

מפתח ה-API שחיבור זה משתמש בו נמצא ב-**הגדרות (Settings) ← אינטגרציות (Integrations) ← מפתח API** — סעיף נפרד, שאינו קשור ל-Webhooks. עיין ב[גישת API](api-access.md#generating-your-api-key) עבור הצעדים המדויקים.

## פתרון בעיות

- **"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**, זהו אותו תהליך כמו בשאר תת-הדומיינים הממותגים שלך. עד לאימות, השתמש בכתובת הסטנדרטית שלעיל — היא אינה ממותגת, לכן בטוח לשתף אותה עם לקוחות.

---

## צעדים הבאים

- [גישת API](api-access.md) — יצירה או החלפה של המפתח שחיבור זה משתמש בו.
- [Webhooks](webhooks.md) — המקביל מבוסס ה-push לחיבור ה-MCP מבוסס ה-pull הזה.