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

1- مقدمة

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

بنية MCP في Google Workspace

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

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

المتطلبات

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

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

qr_code.png

2. قبل البدء

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

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

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

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

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

تفعيل خدمات MCP

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

ضبط تطبيق Chat

لاستخدام خادم Google Chat MCP، يجب ضبط تطبيق 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 MCP بروتوكول OAuth 2.0 للمصادقة الآمنة. يجب ضبط شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth وإنشاء عميل لتطبيق الويب.

تستخدم خوادم Google Workspace MCP بروتوكول 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.

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

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

open_mcp_servers.png

  1. انقر على إدارة خوادم MCP ، ثم على عرض الإعدادات الأولية.

manage_mcp_servers.png

  1. عدِّل الملف الذي تم فتحه حديثًا mcp_config.json باستخدام إعدادات خادم MCP المخصّصة التالية. قبل إجراء ذلك، استبدِل العنصرَين النائبَين <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. ارجع إلى إدارة خوادم MCP ، ثم انقر على إعادة التحميل.

configured_mcp_servers.png

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

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

open_user_settings.png

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

customizations.png

  1. لكل خادم مُدرَج ضِمن خوادم MCP المثبَّتة:
    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]"."

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

تظهر القوة الحقيقية لبروتوكول 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. تهانينا

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

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