להמשך קריאה: לאיזו מערכת דיוור יש שרת MCP אמיתי

שרת MCP: לחבר את מסר 10 לקלוד ולכל סוכן AI

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

שרת ה-MCP של מסר 10 (Model Context Protocol) הוא קוד פתוח ברישיון MIT, והוא נבנה כך שהכלים נגזרים מחוזה ה-API החי בזמן ריצה. המשמעות המעשית: הכיסוי מלא מעצם המבנה, ואם הפלטפורמה מוסיפה פעולה, היא מופיעה בלי לחכות לגרסה חדשה.

מה אפשר לעשות עם זה

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

61 פעולות יושבות בחוזה ה-API. במצב ברירת המחדל מוצגים 14 כלי קריאה, והשאר נפתחים רק כשאתם מחליטים לפתוח אותם.

התקנה, שתי דרכים

א. דרך npm, בלי להוריד כלום

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

מדביקים את הבלוק הבא בקובץ ההגדרות של הכלי שלכם (ב-Claude Desktop זה claude_desktop_config.json), ומפעילים אותו מחדש.

{
  "mcpServers": {
    "meser10": {
      "command": "npx",
      "args": ["-y", "@meser10/mcp-server"],
      "env": {
        "MESER10_API_KEY": "המפתח שלכם",
        "MESER10_USER_ID": "מספר החשבון",
        "MESER10_MODE": "read"
      }
    }
  }
}

ב. מקובץ ZIP

אם אתם מעדיפים להחזיק את הקוד אצלכם: הורדת החבילה, גרסה 1.0.0. מחלצים לתיקייה קבועה, מריצים npm install ואחריו npm run build, ואז מפנים את הכלי לנתיב המלא.

הקוד המלא פתוח ב-GitHub: github.com/meser10/meser10-mcp. אפשר לשכפל את המאגר, לפתוח Issue או להציע שיפור.

{
  "mcpServers": {
    "meser10": {
      "command": "node",
      "args": ["C:/path/to/meser10-mcp-server/dist/index.js"],
      "env": {
        "MESER10_API_KEY": "המפתח שלכם",
        "MESER10_USER_ID": "מספר החשבון",
        "MESER10_MODE": "read"
      }
    }
  }
}

לפני שמתחילים: צריך Node.js בגרסה 18 ומעלה, חשבון מסר 10, ומפתח API. את המפתח מוצאים בממשק תחת החשבון שלי ← הגדרות מתקדמות ← הגדרות API, ושם גם אפשר להגביל את הפניות לכתובות IP מורשות.

ארבע רמות הרשאה, ומתחילים מהנמוכה

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

MESER10_MODE	מה זה	מה נפתח
read	ברירת המחדל	14 כלים. קריאת רשימות, קמפיינים, נתוני פתיחה ומכסות. שום דבר לא זז.
write	יצירה ועריכה	מוסיף אנשי קשר, רשימות וטיוטות קמפיין. עדיין לא שולח לאיש.
send	שליחה בפועל	מוסיף את הפעולות שמגיעות לנמענים אמיתיים וצורכות מהחבילה.
destructive	מחיקות	מוסיף מחיקה של רשומות. הרמה היחידה שאי אפשר לבטל אחריה.

ובנוסף לשער עצמה, MESER10_MAX_RECIPIENTS קובע תקרה לכל שליחה בודדת, ברירת המחדל 100. גם אם פתחתם שליחה, קריאה אחת לא יכולה לפנות לרשימה שלמה בטעות.

מה שהשרת לא עושה

המודל לא רואה את המפתח שלכם

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

השרת לא משתמש בסיסמה

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

הוא לא מניח שתשובה תקינה היא הצלחה

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

הוא לא בולע הצלחה חלקית

כשחלק מרשומות בקבוצה לא נכנסו, זה עולה כאזהרה ולא נבלע בשקט.

מה זה אומר מול מערכות אחרות

כשמערכת דיוור מציעה חיבור לסוכני AI, לרוב מדובר בגשר של ספק צד שלישי: הפעולות נחשפות דרך פלטפורמת אוטומציה, והמפתח שלכם עובר דרכה. שרת ה-MCP של מסר 10 הוא שרת משלנו, קוד פתוח ברישיון MIT, שרץ אצלכם ומדבר ישירות מול ה-API של החשבון. אין צד שלישי בדרך, אפשר לקרוא את הקוד, והשרת עולה במצב קריאה בלבד.

שאלות נפוצות

מה זה בכלל MCP?

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

איפה מוצאים את מפתח ה-API ואת מספר החשבון?

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

האם המודל יכול לשלוח דיוור בטעות?

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

האם המודל רואה את מפתח ה-API שלי?

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

קיבלתי LoginFailed על מפתח שעבד קודם. מה קרה?

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

אפשר להגביל את הגישה לכתובת IP אחת?

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

איזה גרסת Node צריך?

גרסה 18 ומעלה. אם אתם מתקינים דרך npx אין מה להתקין מראש מעבר ל-Node עצמו.

זה עולה כסף?

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

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

תמיכה

נתקעתם? support@meser10.co.il או 03-7440020, ראשון עד חמישי 9:00 עד 17:00. צרפו את שם הפעולה ואת התוצאה שחזרה, ואף פעם לא את המפתח עצמו. אם מפתח נחשף במקום כלשהו, הנפיקו חדש בממשק.

רוצים לראות את שאר דרכי החיבור? עמוד האינטגרציות ותיעוד ה-API.

מוכנים להתחיל?

פתחו חשבון ניסיון חינם במסר 10, ופנו לתמיכה לקבלת פרטי החיבור לטופס שלכם.

פתחו חשבון ניסיון חינם