خوادم MCP من Google Workspace في Google Antigravity

1- مقدمة

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

بنية MCP في Google Workspace

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

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

المتطلبات

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

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

qr_code.png

‫2. قبل البدء

إنشاء مشروع على السحابة الإلكترونية أو اختياره

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

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

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

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

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

بعد ذلك، فعِّل خدمات بروتوكول سياق النموذج المخصّصة للمنتجات.

ضبط تطبيق Chat

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

chat_app.png

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

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

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

  1. في Google Cloud Console، انتقِل إلى 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_consent_screen.png

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

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

oauth_client.png

4. ضبط Antigravity

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

إضافة خوادم بروتوكول سياق النموذج المخصّصة

  1. افتح خوادم بروتوكول سياق النموذج من خلال القائمة المنسدلة ... في أعلى لوحة الوكيل في المحرّر.

open_mcp_servers.png

  1. انقر على إدارة خوادم بروتوكول سياق النموذج ، ثم على عرض الإعدادات الأولية.

manage_mcp_servers.png

  1. عدِّل الملف الذي تم فتحه حديثًا mcp_config.json باستخدام إعدادات خادم بروتوكول سياق النموذج المخصّصة التالية. قبل إجراء ذلك، استبدِل العنصرَين النائبَين <YOUR_CLIENT_ID> و<YOUR_CLIENT_SECRET> بمعرّف عميل OAuth والسرّ اللذين أنشأتهما في الخطوات السابقة:
{
  "mcpServers": {
    "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-drive": {
      "serverUrl": "https://drivemcp.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-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

mcp_config.png

  1. ارجع إلى إدارة خوادم بروتوكول سياق النموذج ، ثم انقر على إعادة تحميل.

configured_mcp_servers.png

مصادقة خوادم بروتوكول سياق النموذج المخصّصة

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

open_user_settings.png

  1. انتقِل إلى التخصيصات.

customizations.png

  1. لكل خادم مُدرَج ضِمن خوادم بروتوكول سياق النموذج المثبَّتة:
    1. انقر على مصادقة.

installed_servers.png

  1. اتّبِع خطوات عملية المصادقة في نافذة المتصفح الجديدة التي تفتح.
  2. بعد الانتهاء، انقر على النسخ إلى الحافظة.

copy_auth_code.png

  1. أغلِق نافذة المتصفح.
  2. الصِق رمز التفويض الذي نسخته للتو في حقل النص الذي يظهر في إعدادات Antigravity.
  3. انقر على إرسال.

mcp_servers_authenticated.png

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

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

تقويم Google

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

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

test_prompt.png

Google Chat

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

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

Google Drive

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

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

Gmail

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

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

‫People API

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

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

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

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

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

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

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

6. تَنظيم

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

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

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

7. تهانينا

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

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