שרת ה-MCP של מסר 10 הוא קוד פתוח ברישיון MIT, והוא נבנה כך שהכלים נגזרים מחוזה ה-API החי בזמן ריצה. המשמעות המעשית: הכיסוי מלא מעצם המבנה, ואם הפלטפורמה מוסיפה פעולה, היא מופיעה בלי לחכות לגרסה חדשה.
מה אפשר לעשות עם זה
לשאול את החשבון שאלות בשפה רגילה במקום לכתוב קוד לכל שאילתה: כמה נמענים יש ברשימה, איזה קמפיין נשלח מתי, מה מצב המכסה. ומעבר לזה, לבנות אוטומציות שמוסיפות אנשי קשר, מכינות טיוטות ומסנכרנות רשימות מול המערכות שלכם, בכל רמת הרשאה שתבחרו.
61 פעולות יושבות בחוזה ה-API. במצב ברירת המחדל מוצגים 14 כלי קריאה, והשאר נפתחים רק כשאתם מחליטים לפתוח אותם.
התקנה, שתי דרכים
א. דרך 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, ואז מפנים את הכלי לנתיב המלא.
{
"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 מאפשר גם שם משתמש וסיסמה, והשרת הזה נמנע מזה במכוון ועובד עם מפתח בלבד.
הוא לא מניח שתשובה תקינה היא הצלחה
הפלטפורמה מחזירה סטטוס תקין גם על כישלון, וההצלחה יושבת בשדה התוצאה. השרת קורא את השדה הזה, נכשל במפורש על כל מה שאינו הצלחה, ומצרף הסבר מה לעשות.
הוא לא בולע הצלחה חלקית
כשחלק מרשומות בקבוצה לא נכנסו, זה עולה כאזהרה ולא נבלע בשקט.
שאלות נפוצות
מה זה בכלל MCP?
MCP הוא תקן פתוח לחיבור מודלים למערכות חיצוניות. במקום לכתוב אינטגרציה לכל כלי בנפרד, המערכת מציגה את היכולות שלה כ“כלים”, והמודל יודע להפעיל אותם. שרת ה-MCP של מסר 10 הוא הגשר הזה בין החשבון שלכם למודל.
איפה מוצאים את מפתח ה-API ואת מספר החשבון?
מפתח ה-API נמצא בממשק מסר 10, תחת החשבון שלי, הגדרות מתקדמות, הגדרות API. אם מספר החשבון לא מופיע לכם מול העיניים, התמיכה נותנת אותו בשיחה אחת.
האם המודל יכול לשלוח דיוור בטעות?
לא במצב ברירת המחדל. השרת עולה במצב קריאה בלבד, וכלי השליחה פשוט אינם מופיעים ברשימת הכלים. כדי לאפשר שליחה צריך לשנות את MESER10_MODE במפורש, ואז עדיין חלה תקרת נמענים לכל קריאה בודדת.
האם המודל רואה את מפתח ה-API שלי?
לא. השדות של פרטי ההזדהות מושמטים מכל סכמת כלי, והשרת ממלא אותם בעצמו מהקונפיג. השרת גם אינו משתמש בשם משתמש וסיסמה בכלל, אלא במפתח בלבד.
קיבלתי LoginFailed על מפתח שעבד קודם. מה קרה?
ככל הנראה חסימה זמנית אחרי כמה ניסיונות הזדהות כושלים ברצף. החסימה היא על כתובת ה-IP הפונה, ולכן הנפקת מפתח חדש לא תעזור והיא עלולה להאריך את הבעיה. הפעולה הנכונה היא להפסיק לפנות, לוודא שאין לולאת ניסיונות חוזרים בקוד, ולפנות לתמיכה.
אפשר להגביל את הגישה לכתובת IP אחת?
כן, וזה מומלץ אם אתם מריצים משרת עם כתובת קבועה. בהגדרות המתקדמות בחשבון אפשר להגביל פניות API לכתובות IP שאתם מאשרים, וכל פנייה מכתובת אחרת תידחה.
איזה גרסת Node צריך?
גרסה 18 ומעלה. אם אתם מתקינים דרך npx אין מה להתקין מראש מעבר ל-Node עצמו.
זה עולה כסף?
השרת עצמו חינם וקוד פתוח ברישיון MIT. מה שנצרך הוא חשבון מסר 10, והשימוש נספר לפי החבילה שלכם בדיוק כמו כל פנייה אחרת ל-API.
תמיכה
נתקעתם? support@meser10.co.il או 03-7440020, ראשון עד חמישי 9:00 עד 17:00. צרפו את שם הפעולה ואת התוצאה שחזרה, ואף פעם לא את המפתח עצמו. אם מפתח נחשף במקום כלשהו, הנפיקו חדש בממשק.
רוצים לראות את שאר דרכי החיבור? עמוד האינטגרציות ותיעוד ה-API.