ربط وكلاء الذكاء الاصطناعي بخدمة TrekMail عبر MCP

يتيح خادم MCP من TrekMail لعملاء الذكاء الاصطناعي المتوافقين إدارة بنية بريدك الإلكتروني بلغة طبيعية. يشمل الكتالوج النطاقات وصناديق البريد والعلامة التجارية والفرق في White Label وDrive والبريد والتقويم وعمليات النقل والدعم والفوترة والخدمات المرتبطة عبر واجهة TrekMail API نفسها.

لا يتم تحميل الكتالوج الكامل في كل محادثة. تنشئ TrekMail قائمة tools/list من بيانات الاعتماد النشطة: تُحذف الأدوات الواقعة خارج نطاقاتها، وكذلك الأدوات المستبعدة بمجموعة أدوات محددة أو وضع القراءة فقط أو حدود النقل أو إعداد أمان محلي. لذلك تعرض بيانات اعتماد البريد ذات النطاق المحدود قائمة موجزة من أدوات البريد.

اختر طريقة الاتصال

تستخدم المسارات 1-3 بروتوكول OAuth 2.1: عند الاتصال لأول مرة، يفتح المتصفح صفحة موافقة TrekMail، فتراجع الأذونات المطلوبة ويحصل العميل على رمز محدود بحسابك. لا يُنسخ أي رمز tm_live_ طويل الأجل إلى العميل. يمكنك إلغاء أي اتصال في أي وقت من وكلاء الذكاء الاصطناعي وAPI ← الرموز ← التطبيقات المتصلة.

ما الذي تحصل عليه

• مجموعة أدوات خاصة بالاتصال تتم تصفيتها قبل التسجيل وفقا لأذونات الاتصال الحالي وإعدادات أمانه.
• OAuth 2.1 + تسجيل ديناميكي للعميل: يسجل عميل الذكاء الاصطناعي نفسه، ويرشدك خلال صفحة موافقة في المتصفح، ويحصل على رمز محدد النطاق. لا حاجة إلى نسخ رموز طويلة الأجل ولصقها في مسارات الويب أو سطح المكتب أو CLI.
• بنية برمزين: رمز عمليات منفصل للبنية التحتية ورمز رسائل لعمليات بريد الويب الكاملة. عند الاتصال عبر OAuth، يتم إصدار رموز الرسائل تلقائيا لكل صندوق بريد عند الحاجة.
• تكرار آمن تلقائي للعمليات التي تتطلبه، حتى لا تعيد المحاولة تنفيذ العملية نفسها.
• حذف بخطوتين: يتطلب حذف صندوق البريد نية صريحة وتأكيدا، ثم ينقله إلى المحذوفة مؤخرا لاستعادته.
• ضوابط أمان للاستضافة الذاتية: يستطيع مسؤول يشغل خادم MCP stdio الخاص به فرض الموافقة على إجراءات الحذف والإرسال والنقل.
• سجل تدقيق كامل: تُسجل كل عملية API وMCP مع الاحتفاظ بها لمدة 90 يوما.

قبل البدء

• يمكن ربط الوكلاء في جميع الخطط.
  • Nano: أدوات التحقق من البريد الإلكتروني. تؤدي إضافة مساحة Drive أيضا إلى منح الوكيل إمكانات Drive التي يحق للحساب استخدامها، بما فيها التصفح والرفع والمشاركة والاستعادة والحذف النهائي.
  • Starter: وصول كامل إلى Drive وأداة التحقق من البريد، ووصول للقراءة فقط في بقية المجالات (النطاقات وصناديق البريد وعمليات النقل والتذاكر وغيرها). استخدم لوحة التحكم لإجراءات الكتابة التي لا تتيحها Starter عبر API، مثل إنشاء عمليات النقل أو الرد على التذاكر أو تغيير الرد التلقائي.
  • Pro / Agency: وصول كامل للقراءة والكتابة في جميع العائلات.
  • تجربة White Label أو الإضافة: تضيف أدوات العلامة التجارية والعملاء/الفريق والنشاط ما دام الاستحقاق فعالا. بدونها، تُحذف هذه المخططات. خلال مهلة الإلغاء، يحصل المالك وحده على أدوات القراءة.
• هل هذه أول مرة؟ يرشدك زر بدء الجولة في صفحة وكلاء الذكاء الاصطناعي وAPI خلال ربط وكيل والخطوات الخاصة بكل عميل والرموز اليدوية والتطبيقات المتصلة وسجل التدقيق.
• في مسارات OAuth ‏(1، 2، 3) لا تحتاج إلى إنشاء رمز يدويا. ينشئه العميل عبر مسار تفويض المتصفح. في مسار stdio المستضاف ذاتيا (4)، أنشئ أولا رمز tm_live_ في لوحة التحكم.

1. عميل MCP بعيد (موصى به)

استخدم هذا المسار عندما يدعم عميل الذكاء الاصطناعي خوادم MCP البعيدة وتفويض المتصفح.

اختصار: تسألك علامة تبويب ربط وكيل في صفحة وكلاء الذكاء الاصطناعي وAPI عن العميل الذي تستخدمه، ثم تعرض مساره الدقيق أو مسار القائمة أو ملف الإعدادات ومقتطفا جاهزا يحتوي على عنوانك مسبقا. إذا كان عميلك مدرجا، فاتبع ذلك بدلا من الخطوات العامة أدناه.

1. افتح إعدادات MCP أو عمليات التكامل أو الموصلات في عميلك.
2. اختر إضافة خادم MCP بعيد أو إضافة موصل مخصص. تختلف التسمية الدقيقة حسب العميل.
3. أدخل:
   • الاسم: TrekMail
   • عنوان خادم 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 في صفحة وكلاء الذكاء الاصطناعي و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 Add-on. يرى اتصالك الأدوات التي تسمح بها نطاقاته.

للوكيل المخصص لـDrive، اضبط TREKMAIL_API_TOKEN وامنح فقط النطاقات التي يحتاجها سير العمل. إذا شغلت stdio مستضافا ذاتيا، فاترك الإجراءات المدمرة معطلة ما لم يكن الوكيل ينفذ مهمة مراجعة للحذف النهائي أو إفراغ المهملات. شراء Drive Add-on وتغيير حجمه وإلغاؤه ليست أدوات MCP؛ يمكن للوكلاء قراءة حالة الإضافة وأسعارها، لكن تغييرات الفوترة تبقى في لوحة التحكم.

راجع نظرة عامة على أدوات Drive في MCP وربط وكلاء الذكاء الاصطناعي بخدمة 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@) يفتحه الأعضاء عبر حساب صندوق بريدهم العادي في Webmail، وعند التمكين، عبر وصول 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 قبل ضبط الإرسال. توفر الاستجابة مسارات Inbox/Sent/Archive/Junk الدقيقة وعلامات العمليات؛ ولا يحفظ SMTP النسخة المشتركة في Sent. تعني حالة 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 المحلي صندوق البريد بطرق مختلفة. في HTTP MCP المستضاف، يتضمن مخطط كل أداة رسائل حقلا مطلوبا هو mailbox_id؛ ويستخدمه الخادم لإصدار رمز قصير العمر لصندوق البريد ذاك. في stdio MCP المحلي، يكون TREKMAIL_MESSAGE_TOKEN مرتبطا بالفعل بصندوق بريد واحد، لذلك لا تقبل الأدوات نفسها mailbox_id. صندوق الوارد المتصل هو مستوى ثان من الاختيار: مرر external_account_id بالإضافة إلى mailbox_id في MCP المستضاف، أو بالإضافة إلى رمز الرسائل المرتبط في stdio.

تدير سبع من أدوات الرسائل البالغ عددها 62 الحسابات المتصلة، وتدير خمس منها هويات From وسياسة الرد. استخدم كلتا المجموعتين لسير عمل شبيه بـGmail يقرأ فيه الوكيل صندوق Gmail متصلا، لكنه يرسل من عنوان عمل مصرح به عبر مسار نطاق أو ملف تعريف SMTP محفوظ. راجع عناوين Send As عبر API وMCP.

الرسائل الأساسية

إذا كان لصندوق البريد CC افتراضي أو BCC افتراضي مضبوط في الإعدادات ← الملف الشخصي، فيُضاف إلى ما ترسله send_message وschedule_message تماما كما يحدث مع البريد المكتوب في تطبيق الويب، ولا يُضاف العنوان الموجود أصلا في الرسالة مرتين. مرر apply_default_recipients: false لتعطيله في رسالة واحدة. لا ينطبق ذلك على البريد المرسل عبر عميل بريد على سطح المكتب أو الهاتف من خلال SMTP، إذ لا يمر أبدا عبر API. | report_spam | الإبلاغ عن رسالة كبريد مزعج، ونقلها إلى Junk وتدريب المرشح | | report_ham | وضع علامة على رسالة في Junk بأنها ليست مزعجة، ونقلها إلى Inbox وتدريب المرشح | | bulk_action | تطبيق إجراء (قراءة أو تمييز بنجمة أو حذف أو نقل أو رسالة مزعجة) على ما يصل إلى 50 رسالة دفعة واحدة |

المجلدات

المرفقات

المسودات

تعيد كلتا الأداتين uid وuidvalidity للمسودة. احتفظ بهما معا: تتطلب update_draft الحقبة حتى لا يحذف UID قديم أُعيد استخدامه رسالة مختلفة بعد إعادة إنشاء مجلد Drafts. ينبغي أولا فتح المسودة التي عُثر عليها باستخدام list_messages عبر read_message، التي تعيد uidvalidity الحالية لها. يعيد التحديث زوجا جديدا ويتوقف UID القديم عن العمل. في خادم لا يدعم UIDPLUS، قد تكون القيمتان null رغم حفظ مسودة جديدة؛ حدّث Drafts وافتح المسودة قبل تحديثها.

تقبل الأداتان أيضا idempotency_key اختياريا. إذا تركته فارغا، يُعامل كل استدعاء كاستدعاء جديد، ولذلك يؤدي حفظ المسودة نفسها مرتين إلى إنشاء مسودتين. مرر المفتاح نفسه عند إعادة محاولة استدعاء ربما نُفذ بالفعل، وستحصل على النتيجة الأولى بدلا من نسخة مكررة.

الإرسال المجدول

جهات الاتصال

مجموعات جهات الاتصال

التقويم

أدوات مساعدة للإنشاء

تجهز هذه الأدوات بيانات الرد أو إعادة التوجيه. ولا ترسل أي شيء. مرر البيانات المرجعة مباشرة إلى send_message أو save_draft.

الهويات (عناوين الإرسال)

القوالب

المرسلون المحظورون

أدوات التحقق من البريد الإلكتروني (رمز العمليات)

تتوفر أدوات التحقق من البريد الإلكتروني في كل الخطط، بما فيها Nano. والقيد الوحيد هو رصيد اعتماداتك.

أدوات Cloudflare (رمز العمليات)

تتوفر أدوات Cloudflare في خطتي Pro وAgency.

ضوابط الأمان لخدمة stdio المستضافة ذاتيا

عندما تشغل خادم stdio MCP بنفسك، يتحكم 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 بعد الاستنساخ.
• أخطاء "رمز bearer مفقود": تحقق من ضبط واحد على الأقل من TREKMAIL_API_TOKEN أو TREKMAIL_MESSAGE_TOKEN.
• تعمل أدوات القراءة فقط لكن تفشل الكتابة: رمزك مرتبط بخطة Starter. تعمل عمليات الكتابة في Drive على Starter (واجهة Drive الكاملة). أما عمليات الكتابة الأخرى أو توفير صناديق البريد أو بدء عمليات النقل أو الرد على التذاكر، فقم بالترقية إلى Pro أو استخدم لوحة التحكم.
• تعيد أدوات الحذف أخطاء في stdio المستضاف ذاتيا: اضبط TREKMAIL_ALLOW_DESTRUCTIVE=true في بيئة عملية MCP تلك. ينطبق ذلك على الحذف وإجراءات الكتابة الأخرى، بما فيها الرسائل والمجلدات وجهات الاتصال والتقويم والهويات والقوالب والمرسلون المحظورون والرسائل المجدولة.
• تعيد أداة إرسال في stdio المستضاف ذاتيا "الإرسال معطل": اضبط TREKMAIL_ALLOW_SENDING=true في بيئة عملية MCP تلك.
• تعيد أداة الإرسال "لم يتم تأكيد الإرسال": يجب أن يمرر الوكيل 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 من الاستجابة لأي خطوة تالية؛ فالزوج الذي مررته لم يعد يحدد البديل.
• تصل نسخة من كل رسالة إلى مكان لم تحدده: يحتوي صندوق البريد على CC افتراضي أو BCC افتراضي مضبوط في الإعدادات ← الملف الشخصي. وينطبق ذلك على ما يرسله صندوق البريد هذا، بما فيه الإرسال عبر API. امسحه من هناك، أو مرر apply_default_recipients: false لتعطيله لرسالة واحدة.
• حدث التقويم غير موجود: تقتصر الأحداث على صندوق البريد المحدد. تأكد من إصدار رمز الرسائل لصندوق البريد الصحيح.