ضبط إعدادات خادم 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. في حال استخدام موفِّر هوية خارجي، سجِّل الدخول إلى 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

لاستخدام خادم Google Chat MCP، عليك إعداد تطبيق Chat في مشروعك على Google Cloud.

  1. في "وحدة تحكّم Google Cloud"، ابحث عن 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. ضمن السجلات، اختَر تسجيل الأخطاء في خدمة تسجيل البيانات.

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

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

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

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

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

  2. إذا سبق لك إعداد منصّة Google للمصادقة، يمكنك إعداد الإعدادات التالية في "شاشة طلب الموافقة المتعلّقة ببروتوكول 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.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"، انتقِل إلى منصة Google للمصادقة > العملاء > إنشاء عميل.

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

    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 يمكنك المصادقة باستخدام إعدادات واجهة المستخدم التصويرية أو واجهة سطر الأوامر:

    • بالنسبة إلى 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 التي تم إعدادها. تعرض الخوادم التي تم التحقّق منها ومصادقتها الحالة تمت المصادقة بجانب أسمائها داخل لوحة 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 للمصادقة > العملاء > إنشاء عميل.

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

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

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

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

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

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

    1. في Claude.ai أو تطبيق Claude على الكمبيوتر، انتقِل إلى الإعدادات (أو إعدادات المشرف) > الموصِّلات.
    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:

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

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

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

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

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

مرجع الأداة

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

  • search_conversations
  • list_messages
  • search_messages
  • send_message

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

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

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

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