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

לפני שמתחילים

נדרשים חשבון אקטיב טרייל בתוכנית Plus ומעלה וכלי AI (לקוח MCP) שיכול לשלוח כותרת בקשה (header) מותאמת אישית.

הגדרה

ערך

כתובת השרת

https://mcp.activetrail.com/v1

פרוטוקול תעבורה (Transport)

Streamable HTTP (שרת מרוחק, אין מה להתקין)

שם הכותרת

Authorization

ערך הכותרת

מפתח ה-API שלכם כמו שהוא, בלי Bearer

גישה

קריאה בלבד

תוכנית

Plus ומעלה

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

קבלת מפתח API

שרת ה-MCP משתמש במפתח API רגיל של אקטיב טרייל.

  1. היכנסו לאקטיב טרייל.

  2. עברו אל אינטגרציות ← API ← מפתחות API.

  3. צרו מפתח API חדש והעתיקו אותו.

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

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

כלי AI נתמכים

כל כלי שתומך בשרתי Streamable HTTP מרוחקים עם כותרת Authorization מותאמת אישית יכול להתחבר.

כלי

איך

Claude (מחברים באתר ובאפליקציית הדסקטופ)

מחבר מותאם אישית (Custom connector) עם כותרות בקשה (מומלץ)

Claude Code

claude mcp add עם --header

Claude Desktop

הגשר mcp-remote בקובץ ההגדרות

Cursor

url + headers בקובץ mcp.json

VS Code (GitHub Copilot)

type: http + headers בקובץ mcp.json

Gemini CLI

httpUrl + headers בקובץ settings.json

OpenAI Codex

url + env_http_headers בקובץ config.toml

Windsurf

serverUrl + headers בקובץ mcp_config.json

הגדרת הכלי

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

# macOS / Linux: add to ~/.zshrc or ~/.bashrc
export ACTIVETRAIL_API_KEY="YOUR_ACTIVETRAIL_API_KEY"

# Windows (PowerShell), then restart the tool
setx ACTIVETRAIL_API_KEY "YOUR_ACTIVETRAIL_API_KEY"

ערך הכותרת הוא המפתח בלבד. אל תוסיפו Bearer.

Claude (מחברים באתר ובאפליקציית הדסקטופ)

זו הדרך המומלצת ל-Claude, בחשבונות אישיים ובחשבונות ארגוניים.

  1. פתחו את חלון המחבר המותאם אישית:

    • בתוכניות Free, Pro, Max: Customize > Connectors > Add custom connector.

    • בתוכניות Team, Enterprise: בעל הארגון (Owner) פותח את Organization settings > Connectors > Add > Custom. לאחר מכן החברים מתחברים מתוך Customize > Connectors.

  2. כתובת השרת (Server URL): https://mcp.activetrail.com/v1

  3. אימות (Authentication): No sign-in.

  4. תחת Request headers (כותרות בקשה), בחרו authorization והדביקו את המפתח שלכם כערך, בלי Bearer.

  5. לחצו על Add.

אם בחלון אין אזור Request headers, חשבון ה-Claude שלכם לא מציע אותו: השתמשו בהגדרה של Claude Desktop שלמטה. בתוכניות Team ו-Enterprise, בעל הארגון מגדיר את הכותרת פעם אחת, כך שכל החברים חולקים את אותו מפתח ואת הגישה שלו.

Claude Code

claude mcp add --transport http --scope user activetrail https://mcp.activetrail.com/v1 --header "Authorization: YOUR_ACTIVETRAIL_API_KEY"

בדקו עם claude mcp list, או עם /mcp בתוך שיחה.

Claude Desktop

נדרש Node.js (עבור npx). פתחו את Settings > Developer > Edit Config והוסיפו:

{
  "mcpServers": {
    "activetrail": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.activetrail.com/v1",
        "--header",
        "Authorization:${ACTIVETRAIL_API_KEY}"
      ],
      "env": {
        "ACTIVETRAIL_API_KEY": "YOUR_ACTIVETRAIL_API_KEY"
      }
    }
  }
}

השאירו את Authorization:${ACTIVETRAIL_API_KEY} בלי רווח אחרי הנקודתיים: רווחים בתוך args גורמים לתקלות ב-Windows. צאו מ-Claude Desktop ופתחו אותו מחדש.

Cursor

ערכו את ~/.cursor/mcp.json (לכל הפרויקטים) או את .cursor/mcp.json (לפרויקט אחד):

{
  "mcpServers": {
    "activetrail": {
      "url": "https://mcp.activetrail.com/v1",
      "headers": {
        "Authorization": "${env:ACTIVETRAIL_API_KEY}"
      }
    }
  }
}

הפעילו מחדש את Cursor.

VS Code (GitHub Copilot)

הריצו את MCP: Open User Configuration מתוך ה-Command Palette (לוח הפקודות) והוסיפו:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "activetrail-key",
      "description": "ActiveTrail API key",
      "password": true
    }
  ],
  "servers": {
    "activetrail": {
      "type": "http",
      "url": "https://mcp.activetrail.com/v1",
      "headers": {
        "Authorization": "${input:activetrail-key}"
      }
    }
  }
}

בפעם הראשונה VS Code מבקש את המפתח ושומר אותו באופן מאובטח.

Gemini CLI

ערכו את ~/.gemini/settings.json:

{
  "mcpServers": {
    "activetrail": {
      "httpUrl": "https://mcp.activetrail.com/v1",
      "headers": {
        "Authorization": "$ACTIVETRAIL_API_KEY"
      }
    }
  }
}

השתמשו ב-httpUrl ולא ב-url: Gemini CLI מפרש את url כפרוטוקול SSE הישן. בדקו עם /mcp.

OpenAI Codex

ערכו את ~/.codex/config.toml:

[mcp_servers.activetrail]
url = "https://mcp.activetrail.com/v1"
env_http_headers = { "Authorization" = "ACTIVETRAIL_API_KEY" }

אל תשתמשו ב-bearer_token_env_var: הוא מוסיף קידומת Bearer, שהשרת הזה לא מצפה לה. בדקו עם /mcp ב-Codex.

Windsurf

ערכו את mcp_config.json:

{
  "mcpServers": {
    "activetrail": {
      "serverUrl": "https://mcp.activetrail.com/v1",
      "headers": {
        "Authorization": "${env:ACTIVETRAIL_API_KEY}"
      }
    }
  }
}

כל כלי אחר

כתובת https://mcp.activetrail.com/v1, פרוטוקול Streamable HTTP, כותרת Authorization: YOUR_ACTIVETRAIL_API_KEY. כלי שלא תומך בכותרות מותאמות אישית יכול להשתמש בגשר mcp-remote מההגדרה של Claude Desktop.

בדיקת החיבור

הכלי שלכם אמור להציג 9 כלים של אקטיב טרייל. אחר כך נסו שאלה אחת לכל תחום:

  • "הצג את קמפייני הדיוור שלי מ-30 הימים האחרונים, עם שיעורי הפתיחה וההקלקה."

  • "אילו קמפיינים ב-WhatsApp שלחתי בחודש שעבר?"

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

  • "מצא את הנמען name@example.com והצג את הסטטוס שלו."

כלים זמינים

כלי

מחזיר

search_contacts

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

search_contacts_with_sms_state

אותו דבר כמו search_contacts, ובנוסף סטטוס המנוי ל-SMS.

search_external_contacts

נמענים ממופים ממערכת CRM עם External ID ושם. סינון לפי סטטוס ותאריכים בלבד, בלי מונח חיפוש.

list_email_campaign_reports

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

list_sms_campaign_reports

ביצועי SMS לכל קמפיין, כולל מקליקים וסך ההקלקות. חיפוש לפי שם הקמפיין.

list_whatsapp_campaign_reports

ביצועי WhatsApp לכל קמפיין. חיפוש לפי שם הקמפיין.

list_push_campaign_reports

ביצועי Push לכל קמפיין. חיפוש לפי שם הקמפיין.

list_automations

אוטומציות עם ID, שם, מצב ומספר הטריגרים.

get_automation_overview

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

מגבלות ופתרון בעיות

כדאי לדעת

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

  • התוצאות מגיעות בעמודים: עד 100 בכל עמוד, ו-20 כברירת מחדל בדוחות קמפיינים ובאוטומציות.

  • נתוני האוטומציות הם סיכומים מצטברים מאז ההפעלה, לא מסוננים לפי תאריך, ואינם כוללים אירועים של בוטים.

  • רשימת אוטומציות בלי סינון לפי מצב כוללת גם אוטומציות מחוקות. בקשו במפורש אוטומציות שפורסמו.

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

בעיה

סיבה

פתרון

שגיאה 401 או unauthorized

מפתח שגוי, או Bearer שנוסף לפניו

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

לא מוצגים כלים

הכלי לא הופעל מחדש, או JSON לא תקין

הפעילו מחדש את הכלי. ודאו שקובץ ההגדרות תקין.

הכלי list_automations מחזיר 403

יכולת האוטומציות לא פעילה בחשבון

פנו לתמיכה של אקטיב טרייל.

הכלי search_external_contacts מחזיר 405

יכולת ה-External IDs לא פעילה בחשבון

פנו לתמיכה של אקטיב טרייל.

ב-Claude Desktop מוצגת שגיאת mcp-remote

Node.js לא מותקן, או שיש רווח אחרי Authorization:

התקינו Node.js. מחקו את הרווח.

Gemini CLI לא מתחבר

נעשה שימוש ב-url במקום httpUrl

עברו ל-httpUrl.

העוזר מציע לשלוח או לערוך

השרת מיועד לקריאה בלבד

בצעו את השינוי באקטיב טרייל.