الذكاء الاصطناعي وMCP

يستهلك translate وcompose كل منهما إجراء ذكاء اصطناعي واحدًا من الحصة اليومية لمساحة العمل، والحصة المستنفدة تتوقف برمز الخروج 8. ويعمل compose وsummarize عبر أداتي MCP composeEmail وgetThreadSummary، ولهذا يحتاجان إلى تسجيل دخول عبر المتصفح: مفتاح API لا يصل إلى خادم MCP.

openemail ai translate --to de --subject "Your invoice" --text "The invoice is attached."openemail ai translate --to Japanese --body-file reply.html --no-originalcat notes.txt | openemail ai translate --to fropenemail ai languages --search port

ينفّذ الترجمة التي كان سينفذها إرسال مترجم ويطبع النتيجة، كي تقرأها قبل أن يخرج أي شيء. لا يُحفظ شيء ولا يُرسل. يأخذ --to رمزًا، أو اسمًا بالإنجليزية، أو اسم اللغة بلغتها. ويأتي الجسم من --text أو --html أو --body-file أو stdin، ويقرأ --text و--html أيضًا ملفًا عبر @path.

• —يبقى نصك الأصلي تحت الترجمة، ما لم تمرّر --no-original.
• —تُطبع لغة المصدر المكتشفة على stderr، ويطبع --json الترجمة كاملة.
• —للترجمة أثناء الإرسال، استخدم openemail send --translate de.

openemail ai compose "thank Ada for the invoice and ask for a PDF copy" --to [email protected]openemail ai compose "say yes to Tuesday at 3pm" --thread CAHk7pQ2x9LmZ4 --tone friendlyopenemail ai compose "decline politely" --thread CAHk7pQ2x9LmZ4 | openemail send --to [email protected] --subject "Re: Proposal"openemail ai summarize CAHk7pQ2x9LmZ4

• —يطبع compose جسمًا مكتوبًا بأسلوبك ولا يرسل شيئًا، فمرّره إلى openemail send حين يرضيك. ومع --thread يقرأ أحدث رسائل المحادثة أولًا ثم يكتب ردًا. و--tone واحد من formal أو friendly أو casual أو concise أو direct أو warm.
• —يطبع summarize الملخص مع الموضوع والمرسل والتاريخ. تُكتب الملخصات حين يصل البريد، والمحادثة التي تحتوي على رسالة مشفّرة لا ملخص لها، وهذا يخرج بالرمز 5.

يمنح خادم MCP في OpenEmail عميل الذكاء الاصطناعي الأدوات التي يستخدمها المساعد في التطبيق: يمكنه قراءة البريد وإرساله وإدارة جهات الاتصال والقوالب والنطاقات وغيرها، في حدود ما توافق عليه. يتصل العميل بإحدى طريقتين، ويطبع openemail mcp config الاثنتين للعميل الذي تستخدمه:

• —الخادم البعيد. يجري العميل تسجيل دخوله الخاص عبر المتصفح، وتوافق عليه في صفحة الموافقة في OpenEmail، فيظهر في الحساب → التطبيقات المرتبطة. هذا هو الخيار الأبسط حين يدعمه العميل.
• —الجسر المحلي، openemail mcp serve، الذي يشغّله العميل عبر npx. يستخدم تسجيل دخول هذه CLI، فشغّل openemail login أولًا. ويناسب العملاء الذين لا يشغّلون إلا خوادم محلية.

openemail mcp configopenemail mcp config --client claude-codeopenemail mcp config --client cursor --profile workopenemail mcp config --client vscode --json

claude mcp add --transport http openemail https://api.openemail.uk/mcp

claude mcp add openemail -- npx -y @openemail/cli mcp serve

بعد إضافة الخادم البعيد، يسجّل Claude Code الدخول من /mcp، ويسجّل Codex الدخول عبر codex mcp login openemail. ويضيفه Claude Desktop من Settings → Connectors → Add custom connector. ويخبرك openemail mcp config --client <name> أيضًا بالملف الذي يقرؤه كل عميل.

يقرأ openemail mcp serve رسائل JSON-RPC مفصولة بأسطر جديدة من stdin، ويمرّر كل رسالة إلى خادم MCP بتسجيل دخولك المحفوظ عبر المتصفح، ويكتب كل جواب على stdout في سطر واحد. يجدد رمز الوصول المنتهي دون أن يلاحظ العميل، ويجيب عن الدفعة كمصفوفة واحدة، ويتوقف حين يُغلق stdin. لا يصل إلى stdout إلا البروتوكول، ويبقى stderr صامتًا ما لم تمرّر --debug.

echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | openemail mcp serveopenemail mcp serve --profile workopenemail mcp serve --debug 2> mcp.log

openemail mcp toolsopenemail mcp tools composeEmailopenemail mcp call whoAmIopenemail mcp call listThreads --arg folder=inbox --arg maxResults=5openemail mcp call getThread --args '{"threadId":"CAHk7pQ2x9LmZ4"}'

• —يسرد mcp tools الأدوات التي يمكن لهذا الدخول استخدامها، وقد استبعد بالفعل ما لا يسمح به دورك أو الموافقة. سمِّ أداة لترى وصفها ووسائطها.
• —يأخذ mcp call الوسائط ككائن JSON واحد في --args (مضمّنًا، أو @file، أو -)، ويضبط --arg key=value وسيطًا واحدًا في كل مرة. تُقرأ القيمة كـ JSON حين يمكن تحليلها، لذا ضع بين علامتي تنصيص أي رقم تقصده نصًا.
• —لا يطلب خادم MCP تأكيدًا أبدًا، فالأداة التي ترسل أو تحذف تتصرف فورًا.
• —النتيجة التي تبدأ بـ Refused ( تخرج بالرمز 4. والأداة المجهولة تخرج بـ 5، والوسائط غير الصالحة بـ 7، والحصة المستنفدة للذكاء الاصطناعي بـ 8.

ست أدوات تُجري تغييرًا تحميه REST API برمز تحقق، وتطلب الرمز نفسه: createRule وsetRuleEnabled وremoveDomain وremoveDomainAddress، وdeleteAudience لجمهور أنشأته، وemptyAudience لجمهور أنشأته وما زال فيه جهات اتصال. في الطرفية يطلب mcp call الرمز ثم يستدعي الأداة من جديد. ومن دون إشراف يخرج بالرمز 4، فشغّل openemail verify أولًا.

openemail docs ask "how do I verify a domain?"openemail docs open cli/authenticationopenemail docs read cli/commandsopenemail docs read

• —يطرح docs ask سؤالًا على مساعد التوثيق ويطبع الجواب أثناء كتابته، ثم الصفحات التي جاء منها. لا يجيب إلا من هذا التوثيق، ولا يحتاج إلى تسجيل دخول، ولا يرسل بيانات اعتمادك أبدًا. يمكن أن يصل السؤال إلى 600 حرف، ولكل شبكة عدد محدود من الأسئلة في اليوم.
• —يفتح docs open صفحة في متصفحك، ويطبع --print رابطها بدلًا من ذلك.
• —يطبع docs read صفحة بصيغة Markdown. ومن دون صفحة يطبع فهرس كل الصفحات.