توفّر Google Workspace خوادم بروتوكول سياق النموذج (MCP) عن بُعد تتيح لوكلاء الذكاء الاصطناعي التفاعل بأمان مع بيانات Google Workspace. من خلال ضبط خوادم Google Workspace MCP، يمكنك السماح لتطبيقات الذكاء الاصطناعي، مثل Google Antigravity وClaude، بتنفيذ إجراءات في تطبيقات Google Workspace، مثل Gmail وGoogle Drive و"مستندات Google" و"جداول بيانات Google" و"العروض التقديمية من Google" و"تقويم Google" وGoogle Chat. يحتوي كل منتج من منتجات Google Workspace على خادم MCP مخصّص.
توفّر خوادم بروتوكول سياق النموذج المُدار (MCP) من Google Workspace طريقة موحّدة لوكلاء الذكاء الاصطناعي من أجل:
- قراءة البيانات: البحث في الرسائل الإلكترونية واسترداد الملفات وإدراج أحداث التقويم
- اتخاذ الإجراءات: إنشاء مسودات للرسائل الإلكترونية وتحميل الملفات وجدولة الاجتماعات
- احترام الأمان: يمكنك الحصول على الأذونات وعناصر التحكّم في إدارة البيانات نفسها التي يملكها المستخدم.
المتطلبات الأساسية
مشروع Google Cloud لإنشاء مشروع، يُرجى الاطّلاع على مقالة إنشاء مشروع.
أحد برامج MCP، مثل Google Antigravity
لتنفيذ الأوامر الواردة في هذه الصفحة، عليك إعداد gcloud CLI في بيئة تطوير محلية باتّباع الخطوات التالية:
- ثبِّت Google Cloud CLI.
إذا سبق لك تثبيت gcloud CLI، تأكَّد من استخدام أحدث إصدار من خلال تنفيذ الأمر
gcloud components update. - في حال استخدام موفِّر هوية خارجي، سجِّل الدخول إلى gcloud CLI باستخدام هويتك الموحّدة. لمزيد من المعلومات، يُرجى الاطّلاع على تسجيل الدخول إلى gcloud CLI باستخدام هويتك الموحّدة.
- افتح gcloud CLI.
- ثبِّت Google Cloud CLI.
إذا سبق لك تثبيت gcloud CLI، تأكَّد من استخدام أحدث إصدار من خلال تنفيذ الأمر
ضبط خوادم MCP في Google Workspace
لاستخدام خوادم Google Workspace MCP، عليك تفعيلها في مشروعك على Google Cloud، ثم ضبط برنامج MCP للربط بها.
تفعيل واجهات برمجة التطبيقات
لاستخدام خوادم MCP في Google Workspace، يجب تفعيل واجهات برمجة التطبيقات التالية في مشروعك على Google Cloud:
- Gmail API
- Google Drive API
- Google Docs API
- Google Sheets API
- Google Slides API
- Google Calendar API
- Google Chat API
People API
CLI
gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com --project=PROJECT_ID
استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud.
وحدة التحكّم
فعِّل واجهات برمجة التطبيقات في Google Cloud Console:
تفعيل خدمات MCP
لتفعيل مكوّنات MCP لكل منتج من منتجات Google Workspace، يجب تفعيل الخدمات التالية في مشروعك على Google Cloud:
- Gmail MCP API
- Google Drive MCP API
- Google Docs MCP API
- Google Sheets MCP API
- Google Slides MCP API
- Google Calendar MCP API
- Google Chat MCP API
People MCP API
CLI
gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com --project=PROJECT_ID
استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud.
وحدة التحكّم
فعِّل خدمات MCP في Google Cloud Console:
ضبط إعدادات تطبيق Chat
لاستخدام خادم Google Chat MCP، عليك إعداد تطبيق Chat في مشروعك على Google Cloud.
في "وحدة تحكّم Google Cloud"، ابحث عن Google Chat API، ثم انقر على Google Chat API > إدارة > الإعدادات.
إعداد تطبيق Chat:
- في حقل اسم التطبيق، أدخِل
Chat MCP. - في حقل عنوان URL للصورة الرمزية، أدخِل
https://developers.google.com/chat/images/quickstart-app-avatar.png. - في الوصف، أدخِل
Chat MCP server. - ضمن الوظائف، أوقِف الميزات التفاعلية من خلال إيقاف تفعيل الميزات التفاعلية.
- ضمن السجلات، اختَر تسجيل الأخطاء في خدمة تسجيل البيانات.
- في حقل اسم التطبيق، أدخِل
انقر على حفظ.
لمزيد من المعلومات حول إنشاء تطبيق Chat، يُرجى الاطّلاع على مقالة اختيار بنية تطبيق Google Chat.
إعداد شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth
تستخدم خوادم MCP في Google Workspace بروتوكول OAuth 2.0 للمصادقة والتفويض. يجب إعداد شاشة طلب موافقة OAuth قبل إنشاء معرّف عميل OAuth.
في "وحدة تحكّم Google Cloud"، انتقِل إلى منصة Google للمصادقة > تحديد هوية العلامة التجارية.
إذا سبق لك إعداد منصة Google للمصادقة، يمكنك ضبط إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التالية في العلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك الرسالة لم يتم إعداد "منصة مصادقة Google" بعد، انقر على البدء:
- ضمن معلومات التطبيق، في اسم التطبيق، اكتب
Workspace MCP Servers. - في البريد الإلكتروني لدعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة Google المناسبة.
- انقر على التالي.
- ضمن الجمهور، اختَر داخلي. إذا لم تتمكّن من اختيار داخلي، اختَر خارجي.
- انقر على التالي.
- ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكنك تلقّي إشعارات فيه بشأن أي تغييرات تطرأ على مشروعك.
- انقر على التالي.
- ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، وإذا كنت توافق عليها، ضَع علامة في المربّع أوافق على "سياسة بيانات المستخدمين في خدمات Google API".
- انقر على متابعة.
- انقر على إنشاء.
- إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمين اختباريين:
- انقر على الجمهور.
- ضمن المستخدمون التجريبيون، انقر على إضافة مستخدمين.
- أدخِل عنوان بريدك الإلكتروني وأي مستخدمين آخرين معتمَدين للاختبار، ثم انقر على حفظ.
- ضمن معلومات التطبيق، في اسم التطبيق، اكتب
انقر على الوصول إلى البيانات > إضافة نطاقات أو إزالتها. يظهر لوحة تتضمّن قائمة بنطاقات كل واجهة برمجة تطبيقات فعّلتها في مشروعك على Google Cloud.
ضِمن إضافة النطاقات يدويًا، الصِق نطاقات خوادم MCP التي تريد استخدامها:
- Gmail:
https://www.googleapis.com/auth/gmail.readonlyhttps://www.googleapis.com/auth/gmail.compose
- Google Drive:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.file
- مستندات Google:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/documents.readonlyhttps://www.googleapis.com/auth/documents
- جداول بيانات Google:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/spreadsheets.readonlyhttps://www.googleapis.com/auth/spreadsheets
- العروض التقديمية من Google:
https://www.googleapis.com/auth/drive.readonlyhttps://www.googleapis.com/auth/drive.filehttps://www.googleapis.com/auth/presentations.readonlyhttps://www.googleapis.com/auth/presentations
- تقويم Google:
https://www.googleapis.com/auth/calendar.calendarlist.readonlyhttps://www.googleapis.com/auth/calendar.events.freebusyhttps://www.googleapis.com/auth/calendar.events.readonly
- Google Chat:
https://www.googleapis.com/auth/chat.spaces.readonlyhttps://www.googleapis.com/auth/chat.memberships.readonlyhttps://www.googleapis.com/auth/chat.messages.readonlyhttps://www.googleapis.com/auth/chat.messages.createhttps://www.googleapis.com/auth/chat.users.readstate.readonly
- People API:
https://www.googleapis.com/auth/directory.readonlyhttps://www.googleapis.com/auth/userinfo.profilehttps://www.googleapis.com/auth/contacts.readonly
- Gmail:
انقر على إضافة إلى الجدول.
انقر على تعديل.
بعد اختيار النطاقات التي يتطلّبها تطبيقك، انقر على حفظ في صفحة الوصول إلى البيانات.
إعداد برنامج MCP
لإضافة خادم MCP بعيد في Google Workspace إلى برنامج MCP، اتّبِع التعليمات الخاصة ببرنامجك.
Antigravity
لإضافة خوادم MCP البعيدة في Google Workspace إلى Antigravity،
أضِف إعدادات الخادم إلى ملف mcp_config.json. تتوافق هذه التعليمات مع Antigravity 2.0 وAntigravity IDE وAntigravity CLI.
أنشئ معرّف عميل وسر عميل OAuth 2.0:
في "وحدة تحكّم Google Cloud"، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.
اختَر تطبيق الويب كنوع التطبيق.
أدخل اسمًا.
في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أضِف
https://antigravity.google/oauth-callbackفي حقل معرّفات الموارد المنتظمة (URI).انقر على إنشاء وانسخ معرّف العميل والرمز السري للعميل.
افتح ملف الإعداد
~/.gemini/antigravity/mcp_config.jsonأو أنشئه.أضِف إعدادات
mcpServersإلىmcp_config.json:{ "mcpServers": { "gmail": { "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "drive": { "serverUrl": "https://drivemcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "docs": { "serverUrl": "https://docsmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "sheets": { "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "slides": { "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "calendar": { "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "chat": { "serverUrl": "https://chatmcp.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } }, "people": { "serverUrl": "https://people.googleapis.com/mcp/v1", "oauth": { "clientId": "OAUTH_CLIENT_ID", "clientSecret": "OAUTH_CLIENT_SECRET" } } } }غيِّر القيم في السلسلة على الشكل التالي:
OAUTH_CLIENT_ID: معرّف العميل الذي أنشأته.-
OAUTH_CLIENT_SECRET: سر العميل الذي أنشأته
وفِّر
mcp_config.json.مصادقة خوادم MCP يمكنك المصادقة باستخدام إعدادات واجهة المستخدم التصويرية أو واجهة سطر الأوامر:
بالنسبة إلى Antigravity IDE أو واجهة المستخدم الرسومية (Antigravity 2.0):
- افتح شاشة الإعدادات (على سبيل المثال، انقر على الإعدادات في أسفل يسار الشاشة أو افتح إعدادات مستخدم Antigravity).
- انتقِل إلى التخصيصات.
- ضمن خوادم MCP المثبَّتة، انقر على إعادة التحميل.
- بالنسبة إلى كل خادم مُدرَج (
gmailوdriveوdocsوsheetsوslidesوcalendarوchatوpeople)، انقر على مصادقة، وسجِّل الدخول إلى حساب Google، وانسخ رمز التفويض، والصقه في مربّع الحوار الخاص بالإدخال، ثم انقر على إرسال.
في Antigravity CLI:
ابدأ Antigravity CLI:
agyافتح لوحة إدارة MCP التفاعلية من خلال تنفيذ ما يلي:
/mcpمصادقة كل خادم MCP:
- استخدِم مفاتيح الأسهم لاختيار الخادم، وانتقِل إلى الإجراء مصادقة، ثم اضغط على Enter. أكمِل عملية تسجيل الدخول في المتصفح، وانسخ رمز التفويض، والصِقه في طلب المحطة الطرفية، ثم اضغط على Enter.
- كرِّر هذه الخطوات لكل خادم تم إعداده (
gmailوdriveوdocsوsheetsوslidesوcalendarوchatوpeople).
تأكَّد من إعداد الخوادم وتشغيلها بشكلٍ صحيح:
- بالنسبة إلى Antigravity IDE أو واجهة المستخدم الرسومية: يظهر زر تسجيل الخروج بجانب كل خادم ضمن التخصيصات > خوادم MCP المثبّتة.
- بالنسبة إلى واجهة سطر الأوامر Antigravity: افتح اللوحة
/mcpلعرض خوادم MCP التي تم ضبطها. تعرض الخوادم التي تم التحقّق منها ومصادقتها Authed بجانب أسمائها داخل لوحة واجهة المستخدم النصية التفاعلية. يمكنك اختيار أي خادم ضمن عرض لوحة البيانات لفحص حالته وإدراج جميع الأدوات المتاحة فيه.
أصبحت خوادم MCP البعيدة جاهزة للاستخدام في Antigravity.
Claude
لاستخدام خوادم MCP البعيدة في Google Workspace مع Claude.ai أو تطبيق Claude Desktop، يجب أن يكون لديك اشتراك في إحدى خطط Claude Enterprise أو Pro أو Max أو Team.
لإضافة خوادم MCP البعيدة في Google Workspace إلى Claude، عليك إعداد موصّل مخصّص باستخدام معرّف عميل OAuth وسر.
أنشئ معرّف عميل وسر عميل OAuth 2.0:
في "وحدة تحكّم Google Cloud"، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.
اختَر تطبيق الويب كنوع التطبيق.
أدخل اسمًا.
في قسم معرّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرّف الموارد المنتظمة (URI)، ثم أضِف
https://claude.ai/api/mcp/auth_callbackفي حقل معرّفات الموارد المنتظمة (URI).انقر على إنشاء وانسخ معرّف العميل والرمز السري للعميل.
ضبط إعدادات خادم MCP في Claude:
- في Claude.ai أو تطبيق Claude على الكمبيوتر، انتقِل إلى الإعدادات (أو إعدادات المشرف) > الموصِّلات.
- انقر على إضافة موصِّل مخصّص.
- أدخِل تفاصيل الربط لمنتج Google Workspace الذي تريد إضافته:
- اسم الخادم: اسم الخادم، مثل
Gmail. - عنوان URL لخادم MCP عن بُعد: عنوان URL لمنتج Google Workspace، مثل أحد ما يلي:
- Gmail:
https://gmailmcp.googleapis.com/mcp/v1 - Google Drive:
https://drivemcp.googleapis.com/mcp/v1 - مستندات Google:
https://docsmcp.googleapis.com/mcp/v1 - جداول بيانات Google:
https://sheetsmcp.googleapis.com/mcp/v1 - العروض التقديمية من Google:
https://slidesmcp.googleapis.com/mcp/v1 - تقويم Google:
https://calendarmcp.googleapis.com/mcp/v1 - Google Chat:
https://chatmcp.googleapis.com/mcp/v1 - People API:
https://people.googleapis.com/mcp/v1
- Gmail:
- اسم الخادم: اسم الخادم، مثل
- في الإعدادات المتقدّمة، أدخِل معرّف عميل OAuth وسر عميل OAuth.
- انقر على إضافة.
- كرِّر هذه الخطوات لكل منتج من منتجات Google Workspace تريد إضافته.
غير ذلك
تتضمّن العديد من تطبيقات الذكاء الاصطناعي طرقًا للاتصال بخادم MCP بعيد. عليك عادةً إدخال تفاصيل حول الخادم، مثل اسمه ونقاط النهاية وبروتوكول النقل وطريقة المصادقة. بالنسبة إلى خوادم MCP البعيدة في Google Workspace، أدخِل ما يلي:
اسم الخادم:
googleworkspaceالخوادم: لكل منتج من منتجات Google Workspace عنوان URL خاص بالخادم:
- Gmail:
https://gmailmcp.googleapis.com/mcp/v1 - Google Drive:
https://drivemcp.googleapis.com/mcp/v1 - مستندات Google:
https://docsmcp.googleapis.com/mcp/v1 - جداول بيانات Google:
https://sheetsmcp.googleapis.com/mcp/v1 - العروض التقديمية من Google:
https://slidesmcp.googleapis.com/mcp/v1 - تقويم Google:
https://calendarmcp.googleapis.com/mcp/v1 - Google Chat:
https://chatmcp.googleapis.com/mcp/v1 - People API:
https://people.googleapis.com/mcp/v1
- Gmail:
النقل: HTTP
المصادقة: يستخدم خادم MCP البعيد في Google Workspace بروتوكول OAuth 2.0. للحصول على التفاصيل، يُرجى الاطّلاع على التعرّف على المصادقة والتفويض.
لمزيد من التفاصيل حول ربط أنواع مختلفة من العملاء، يُرجى الاطّلاع على ضبط MCP في تطبيق يعمل بالذكاء الاصطناعي.
اختبار خوادم MCP من Google Workspace
بعد إعداد برنامج MCP، يمكنك التحقّق من الاتصال من خلال تنفيذ بعض الطلبات التجريبية.
جرِّب طرح الأسئلة التالية على عميل MCP:
"ماذا قالت "أرييل" في رسالتها الإلكترونية الأخيرة حول خطة التسويق؟"
تستخدم الفلاتر في الجهاز
gmail.search_threadsللبحث عن رسائل إلكترونية من "أرييل"، وتسترد محتوى أحدث سلسلة محادثات باستخدامgmail.get_thread، ثم تلخّصها لك."أريد كتابة مسودة رسالة إلكترونية إلى ariel@example.com تفيد بموافقتي على خطة التسويق".
يستخدم العميل
gmail.create_draftلإنشاء رسالة إلكترونية في مجلد المسودات، ما يتيح لك مراجعتها وإرسالها من Gmail."لخِّص الملف "خطة التسويق".
يطلب العميل
drive.search_filesتحديد موقع "خطة التسويق"، ثم يستخدمdrive.read_file_contentلاسترداد محتواها وتلخيصه."أريد الاطّلاع على المحتوى المنظَّم لمستند Google "ملاحظات الاجتماع".
يستردّ العميل بنية المستند ومحتواه باستخدام
docs.read_doc."اقرأ ورقة Sheet1 من جدول بيانات Google "المبيعات الفصلية".
يجلب العميل قيم الشبكة باستخدام
sheets.get_values."اعرض لي التخطيط اللفظي للعرض التقديمي "نظرة عامة على المنتج" في "العروض التقديمية من Google".
يجلب العميل بُنى التنسيق المرئي للعرض التقديمي باستخدام
slides.read_presentation."متى يحين موعد اجتماعي القادم مع "أرييل"؟
يراجع العميل جدولك الزمني باستخدام
calendar.list_eventsوالتفاصيل المتعلّقة باجتماعك القادم مع "أرييل"."ما هو اسمي وفقًا لملفي الشخصي على Google؟"
يستخدم العميل
people.get_user_profileلاسترداد معلومات ملفك الشخصي على Google Workspace.
إذا تم تنفيذ الأدوات بنجاح وتلقّيت ردودًا ذات صلة، يعني ذلك أنّه تم ضبط خوادم Google Workspace MCP بشكل صحيح.
تحديد المشاكل وحلّها
في حال واجهت مشاكل في الاتصال بخوادم MCP، يمكنك التحقّق من وجود أخطاء في سجلات OAuth. اطلب من المشرف التحقّق من أحداث سجلّ OAuth في أداة التحقيق الأمني.
المنتجات التي تشملها الخدمة
تتوافق منتجات Google Workspace التالية مع خوادم Google Workspace MCP وتوفّر الأدوات التالية:
- Gmail
- Google Drive
- مستندات Google
- جداول بيانات Google
- العروض التقديمية من Google
- تقويم Google
- Google Chat
- People API
اعتبار مهم بشأن الأمان: حقن غير مباشر للطلبات
عندما تعرّض نموذجًا لغويًا لبيانات غير موثوق بها، هناك خطر من حدوث هجوم حقن طلب غير مباشر. بما أنّ عملاء MCP، مثل Google Antigravity، يمكنهم الوصول إلى أدوات وواجهات برمجة تطبيقات فعّالة من خلال خوادم Google Workspace MCP، يمكنهم قراءة البيانات وتعديلها وحذفها في حسابك على Google.
لتقليل هذه المخاطر، اتّبِع أفضل الممارسات التالية:
- استخدام الأدوات الموثوقة فقط: لا تربط أبدًا خوادم MCP في Google Workspace بتطبيقات غير موثوق بها أو لم يتم التحقّق منها.
- توخَّ الحذر بشأن المدخلات غير الموثوق بها. تجنَّب الطلب من برنامج البريد الإلكتروني المستند إلى بروتوكول IMAP معالجة الرسائل الإلكترونية أو المستندات أو الموارد الأخرى من مصادر لم يتم التحقّق منها. قد تحتوي هذه المدخلات على تعليمات مخفية يمكنها السيطرة على جلستك، ما يسمح للمهاجم بتعديل بياناتك أو سرقتها أو حذفها.
- راجِع جميع الإجراءات. ننصحك دائمًا بمراجعة الإجراءات التي يتّخذها عميل الذكاء الاصطناعي نيابةً عنك بعناية للتأكّد من أنّها صحيحة وتتوافق مع نواياك.