هوش مصنوعی و 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 چاپ می‌کند. بدون صفحه، فهرست همهٔ صفحه‌ها را چاپ می‌کند.