خوادم Google Workspace MCP مع Antigravity في Gemini Enterprise

1. مقدمة

ملاحظة: هل أنت مطوّر؟ هذا الدليل مخصّص لمشرفي Gemini Enterprise. استخدِم خوادم Google Workspace MCP مع Antigravity Codelab للتعرّف على كيفية ربط خوادم Google Workspace MCP بـ Antigravity 2.0 و/أو بيئة التطوير المتكاملة (IDE) و/أو واجهة سطر الأوامر (CLI).

بالنسبة إلى العملاء المؤهّلين الذين يستخدمون هذا الدرس التطبيقي حول الترميز، ستتعلّم كيفية إعداد خوادم بروتوكول سياق النموذج في Google Workspace‏ (MCP) وإدارتها وتأمينها في Antigravity باستخدام Gemini Enterprise. ‫MCP هو معيار مفتوح يتيح لوكلاء الذكاء الاصطناعي طلب الأدوات التي تعرضها خدمات الواجهة الخلفية البعيدة وتنفيذها بأمان.

عند تطوير ميزات معقّدة، ومواصفات معمارية، ومستندات متطلبات المنتج (PRD)، ومقاييس الأداء، يتم تخزينها في "مستندات Google" و"جداول بيانات Google" وDrive. يؤدي نسخ النص ولصقه بين علامات تبويب المتصفّح إلى إنشاء سياق قديم ويؤدي إلى خطر تسرُّب البيانات. يتيح ربط خوادم MCP في Workspace باستخدام Gemini Enterprise للمطوّرين الحصول على سياق مباشر مع فرض إدارة على مستوى المؤسسة.

يمكنك الاطّلاع على مزيد من المعلومات حول إمكانات مطوّري الذكاء الاصطناعي في المؤسسات في مشاركة المدوّنة حول Antigravity Enterprise.

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

• فعِّل أدوات المطوّرين المستندة إلى الذكاء الاصطناعي واضبط قوائم السماح لخادم بروتوكول سياق النموذج (MCP) المركزية في Gemini Enterprise.
• فعِّل واجهات برمجة التطبيقات في Google Workspace وMCP في Google Cloud.
• اضبط بيانات اعتماد تطبيق الويب OAuth 2.0 ذات النطاق المحدود والمقتصرة على مؤسستك الداخلية.
• سجِّل خدمات MCP المعتمَدة في Workspace وأثبِت ملكيتها داخل Antigravity.
• تحقَّق من حدود الأمان الإدارية، بما في ذلك حظر القائمة المسموح بها، وتكافؤ قائمة التحكّم بالوصول (ACL) الخاصة بالمستخدم، وتسجيل التدقيق.

المتطلبات

• متصفّح ويب، مثل Google Chrome
• مشروع Google Cloud تم تفعيل الفوترة فيه، وإذن وصول المشرف إلى Gemini Enterprise
• مشروع Google Cloud المُدرَج في برنامج استخدام المنتج قبل إطلاقه في Google Workspace
• تثبيت Antigravity 2.0 أو بيئة تطوير متكاملة (IDE) أو واجهة سطر أوامر (CLI) على محطة العمل تتوفّر إرشادات مفصّلة حول عملية التثبيت على موقع مستندات Antigravity.

2. تفعيل أدوات المطوّرين المستندة إلى الذكاء الاصطناعي في Gemini Enterprise وقوائم السماح

يبدأ أمان المؤسسة بإدارة مركزية. قبل أن يتمكّن المطوّرون الفرديون من تسجيل خوادم MCP محليًا، يجب أن يسمح مشرفو مساحة العمل بعملية الدمج.

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

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

تفعيل أدوات المطوّرين بالذكاء الاصطناعي

1. افتح Google Cloud Console.
2. في قائمة التنقّل، انتقِل إلى Gemini Enterprise > الإعدادات.
3. اختَر أدوات المطوّرين بالذكاء الاصطناعي وانقر على زر التبديل مفعّلة.

يسمح هذا الإعداد لأفراد الفريق المفوّضين بالمصادقة على جلسات Antigravity باستخدام حساباتهم على Google Cloud للمؤسسات.

تحديد القائمة المسموح بها لخادم MCP

لمنع ربط الأدوات غير المصرّح بها التابعة لجهات خارجية، يحدّد المشرفون قائمة سماح صريحة بنقاط نهاية خادم MCP المعتمَدة.

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

{
  "mcpServers": {
    "remote_servers": [
      {
        "id": "drive",
        "url": "https://drivemcp.googleapis.com/mcp/v1"
      },
      {
        "id": "docs",
        "url": "https://docsmcp.googleapis.com/mcp/v1"
      },
      {
        "id": "sheets",
        "url": "https://sheetsmcp.googleapis.com/mcp/v1"
      }
    ]
  }
}

5. انقر على حفظ.

الإدارة والتوزيع المركزي: تضمن قائمة السماح هذه احتفاظ مؤسستك بتحكّم دقيق في واجهات برمجة تطبيقات Workspace التي يمكن الوصول إليها في بيئات الوكلاء. يمكن للمشرفين إدارة إعدادات الأجهزة بشكل مركزي من خلال نشر ملف mcp_config.json مملوء مسبقًا على جميع أجهزة الهندسة باستخدام إدارة الأجهزة الجوّالة (MDM) أو نماذج Google Cloud Workstation أو نصوص برمجية لإعداد الأجهزة. ويؤدي ذلك إلى إزالة عبء الإعداد اليدوي على المطوّرين. لمزيد من التفاصيل، يُرجى الرجوع إلى مستندات إعدادات أدوات المطوّرين المستندة إلى الذكاء الاصطناعي.

3- ضبط واجهات برمجة التطبيقات الخلفية وبيانات اعتماد OAuth

بعد تفعيل إدارة المشرف، يمكنك ضبط مشروع Google Cloud لتوجيه الطلبات والتعامل مع مصادقة المستخدم.

مسؤولية المشرف: بصفتك مشرفًا، عليك ضبط شاشة طلب موافقة OAuth ومعرّف العميل مرة واحدة لمشروعك أو مؤسستك. بعد ذلك، يمكنك مشاركة معرّف العميل هذا مع فِرق الهندسة حتى يتمكّنوا من ضبط بيئات Antigravity المحلية بدون الحاجة إلى امتيازات مشرف Cloud Console.

تفعيل واجهات برمجة التطبيقات الخلفية وخدمات بروتوكول سياق النموذج

فعِّل واجهات Google Workspace API العادية وخدمات الخلفية MCP المقابلة لها.

1. فعِّل واجهات برمجة التطبيقات Google Drive و"مستندات Google" و"جداول بيانات Google" باتّباع الخطوات التالية:

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

2. فعِّل خدمات MCP في Google Drive و"مستندات Google" و"جداول بيانات Google" باتّباع الخطوات التالية:

تفعيل خدمات MCP

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

1. في Google Cloud Console، انتقِل إلى منصة Google للمصادقة > العلامة التجارية (أو واجهات برمجة التطبيقات والخدمات > شاشة طلب موافقة OAuth).
2. اضبط اسم التطبيق على WorkspaceMCPDemo.
3. اضبط عنوان البريد الإلكتروني المخصّص لدعم المستخدمين ومعلومات الاتصال الخاصة بالمطوّر، ثم انقر على حفظ ومتابعة.

إعداد الجمهور

1. ضمن الجمهور، اختَر نوع المستخدم داخلي. يقتصر ذلك على مصادقة مستخدمي Google Workspace داخل مؤسستك فقط.

إنشاء بيانات اعتماد عميل OAuth 2.0

1. انتقِل إلى منصة Google للمصادقة > العملاء (أو واجهات برمجة التطبيقات والخدمات > بيانات الاعتماد).
2. انقر على إنشاء عميل (أو إنشاء بيانات اعتماد > معرّف عميل OAuth).
3. اختَر تطبيق الويب لنوع التطبيق.
4. اضبط الاسم على WorkspaceMCPDemoClient.
5. ضمن معرّفات الموارد المنتظمة (URI) المُعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظم (URI) وأدخِل: https://antigravity.google/oauth-callback
6. انقر على إنشاء وسجِّل معرّف العميل والرمز السري للعميل.

4. ضبط إعدادات خدمات Antigravity MCP

للتحقّق من إعدادات المشرف، ولإعداد إرشادات الإعداد للمطوّرين، اضبط خدمات MCP المعتمَدة داخل Antigravity.

خيارات إعداد المطوّرين والإدارة المركزية: يمكنك توزيع الإعدادات أدناه على فِرق الهندسة (أو نشرها من خلال إدارة الإعدادات المركزية). على المطوّرين إضافة بيانات اعتماد OAuth الخاصة بمؤسستك إلى ملف mcp_config.json المحلي فقط. يمكنك أيضًا مشاركة برنامج Developer Codelab معهم للحصول على إرشادات كاملة حول بيئة التطوير المتكاملة وواجهة سطر الأوامر.

تسجيل خوادم MCP معتمَدة

يستخدم Antigravity ملف إعداد مركزيًا يقع في ~/.gemini/config/mcp_config.json.

1. افتح ~/.gemini/config/mcp_config.json في محرِّر النصوص المفضّل لديك (أو انتقِل إلى الإعدادات > التخصيصات في Antigravity وانقر على فتح إعدادات MCP).
2. املأ تعريفات الخدمات المدرَجة في القائمة المسموح بها (drive وdocs وsheets)، واستبدِل <YOUR_CLIENT_ID> و<YOUR_CLIENT_SECRET> ببيانات اعتماد OAuth:

{
  "mcpServers": {
    "drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "docs": {
      "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "sheets": {
      "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

3. احفظ الملف.
4. ارجِع إلى الإعدادات > التخصيصات في Antigravity وانقر على إعادة تحميل الصفحة. سيظهر Google Drive و"مستندات Google" و"جداول بيانات Google" ضمن خوادم MCP المثبَّتة النشطة.

5- المصادقة على مستندات Workspace المباشرة وإرسال طلبات البحث إليها

قبل أن يتمكّن الوكيل من إجراء مكالمات الأدوات، اربط جلسة المستخدم ببيانات اعتماد OAuth للتحقّق من الوظائف المتكاملة.

إكمال عملية المصافحة باستخدام OAuth

1. في لوحة عمليات التخصيص، انقر على المصادقة بجانب كل خدمة نشطة.
2. أكمِل عملية OAuth المستندة إلى المتصفّح باستخدام حسابك على Google Workspace Enterprise.
3. بعد المصادقة، يعرض كل خادم الأدوات المسجّلة فيه (مثل read_doc وget_spreadsheet وsearch_files).

تشغيل طلبات الوكيل المستندة إلى بيانات واقعية

تأكَّد من أنّ الوكيل يمكنه قراءة ملفات Workspace المباشرة وتلخيصها مباشرةً من واجهة المحادثة.

الطلب 1: استخراج بيانات منظَّمة من "جداول بيانات Google"

Read the 'Pricing Catalog' Sheet in my Google Drive and list our three most expensive items along with their specifications.

يستدعي الوكيل الدالة sheets.get_spreadsheet ويحلّل البيانات الجدولية ويعرض أهم العناصر مع الأرقام الدقيقة.

الطلب 2: إنشاء مواصفات معمارية من "مستندات Google"

Read the 'PRD: Online Storefront' Google Doc in Drive. Summarize the architectural requirements and highlight any missing security considerations.

يستدعي الوكيل docs.read_doc، ويسترجع أحدث مراجعة، ويقدّم ملخّصًا قابلاً للتنفيذ للميزات ونقاط المخاطر والاقتراحات.

6. التحقّق من حدود الأمان وإدارة المعلومات على مستوى المؤسسة

تتطلّب عمليات النشر على مستوى المؤسسة حدودًا أمنية يمكن التحقّق منها. اختبار كيفية فرض Gemini Enterprise وAntigravity لقيود السياسة

الاختبار 1: فرض القائمة المسموح بها الإدارية الصارمة

تأكَّد من عدم إمكانية ربط المطوّرين بخوادم MCP غير معتمَدة.

1. افتح ~/.gemini/config/mcp_config.json وأضِف تعريف خادم غير معتمَد (مثل People API):

{
  "mcpServers": {
    "people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

2. في الإعدادات > التخصيصات في Antigravity، انقر على إعادة التحميل.
3. تؤدي الجاذبية المضادة إلى إيقاف الاتصال. يعرض الخادم غير الموافق عليه الحالة Unauthorized / Blocked by Admin Policy ولا يمكن إعداده أو الاستعلام عنه.
4. أزِل الإدخال غير الموافق عليه من mcp_config.json وانقر على إعادة تحميل مرة أخرى.

الاختبار 2: تطابق هوية المستخدم وقائمة التحكّم بالوصول

يفرض دمج MCP في Workspace قوائم التحكّم بالوصول (ACL) العادية:

• عدم تصعيد الامتيازات: يعمل الوكيل بشكل صارم بموجب رمز الدخول عبر OAuth الخاص بالمستخدم الذي تمت مصادقته.
• فرض الوصول: إذا لم يكن لدى المطوّر إذن بعرض مستند Google أو مجلد Drive معيّن، سيتلقّى البرنامج HTTP 403 Forbidden خطأ ولن يتمكّن من فحص الملف.
• تسجيل التدقيق: يتم تسجيل جميع طلبات البيانات من واجهة برمجة التطبيقات التي ينشئها الوكيل ضمن هوية المستخدم الذي تمّت مصادقته في سجلات تدقيق Google Cloud.

7. تَنظيم

لتنظيف الموارد التي تم إنشاؤها في هذا الدرس التطبيقي حول الترميز، اتّبِع الخطوات التالية:

1. في Google Cloud Console، انتقِل إلى لوحة بيانات واجهات برمجة التطبيقات والخدمات.
2. اختَر كل خدمة MCP مفعَّلة (drivemcp.googleapis.com وdocsmcp.googleapis.com وsheetsmcp.googleapis.com) وانقر على إيقاف واجهة برمجة التطبيقات.
3. في منصة Google Auth > العملاء، احذف بيانات اعتماد عميل OAuth WorkspaceMCPDemoClient.
4. في Gemini Enterprise > الإعدادات > أدوات المطوّرين المستندة إلى الذكاء الاصطناعي، أوقِف قوائم السماح لخادم MCP إذا لم تعُد هناك حاجة إليها.

8. تهانينا

تهانينا! لقد أعددت وأثبتّ صحة الإدارة المركزية والقوائم المسموح بها ومصادقة OAuth المحدودة النطاق لخوادم Google Workspace MCP في Antigravity باستخدام Gemini Enterprise بنجاح.

المواضيع التي تناولتها

• تم تفعيل أدوات المطوّرين بالذكاء الاصطناعي وتحديد قوائم السماح لخادم MCP في Gemini Enterprise.
• تم تفعيل واجهات برمجة التطبيقات وخدمات MCP في Google Workspace في Google Cloud.
• تم إنشاء بيانات اعتماد تطبيق الويب الداخلي OAuth 2.0 ذات النطاق المحدود.
• تم التحقّق من استرداد البيانات الإيجابية وفرض السياسات السلبية في Antigravity.
• حدود الأمان التي تمنح أقل أذونات ممكنة وسجلّات التدقيق التي تم التحقّق من صحتها

الخطوات التالية: مشاركة المعلومات مع المطوّرين

بعد إعداد بيئة المؤسسة وتأمينها، شارِك دليل المطوّرين المرافق مع فِرق الهندسة:

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

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

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