ضبط إعدادات خادم MCP الخاص بالمحادثة

يوفّر Google Chat خادمًا عن بُعد لـ بروتوكول سياق النموذج (MCP) يتيح لوكلاء الذكاء الاصطناعي التفاعل بأمان مع بيانات Google Chat. من خلال ضبط إعدادات خادم MCP في Google Chat، يمكنك تفعيل تطبيقات الذكاء الاصطناعي مثل Google Antigravity وClaude لتنفيذ الإجراءات في Google Chat.

يوفّر خادم MCP في Google Chat طريقة موحّدة لوكلاء الذكاء الاصطناعي من أجل:

  • قراءة البيانات: يمكنك عرض المحادثات والبحث فيها وقراءة الرسائل.
  • مراعاة الأمان: يكتسب Gemini نفس الأذونات وعناصر التحكّم في إدارة البيانات التي يملكها المستخدم.

المتطلبات الأساسية

إعداد خادم MCP في Google Chat

لاستخدام خادم MCP في Google Chat، يجب تفعيله في مشروعك على Google Cloud، ثم ضبط عميل MCP للاتصال به.

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

لاستخدام خادم MCP في Google Chat، يجب تفعيل واجهات برمجة التطبيقات التالية في مشروعك على Google Cloud:

  • Google Chat API

CLI

gcloud services enable chat.googleapis.com --project=PROJECT_ID

استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud.

وحدة التحكّم

فعِّل واجهات برمجة التطبيقات في Google Cloud Console:

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

تفعيل خدمات MCP

لتفعيل مكوّنات MCP في Google Chat، يجب تفعيل الخدمة التالية في مشروعك على Google Cloud:

  • Google Chat MCP API

CLI

gcloud services enable chatmcp.googleapis.com --project=PROJECT_ID

استبدِل PROJECT_ID برقم تعريف مشروعك على Google Cloud.

وحدة التحكّم

فعِّل خدمات MCP في Google Cloud Console:

تفعيل خدمات MCP

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

لاستخدام خادم MCP في Google Chat لإجراء عمليات للقراءة فقط، مثل البحث عن المحادثات، يجب تفعيل واجهة برمجة التطبيقات وإنشاء عميل OAuth. لا يلزم توفّر تطبيق Chat تم ضبطه.

لتنفيذ عمليات الكتابة، مثل إرسال الرسائل، عليك ضبط تطبيق Chat في مشروعك على Google Cloud.

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

    الانتقال إلى Google Chat API

  2. إعداد تطبيق Chat:

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

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

لمزيد من المعلومات حول إنشاء تطبيق في Chat، يُرجى الاطّلاع على اختيار بنية تطبيق في Google Chat.

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

  1. في وحدة تحكّم Google Cloud، انتقِل إلى Google Auth Platform > الهوية البصرية.

    الانتقال إلى "هوية العلامة التجارية"

  2. إذا سبق لك ضبط Google Auth Platform، يمكنك ضبط إعدادات شاشة طلب الموافقة المتعلّقة ببروتوكول OAuth التالية في الهوية البصرية للعلامة التجارية والجمهور والوصول إلى البيانات. إذا ظهرت لك رسالة تفيد بأنّ منصة Google Auth لم يتم إعدادها بعد، انقر على البدء:

    1. ضمن معلومات التطبيق، في اسم التطبيق، اكتب Chat MCP Server.
    2. في حقل البريد الإلكتروني لدعم المستخدمين، اختَر عنوان بريدك الإلكتروني أو مجموعة Google المناسبة.
    3. انقر على التالي.
    4. ضمن الجمهور، اختَر داخلي. إذا لم تتمكّن من اختيار داخلي، اختَر خارجي.
    5. انقر على التالي.
    6. ضمن معلومات الاتصال، أدخِل عنوان بريد إلكتروني يمكن من خلاله إعلامك بأي تغييرات تطرأ على مشروعك.
    7. انقر على التالي.
    8. ضمن إنهاء، راجِع سياسة بيانات المستخدمين في خدمات Google API، وإذا وافقت عليها، اختَر أوافق على سياسة بيانات المستخدمين في خدمات Google API.
    9. انقر على متابعة.
    10. انقر على إنشاء.
    11. إذا اخترت خارجي لنوع المستخدم، أضِف مستخدمين تجريبيين:
      1. انقر على الجمهور.
      2. ضمن المستخدمون التجريبيون، انقر على إضافة مستخدمين.
      3. أدخِل عنوان بريدك الإلكتروني وأي مستخدمين اختباريين معتمَدين آخرين، ثم انقر على حفظ.

  3. انقر على الوصول إلى البيانات > إضافة نطاقات أو إزالتها. ستظهر لوحة تتضمّن قائمة بالنطاقات لكل واجهة برمجة تطبيقات تم تفعيلها في مشروعك على Google Cloud.

    1. ضمن إضافة النطاقات يدويًا، الصِق نطاقات خادم MCP في 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
      • https://www.googleapis.com/auth/chat.users.spacesettings

    2. انقر على إضافة إلى الجدول.

    3. انقر على تعديل.

    4. بعد اختيار النطاقات التي يتطلبها تطبيقك، انقر على حفظ في صفحة الوصول إلى البيانات.

ضبط عميل MCP

لإضافة خادم MCP عن بُعد في Google Chat إلى عميل MCP، يُرجى اتّباع التعليمات الخاصة بالعميل.

Antigravity

لإضافة خادم MCP البعيد في Google Chat إلى Antigravity، يُرجى إضافة إعدادات الخادم إلى ملف mcp_config.json. تنطبق هذه التعليمات على Antigravity 2.0 وAntigravity IDE وAntigravity CLI.

  1. أنشئ معرّف عميل وسر عميل لبروتوكول OAuth 2.0:

    1. في وحدة تحكّم Google Cloud، انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل

      الانتقال إلى "إنشاء عميل"

    2. اختَر تطبيق ويب كنوع التطبيق.

    3. أدخل اسمًا.

    4. في قسم معرِّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرِّف موارد منتظم (URI)، ثم أضِف https://antigravity.google/oauth-callback في حقل معرِّفات الموارد المنتظمة (URI).

    5. اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي.

    6. انقر على إنشاء وانسخ معرّف العميل وسر العميل.

  2. افتح ملف الإعداد ~/.gemini/config/mcp_config.json أو أنشئه.

  3. أضِف إعدادات mcpServers إلى mcp_config.json:

    {
  "mcpServers": {
    "chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    غيِّر القيم في السلسلة على الشكل التالي:

    • ‫OAUTH_CLIENT_ID: معرّف العميل الذي أنشأته
    • ‫OAUTH_CLIENT_SECRET: سر العميل الذي أنشأته

  4. وفِّر ‎mcp_config.json.

  5. مصادقة خادم MCP يمكنك المصادقة باستخدام إعدادات واجهة المستخدم الرسومية أو واجهة سطر الأوامر:

    • بالنسبة إلى Antigravity IDE أو واجهة المستخدم الرسومية (Antigravity 2.0):

      1. افتح شاشة الإعدادات (مثلاً، انقر على الإعدادات في أسفل يمين الصفحة أو افتح إعدادات مستخدم Antigravity).
      2. انتقِل إلى التخصيصات.
      3. ضمن خوادم MCP المثبّتة، انقر على إعادة تحميل.
      4. ابحث عن chat في القائمة، وانقر على مصادقة، وسجِّل الدخول إلى حساب Google، وانسخ رمز التفويض، وألصِقه في مربّع حوار الإدخال، ثم انقر على إرسال.

    • في Antigravity CLI:

      1. ابدأ Antigravity CLI:

        agy

      2. افتح لوحة إدارة MCP التفاعلية من خلال تشغيل:

        /mcp

      3. استخدِم مفاتيح الأسهم لاختيار chat، ثم انتقِل إلى الإجراء مصادقة واضغط على مفتاح Enter. أكمِل عملية تسجيل الدخول في المتصفّح، وانسخ رمز التفويض، والصقه في طلب Terminal، ثم اضغط على مفتاح Enter.

  6. تأكَّد من أنّ الخادم تم ضبطه بشكل صحيح وأنّه قيد التشغيل:

    • في Antigravity IDE أو واجهة المستخدم الرسومية: يظهر زر تسجيل الخروج بجانب الخادم ضمن التخصيصات > خوادم MCP المثبَّتة.
    • بالنسبة إلى Antigravity CLI: افتح لوحة "/mcp" لعرض خوادم MCP التي تم ضبطها. تعرض الخوادم التي تم التحقّق منها والمصادقة عليها تمت المصادقة بجانب أسمائها داخل لوحة TUI التفاعلية. يمكنك اختيار أي خادم ضمن عرض لوحة البيانات لفحص حالته وعرض جميع الأدوات المتاحة له.

أصبح خادم MCP البعيد جاهزًا للاستخدام في Antigravity.

Claude

لاستخدام خادم MCP عن بُعد في Google Chat مع Claude.ai أو Claude Desktop، يجب أن تكون مشتركًا في خطة Claude Enterprise أو Pro أو Max أو Team.

لإضافة خادم MCP عن بُعد في Google Chat إلى Claude، عليك إعداد موصل مخصّص باستخدام معرّف عميل OAuth وسر العميل.

  1. أنشئ معرّف عميل وسر عميل لبروتوكول OAuth 2.0:

    1. في وحدة تحكّم Google Cloud، انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل

      الانتقال إلى "إنشاء عميل"

    2. اختَر تطبيق ويب كنوع التطبيق.

    3. أدخل اسمًا.

    4. في قسم معرِّفات الموارد المنتظمة (URI) المعتمَدة لإعادة التوجيه، انقر على + إضافة معرِّف موارد منتظم (URI)، ثم أضِف https://claude.ai/api/mcp/auth_callback في حقل معرِّفات الموارد المنتظمة (URI).

    5. اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي.

    6. انقر على إنشاء وانسخ معرّف العميل وسر العميل.

  2. اضبط إعدادات خادم MCP في Claude:

    1. في Claude.ai أو Claude Desktop، انتقِل إلى الإعدادات (أو إعدادات المشرف) > الموصِّلات.
    2. انقر على إضافة موصِّل مخصّص.
    3. أدخِل تفاصيل الاتصال لمنتج Google Chat:
      • اسم الخادم: Google Chat
      • عنوان URL لخادم MCP عن بُعد: https://chatmcp.googleapis.com/mcp/v1
    4. في الإعدادات المتقدّمة، أدخِل معرّف عميل OAuth وسر عميل OAuth.
    5. انقر على إضافة.

غير ذلك

تتوفّر في العديد من تطبيقات الذكاء الاصطناعي طرق للاتصال بخادم MCP عن بُعد. تحتاج عادةً إلى إدخال تفاصيل عن الخادم، مثل اسمه ونقاط النهاية وبروتوكول النقل وطريقة المصادقة. بالنسبة إلى خادم MCP البعيد في Google Chat، أدخِل ما يلي:

  • اسم الخادم: chat

  • عنوان URL للخادم: https://chatmcp.googleapis.com/mcp/v1

  • النقل: بروتوكول HTTP قابل للبث

  • المصادقة: يستخدم خادم MCP عن بُعد في Google Chat بروتوكول OAuth 2.0. عند إنشاء عميل OAuth 2.0، اختَر استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي. لمعرفة التفاصيل، يُرجى الاطّلاع على التعرّف على المصادقة والتفويض.

لمزيد من التفاصيل حول ربط أنواع مختلفة من البرامج، يُرجى الاطّلاع على ضبط إعدادات بروتوكول MCP في تطبيق مستنِد إلى الذكاء الاصطناعي.

اختبار خادم MCP في Google Chat

بعد ضبط عميل MCP، يمكنك التحقّق من الاتصال من خلال تشغيل بعض الطلبات الاختبارية.

جرِّب طرح الأسئلة التالية على عميل MCP:

  • "ما هي آخر رسالة في مساحة المشروع X؟"

    يعثر العميل على المساحة باستخدام search_conversations ثم يستردّ الرسائل باستخدام list_messages.

إذا تم تنفيذ الأدوات بنجاح وتلقّيت ردودًا ذات صلة، يعني ذلك أنّ خادم MCP في Google Chat تم ضبطه بشكل صحيح.

تحديد المشاكل وحلّها

إذا واجهت مشاكل في الاتصال بخادم MCP، يمكنك التحقّق من الأخطاء في سجلّات OAuth. اطلب من المشرف مراجعة أحداث سجلّ OAuth في أداة التحقيق الأمني.

إذا تم رفض طلباتك إلى خادم MCP، تأكَّد من أنّ عميل OAuth 2.0 لديه الخيار استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي محدّدًا في Google Auth Platform > العملاء. إذا لم تتمكّن من تغيير هذا الإعداد في عميل OAuth حالي، أنشِئ عميل OAuth جديدًا مع اختيار استخدام هذا العميل لوكيل مستنِد إلى الذكاء الاصطناعي وعدِّل تطبيقك لاستخدامه. إذا كان عميل OAuth الحالي يُستخدم لكل من ميزات وكيل الذكاء الاصطناعي والميزات غير المرتبطة بالوكيل، يجب إنشاء عميل OAuth منفصل لوكيل الذكاء الاصطناعي والاحتفاظ بالعميل الحالي للميزات غير المرتبطة بالوكيل. للحصول على التعليمات، يُرجى الاطّلاع على ضبط عميل MCP وإدارة عملاء OAuth.

إذا طُلب منك تسجيل الدخول مرة أخرى كل ساعة تقريبًا، يعني ذلك أنّ عميل MCP لا يتلقّى رمزًا مميزًا لإعادة التحميل. يُصدر خادم التفويض في Google الرموز المميزة لإعادة التحميل فقط عندما يتضمّن طلب التفويض access_type=offline، لأنّ طلب نطاق offline_access OIDC وحده لا يكفي. إذا كان عميل MCP يتيح استخدام مَعلمات التفويض المخصّصة، أضِف access_type=offline إلى طلب التفويض. للحصول على رمز مميز جديد لإعادة التحميل لمستخدم سبق أن منح الإذن بالوصول، أضِف أيضًا prompt=consent.

مرجع الأداة

تتوفّر الأدوات التالية لخادم MCP في Google Chat:

  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
  • get_notification_settings
  • update_notification_settings

اعتبارات أمان مهمة: حقن الطلبات غير المباشر

عندما يتعرّض نموذج لغوي لبيانات غير موثوق بها، يكون هناك خطر حدوث هجمة بحقن الطلبات غير المباشرة. بما أنّ مضيفي MCP، مثل Google Antigravity، يمكنهم الوصول إلى أدوات وواجهات برمجة تطبيقات فعّالة من خلال خادم MCP في Google Chat، يمكنهم قراءة البيانات وتعديلها وحذفها في حسابك على Google.

للحدّ من هذه المخاطر، يجب فحص الطلبات والردود بحثًا عن محتوى ضارّ أو هجمات بحقن الطلبات. يمكنك استخدام Model Armor المقدَّم من Google أو استخدام الحلّ الخاص بك إذا وثّقته ليتمكّن المستخدمون من قبول هذه المخاطر. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة ضبط إعدادات الأمان لخوادم MCP في Google Workspace.

اتّبِع أفضل الممارسات التالية:

  • استخدِم الأدوات الموثوقة فقط. لا تربط خادم MCP في Google Chat بتطبيقات غير موثوقة أو غير معتمَدة.
  • يُرجى توخّي الحذر عند التعامل مع المدخلات غير الموثوق بها. تجنَّب الطلب من عميل MCP معالجة الرسائل أو الموارد الأخرى من مصادر غير موثوقة. قد تحتوي هذه المدخلات على تعليمات مخفية يمكنها الاستيلاء على جلستك، مما يسمح للمهاجم بتعديل بياناتك أو سرقتها أو حذفها.
  • راجِع جميع الإجراءات. يُرجى دائمًا مراجعة الإجراءات التي يتّخذها عميل الذكاء الاصطناعي نيابةً عنك بعناية للتأكّد من أنّها صحيحة وتتوافق مع نواياك.