ضبط إعدادات خادم MCP الخاص بـ "تقويم Google"

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

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

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

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

  • يجب أن يكون لديك مشروع على 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"

لاستخدام خادم بروتوكول سياق النموذج (MCP) في التقويم، عليك تفعيله في مشروعك على السحابة الإلكترونية، ثم إعداد عميل بروتوكول سياق النموذج (MCP) للاتصال به.

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

لاستخدام خادم بروتوكول سياق النموذج (MCP) في التقويم، عليك تفعيل واجهة برمجة التطبيقات التالية في مشروعك على السحابة الإلكترونية:

  • Google Calendar API

CLI

gcloud services enable calendar-json.googleapis.com --project=PROJECT_ID

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

وحدة التحكّم

فعِّل واجهات برمجة التطبيقات في وحدة التحكّم:

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

تفعيل خدمات MCP

لتفعيل مكوّنات بروتوكول سياق النموذج (MCP) في التقويم، عليك تفعيل الخدمة التالية في مشروعك على السحابة الإلكترونية:

  • Calendar MCP API

CLI

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

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

وحدة التحكّم

فعِّل خدمات MCP في وحدة التحكّم:

تفعيل خدمات MCP

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

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

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

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

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

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

    1. ضمن إضافة نطاقات يدويًا، ألصِق نطاقات خادم MCP في "تقويم 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

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

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

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

إعداد عميل MCP

لإضافة خادم MCP عن بُعد في "تقويم Google" إلى عميل MCP، اتّبِع التعليمات الخاصة بعميلك.

Antigravity

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

  1. أنشِئ معرّف عميل OAuth 2.0 وسر العميل:

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

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

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

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

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

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

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

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

    {
  "mcpServers": {
    "calendar": {
      "serverUrl": "https://calendarmcp.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. ابحث عن calendar في القائمة، وانقر على المصادقة، سجِّل الدخول إلى حساب Google، وانسخ رمز التفويض، وألصِقه في مربّع حوار الإدخال، وانقر على إرسال.

    • بالنسبة إلى Antigravity CLI:

      1. ابدأ Antigravity CLI:

        agy

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

        /mcp

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

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

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

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

Claude

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

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

  1. أنشِئ معرّف عميل OAuth 2.0 وسر العميل:

    1. في وحدة التحكّم، انتقِل إلى 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":
      • اسم الخادم: Calendar.
      • عنوان URL لخادم MCP عن بُعد: https://calendarmcp.googleapis.com/mcp/v1
    4. في الإعدادات المتقدّمة، أدخِل معرّف عميل OAuth و سر عميل OAuth.
    5. انقر على إضافة.

غير ذلك

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

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

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

  • النقل: HTTP

  • المصادقة: يستخدم خادم MCP عن بُعد في "تقويم Google" بروتوكول OAuth 2.0. لمعرفة التفاصيل، يُرجى الاطّلاع على لمحة عن المصادقة والتفويض.

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

اختبار خادم MCP في "تقويم Google"

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

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

  • "ما هو موعد اجتماعي القادم مع أرييل؟"

    يتحقّق العميل من جدولك الزمني باستخدام calendar.list_events ويقدّم تفاصيل عن اجتماعك القادم مع أرييل.

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

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

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

مرجع الأدوات

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

  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • suggest_time
  • update_event

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

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

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

يُرجى اتّباع أفضل الممارسات التالية:

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