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

ضبط إعدادات خادم Calendar MCP

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

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

لاستخدام خادم MCP الخاص بـ "تقويم Google"، يجب تفعيل واجهة برمجة التطبيقات التالية في مشروعك على السحابة الإلكترونية:

  • 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 للمصادقة > العلامة التجارية.

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

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

    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 بعيد خاص بالتقويم إلى برنامج MCP، اتّبِع التعليمات الخاصة ببرنامجك.

Antigravity

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

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

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

    • بالنسبة إلى 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: افتح اللوحة /mcp لعرض خوادم MCP التي تم ضبطها. تعرض الخوادم التي تم التحقّق منها ومصادقتها Authed بجانب أسمائها داخل لوحة واجهة المستخدم النصية التفاعلية. يمكنك اختيار الخادم ضمن عرض لوحة البيانات لفحص حالته وإدراج جميع الأدوات المتاحة فيه.

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

Claude

لاستخدام خادم MCP البعيد في "تقويم Google" مع Claude.ai أو تطبيق Claude Desktop، يجب أن تكون مشتركًا في إحدى خطط Claude Enterprise أو Pro أو Max أو Team.

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

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

    1. في وحدة التحكّم، انتقِل إلى منصة 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":
      • اسم الخادم: 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 البعيد الخاص بالتقويم بروتوكول 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 معالجة الأحداث أو الموارد الأخرى من مصادر لم يتم التحقّق منها. قد تحتوي هذه المدخلات على تعليمات مخفية يمكنها السيطرة على جلستك، ما يسمح للمهاجم بتعديل بياناتك أو سرقتها أو حذفها.
  • راجِع جميع الإجراءات. ننصحك دائمًا بمراجعة الإجراءات التي يتّخذها عميل الذكاء الاصطناعي نيابةً عنك بعناية للتأكّد من أنّها صحيحة وتتوافق مع نواياك.