Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ضبط خادم MCP في Gmail

يوفّر Gmail خادم Model Context Protocol (MCP) عن بُعد يتيح لوكلاء الذكاء الاصطناعي التفاعل بأمان مع بيانات Gmail. من خلال إعداد خادم Gmail MCP، يمكنك تفعيل تطبيقات الذكاء الاصطناعي، مثل Gemini CLI أو Claude أو بيئات التطوير المتكاملة (IDE)، لتنفيذ إجراءات في Gmail.

يوفّر خادم Gmail MCP طريقة موحّدة لوكلاء الذكاء الاصطناعي لإجراء ما يلي:

قراءة البيانات: البحث عن الرسائل الإلكترونية واسترداد سلاسل المحادثات وإدراج التصنيفات
اتّخاذ الإجراءات: إنشاء مسودات للرسائل الإلكترونية وتصنيف الرسائل
مراعاة الأمان: اكتساب الأذونات وعناصر التحكّم في إدارة البيانات نفسها التي يملكها المستخدم

المتطلبات الأساسية

مشروع على Google Cloud لإنشاء مشروع، يُرجى الاطّلاع على مقالة إنشاء مشروع.
عميل MCP، مثل Gemini CLI
لتنفيذ الأوامر في هذه الصفحة، عليك إعداد gcloud CLI في بيئة تطوير محلية باتّباع الخطوات التالية:
1. ثبِّت Google Cloud CLI. إذا سبق لك تثبيت gcloud CLI، تأكَّد من استخدام أحدث إصدار من خلال تنفيذ الأمر gcloud components update.
2. إذا كنت تستخدم موفِّر هوية (IdP) خارجيًا، سجِّل الدخول إلى gcloud CLI باستخدام هويتك الموحّدة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تسجيل الدخول إلى gcloud CLI باستخدام هويتك الموحّدة.
3. افتح gcloud CLI.

إعداد خادم Gmail MCP

لاستخدام خادم Gmail MCP، عليك تفعيله في مشروعك على Google Cloud، ثم إعداد عميل MCP للاتصال به.

تفعيل واجهات برمجة التطبيقات

لاستخدام خادم Gmail MCP، عليك تفعيل واجهة برمجة التطبيقات التالية في مشروعك على Google Cloud:

Gmail API

CLI

gcloud services enable gmail.googleapis.com --project=PROJECT_ID

استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud.

وحدة التحكّم

يمكنك تفعيل واجهات برمجة التطبيقات في Google Cloud Console:

تفعيل واجهات برمجة التطبيقات

تفعيل خدمات MCP

لتفعيل مكوّنات MCP في Gmail، عليك تفعيل الخدمة التالية في مشروعك على Google Cloud:

Gmail MCP API

CLI

gcloud services enable gmailmcp.googleapis.com --project=PROJECT_ID

استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud.

وحدة التحكّم

يمكنك تفعيل خدمات MCP في Google Cloud Console:

تفعيل خدمات MCP

يستخدم خادم Gmail MCP بروتوكول OAuth 2.0 للمصادقة والتفويض. عليك إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth قبل أن تتمكّن من إنشاء معرّف عميل OAuth.

في Google Cloud Console، انتقِل إلى Google Auth Platform > العلامة التجارية.

الانتقال إلى العلامة التجارية
إذا سبق لك إعداد Google Auth Platform، يمكنك إعداد إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التالية في العلامة التجارية، الجمهور، والوصول إلى البيانات. إذا ظهرت لك رسالة تشير إلى لم يتم إعداد Google Auth Platform بعد، انقر على البدء:
1. ضمن معلومات التطبيق، في اسم التطبيق، اكتب Gmail MCP Server.
2. في البريد الإلكتروني لدعم المستخدم، اختَر عنوان بريدك الإلكتروني أو مجموعة Google مناسبة.
3. انقر على التالي.
4. ضمن الجمهور، اختَر داخلي. إذا لم تتمكّن من اختيار داخلي، اختَر خارجي.
5. انقر على التالي.
6. ضمن معلومات الاتصال ، أدخِل عنوان بريد إلكتروني يمكنك تلقّي إشعارات فيه بشأن أي تغييرات تطرأ على مشروعك.
7. انقر على التالي.
8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API ، وإذا كنت موافقًا عليها، اختَر أوافق على سياسة بيانات المستخدمين في خدمات Google API.
9. انقر على متابعة.
10. انقر على إنشاء.
11. إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمين للاختبار:
  1. انقر على الجمهور.
  2. ضمن مستخدمو الاختبار ، انقر على إضافة مستخدمين.
  3. أدخِل عنوان بريدك الإلكتروني وأي مستخدمين اختباريين آخرين تم منحهم الإذن، ثم انقر على حفظ.
انقر على الوصول إلى البيانات > إضافة نطاقات أو إزالتها. ستظهر لوحة تتضمّن قائمة بالنطاقات لكل واجهة برمجة تطبيقات فعّلتها في مشروعك على Google Cloud.
1. ضمن إضافة نطاقات يدويًا، الصِق نطاقات خادم Gmail MCP:
  - https://www.googleapis.com/auth/gmail.readonly
  - https://www.googleapis.com/auth/gmail.compose
2. انقر على الإضافة إلى الجدول.
3. انقر على تعديل.
4. بعد اختيار النطاقات التي يتطلبها تطبيقك، انقر على حفظ في صفحة الوصول إلى البيانات.

إعداد عميل MCP

لإضافة خادم Gmail MCP عن بُعد إلى عميل MCP، اتّبِع التعليمات الخاصة بعميلك.

Gemini CLI

لإضافة خادم Gmail MCP عن بُعد إلى Gemini CLI، أضِف إعدادات الخادم إلى ملف settings.json.

أنشئ معرّف عميل OAuth 2.0 وسر عميل:
1. في Google Cloud Console، انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل
  
  الانتقال إلى "إنشاء عميل"
2. اختَر تطبيق كمبيوتر مكتبي كنوع التطبيق.
3. أدخِل اسمًا.
4. انقر على إنشاء وانسخ معرّف العميل وسر العميل.
افتح ملف الإعداد ~/.gemini/settings.json أو أنشئه.

أضِف إعدادات mcpServers إلى settings.json:

{
  "mcpServers": {
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    }
  }
}

غيِّر القيم في السلسلة على الشكل التالي:

OAUTH_CLIENT_ID: معرّف العميل الذي أنشأته
OAUTH_CLIENT_SECRET: سر العميل الذي أنشأته

احفظ settings.json.
ابدأ استخدام Gemini CLI:
```
gemini
```
في Gemini CLI، صادِق على خادم MCP من خلال تنفيذ الأمر التالي:
```
/mcp auth gmail
```
1. عندما يُطلب منك ذلك، اضغط على 1 لفتح صفحة مصادقة في متصفّحك. إذا كنت تعمل عبر بروتوكول SSH، اتّبِع التعليمات الواردة في واجهة سطر الأوامر.
2. سجِّل الدخول إلى حساب Google.
3. راجِع نطاقات OAuth المطلوبة وانقر على السماح.
4. ستظهر رسالة تؤكّد نجاح المصادقة.

في Gemini CLI، نفِّذ الأمر /mcp list لعرض خوادم MCP التي تم إعدادها وأدواتها.

ستكون الإجابة مشابهة لما يلي:

🟢 gmail - Ready (10 tools)
  Tools:
  - create_draft
  - create_label
  - get_thread
  - label_message
  - label_thread
  - list_drafts
  - list_labels
  - search_threads
  - unlabel_message
  - unlabel_thread

خادم MCP عن بُعد جاهز للاستخدام في Gemini CLI.

Claude

لاستخدام خادم Gmail MCP عن بُعد مع Claude.ai أو Claude Desktop، يجب أن يكون لديك خطة Claude Enterprise أو Pro أو Max أو Team.

لإضافة خادم Gmail MCP عن بُعد إلى Claude، عليك إعداد موصِّل مخصّص باستخدام معرّف عميل OAuth وسر عميل.

أنشئ معرّف عميل OAuth 2.0 وسر عميل:
1. في Google Cloud Console، انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل
  
  الانتقال إلى "إنشاء عميل"
2. اختَر تطبيق ويب كنوع التطبيق.
3. أدخِل اسمًا.
4. في قسم عناوين URI لإعادة التوجيه المصرَّح بها، انقر على + إضافة عنوان URI، ثم أضِف https://claude.ai/api/mcp/auth_callback في حقل عناوين URI.
5. انقر على إنشاء وانسخ معرّف العميل وسر العميل.
إعداد خادم MCP في Claude:
1. في Claude.ai أو Claude Desktop، انتقِل إلى الإعدادات (أو إعدادات المشرف) > الموصِّلات.
2. انقر على إضافة موصِّل مخصّص.
3. أدخِل تفاصيل الاتصال بمنتج Gmail:
  - اسم الخادم: Gmail.
  - عنوان URL لخادم MCP عن بُعد: https://gmailmcp.googleapis.com/mcp/v1
4. في الإعدادات المتقدّمة، أدخِل معرّف عميل OAuth وسر عميل OAuth.
5. انقر على إضافة.

غير ذلك

تتوفّر في العديد من تطبيقات الذكاء الاصطناعي طرق للاتصال بخادم MCP عن بُعد. عليك عادةً إدخال تفاصيل عن الخادم، مثل اسمه ونقاط النهاية وبروتوكول النقل وطريقة المصادقة. بالنسبة إلى خادم Gmail MCP عن بُعد، أدخِل ما يلي:

اسم الخادم: gmail
عنوان URL للخادم: https://gmailmcp.googleapis.com/mcp/v1
النقل: HTTP
المصادقة: يستخدم خادم Gmail MCP عن بُعد بروتوكول OAuth 2.0. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة لمحة عن المصادقة والتفويض.

لمزيد من التفاصيل حول ربط أنواع مختلفة من العملاء، يُرجى الاطّلاع على مقالة إعداد MCP في تطبيق ذكاء اصطناعي.

اختبار خادم Gmail MCP

بعد إعداد عميل MCP، يمكنك التحقّق من الاتصال من خلال تنفيذ بعض طلبات الاختبار.

حاوِل طرح الأسئلة التالية على عميل MCP:

"ماذا قالت أرييل في آخر رسالة إلكترونية لها عن خطتنا التسويقية؟"

يُجري العميل فلترة للرسائل الإلكترونية من أرييل باستخدام gmail.search_threads، ويسترد محتوى أحدث سلسلة محادثات باستخدام gmail.get_thread، ثم يلخّصها لك.
"أريد إنشاء مسودة رسالة إلكترونية إلى ariel@example.com أقول فيها إنني أوافق على الخطة التسويقية."

يستخدم العميل gmail.create_draft لإنشاء رسالة إلكترونية في مجلد "المسودات"، ما يتيح لك مراجعتها وإرسالها من Gmail.

إذا تم تنفيذ الأدوات بنجاح وتلقّيت ردودًا ذات صلة، يعني ذلك أنّ خادم Gmail MCP تم إعداده بشكلٍ صحيح.

تحديد المشاكل وحلّها

إذا واجهت مشاكل في الاتصال بخادم MCP، يمكنك التحقّق من وجود أخطاء في سجلات OAuth. اطلب من المشرف التحقّق من أحداث سجلّ OAuth في أداة التحقيق الأمني.

مرجع الأداة

تتوفّر الأدوات التالية لخادم Gmail MCP:

create_draft
get_thread
label_message
label_thread
list_drafts
list_labels
search_threads
unlabel_message
unlabel_thread

اعتبارات أمان مهمة: حقن الطلبات بشكل غير مباشر

عند عرض نموذج لغة على بيانات غير موثوق بها، هناك خطر من تعرّضه لهجوم حقن الطلبات بشكل غير مباشر . بما أنّ عملاء MCP، مثل Gemini CLI، يمكنهم الوصول إلى أدوات وواجهات برمجة تطبيقات فعّالة من خلال خادم Gmail MCP، يمكنهم قراءة البيانات وتعديلها وحذفها في حسابك على Google.

للحدّ من هذه المخاطر، اتّبِع أفضل الممارسات التالية:

استخدِم الأدوات الموثوق بها فقط. لا تربط أبدًا خادم Gmail MCP بتطبيقات غير موثوق بها أو لم يتم التحقّق منها.
تعامَل بحذر مع الإدخالات غير الموثوق بها. تجنَّب أن تطلب من عميل MCP معالجة الرسائل الإلكترونية أو الموارد الأخرى من مصادر لم يتم التحقّق منها. قد تحتوي هذه الإدخالات على تعليمات مخفية يمكنها اختراق جلستك، ما يسمح للمهاجم بتعديل بياناتك أو سرقتها أو حذفها.
راجِع جميع الإجراءات. ننصحك دائمًا بمراجعة الإجراءات التي يتّخذها عميل الذكاء الاصطناعي نيابةً عنك بعناية للتأكّد من أنّها صحيحة وتتوافق مع نواياك.

ضبط خادم MCP في Gmail تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

المتطلبات الأساسية

إعداد خادم Gmail MCP

تفعيل واجهات برمجة التطبيقات

CLI

وحدة التحكّم

تفعيل خدمات MCP

CLI

وحدة التحكّم

إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth

إعداد عميل MCP

Gemini CLI

Claude

غير ذلك

اختبار خادم Gmail MCP

تحديد المشاكل وحلّها

مرجع الأداة

اعتبارات أمان مهمة: حقن الطلبات بشكل غير مباشر

القسم ذو الصلة

ضبط خادم MCP في Gmail