بدء استخدام Google Workspace MCP وGemini CLI

1. مقدمة

ملاحظة: هل ما زلت تستخدم Gemini CLI؟ يمكنك الانتقال إلى هذا الدرس التطبيقي حول الترميز للتعرّف على كيفية إعداد خوادم MCP في Google Workspace باستخدام Antigravity CLI بدلاً من ذلك. يمكنك العثور على مزيد من المعلومات حول عملية النقل في منشور المدوّنة الرسمي هذا.

في هذا الدرس التطبيقي حول الترميز، ستتعرّف على كيفية استخدام بروتوكول سياق النموذج (MCP) لربط Gemini CLI ببياناتك على Google Workspace. ‫MCP هو معيار مفتوح يتيح لنماذج الذكاء الاصطناعي استخدام الأدوات التي توفّرها الخوادم البعيدة بأمان. ستستخدم Gemini CLI كعميل للتفاعل مع Gmail وGoogle Drive و"تقويم Google" وGoogle Chat وPeople API بدون كتابة أي رمز برمجي.

الإجراءات التي ستنفذّها

• فعِّل خدمات MCP في Google Workspace في مشروعك على Google Cloud.
• اضبط Gemini CLI لاستخدام خدمات MCP هذه.
• اختبِر عملية الدمج من خلال طلبات ممتعة ومفيدة تتفاعل مع بياناتك في Google Workspace.

المتطلبات

• متصفّح ويب، مثل Chrome
• مشروع على Google Cloud
• حساب Google Workspace
• تثبيت Gemini CLI على جهازك

سيستغرق إكمال هذا الدرس التطبيقي حول الترميز 30 دقيقة تقريبًا.

سهولة الوصول إلى هذا الدرس التطبيقي حول الترميز

2. قبل البدء

برنامج معاينة المطوّر في Google Workspace: يمكنك الوصول إلى خوادم MCP في Google Workspace من خلال برنامج معاينة المطوّر المتاح للجميع. يُرجى الاشتراك والتأكّد من قبول حسابك في البرنامج على الرابط https://developers.google.com/workspace/preview، إذا لم يسبق لك إجراء ذلك.

إنشاء مشروع على Google Cloud أو اختياره

في Google Cloud Console، اختَر مشروعًا على Google Cloud أو أنشِئه.

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

لاستخدام خوادم بروتوكول سياق النموذج (MCP) في Google Workspace، يجب تفعيل واجهات برمجة التطبيقات في Google Workspace. في حين أنّ بعض خوادم MCP تعمل بشكل مستقل، يتطلّب بعضها الآخر تفعيل واجهة برمجة التطبيقات العادية الأساسية:

• لا يزال Gmail وChat يتطلبان واجهات برمجة التطبيقات العادية.
• يتطلّب Drive واجهة برمجة التطبيقات العادية لبعض الأدوات.
• لا يتطلّب تقويم Google تفعيل واجهة برمجة التطبيقات العادية.
• تتعامل People API مع كل من إذن الوصول العادي ووظائف MCP، لذا لا تتوفّر لها خدمة MCP منفصلة لتفعيلها.

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

تفعيل خدمات MCP

بعد ذلك، فعِّل خدمات MCP المخصّصة للمنتجات.

تفعيل خدمات MCP

ضبط إعدادات تطبيق Chat

لاستخدام خادم MCP في Google Chat، عليك إعداد تطبيق Chat في مشروعك على Google Cloud.

1. في Google Cloud Console، ابحث عن Google Chat API، وانقر على Google Chat API > إدارة > الإعدادات.الانتقال إلى Google Chat API
2. إعداد تطبيق Chat:
   • في حقل اسم التطبيق، أدخِل Chat MCP.
   • في حقل عنوان URL للأفاتار، أدخِل https://developers.google.com/chat/images/quickstart-app-avatar.png.
   • في حقل الوصف، أدخِل Chat MCP server.
   • ضمن الوظائف، أوقِف تفعيل الميزات التفاعلية.
   • ضمن السجلّات، اختَر تسجيل الأخطاء في Logging.
3. انقر على حفظ.

3- ضبط موافقة OAuth والعميل

تستخدم خوادم MCP في Google Workspace بروتوكول OAuth 2.0 للمصادقة الآمنة. يجب إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth وإنشاء عميل لتطبيق سطح المكتب.

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

تستخدم خوادم MCP في Google Workspace بروتوكول OAuth 2.0 للمصادقة. يجب ضبط شاشة طلب الموافقة أولاً.

1. في وحدة تحكّم Google Cloud، انتقِل إلى Google Auth Platform > الهوية البصرية. انقر على البدء إذا لم يتم ضبط الإعدادات.
2. اضبط معلومات التطبيق:
   • اسم التطبيق: Google Workspace MCP Servers
   • البريد الإلكتروني المخصّص لدعم المستخدمين: اختَر عنوان بريدك الإلكتروني.
3. اضبط الجمهور: اختَر داخلي (أو خارجي إذا لم يكن الخيار "داخلي" متاحًا).
4. اضبط معلومات الاتصال: أدخِل عنوان بريدك الإلكتروني.
5. راجِع "سياسة بيانات المستخدمين" ووافِق عليها، ثم انقر على إنشاء.
6. إذا اخترت خارجي، انتقِل إلى الجمهور وأضِف عنوان بريدك الإلكتروني ضمن المستخدمون التجريبيون.
7. انتقِل إلى الوصول إلى البيانات > إضافة نطاقات أو إزالتها. ضمن إضافة النطاقات يدويًا، أضِف ما يلي للخوادم التي تريد استخدامها:
   • تقويم Google: https://www.googleapis.com/auth/calendar.calendarlist.readonly وhttps://www.googleapis.com/auth/calendar.events.freebusy وhttps://www.googleapis.com/auth/calendar.events.readonly
   • Google Chat: ‏https://www.googleapis.com/auth/chat.spaces.readonly، ‏https://www.googleapis.com/auth/chat.memberships.readonly، ‏https://www.googleapis.com/auth/chat.messages.readonly، ‏https://www.googleapis.com/auth/chat.users.readstate.readonly
   • ‫Google Drive: https://www.googleapis.com/auth/drive.readonly، https://www.googleapis.com/auth/drive.file
   • Gmail: https://www.googleapis.com/auth/gmail.readonly، https://www.googleapis.com/auth/gmail.compose
   • People API: https://www.googleapis.com/auth/directory.readonly، https://www.googleapis.com/auth/userinfo.profile، https://www.googleapis.com/auth/contacts.readonly
8. انقر على الإضافة إلى الجدول، ثم على تعديل، وأخيرًا على حفظ.

إنشاء معرِّف عميل OAuth

عند إعداد عميل OAuth 2.0 لخوادم MCP في Google Workspace، يجب تفعيل إعداد التصنيف المستند إلى الوكلاء (is_agentic) من خلال اختيار استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي. يتم حظر عملاء OAuth الذين لم يتم تفعيل هذا الإعداد لهم من طلب نقاط نهاية MCP في Google Workspace.

1. انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل (أو واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد > إنشاء بيانات اعتماد > معرِّف عميل OAuth).
2. اختَر تطبيق متوافق مع الكمبيوتر المكتبي كنوع التطبيق.
3. أدخِل الاسم Gemini CLI.
4. اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي لتفعيل علامة تصنيف is_agentic في عميل OAuth.
5. انقر على إنشاء وانسخ معرِّف العميل وسر العميل. ستحتاج إليها في الخطوة التالية.

4. إعداد Gemini CLI

لنضبط الآن Gemini CLI لاستخدام نقاط النهاية هذه. إذا لم يكن Gemini CLI مثبّتًا، اتّبِع تعليمات التثبيت على موقع Gemini CLI الإلكتروني.

يجب استخدام بيئة محلية: لا تستخدِم Cloud Shell لهذه الخطوة. يتطلّب Gemini CLI متصفّحًا محليًا لمصادقة OAuth. يُرجى استخدام الوحدة الطرفية لجهازك المحلي. لمزيد من المعلومات، يُرجى الاطّلاع على متطلبات إعادة توجيه المتصفّح.

إنشاء ملف الإعداد

افتح ملف ~/.gemini/settings.json أو أنشئه في الدليل الرئيسي وأضِف الإعدادات التالية. استبدِل العناصر النائبة ببيانات اعتماد OAuth.

{
  "mcpServers": {
    "calendar": {
      "httpUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/calendar.calendarlist.readonly",
          "https://www.googleapis.com/auth/calendar.events.freebusy",
          "https://www.googleapis.com/auth/calendar.events.readonly"
        ]
      }
    },
    "chat": {
      "httpUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/chat.spaces.readonly",
          "https://www.googleapis.com/auth/chat.memberships.readonly",
          "https://www.googleapis.com/auth/chat.messages.readonly",
          "https://www.googleapis.com/auth/chat.users.readstate.readonly"
        ]
      }
    },
    "drive": {
      "httpUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/drive.readonly",
          "https://www.googleapis.com/auth/drive.file"
        ]
      }
    },
    "gmail": {
      "httpUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/gmail.readonly",
          "https://www.googleapis.com/auth/gmail.compose"
        ]
      }
    },
    "people": {
      "httpUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "enabled": true,
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>",
        "scopes": [
          "https://www.googleapis.com/auth/directory.readonly",
          "https://www.googleapis.com/auth/userinfo.profile",
          "https://www.googleapis.com/auth/contacts.readonly"
        ]
      }
    }
  }
}

5- مصادقة خوادم MCP والتحقّق منها

قبل استخدام خوادم MCP، عليك مصادقتها والتحقّق من أنّها متصلة.

بدء استخدام Gemini CLI

نفِّذ الأمر التالي في نافذة الأوامر على جهازك لبدء استخدام Gemini CLI:

gemini

مصادقة

يمكنك المصادقة باستخدام الخدمات التي تريد اختبارها من خلال تشغيل الأمر المقابل في Gemini CLI. ما عليك سوى المصادقة باستخدام الخدمات التي تخطّط لاستخدامها في هذا الدرس التطبيقي حول الترميز.

التقويم

/mcp auth calendar

محادثة

/mcp auth chat

Drive

/mcp auth drive

Gmail

/mcp auth gmail

الأشخاص

/mcp auth people

اتّبِع التعليمات التي تظهر في المتصفّح لمنح الإذن لكل خدمة.

تأكيد الربط

تأكَّد من تحميل الأدوات وجاهزيتها:

/mcp list

من المفترض أن يظهر لك ناتج يشير إلى أنّ الخدمات Ready مع إدراج أدواتها.

6. اختبار خوادم MCP

يمكنك الآن التفاعل مع بياناتك في Google Workspace باستخدام اللغة الطبيعية. في ما يلي بعض الأمثلة على الطلبات لكل خدمة.

ملاحظة: استبدِل العناصر النائبة بين قوسين في الطلبات أدناه (مثل [NAME] و[FILE_NAME]) بقيم فعلية من بياناتك في Google Workspace.

تقويم Google

جرّب أن تسأل Gemini عن جدولك الزمني:

• "ما هي اجتماعاتي القادمة هذا الأسبوع؟"
• "هل لديّ أي وقت فراغ غدًا بعد الظهر؟"

Google Chat

إليك بعض الطلبات لتجربتها:

• "ابحث عن الرسائل التي تحتوي على '[KEYWORD]' في '[SPACE_NAME]'"

Google Drive

جرّب اسأل Gemini للعثور على الملفات أو قراءتها:

• "أريد البحث عن ملفات في Google Drive تحتوي على '[الكلمة الرئيسية]'".
• "أريد قائمة بالمستندات الأخيرة التي عدّلتها".
• "اقرأ محتوى مستند [FILE_NAME] ولخِّص الأهداف الرئيسية".

Gmail

إليك بعض الطلبات لتجربتها:

• "لخِّص آخر 5 رسائل إلكترونية تلقّيتها".
• "أريد صياغة رسالة إلكترونية إلى [EMAIL_ADDRESS] لطلب آخر الأخبار عن مشروع [PROJECT_NAME]".

People API

جرّب أن تسأل Gemini عن ملفك الشخصي أو جهات اتصالك:

• "ما هو اسمي وفقًا لملفي الشخصي في حساب Google؟"
• "أريد العثور على معلومات الاتصال الخاصة بـ [الاسم]".

دمج خدمات متعددة

تظهر الإمكانات الحقيقية لبروتوكول MCP عندما ينسّق Gemini المهام في خدمات متعددة. جرِّب هذه الطلبات التي توضّح إمكانات الاستخدام على مستوى الخدمات:

• "ابحث عن ملفات في Drive ذات صلة بـ "تعديلات على المراحل الرئيسية في [PROJECT_NAME]"، ولخِّص محتواها، واعثر على عنوان البريد الإلكتروني لـ "[NAME]"، وأنشئ مسودة في Gmail لإرسالها إليه مع الملخّص".

استكشاف المزيد من الأدوات

هذه مجرد أمثلة قليلة على ما يمكنك فعله. للاطّلاع على القائمة الكاملة للأدوات المتاحة لكل خدمة وتجربتها، يُرجى الرجوع إلى قسم المنتجات المتوافقة في المستندات الرسمية.

7. تَنظيم

لتنظيف مشروعك بدون حذفه، يمكنك إيقاف واجهات برمجة التطبيقات وخدمات MCP التي فعّلتها:

1. في Google Cloud Console، انتقِل إلى لوحة بيانات واجهات برمجة التطبيقات والخدمات.
2. انقر على كل من واجهات برمجة التطبيقات في Google Workspace وMCP التي فعّلتها (مثل Calendar MCP وChat MCP)، ثم انقر على إيقاف واجهة برمجة التطبيقات.

احذف بيانات اعتماد عميل OAuth في وحدة تحكّم Google Auth Platform إذا لم تعُد تخطّط لاستخدامها.

8. تهانينا

تهانينا! لقد نجحت في إعداد خوادم MCP الرسمية في Google Workspace واختبارها باستخدام Gemini CLI.

ما تعلّمته

• كيفية تفعيل خدمات Google Workspace MCP في Google Cloud
• كيفية ضبط عميل OAuth لبروتوكول MCP
• كيفية استخدام Gemini CLI للتفاعل مع بيانات Google Workspace باستخدام الأدوات العادية

المستندات المرجعية

• مقدمة عن "بروتوكول سياق النموذج" (MCP)
• كيفية ضبط خوادم MCP في Google Workspace
• ضبط إعدادات الموافقة على OAuth