שרת ה-MCP של אקטיב טרייל מאפשר לעוזר AI לקרוא את החשבון שלכם: נמענים, דוחות קמפיינים בכל הערוצים ואוטומציות. השרת מיועד לקריאה בלבד וזמין בתוכניות Plus ומעלה. ב-Claude, הדרך המהירה ביותר מתוארת במאמר חיבור אקטיב טרייל ל-Claude.
לפני שמתחילים
נדרשים חשבון אקטיב טרייל בתוכנית Plus ומעלה וכלי AI (לקוח MCP) שיכול לשלוח כותרת בקשה (header) מותאמת אישית.
|
הגדרה |
ערך |
|---|---|
|
כתובת השרת |
|
|
פרוטוקול תעבורה (Transport) |
Streamable HTTP (שרת מרוחק, אין מה להתקין) |
|
שם הכותרת |
|
|
ערך הכותרת |
מפתח ה-API שלכם כמו שהוא, בלי |
|
גישה |
קריאה בלבד |
|
תוכנית |
Plus ומעלה |
השרת רק קורא נתונים. הוא לא יכול ליצור, לערוך, לשלוח או למחוק שום דבר בחשבון שלכם.
קבלת מפתח API
שרת ה-MCP משתמש במפתח API רגיל של אקטיב טרייל.
-
היכנסו לאקטיב טרייל.
-
עברו אל אינטגרציות ← API ← מפתחות API.
-
צרו מפתח API חדש והעתיקו אותו.
-
שמרו אותו מיד במנהל סיסמאות. המפתח מוצג פעם אחת בלבד, ואי אפשר לשחזר אותו אחר כך.
המפתח נותן את אותה גישה כמו ה-API, לכן שמרו עליו כמו על סיסמה. צרו מפתח נפרד לכל אדם או כלי, כדי שתוכלו לבטל מפתח אחד בלי לפגוע באחרים. לעולם אל תשמרו אותו בקובץ הגדרות משותף או במאגר קוד (repository).
כלי AI נתמכים
כל כלי שתומך בשרתי Streamable HTTP מרוחקים עם כותרת Authorization מותאמת אישית יכול להתחבר.
|
כלי |
איך |
|---|---|
|
Claude (מחברים באתר ובאפליקציית הדסקטופ) |
מחבר מותאם אישית (Custom connector) עם כותרות בקשה (מומלץ) |
|
Claude Code |
|
|
Claude Desktop |
הגשר |
|
Cursor |
|
|
VS Code (GitHub Copilot) |
|
|
Gemini CLI |
|
|
OpenAI Codex |
|
|
Windsurf |
|
הגדרת הכלי
החליפו את 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, בחשבונות אישיים ובחשבונות ארגוניים.
-
פתחו את חלון המחבר המותאם אישית:
-
בתוכניות Free, Pro, Max: Customize > Connectors > Add custom connector.
-
בתוכניות Team, Enterprise: בעל הארגון (Owner) פותח את Organization settings > Connectors > Add > Custom. לאחר מכן החברים מתחברים מתוך Customize > Connectors.
-
-
כתובת השרת (Server URL):
https://mcp.activetrail.com/v1 -
אימות (Authentication): No sign-in.
-
תחת Request headers (כותרות בקשה), בחרו
authorizationוהדביקו את המפתח שלכם כערך, בליBearer. -
לחצו על 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 והצג את הסטטוס שלו."
כלים זמינים
|
כלי |
מחזיר |
|---|---|
|
|
נמענים, עם סינון לפי סטטוס, כתובת מייל או טלפון ותאריכי שינוי סטטוס. עד 100 בכל עמוד. |
|
|
אותו דבר כמו |
|
|
נמענים ממופים ממערכת CRM עם External ID ושם. סינון לפי סטטוס ותאריכים בלבד, בלי מונח חיפוש. |
|
|
ביצועי מייל לכל קמפיין: נשלחו, פתיחות, הקלקות, שיעורים, שגיאות, הסרות ותלונות ספאם. |
|
|
ביצועי SMS לכל קמפיין, כולל מקליקים וסך ההקלקות. חיפוש לפי שם הקמפיין. |
|
|
ביצועי WhatsApp לכל קמפיין. חיפוש לפי שם הקמפיין. |
|
|
ביצועי Push לכל קמפיין. חיפוש לפי שם הקמפיין. |
|
|
אוטומציות עם ID, שם, מצב ומספר הטריגרים. |
|
|
נתונים מצטברים לאוטומציה אחת: הודעות לפי ערוץ, ונמענים שהתחילו וסיימו. |
מגבלות ופתרון בעיות
כדאי לדעת
-
דוחות קמפיינים בלי תאריכים מכסים את 3 החודשים האחרונים. כדי להגיע אחורה יותר, בקשו טווח תאריכים.
-
התוצאות מגיעות בעמודים: עד 100 בכל עמוד, ו-20 כברירת מחדל בדוחות קמפיינים ובאוטומציות.
-
נתוני האוטומציות הם סיכומים מצטברים מאז ההפעלה, לא מסוננים לפי תאריך, ואינם כוללים אירועים של בוטים.
-
רשימת אוטומציות בלי סינון לפי מצב כוללת גם אוטומציות מחוקות. בקשו במפורש אוטומציות שפורסמו.
-
אי אפשר למיין דוחות מייל לפי שיעור. השוו את כמות השליחות לפני שמדרגים קמפיינים לפי שיעור.
|
בעיה |
סיבה |
פתרון |
|---|---|---|
|
שגיאה 401 או unauthorized |
מפתח שגוי, או |
שלחו את המפתח בלבד ב- |
|
לא מוצגים כלים |
הכלי לא הופעל מחדש, או JSON לא תקין |
הפעילו מחדש את הכלי. ודאו שקובץ ההגדרות תקין. |
|
הכלי |
יכולת האוטומציות לא פעילה בחשבון |
פנו לתמיכה של אקטיב טרייל. |
|
הכלי |
יכולת ה-External IDs לא פעילה בחשבון |
פנו לתמיכה של אקטיב טרייל. |
|
ב-Claude Desktop מוצגת שגיאת |
Node.js לא מותקן, או שיש רווח אחרי |
התקינו Node.js. מחקו את הרווח. |
|
Gemini CLI לא מתחבר |
נעשה שימוש ב- |
עברו ל- |
|
העוזר מציע לשלוח או לערוך |
השרת מיועד לקריאה בלבד |
בצעו את השינוי באקטיב טרייל. |