اتوماسیون هوشمند Gmail با سرور MCP در n8n

اتوماسیون Gmail با هوش مصنوعی و سرور MCP

این Workflow از قدرت هوش مصنوعی برای خودکارسازی عملیات Gmail شما استفاده می‌کند. با ادغام با یک سرور خارجی کنترل کننده مدل هوش مصنوعی (MCP)، امکان ترکیب، پاسخ‌دهی، دریافت و موارد دیگر ایمیل را به صورت پویا فراهم می‌کند که همگی توسط محتوای تولید شده توسط هوش مصنوعی هدایت می‌شوند. این راهکار برای توسعه‌دهندگان، مهندسان اتوماسیون و کاربران حرفه‌ای که به دنبال بهینه‌سازی مدیریت ایمیل خود هستند، ایده‌آل است.

کاتالوگ Axeto.ai n8n: https://axeto.ai/n8n

نسخه مورد نیاز n8n: 1.88.0+

Node های مورد نیاز:

• n8n-nodes-base.gmailTool (v2.1)
• @n8n/n8n-nodes-langchain.mcpTrigger

---

نمای کلی Workflow

این Workflow به عنوان یک سرور Gmail با پشتیبانی هوش مصنوعی عمل می‌کند، دستورالعمل‌ها را از سرور MCP دریافت کرده و اقدامات مربوط به Gmail را اجرا می‌کند.

1. دریافت ورودی تریگر MCP: منتظر درخواست‌های HTTP ورودی از سرور MCP می‌ماند. این درخواست‌ها حاوی محتوای تولید شده توسط هوش مصنوعی و فراداده برای عملیات ایمیل هستند.

2. عملیات ایمیل Gmail: وظایف مختلف Gmail (ارسال، پاسخ‌دهی، دریافت) را بر اساس داده‌های دریافتی از تریگر MCP اجرا می‌کند.

---

تحلیل بلوک به بلوک

1. دریافت ورودی تریگر MCP

این بلوک نقطه ورود Workflow است که برای دریافت و پردازش درخواست‌های ورودی از سرور MCP شما طراحی شده است.

• Node: MCP_GMAIL
• نوع Node: MCP Trigger (@n8n/n8n-nodes-langchain.mcpTrigger)
• نقش: درخواست‌های HTTP POST را از سرور MCP دریافت می‌کند.
• پیکربندی:

* مسیر HTTP: /mcp/:tool/gmail

* بخش :tool امکان مسیریابی انعطاف‌پذیر یا شناسایی ابزار هوش مصنوعی که درخواست را ارسال می‌کند را فراهم می‌کند.

• ورودی: ندارد (Node تریگر).
• خروجی: فیلدهای داده استاندارد از درخواست MCP، مانند To، Subject، Message، Message_ID، Simplify (boolean) و غیره. اینها به Node های Gmail پایین‌دستی منتقل می‌شوند.
• ویژگی‌های کلیدی:

* نیاز به نسخه n8n 1.88.0+ دارد.

* پارامتر URL پویا :tool می‌تواند برای ثبت وقایع یا منطق شرطی استفاده شود.

• مشکلات احتمالی:

* خطاهای احراز هویت اگر سرور MCP مجاز نباشد.

* بارهای HTTP نامعتبر یا ناقص.

* پیکربندی نادرست URL وب‌هوک.

2. عملیات ایمیل Gmail

این بلوک عملیات واقعی Gmail را انجام می‌دهد که توسط داده‌های تولید شده توسط هوش مصنوعی دریافتی از تریگر MCP هدایت می‌شود.

• Nodes: SEND_EMAIL، REPLY_EMAIL، GET_EMAIL، SEND_AND_WAIT
• نوع Node: Gmail Tool (v2.1)
• نقش: عملیات خاص Gmail را بر اساس ورودی اجرا می‌کند.

#### 2.1 SEND\_EMAIL

• عملکرد: ارسال یک ایمیل جدید.
• پیکربندی:

* sendTo: به صورت پویا از فیلد ورودی MCP To با استفاده از ={{ $fromAI('To', '', 'string') }} پر می‌شود.

* subject: به صورت پویا از فیلد ورودی MCP Subject با استفاده از ={{ $fromAI('Subject', '', 'string') }} پر می‌شود.

* message: به صورت پویا از فیلد ورودی MCP Message با استفاده از ={{ $fromAI('Message', '', 'string') }} پر می‌شود.

* descriptionType: روی manual تنظیم شده است.

• ورودی: از خروجی ai_tool Node MCP_GMAIL متصل شده است.
• خروجی: نتیجه استاندارد ارسال Gmail (فراداده پیام).
• مشکلات احتمالی:

* خطاهای احراز هویت Gmail OAuth2.

* آدرس‌های ایمیل یا محتوای پیام نامعتبر.

* محدودیت‌های نرخ API.

#### 2.2 REPLY\_EMAIL

• عملکرد: به یک رشته ایمیل موجود پاسخ می‌دهد.
• پیکربندی:

* messageId: از فیلد ورودی MCP Message_ID با استفاده از ={{ $fromAI('Message_ID', '', 'string') }} برای شناسایی رشته پر می‌شود.

* message: محتوای پاسخ تولید شده توسط هوش مصنوعی از فیلد ورودی MCP Message با استفاده از ={{ $fromAI('Message', '', 'string') }}.

* operation: روی reply تنظیم شده است.

* descriptionType: روی manual تنظیم شده است.

• ورودی: از خروجی ai_tool Node MCP_GMAIL متصل شده است.
• خروجی: فراداده پیام پاسخ.
• مشکلات احتمالی:

* Message_ID گمشده یا نامعتبر.

* خطاهای احراز هویت یا API.

* مشکلات قالب‌بندی محتوای پاسخ.

#### 2.3 GET\_EMAIL

• عملکرد: جزئیات یک ایمیل خاص را دریافت می‌کند.
• پیکربندی:

* messageId: از فیلد ورودی MCP Message_ID با استفاده از ={{ $fromAI('Message_ID', '', 'string') }}.

* simple: پرچم boolean از ورودی MCP Simplify با استفاده از ={{ $fromAI('Simplify', '', 'boolean') }} برای کنترل جزئیات خروجی.

* operation: روی get تنظیم شده است.

• ورودی: از خروجی ai_tool Node MCP_GMAIL متصل شده است.
• خروجی: داده‌های پیام ایمیل (کامل یا ساده شده).
• مشکلات احتمالی:

* Message_ID نامعتبر یا گمشده.

* خطاهای API یا مشکلات مجوز.

#### 2.4 SEND\_AND\_WAIT

• عملکرد: ایمیلی را ارسال کرده و منتظر پاسخ در همان رشته می‌ماند.
• پیکربندی:

* sendTo: به صورت پویا از فیلد ورودی MCP To با استفاده از ={{ $fromAI('To', '', 'string') }} پر می‌شود.

* subject: به صورت پویا از فیلد ورودی MCP Subject با استفاده از ={{ $fromAI('Subject', '', 'string') }} پر می‌شود.

* message: به صورت پویا از فیلد ورودی MCP Message با استفاده از ={{ $fromAI('Message', '', 'string') }} پر می‌شود.

* operation: روی sendAndWait تنظیم شده است.

* responseType: روی freeText تنظیم شده است (انتظار پاسخ متنی آزاد را دارد).

• ورودی: از خروجی ai_tool Node MCP_GMAIL متصل شده است.
• خروجی: داده‌های پیام پاسخ دریافتی پس از انتظار.
• مشکلات احتمالی:

* اتمام زمان انتظار اگر پاسخی در دوره انتظار پیکربندی شده دریافت نشود.

* خطاهای احراز هویت یا API.

* گیرنده نامعتبر یا محتوای پیام.

---

جدول خلاصه

---

بازسازی Workflow از ابتدا

1. افزودن Node تریگر MCP:

* یک Node از نوع MCP Trigger (@n8n/n8n-nodes-langchain.mcpTrigger) اضافه کنید.

* مسیر HTTP را روی /mcp/:tool/gmail تنظیم کنید.

* این Node برای گوش دادن به درخواست‌های HTTP POST ورودی از سرور MCP شما استفاده خواهد شد.

* در اینجا نیازی به اعتبارنامه نیست مگر اینکه سرور MCP شما به احراز هویت وب‌هوک خاصی نیاز داشته باشد.

2. افزودن Node SEND\_EMAIL:

* یک Node از نوع Gmail Tool (v2.1) اضافه کنید.

* عملیات را روی send (پیش‌فرض) تنظیم کنید.

* فیلدها را با استفاده از عبارات پیکربندی کنید:

* Send To: ={{ $fromAI('To', '', 'string') }}

* Subject: ={{ $fromAI('Subject', '', 'string') }}

* Message: ={{ $fromAI('Message', '', 'string') }}

* Description Type: روی manual تنظیم کنید.

* اعتبارنامه Gmail OAuth2 پیکربندی شده خود را انتخاب کنید.

* ورودی را از خروجی ai_tool Node MCP_GMAIL متصل کنید.

3. افزودودن Node REPLY\_EMAIL:

* یک Node از نوع Gmail Tool (v2.1) اضافه کنید.

* عملیات را روی reply تنظیم کنید.

* فیلدها را پیکربندی کنید:

* Message ID: ={{ $fromAI('Message_ID', '', 'string') }}

* Message: ={{ $fromAI('Message', '', 'string') }}

* Description Type: روی manual تنظیم کنید.

* از همان اعتبارنامه‌های Gmail OAuth2 استفاده کنید.

* ورودی را از خروجی ai_tool Node MCP_GMAIL متصل کنید.

4. افزودن Node GET\_EMAIL:

* یک Node از نوع Gmail Tool (v2.1) اضافه کنید.

* عملیات را روی get تنظیم کنید.

* فیلدها را پیکربندی کنید:

* Message ID: ={{ $fromAI('Message_ID', '', 'string') }}

* Simple: ={{ $fromAI('Simplify', '', 'boolean') }}

* از اعتبارنامه‌های Gmail OAuth2 استفاده کنید.

* ورودی را از خروجی ai_tool Node MCP_GMAIL متصل کنید.

5. افزودن Node SEND\_AND\_WAIT:

* یک Node از نوع Gmail Tool (v2.1) اضافه کنید.

* عملیات را روی sendAndWait تنظیم کنید.

* فیلدها را پیکربندی کنید:

* Send To: ={{ $fromAI('To', '', 'string') }}

* Subject: ={{ $fromAI('Subject', '', 'string') }}

* Message: ={{ $fromAI('Message', '', 'string') }}

* Response Type: روی freeText تنظیم کنید.

* از اعتبارنامه‌های Gmail OAuth2 استفاده کنید.

* ورودی را از خروجی ai_tool Node MCP_GMAIL متصل کنید.

6. اتصال Node ها:

* اطمینان حاصل کنید که همه Node های Gmail (SEND_EMAIL، REPLY_EMAIL، GET_EMAIL، SEND_AND_WAIT) ورودی را از خروجی ai_tool Node MCP_GMAIL دریافت می‌کنند.

7. پیکربندی اعتبارنامه‌ها:

* Gmail OAuth2: به Settings > Credentials > New > Google > Gmail (OAuth2 API) بروید و اعتبارنامه‌های خود را پیکربندی کنید. اطمینان حاصل کنید که API Gmail در پروژه Google Cloud شما فعال است.

* احراز هویت سرور MCP: هرگونه احراز هویت لازم برای سرور MCP خود را پیکربندی کنید (به عنوان مثال، با استفاده از اعتبارنامه‌های احراز هویت هدر در n8n).

8. فعال‌سازی Workflow:

* کلید فعال‌سازی Workflow را روشن کنید.

* URL وب‌هوک ارائه شده توسط Node MCP_GMAIL را کپی کنید.

* سرور MCP خود را پیکربندی کنید تا درخواست‌های HTTP را به این URL با بارهای داده تولید شده توسط هوش مصنوعی مناسب ارسال کند.

---

نکات عمومی و منابع

• ادغام سرور MCP: اطمینان حاصل کنید که سرور MCP شما برای ارسال درخواست‌های POST به URL وب‌هوک n8n با یک بار داده JSON حاوی فیلدهای لازم (To، Subject، Message، Message_ID، Simplify و غیره) پیکربندی شده است.
• مدیریت خطا: مدیریت خطای قوی را در سرور MCP خود پیاده‌سازی کنید و برای Workflow های پیچیده‌تر، Node های گرفتن خطا را در n8n در نظر بگیرید.
• امنیت: نقطه پایانی وب‌هوک خود را به طور مناسب ایمن کنید، به خصوص اگر اطلاعات حساس را پردازش می‌کند. روش‌های احراز هویت فراتر از HTTP پایه را در نظر بگیرید.
• سهمیه‌های API Gmail: به سهمیه‌ها و محدودیت‌های نرخ API Google برای عملیات Gmail توجه داشته باشید.