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

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

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

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

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

  • يجب أن يكون لديك مشروع على Google Cloud. لإنشاء مشروع، يُرجى الاطّلاع على مقالة إنشاء مشروع.

  • يجب أن يكون لديك عميل MCP، مثل Google Antigravity.

  • لتنفيذ الأوامر في هذه الصفحة، عليك إعداد gcloud CLI في بيئة تطوير محلية باتّباع الخطوات التالية:

    1. ثبِّت Google Cloud CLI. إذا سبق لك تثبيت gcloud CLI، تأكَّد من استخدام أحدث إصدار من خلال تنفيذ الأمر gcloud components update.
    2. إذا كنت تستخدم موفِّر هوية (IdP) خارجيًا، سجِّل الدخول إلى gcloud CLI باستخدام هويتك الموحّدة. لمزيد من المعلومات، يُرجى الاطّلاع على مقالة تسجيل الدخول إلى gcloud CLI باستخدام هويتك الموحّدة.
    3. افتح gcloud CLI.

ضبط خادم 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. ضمن السجلات ، اختَر تسجيل الأخطاء في Cloud Logging.

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

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

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

  1. في Google Cloud Console، انتقِل إلى Google Auth Platform > العلامة التجارية.

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

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

    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.readonly

    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 Console، انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل

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

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

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

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

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

  2. افتح ملف الإعداد ~/.gemini/antigravity/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. يمكنك إجراء المصادقة باستخدام إعدادات واجهة المستخدم الرسومية أو واجهة سطر الأوامر (CLI):

    • بالنسبة إلى 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. أكمِل عملية تسجيل الدخول في متصفّحك، وانسخ رمز التفويض، والصِقه في طلب المحطة الطرفية، واضغط على Enter.

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

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

أصبح خادم 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 Console، انتقِل إلى Google Auth Platform > العملاء > إنشاء عميل

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

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

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

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

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

  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. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة لمحة عن المصادقة والتفويض.

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

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

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

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

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

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

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

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

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

مرجع الأداة

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

  • search_conversations
  • list_messages
  • search_messages
  • send_message

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

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

للحدّ من هذه المخاطر، اتّبِع أفضل الممارسات التالية:

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