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

1. مقدمة

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

في هذا الدرس التطبيقي حول الترميز، ستتعلّم كيفية استخدام بروتوكول Model Context Protocol ‏ (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 أو أنشِئ مشروعًا.

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

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

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

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

تفعيل خدمات MCP

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

تفعيل خدمات MCP

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

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

1. في وحدة تحكّم Google Cloud، ابحث عن 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.
   • ضمن الوظائف، أوقِف تفعيل الميزات التفاعلية.
   • ضمن السجلات، اختَر تسجيل الأخطاء في خدمة تسجيل البيانات.
3. انقر على حفظ.

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

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

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

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

1. في وحدة تحكّم Google Cloud، انتقِل إلى منصة Google للمصادقة > العلامة التجارية. انقر على البدء إذا لم يتم ضبطها.
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

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

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

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

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

Google Chat

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

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

Google Drive

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

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

Gmail

جرِّب أن تطلب من Gemini البحث عن رسائلك الإلكترونية أو إدارتها:

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

People API

جرِّب طرح أسئلة على Gemini حول ملفك الشخصي أو جهات الاتصال:

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

الجمع بين خدمات متعددة

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

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

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

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

7. تَنظيم

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

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

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

8. تهانينا

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

ما تعلّمته

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

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

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