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

1. مقدمة

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

google_workspace_mcp_antigravity_arch_2.png

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

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

المتطلبات

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

qr_code.png

2. قبل البدء

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

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

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

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

تفعيل خدمات MCP

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

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

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

  1. في Google Cloud Console، ابحث عن Google Chat API، ثم انقر على Google Chat API > إدارة > الإعدادات.

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

chat_app.png

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

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

يجب إعداد شاشة طلب الموافقة أولاً.

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

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

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

oauth_client.png

4. ضبط Antigravity

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

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

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

  1. افتحه في محرِّر النصوص الذي تفضّله.
  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 المميزة غير مركزية.

Antigravity 2.0

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

unauthed_mcp_servers_20.png

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

Antigravity IDE

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

open_user_settings_ide.png

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

unauthed_mcp_servers_ide.png

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

Antigravity CLI

  1. اكتب /mcp واضغط على enter.

unauthed_mcp_servers_cli.png

  1. لكل خادم MCP مُدرَج:
    1. اختَرها باستخدام مفتاحَي السهمين للأعلى وللأسفل، ثم اضغط على enter.
    2. اختَر مصادقة باستخدام مفتاحَي السهمَين لليمين ولليسار، ثم اضغط على Enter.
    cli_auth.png
    1. افتح عنوان URL المعروض في نافذة متصفح جديدة واتّبِع خطوات المصادقة.
    cli_auth_url.png
    1. بعد الانتهاء، انقر على النسخ إلى الحافظة.
    copy_auth_code.png
    1. ألصِق رمز التفويض الذي نسخته للتو في حقل النص المعروض في نافذة Terminal مع تشغيل Antigravity CLI، ثم اضغط على Enter.
    cli_paste_auth_code.png
    1. تظهر الآن الحالة تم التفويض بدلاً من مطلوب التفويض.
    cli_sign_out.png

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

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

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

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

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

ide_uni_test.png

Gmail

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

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

Google Drive

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

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

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

جرِّب البحث في مراجع Drive:

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

تقويم Google

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

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

Google Chat

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

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

People API

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

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

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

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

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

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

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

6. تَنظيم

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

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

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

7. تهانينا

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

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