خوادم MCP في Google Workspace في Google Antigravity 2.0 وIDE و/أو CLI

1. مقدمة

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

هل تستخدم Gemini Enterprise؟ إذا كانت مؤسستك تستخدم Gemini Enterprise، يمكن لمشرفي العملاء المؤهَّلين إدارة خوادم MCP الموافَق عليها وإدراجها في القائمة المسموح بها مركزيًا. يمكنك الاطّلاع على مزيد من المعلومات في منشور المدوّنة حول Antigravity Enterprise والدرس التطبيقي حول الترميز المصاحب خوادم MCP في Google Workspace مع Antigravity في Gemini Enterprise.

في هذا الدرس التطبيقي حول الترميز، ستتعرّف على كيفية استخدام بروتوكول Model Context Protocol ‏(MCP) لربط بياناتك على Google Workspace بـ Antigravity 2.0 و/أو IDE و/أو CLI. ‫MCP هو معيار مفتوح يتيح لنماذج الذكاء الاصطناعي استخدام الأدوات التي توفّرها الخوادم البعيدة بأمان. ستقوم بإعداد Antigravity للتفاعل مع Gmail وGoogle Drive و"مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" و"تقويم Google" وGoogle Chat وPeople API بدون كتابة أي رمز برمجي.

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

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

المتطلبات

• متصفّح ويب، مثل Chrome
• مشروع على Google Cloud مسجَّل في برنامج المطوّرين الحصري من Google Workspace
• حساب Google Workspace
• تثبيت Antigravity 2.0 و/أو IDE و/أو CLI على جهازك المحلي يمكنك العثور على مزيد من التفاصيل وإرشادات التثبيت على الموقع الإلكتروني الرسمي.

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

2. قبل البدء

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

المتطلبات الأساسية للمؤسسات: بالنسبة إلى العملاء المؤهّلين، إذا كانت مؤسستك تفرض سياسات Gemini Enterprise، يجب أن يفعّل المشرف أولاً "أدوات المطوّرين المستندة إلى الذكاء الاصطناعي" ويُدرج نقاط نهاية خادم MCP في Google Workspace ضمن القائمة المسموح بها في Cloud Console قبل أن تتمكّن من الربط. يمكنك الاطّلاع على مزيد من المعلومات في منشور المدوّنة حول Antigravity Enterprise والدرس التطبيقي حول الترميز المصاحب خوادم MCP في Google Workspace مع Antigravity في Gemini Enterprise.

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

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

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

لاستخدام خوادم MCP في Google Workspace، يجب تفعيل واجهات برمجة التطبيقات العادية في Google Workspace.

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

تفعيل خدمات MCP

بعد ذلك، فعِّل خدمات MCP في Google Workspace.

تفعيل خدمات 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 والعميل

ملاحظة للمؤسسات: في بيئة Google Workspace الخاصة بالمؤسسات، عادةً ما يوفّر مشرف Cloud أو Gemini Enterprise شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth ومعرّف العميل بشكل مركزي. إذا سبق أن قدّم لك المشرف معرّف عميل معتمَدًا، يمكنك تخطّي هذه الخطوة والانتقال مباشرةً إلى ضبط Antigravity.

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

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

يجب ضبط شاشة طلب الموافقة أولاً.

1. في وحدة تحكّم Google Cloud، انتقِل إلى Google Auth Platform > الهوية البصرية. انقر على البدء إذا لم يتم ضبط الإعدادات.
2. اضبط معلومات التطبيق:
   • اسم التطبيق: Google Workspace MCP Servers
   • البريد الإلكتروني المخصّص لدعم المستخدمين: اختَر عنوان بريدك الإلكتروني.
3. اضبط الجمهور: اختَر داخلي (أو خارجي إذا لم يكن الخيار "داخلي" متاحًا).
4. اضبط معلومات الاتصال: أدخِل عنوان بريدك الإلكتروني.
5. راجِع "سياسة بيانات المستخدمين" ووافِق عليها، ثم انقر على إنشاء.
6. إذا اخترت خارجي، انتقِل إلى الجمهور وأضِف عنوان بريدك الإلكتروني ضمن المستخدمون التجريبيون.
7. انتقِل إلى الوصول إلى البيانات > إضافة نطاقات أو إزالتها. ضمن إضافة النطاقات يدويًا، أضِف ما يلي للخوادم التي تريد استخدامها:
   • سوار بمقاس يناسب الجميع: https://www.googleapis.com/auth/gmail.readonly، https://www.googleapis.com/auth/drive.readonly، https://www.googleapis.com/auth/calendar.readonly، https://www.googleapis.com/auth/chat.messages.readonly
   • Gmail: https://www.googleapis.com/auth/gmail.readonly، https://www.googleapis.com/auth/gmail.compose
   • ‫Google Drive: https://www.googleapis.com/auth/drive.readonly، https://www.googleapis.com/auth/drive.file
   • مستندات Google: ‏https://www.googleapis.com/auth/drive.readonly وhttps://www.googleapis.com/auth/drive.file وhttps://www.googleapis.com/auth/documents.readonly وhttps://www.googleapis.com/auth/documents
   • جداول بيانات Google: https://www.googleapis.com/auth/drive.readonly وhttps://www.googleapis.com/auth/drive.file وhttps://www.googleapis.com/auth/spreadsheets.readonly وhttps://www.googleapis.com/auth/spreadsheets
   • العروض التقديمية من Google: https://www.googleapis.com/auth/drive.readonly وhttps://www.googleapis.com/auth/drive.file وhttps://www.googleapis.com/auth/presentations.readonly وhttps://www.googleapis.com/auth/presentations
   • تقويم 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.messages.create وhttps://www.googleapis.com/auth/chat.users.readstate.readonly
   • 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 Auth Platform > العملاء > إنشاء عميل.
2. اختَر تطبيق ويب كنوع التطبيق.
3. أدخِل الاسم Antigravity.
4. ضمن معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظم (URI) ثم أدخِل https://antigravity.google/oauth-callback.
5. اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي.
6. انقر على إنشاء وانسخ معرِّف العميل وسر العميل. ستحتاج إليها في الخطوة التالية.

4. ضبط Antigravity

والآن، لنضبط Antigravity لاستخدام نقاط النهاية هذه. إذا لم يكن لديك Antigravity 2.0 و/أو IDE و/أو CLI، اتّبِع التعليمات الواردة على موقع Antigravity الإلكتروني.

إضافة خوادم MCP مخصّصة

تتشارك Antigravity 2.0 وIDE وCLI في إعدادات MCP مركزية في الملف ~/.gemini/config/mcp_config.json.

1. افتحه في محرِّر النصوص المفضّل لديك.

   ملاحظة: يمكنك الوصول إلى الملف مباشرةً من Antigravity IDE إذا كان مثبّتًا لديك باتّباع الخطوات التالية:

   1. افتح خوادم MCP من خلال القائمة المنسدلة ... في أعلى لوحة الوكيل في المحرِّر.
   2. انقر على إدارة خوادم MCP ثم عرض الإعدادات الأولية.
2. يُرجى تعديل إعدادات خادم MCP المخصّص التالية. قبل إجراء ذلك، استبدِل العنصرَين النائبَين <YOUR_CLIENT_ID> و<YOUR_CLIENT_SECRET> بمعرّف عميل OAuth وسرّه اللذين أنشأتهما في الخطوات السابقة.
3. احفظها.

{
  "mcpServers": {
    "gws-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-slides": {
      "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
    ...
  }
  ...
}

مصادقة خوادم MCP المخصّصة

من المفترض أن تظهر لك جميع خوادم MCP التي أعددتها على أنّها مثبَّتة في Antigravity: gws-universal وgws-gmail وgws-drive وgws-docs وgws-sheets وgws-slides وgws-calendar وgws-chat وgws-people. يجب مصادقة كل منها لكل سطح Antigravity لأنّ رموز OAuth المميّزة ليست مركزية.

تحديد مشاكل أخطاء سياسات Enterprise وحلّها: إذا عرض خادم MCP الرمز Unauthorized / Blocked by Admin Policy عند النقر على إعادة تحميل، يعني ذلك أنّ هذه الخدمة غير مضمّنة في القائمة المسموح بها في Gemini Enterprise لمؤسستك. يُرجى التواصل مع المشرف لإضافة نقطة نهاية الخدمة، ومشاركة الدرس التطبيقي حول الترميز لمشرفي Gemini Enterprise معه للحصول على إرشادات حول الإعداد.

Antigravity 2.0

1. انقر على الإعدادات في أسفل يمين الصفحة.
2. انتقِل إلى التخصيصات.
3. ضمن خوادم MCP المثبّتة، انقر على إعادة تحميل.

4. لكل خادم MCP مثبَّت ومُدرَج في القائمة:
   1. انقر على مصادقة.
   
   2. اتّبِع خطوات المصادقة في نافذة المتصفّح الجديدة التي تفتح.
   3. بعد الانتهاء، انقر على النسخ إلى الحافظة.
   
   4. الصِق رمز المصادقة الذي نسخته للتو في حقل النص المعروض في إعدادات Antigravity 2.0 وانقر على إرسال.
   
   5. سيظهر الآن زر تسجيل الخروج بدلاً من المصادقة.
   

Antigravity IDE

1. افتح إعدادات مستخدم Antigravity من خلال القائمة المنسدلة إعدادات خاصة بالمحرِّر في أعلى النافذة.

2. انتقِل إلى التخصيصات.
3. ضمن خوادم MCP المثبّتة، انقر على إعادة تحميل.

4. لكل خادم MCP مثبَّت ومُدرَج في القائمة:
   1. انقر على مصادقة.
   
   2. اتّبِع خطوات المصادقة في نافذة المتصفّح الجديدة التي تفتح.
   3. بعد الانتهاء، انقر على النسخ إلى الحافظة.
   
   4. ألصِق رمز المصادقة الذي نسخته للتو في حقل النص المعروض في إعدادات Antigravity IDE، ثم انقر على إرسال.
   
   5. سيظهر الآن زر تسجيل الخروج بدلاً من المصادقة.
   

Antigravity CLI

1. اكتب /mcp واضغط على مفتاح Enter.

2. لكل خادم MCP مدرَج:
   1. اختَرها باستخدام مفتاحَي السهمَين المتّجهَين للأعلى وللأسفل واضغط على Enter.
   2. اختَر مصادقة باستخدام مفتاحَي السهمَين المتّجهَين لليمين ولليسار، ثم اضغط على مفتاح Enter.
   
   3. افتح عنوان URL المعروض في نافذة متصفّح جديدة واتّبِع خطوات المصادقة.
   
   4. بعد الانتهاء، انقر على النسخ إلى الحافظة.
   
   5. الصق رمز المصادقة الذي نسخته للتو في حقل النص المعروض في وحدة التحكّم التي تشغّل Antigravity CLI، ثم اضغط على مفتاح Enter.
   
   6. ستظهر الآن الحالة تمت المصادقة بدلاً من المصادقة مطلوبة.
   

5- أدوات الاختبار

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

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

سوار بمقاس يناسب الجميع

جرِّب البحث في منتجات مختلفة:

• "أريد تلخيصًا في بضع جمل لآخر ما حدث في حسابي على Google Workspace".
• "أريد العثور على أي محتوى مرتبط بـ [PROJECT_NAME] في بريدي الإلكتروني ومستنداتي ورسائل المحادثة".
• "ما هو موعد اجتماعي القادم حول خطة التسويق، وما هي آخر الملاحظات ورسائل المحادثة حولها؟"

Gmail

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

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

Google Drive

جرِّب البحث في الملفات أو قراءتها:

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

"مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google"

يمكنك البحث في مراجع Drive:

• "أريد الاطّلاع على المحتوى الهيكلي لمستند Google ‏[DOCS_TITLE]".
• "قراءة الورقة Sheet1 من جدول بيانات Google‏ [SHEETS_TITLE]"
• "أريد الاطّلاع على التنسيق اللفظي للعرض التقديمي [SLIDES_TITLE] في "العروض التقديمية من Google"."

تقويم Google

جرِّب البحث في جدولك الزمني:

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

Google Chat

جرِّب البحث عن الرسائل:

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

People API

جرِّب البحث في ملفك الشخصي أو جهات الاتصال:

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

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

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

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

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

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

6. تَنظيم

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

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

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

7. تهانينا

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

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

• مقدمة عن "بروتوكول سياق النموذج" (MCP)
• كيفية ضبط خوادم MCP في Google Workspace
• ضبط إعدادات الموافقة على OAuth
• نظرة عامة على Antigravity Enterprise
• درس تطبيقي حول الترميز بشأن خوادم MCP في Google Workspace مع Antigravity في Gemini Enterprise
• Antigravity