חיבור סוכני AI ל-TrekMail באמצעות MCP

שרת ה-MCP של TrekMail מאפשר ללקוחות AI תואמים לנהל את תשתית הדוא"ל שלכם בשפה טבעית. הקטלוג שלו מכסה דומיינים, תיבות דואר, מיתוג וצוותים של White Label, ‏Drive, דוא"ל, יומן, העברות, תמיכה, חיוב ושירותים קשורים באמצעות אותו TrekMail API.

הקטלוג המלא אינו נטען בכל שיחה. TrekMail בונה את tools/list לפי פרטי האימות הפעילים: כלים שאינם בהיקפים שלהם מושמטים, וכך גם כלים שהוחרגו על ידי ערכת כלים שנבחרה, מצב קריאה בלבד, מגבלות תעבורה או הגדרת בטיחות מקומית. לכן פרטי אימות לדוא"ל בעלי היקף מצומצם מציגים רשימת כלי דוא"ל קומפקטית.

בחרו כיצד להתחבר

נתיבים 1-3 משתמשים ב-OAuth 2.1: בחיבור הראשון הדפדפן פותח את דף ההסכמה של TrekMail, אתם בודקים את ההרשאות המבוקשות והלקוח מקבל אסימון המוגבל לחשבון שלכם. שום אסימון tm_live_ ארוך טווח אינו מועתק אל הלקוח. אפשר לבטל כל חיבור בכל עת דרך סוכני AI ו-API → אסימונים → יישומים מחוברים.

מה תקבלו

• ערכת כלים ייעודית לחיבור, המסוננת לפני הרישום לפי ההרשאות והגדרות הבטיחות של החיבור הנוכחי.
• OAuth 2.1 + רישום לקוח דינמי: לקוח ה-AI רושם את עצמו, מנחה אתכם בדף הסכמה בדפדפן ומקבל אסימון בעל היקף מוגבל. אין צורך להעתיק ולהדביק אסימונים ארוכי טווח עבור נתיבי האינטרנט, שולחן העבודה או CLI.
• ארכיטקטורה עם שני אסימונים: אסימון תפעול נפרד לתשתית ואסימון הודעות לפעולות מלאות בדואר האינטרנט. בחיבור דרך OAuth, אסימוני הודעות מונפקים אוטומטית לכל תיבה לפי הצורך.
• אידמפוטנטיות אוטומטית בפעולות שדורשות אותה, כך שניסיון חוזר אינו מבצע שוב את אותה פעולה.
• מחיקה בשני שלבים: מחיקת תיבה דורשת כוונה ואישור מפורשים, ולאחר מכן מעבירה אותה אל נמחקו לאחרונה לצורך שחזור.
• בקרות בטיחות באירוח עצמי: מנהל שמריץ שרת MCP מסוג stdio בעצמו יכול לדרוש אישור לפעולות מחיקה, שליחה והעברה.
• יומן ביקורת מלא: כל פעולת API ו-MCP נרשמת ונשמרת למשך 90 יום.

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

• כל התוכניות יכולות לחבר סוכנים.
  • Nano: כלי Email Verifier. הוספת Drive Storage מעניקה לסוכן גם את יכולות Drive שהחשבון רשאי להשתמש בהן, לרבות עיון, העלאה, שיתוף, שחזור ומחיקה לצמיתות.
  • Starter: ‏Drive מלא, Email Verifier מלא וגישה לקריאה בלבד בכל התחומים האחרים (דומיינים, תיבות, העברות, כרטיסי תמיכה ועוד). השתמשו בלוח הבקרה לפעולות כתיבה ש-Starter אינו חושף דרך ה-API, כגון יצירת העברות, מענה לכרטיסים או שינוי מענה אוטומטי.
  • Pro / Agency: גישת קריאה וכתיבה מלאה בכל משפחה.
  • תקופת ניסיון או תוסף White Label: מוסיפים כלי מיתוג, לקוחות/צוות ופעילות כל עוד הזכאות פעילה. בלעדיה הסכמות האלה מושמטות. במהלך תקופת החסד לאחר ביטול, רק הבעלים מקבל את כלי הקריאה.
• זו הפעם הראשונה? הכפתור התחלת סיור בדף סוכני AI ו-API מציג חיבור סוכן, שלבים לכל לקוח, אסימונים ידניים, יישומים מחוברים ויומן הביקורת.
• ב-נתיבי OAuth (1, 2, 3) אין צורך ליצור אסימון ידנית. הלקוח יוצר אותו באמצעות תהליך ההרשאה בדפדפן. עבור נתיב stdio באירוח עצמי (4), צרו תחילה אסימון tm_live_ בלוח הבקרה.

1. לקוח MCP מרוחק (מומלץ)

השתמשו בנתיב זה כאשר לקוח ה-AI תומך בשרתי MCP מרוחקים ובהרשאה בדפדפן.

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

1. פתחו את הגדרות MCP, האינטגרציות או המחברים בלקוח.
2. בחרו הוספת שרת MCP מרוחק או הוספת מחבר מותאם אישית. התווית המדויקת תלויה בלקוח.
3. הזינו:
   • שם: TrekMail
   • כתובת URL של שרת MCP מרוחק: https://trekmail.net/mcp
4. אשרו את החיבור. הדפדפן יפתח את דף ההרשאה של TrekMail.
5. היכנסו, בדקו את ההרשאות המבוקשות ואשרו גישה. חזרו אל הלקוח לאחר שהדפדפן מאשר את החיבור.

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

2. לקוח CLI או שולחן עבודה

ללקוח שמקבל פקודת stdio, השתמשו בגשר הניטרלי ללקוח הבא:

npx -y mcp-remote https://trekmail.net/mcp

הגדירו פקודה זו כשרת MCP בלקוח. החיבור הראשון יפתח את הדפדפן לצורך הרשאה.

לקוחות מסוימים מספקים גם פקודה משלהם להוספת שרת MCP מרוחק. גם אפשרות זו תקפה; השתמשו ב-https://trekmail.net/mcp ככתובת השרת ופעלו לפי הנחיות הלקוח.

דוגמה ייעודית ללקוח: Claude Code

claude mcp add trekmail https://trekmail.net/mcp -t http

דוגמה ייעודית ללקוח: Claude Desktop

ערכו את קובץ התצורה (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json) והוסיפו:

{
  "mcpServers": {
    "trekmail": {
      "url": "https://trekmail.net/mcp",
      "transport": "http"
    }
  }
}

הפעילו מחדש את Claude Desktop. בפעם הראשונה שתזכירו את TrekMail בשיחה, החלון הקופץ של OAuth ייפתח.

דוגמה ייעודית ללקוח: Cursor

ל-Cursor אין מסך לשרת מרוחק. הוא קורא את ~/.cursor/mcp.json (או את .cursor/mcp.json בתוך פרויקט):

{
  "mcpServers": {
    "trekmail": {
      "url": "https://trekmail.net/mcp"
    }
  }
}

דוגמה ייעודית ללקוח: Windsurf

Windsurf קורא את ~/.codeium/windsurf/mcp_config.json. שימו לב שהמפתח הוא serverUrl, ולא url; שרת מרוחק שמוגדר עם url אינו נקלט:

{
  "mcpServers": {
    "trekmail": {
      "serverUrl": "https://trekmail.net/mcp"
    }
  }
}

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

3. mcp-remote (CLI)

mcp-remote שימושי לבדיקות או ללקוחות MCP שאינם של Anthropic ועדיין אינם תומכים ישירות בשרתי OAuth מרוחקים. זהו גשר Node קטן מ-stdio אל HTTP מרוחק.

npx -y mcp-remote https://trekmail.net/mcp

ההפעלה הראשונה פותחת את הדפדפן עבור OAuth. לאחר מכן האסימון נשמר במטמון תחת ~/.mcp-auth/ ונמצא בשימוש אוטומטי.

אפשר לשלב אותו בכל לקוח MCP מסוג stdio על ידי הפנייתו אל הפקודה mcp-remote במקום אל נקודת כניסה מקומית של Node.

4. stdio באירוח עצמי (Claude Desktop / Docker / npm)

אם אתם רוצים אסימוני tm_live_ סטטיים במקום OAuth (לדוגמה, עבור שרתים ללא השגחה, מופעי TrekMail פרטיים או פריסות בקונטיינרים), שכפלו והריצו את חבילת MCP מסוג stdio במארח שלכם.

צרו תחילה אסימון API בדף סוכני AI ו-API → אסימונים. לקריאה/שליחה של דוא"ל, צרו גם אסימון הודעות דרך ה-API באמצעות אסימון התפעול (עיינו בלשונית חיבור סוכן לקבלת הוראות).

התקנת שרת MCP

git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
npm install
npm run build

Claude Desktop (stdio)

הוסיפו את הקטע הבא לקובץ התצורה של MCP ב-Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "trekmail": {
      "command": "node",
      "args": ["./trekmail-mcp/build/index.js"],
      "env": {
        "TREKMAIL_BASE_URL": "https://trekmail.net",
        "TREKMAIL_API_TOKEN": "tm_live_your_token",
        "TREKMAIL_MESSAGE_TOKEN": "tm_msg_your_token",
        "TREKMAIL_ALLOW_SENDING": "false",
        "TREKMAIL_ALLOW_MIGRATION": "false"
      }
    }
  }
}

עדכנו את הנתיב args כך שיפנה למיקום שבו שכפלתם את המאגר. החליפו את האסימונים באסימונים שלכם. אפשר להשמיט את TREKMAIL_MESSAGE_TOKEN אם דרושים לכם רק כלי תשתית, או את TREKMAIL_API_TOKEN אם דרושים רק כלי הודעות. נדרש אסימון אחד לפחות.

Claude Code (stdio)

הוסיפו את הקטע הבא להגדרות MCP של Claude Code (.claude/settings.json או תצורה ברמת הפרויקט):

{
  "mcpServers": {
    "trekmail": {
      "command": "node",
      "args": ["./trekmail-mcp/build/index.js"],
      "env": {
        "TREKMAIL_BASE_URL": "https://trekmail.net",
        "TREKMAIL_API_TOKEN": "tm_live_your_token",
        "TREKMAIL_MESSAGE_TOKEN": "tm_msg_your_token",
        "TREKMAIL_ALLOW_SENDING": "false",
        "TREKMAIL_ALLOW_MIGRATION": "false"
      }
    }
  }
}

Docker

אם אתם מעדיפים Docker, בנו את התמונה מהמאגר והריצו אותה:

git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
docker build -t trekmail-mcp .

docker run -i \
  -e TREKMAIL_BASE_URL=https://trekmail.net \
  -e TREKMAIL_API_TOKEN=tm_live_your_token \
  -e TREKMAIL_MESSAGE_TOKEN=tm_msg_your_token \
  -e TREKMAIL_ALLOW_SENDING=false \
  -e TREKMAIL_ALLOW_MIGRATION=false \
  trekmail-mcp

npm מקומי (פיתוח)

git clone https://github.com/trekmail/mcp-server trekmail-mcp
cd trekmail-mcp
npm install && npm run build

TREKMAIL_BASE_URL=https://trekmail.net \
TREKMAIL_API_TOKEN=tm_live_your_token \
TREKMAIL_MESSAGE_TOKEN=tm_msg_your_token \
TREKMAIL_ALLOW_SENDING=false \
TREKMAIL_ALLOW_MIGRATION=false \
npm start

משתני סביבה של stdio

בקרות אלה חלות רק על תהליך MCP מסוג stdio באירוח עצמי שאתם מריצים. הן אינן מפעילות או מכבות תכונה במוצר TrekMail.

כלי Drive לסוכנים

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

לסוכן שפועל רק ב-Drive, הגדירו TREKMAIL_API_TOKEN והעניקו רק את ההיקפים הדרושים לתהליך העבודה. אם אתם מריצים stdio באירוח עצמי, השאירו פעולות הרסניות מושבתות אלא אם הסוכן מפעיל משימת מחיקה לצמיתות או ריקון אשפה שנבדקה. רכישה, שינוי גודל וביטול של תוסף Drive אינם כלי MCP; סוכנים יכולים לקרוא את מצב התוסף והמחירים, אך שינויי חיוב נשארים בלוח הבקרה.

ראו סקירת כלי MCP של Drive וגם חיבור סוכני AI אל TrekMail Drive.

כלים זמינים

שרת MCP חושף את הכלים הבאים לסוכנים מחוברים. הכלים נרשמים באופן מותנה לפי האסימונים שסופקו.

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

1. ההיקפים של האסימון. כלי שהיכולת שלו אינה כלולה באסימון לעולם אינו נרשם.
2. בקרות בטיחות מקומיות של stdio. כשאתם מריצים את שרת stdio באירוח עצמי, המנהל שלו יכול לדרוש אישור לפעולות כתיבה, שליחה או העברה. MCP מתארח משתמש במקום זאת בהיקפים שאושרו במהלך OAuth.
3. TREKMAIL_READ_ONLY=true, שמסיר כל כלי כתיבה ללא תלות בהיקפים ובדגלים.

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

כלי דומיינים (אסימון תפעול)

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

כלי White Label (אסימון תפעול)

ערכת הכלים white_label מכילה 20 כלים ומופיעה רק כאשר זכאות החשבון, החברות הנוכחית והיקפי פרטי האימות מאפשרים זאת. המיתוג מוגדר לכל דומיין; שאר הכלים מנהלים הגדרה, לקוחות, גישת צוות ופעילות. כתיבה דורשת White Label פעיל. במהלך תקופת החסד לאחר ביטול, רק הבעלים שומר על כלי הקריאה.

סוכן יכול להפעיל את הגדרת המותג מתחילתה ועד סופה: להגדיר את המותג, להעתיק את dns_records שהוחזרו, לפרסם אותם באמצעות apply_cloudflare_dns, ואז לאמת ולבדוק את המצב. קריאות שמשנות גישה מוגבלות לפי החברות הפעילה וגבול הדומיין של הקורא, גם אם האסימון ביקש היקפים רחבים יותר. ראו את מדריך ה-API וה-MCP למיתוג White Label ואת ניהול צוותי White Label באמצעות API ו-MCP.

כלי DNS (אסימון תפעול)

כלי תיבות דואר (אסימון תפעול)

כלי תיבות משותפות (אסימון תפעול)

תיבה משותפת היא תיבת צוות (support@,‏ sales@) שחברים פותחים באמצעות חשבון התיבה הרגיל שלהם בדואר האינטרנט, ואם מופעלת, גם בגישה מואצלת של IMAP/SMTP מקומי. אין לה כניסה ישירה בסיסמה. הגישה אחידה, כולם יכולים לקרוא ו-can_send הוא המתג היחיד (אפשרות להשיב לעומת קריאה בלבד). אין תפקידי חברים.

מחזור החיים של תיבה משותפת (אסימון תפעול)

שלושת כלי מחזור החיים ושלושת כלי הכתיבה לחברים משנים גישה. מנהל stdio שמתארח מקומית יכול לדרוש TREKMAIL_ALLOW_DESTRUCTIVE=true לפני שיהיו זמינים; list_shared_mailbox_members הוא לקריאה בלבד וזמין תמיד.

לאחר יצירה, המרה או שינוי חברות, קראו אל get_mail_client_setup עם מזהה של תיבת חבר רגילה. קראו את shared_mailboxes.items[], המתינו ל-native_access_ready=true ובדקו את send_as_ready לפני הגדרת השליחה. התגובה מספקת נתיבים מדויקים לדואר נכנס/נשלח/ארכיון/זבל ודגלי פעולה; SMTP אינו שומר את העותק המשותף בתיקיית נשלח. שגיאת native_access_sync_failed שניתנת לניסיון חוזר בעת הסרת הרשאה, עדכון הרשאה או המרה פירושה שהשירות שמר במכוון את המצב הקודם.

כלי Sieve (אסימון תפעול)

כלי מחיקה (אסימון תפעול)

כלי העברה (אסימון תפעול)

כלי כרטיסי תמיכה (אסימון תפעול)

כלי SMTP / ניתוב דומיינים (אסימון תפעול)

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

כלי הכתיבה והבדיקה שלעיל משנים הגדרות או מבצעים בדיקת חיבור. מנהל stdio שמתארח מקומית יכול לדרוש TREKMAIL_ALLOW_DESTRUCTIVE=true לפני שיהיו זמינים; get_domain_smtp,‏ list_domain_smtp_profiles,‏ get_domain_smtp_test_status ו-get_account_smtp_default מיועדים לקריאה בלבד וזמינים תמיד.

כלי SMTP ישנים (הוצאו משימוש)

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

כלי מדדי דואר זבל (אסימון תפעול)

כלי חשבון (אסימון תפעול)

ניהול אסימוני הודעות (אסימון תפעול)

כלי הודעות (אסימון הודעות)

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

OAuth מתארח ו-stdio מקומי מזהים את התיבה בדרכים שונות. ב-MCP מתארח דרך HTTP, כל סכמה של כלי הודעות כוללת mailbox_id נדרש; השרת משתמש בו להנפקת אסימון קצר טווח עבור אותה תיבה. ב-MCP מקומי דרך stdio,‏ TREKMAIL_MESSAGE_TOKEN כבר קשור לתיבה אחת, ולכן אותם כלים אינם מקבלים mailbox_id. תיבת דואר נכנס מחוברת היא רמת בחירה נוספת: העבירו external_account_id בנוסף ל-mailbox_id ב-MCP מתארח, או בנוסף לאסימון ההודעות המקושר ב-stdio.

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

הודעות עיקריות

אם לתיבה הוגדר עותק ברירת מחדל או עותק מוסתר ברירת מחדל בהגדרות → פרופיל, הוא נוסף למה ש-send_message ו-schedule_message שולחים, בדיוק כמו בדואר שנכתב ביישום האינטרנט; כתובת שכבר נמצאת בהודעה אינה נוספת פעמיים. העבירו apply_default_recipients: false כדי להשמיט אותו מהודעה יחידה. הדבר אינו חל על דואר שנשלח דרך SMTP מלקוח דואר במחשב או בטלפון, שלעולם אינו עובר דרך ה-API. | report_spam | דיווח על הודעה כדואר זבל, העברה לזבל ואימון המסנן | | report_ham | סימון הודעת זבל כתקינה, העברה לדואר נכנס ואימון המסנן | | bulk_action | החלת פעולה (קריאה, כוכב, מחיקה, העברה, דואר זבל) על עד 50 הודעות בבת אחת |

תיקיות

קבצים מצורפים

טיוטות

שני הכלים מחזירים את ה-uid וה-uidvalidity של הטיוטה. שמרו את הצמד יחד: update_draft דורש את התקופה כדי שמזהה UID ישן שנעשה בו שימוש חוזר לעולם לא יוכל למחוק הודעה אחרת לאחר יצירה מחדש של תיקיית הטיוטות. טיוטה שנמצאה באמצעות list_messages צריכה להיפתח תחילה באמצעות read_message, שמחזיר את ה-uidvalidity הנוכחי שלה. עדכון מחזיר צמד חדש וה-UID הישן מפסיק לפעול. בשרת ללא UIDPLUS, שני הערכים יכולים להיות null גם אם טיוטה חדשה נשמרה; רעננו את טיוטות ופתחו את הטיוטה לפני עדכונה.

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

שליחה מתוזמנת

אנשי קשר

קבוצות אנשי קשר

יומן

עזרי כתיבה

כלים אלה מכינים את הנתונים לתשובה או להעברה. הם אינם שולחים דבר. העבירו את הנתונים שהוחזרו ישירות אל send_message או save_draft.

זהויות (כתובות שולח)

תבניות

שולחים חסומים

כלי Email Verifier (אסימון תפעול)

כלי Email Verifier זמינים ב-כל התוכניות, כולל Nano. המגבלה היחידה היא יתרת האשראי שלכם.

כלי Cloudflare (אסימון תפעול)

כלי Cloudflare זמינים בתוכניות Pro ו-Agency.

בקרות בטיחות עבור stdio באירוח עצמי

כאשר אתם מריצים בעצמכם את שרת MCP מסוג stdio,‏ TREKMAIL_ALLOW_DESTRUCTIVE קובע אם התהליך המקומי מאפשר מחיקה ופעולות כתיבה אחרות. הגדירו אותו כ-true רק אם אתם סומכים על הסוכן שיטפל במחיקת תיבות בבטחה. הגדרה זו אינה משנה את זמינות התכונות ב-TrekMail המתארח.

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

שערי בטיחות לשליחה

לכלים send_message ו-schedule_message יש שני שערי בטיחות עצמאיים שחייבים לעבור יחד:

1. שער סביבה: יש להגדיר TREKMAIL_ALLOW_SENDING=true בעת הפעלת שרת MCP.
2. שער לכל קריאה: הסוכן חייב להעביר confirm_send=true כפרמטר בכל קריאה.

העיצוב בעל שני השערים מונע שליחת דוא"ל בטעות מתהליך באירוח עצמי. הגדירו TREKMAIL_ALLOW_SENDING=false כאשר הסוכן צריך רק לקרוא הודעות. list_scheduled פועל ללא בקרה זו; היא חלה רק על יצירה או שליחה של הודעות מתוזמנות.

שערי בטיחות להעברות

לכלי הכתיבה להעברות (start_migration,‏ retry_migration,‏ delete_migration,‏ delete_bulk_migration,‏ update_bulk_migration_job_password,‏ test_migration_connection,‏ preview_bulk_migration,‏ start_bulk_migration,‏ retry_bulk_migration) יש שני שערי בטיחות עצמאיים:

1. שער סביבה: יש להגדיר TREKMAIL_ALLOW_MIGRATION=true בעת הפעלת שרת MCP.
2. שער לכל קריאה: כל כלי דורש פרמטר אישור משלו (confirm_start=true,‏ confirm_retry=true או confirm_delete=true).

cancel_migration,‏ cancel_bulk_migration ו-resume_bulk_migration זמינים תמיד ללא תלות בבקרת הסביבה באירוח עצמי, מפני שהם פעולות בטיחות או חידוש. הם עדיין דורשים פרמטרי אישור לכל קריאה.

כלי העברה לקריאה בלבד (list_migrations,‏ get_migration,‏ list_bulk_migrations,‏ get_bulk_migration) פועלים ללא שערים.

פתרונות מהירים

• הסוכן אינו יכול להתחבר: ודאו שהנתיב build/index.js נכון ושהרצתם npm run build לאחר השכפול.
• שגיאות "Missing bearer token": בדקו שלפחות אחד מבין TREKMAIL_API_TOKEN או TREKMAIL_MESSAGE_TOKEN מוגדר.
• כלי קריאה בלבד פועלים אך כתיבה נכשלת: האסימון שלכם בתוכנית Starter. כתיבה ב-Drive פועלת ב-Starter (כל ממשק Drive). עבור כתיבות אחרות, הקצאת תיבות, התחלת העברות או מענה לכרטיסים, שדרגו ל-Pro או השתמשו בלוח הבקרה.
• כלי מחיקה מחזירים שגיאות ב-stdio באירוח עצמי: הגדירו TREKMAIL_ALLOW_DESTRUCTIVE=true בסביבה של תהליך MCP זה. הדבר חל על מחיקה ופעולות כתיבה אחרות, לרבות הודעות, תיקיות, אנשי קשר, יומן, זהויות, תבניות, שולחים חסומים והודעות מתוזמנות.
• כלי שליחה ב-stdio באירוח עצמי מחזיר "Sending is disabled": הגדירו TREKMAIL_ALLOW_SENDING=true בסביבה של תהליך MCP זה.
• כלי השליחה מחזיר "Send not confirmed": הסוכן חייב להעביר confirm_send=true בכל קריאה אל send_message או schedule_message.
• לא מופיעים כלי הודעות: ודאו ש-TREKMAIL_MESSAGE_TOKEN מוגדר עם אסימון tm_msg_ תקף.
• כלי כתיבה להעברות ב-stdio באירוח עצמי מחזירים שגיאות: הגדירו TREKMAIL_ALLOW_MIGRATION=true בסביבה של תהליך MCP זה.
• שגיאת 503 בתחילת העברה: השרת הגיע לקיבולת ההעברות. נסו שוב בעוד כמה דקות.
• הורדת קובץ מצורף נכשלת: קבצים מצורפים מוחזרים כ-base64. קבצים גדולים (עד 25 MB) עשויים להימשך כמה שניות. download_all_attachments מחזיר ZIP בקידוד base64 של כל הקבצים המצורפים.
• טיוטה נעלמה לאחר עדכון: update_draft מוחק את הטיוטה הישנה ומוסיף תחליף, ולכן הטיוטה מקבלת זהות UID חדשה. השתמשו גם ב-uid וגם ב-uidvalidity מהתגובה לכל פעולה בהמשך; הצמד שהעברתם אינו מזהה עוד את התחליף.
• עותק של כל הודעה מגיע למקום שלא ציינתם: לתיבה מוגדר עותק ברירת מחדל או עותק מוסתר ברירת מחדל בהגדרות → פרופיל. הוא חל על מה שתיבה זו שולחת, לרבות דרך ה-API. נקו אותו שם, או העבירו apply_default_recipients: false כדי להשמיט אותו מהודעה אחת.
• אירוע יומן לא נמצא: האירועים מוגבלים לתיבה המסוימת. ודאו שאסימון ההודעות הונפק עבור התיבה הנכונה.