سرورهای MCP گوگل ورک اسپیس در آنتی‌گراویتی

۱. مقدمه

در این آزمایشگاه کد، یاد خواهید گرفت که چگونه از پروتکل Model Context (MCP) برای اتصال Antigravity به داده‌های Google Workspace خود استفاده کنید. MCP یک استاندارد باز است که مدل‌های هوش مصنوعی را قادر می‌سازد تا به طور ایمن از ابزارهای ارائه شده توسط سرورهای راه دور استفاده کنند. شما Antigravity را طوری تنظیم خواهید کرد که بدون نوشتن هیچ کدی با Gmail، Google Drive، Google Calendar، Google Chat و People API تعامل داشته باشد!

معماری MCP فضای کاری گوگل

کاری که انجام خواهید داد

  • سرویس‌های Google Workspace MCP را در پروژه Google Cloud خود فعال کنید.
  • برای دسترسی به این سرویس‌های MCP ، آنتی‌گراویتی را پیکربندی کنید.
  • ادغام را با پیام‌های سرگرم‌کننده و مفیدی که با داده‌های Google Workspace شما تعامل دارند، آزمایش کنید.

آنچه نیاز دارید

  • یک مرورگر وب مانند کروم
  • یک پروژه ابری گوگل
  • یک حساب کاربری گوگل ورک اسپیس
  • ضد جاذبه روی دستگاه محلی شما نصب شده است

دسترسی آسان به این آزمایشگاه کد

کد QR.png

۲. قبل از شروع

یک پروژه Google Cloud ایجاد یا انتخاب کنید

در کنسول گوگل کلود ، یک پروژه گوگل کلود انتخاب یا ایجاد کنید .

فعال کردن APIها

برای استفاده از سرورهای MCP گوگل ورک‌اسپیس، باید APIهای استاندارد گوگل ورک‌اسپیس را فعال کنید. در حالی که برخی از سرورهای MCP به طور مستقل عمل می‌کنند، برخی دیگر همچنان نیاز به فعال بودن API استاندارد زیرین دارند:

  • جیمیل و چت هنوز به API های استاندارد خود نیاز دارند.
  • درایو برای ابزارهای خاص به API استاندارد نیاز دارد.
  • تقویم نیازی به فعال بودن API استاندارد ندارد.
  • رابط برنامه‌نویسی کاربردی افراد (People API) هم دسترسی استاندارد و هم قابلیت MCP را مدیریت می‌کند، بنابراین سرویس MCP جداگانه‌ای برای فعال‌سازی ندارد.

فعال کردن سرویس‌های MCP

در مرحله بعد، سرویس‌های اختصاصی MCP را برای محصولات فعال کنید.

پیکربندی برنامه چت

برای استفاده از سرور Google Chat MCP، باید یک برنامه چت را در پروژه Google Cloud خود پیکربندی کنید.

  1. در کنسول گوگل کلود، عبارت Google Chat API را جستجو کنید و روی Google Chat API > Manage > Configuration کلیک کنید.

  1. برنامه چت را تنظیم کنید:
    • در فیلد نام برنامه ، Chat MCP را وارد کنید.
    • در قسمت آدرس اینترنتی آواتار ، آدرس https://developers.google.com/chat/images/quickstart-app-avatar.png را وارد کنید.
    • در قسمت توضیحات ، Chat MCP server را وارد کنید.
    • در بخش عملکرد (Functionality) ، گزینه‌ی فعال کردن ویژگی‌های تعاملی (Enable interactive features) را خاموش کنید.
    • در قسمت گزارش‌ها ، گزینه ثبت خطاها را برای ثبت گزارش‌ها انتخاب کنید.
  2. روی ذخیره کلیک کنید.

chat_app.png

۳. پیکربندی OAuth Consent و Client

سرورهای Google Workspace MCP از OAuth 2.0 برای احراز هویت امن استفاده می‌کنند. شما باید یک صفحه رضایت OAuth پیکربندی کنید و یک کلاینت برنامه وب ایجاد کنید.

سرورهای Google Workspace MCP از OAuth 2.0 برای احراز هویت استفاده می‌کنند. ابتدا باید صفحه رضایت را پیکربندی کنید.

  1. در کنسول گوگل کلود، به Google Auth Platform > Branding بروید. اگر پیکربندی نشده است، روی Get Started کلیک کنید.
  2. پیکربندی اطلاعات برنامه :
    • نام برنامه : Google Workspace MCP Servers
    • ایمیل پشتیبانی کاربر : ایمیل خود را انتخاب کنید.
  3. پیکربندی مخاطب : داخلی (یا خارجی اگر داخلی در دسترس نیست) را انتخاب کنید.
  4. پیکربندی اطلاعات تماس : آدرس ایمیل خود را وارد کنید.
  5. سیاست داده‌های کاربر را مرور و با آن موافقت کنید، سپس روی ایجاد کلیک کنید.
  6. اگر گزینه‌ی خارجی (External) را انتخاب کرده‌اید، به بخش مخاطبان (Audience) بروید و ایمیل خود را در بخش کاربران آزمایشی (Test users) اضافه کنید.
  7. به Data Access > Add or Remove Scopes بروید. در قسمت Manually add scopes ، موارد زیر را برای سرورهایی که می‌خواهید استفاده کنید، اضافه کنید:
    • تقویم گوگل : https://www.googleapis.com/auth/calendar.calendarlist.readonly ، https://www.googleapis.com/auth/calendar.events.freebusy ، https://www.googleapis.com/auth/calendar.events.readonly
    • گوگل چت : 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.users.readstate.readonly
    • گوگل درایو : https://www.googleapis.com/auth/drive.readonly ، https://www.googleapis.com/auth/drive.file
    • جیمیل : https://www.googleapis.com/auth/gmail.readonly ، https://www.googleapis.com/auth/gmail.compose
    • رابط برنامه‌نویسی کاربردی افراد : https://www.googleapis.com/auth/directory.readonly ، https://www.googleapis.com/auth/userinfo.profile ، https://www.googleapis.com/auth/contacts.readonly
  8. روی افزودن به جدول ، سپس به‌روزرسانی و در نهایت ذخیره کلیک کنید.

oauth_consent_screen.png

یک شناسه کلاینت OAuth ایجاد کنید

  1. به پلتفرم احراز هویت گوگل > کلاینت‌ها > ایجاد کلاینت بروید.
  2. نوع برنامه را Web application انتخاب کنید.
  3. اسمشو بذار Antigravity .
  4. در زیر Authorized redirect URIs ، روی + Add URI کلیک کنید و سپس https://antigravity.google/oauth-callback را وارد کنید.
  5. روی Create کلیک کنید و Client ID و Client Secret را کپی کنید. در مرحله بعدی به این موارد نیاز خواهید داشت.

oauth_client.png

۴. پیکربندی ضد جاذبه

حالا بیایید Antigravity را برای استفاده از این نقاط پایانی پیکربندی کنیم. اگر Antigravity را نصب ندارید، دستورالعمل‌های نصب را در وب‌سایت Antigravity دنبال کنید.

سرورهای MCP سفارشی اضافه کنید

  1. سرورهای MCP را از طریق منوی کشویی ... در بالای پنل کاربری ویرایشگر باز کنید.

open_mcp_servers.png

  1. روی مدیریت سرورهای MCP و سپس مشاهده پیکربندی خام کلیک کنید.

manage_mcp_servers.png

  1. فایل mcp_config.json که به تازگی باز شده است را با پیکربندی سفارشی سرور MCP زیر تغییر دهید. قبل از انجام این کار، متغیرهای <YOUR_CLIENT_ID> و <YOUR_CLIENT_SECRET> را با شناسه و رمز کلاینت OAuth که در مراحل قبلی ایجاد کرده‌اید، جایگزین کنید: 
{
  "mcpServers": {
    "gws-calendar": {
      "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-chat": {
      "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-drive": {
      "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-gmail": {
      "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    },
    "gws-people": {
      "serverUrl": "https://people.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "<YOUR_CLIENT_ID>",
        "clientSecret": "<YOUR_CLIENT_SECRET>"
      }
    }
  }
}

mcp_config.png

  1. به مدیریت سرورهای MCP برگردید و سپس روی Refresh کلیک کنید.

configuration_mcp_servers.png

احراز هویت سرورهای MCP سفارشی

  1. تنظیمات کاربری Antigravity را از طریق منوی کشویی تنظیمات ویژه ویرایشگر در بالای پنجره باز کنید.

تنظیمات_کاربر_باز.png

  1. به بخش سفارشی‌سازی‌ها بروید.

سفارشی‌سازی‌ها.png

  1. برای هر سرور ذکر شده در زیر سرورهای نصب شده MCP :
    1. روی تأیید اعتبار کلیک کنید.

سرورهای نصب‌شده.png

  1. مراحل احراز هویت را در پنجره مرورگر جدیدی که باز می‌شود، طی کنید.
  2. پس از تکمیل، روی «کپی در کلیپ‌بورد» کلیک کنید.

کپی_کد_auth.png

  1. پنجره مرورگر را ببندید.
  2. کد تاییدی که کپی کرده‌اید را در فیلد متنی که در تنظیمات Antigravity نمایش داده می‌شود، جایگذاری کنید.
  3. روی ارسال کلیک کنید.

mcp_servers_authenticated.png

۵. ابزارهای تست

اکنون می‌توانید با استفاده از زبان طبیعی با داده‌های Google Workspace خود تعامل داشته باشید. در اینجا چند نمونه از دستورالعمل‌ها برای هر سرویس آورده شده است.

تقویم گوگل

سعی کنید برنامه خود را جستجو کنید:

  • «جلسات آینده من این هفته چیست؟»
  • «فردا بعد از ظهر وقت آزاد دارم؟»

test_prompt.png

گوگل چت

سعی کنید پیام‌ها را جستجو کنید:

  • «پیام‌هایی که شامل '[KEYWORD]' هستند را در '[SPACE_NAME]' جستجو کنید.»

گوگل درایو

سعی کنید فایل‌ها را جستجو یا بخوانید:

  • «در گوگل درایو من دنبال فایل‌هایی بگرد که شامل «[کلمه کلیدی]» باشند.»
  • «آخرین اسنادی را که ویرایش کرده‌ام فهرست کنید.»
  • «محتوای سند «[نام فایل]» من را بخوانید و اهداف اصلی را خلاصه کنید.»

جیمیل

سعی کنید ایمیل‌هایتان را جستجو یا مدیریت کنید:

  • «۵ ایمیل آخری که دریافت کردم را خلاصه کن.»
  • «ایمیلی به آدرس '[EMAIL_ADDRESS]' بنویسید و درخواست به‌روزرسانی پروژه '[PROJECT_NAME]' را داشته باشید.»

رابط برنامه‌نویسی کاربردی افراد

سعی کنید پروفایل یا مخاطبین خود را جستجو کنید:

  • «طبق پروفایل گوگل من، اسم من چیست؟»
  • «اطلاعات تماس «[نام]» را پیدا کنید.»

ترکیب چندین سرویس

قدرت واقعی MCP زمانی آشکار می‌شود که وظایف را در چندین سرویس هماهنگ کنید. این دستورالعمل‌ها را که قابلیت‌های بین سرویسی را نشان می‌دهند، امتحان کنید:

  • «فایل‌های مربوط به به‌روزرسانی‌های مرحله‌ای «[PROJECT_NAME]» را در درایو جستجو کنید، محتوای آنها را خلاصه کنید، آدرس ایمیل «[NAME]» را پیدا کنید و یک پیش‌نویس جیمیل برای آنها به همراه خلاصه ایجاد کنید.»

ابزارهای بیشتر را کاوش کنید

اینها فقط چند نمونه از کارهایی هستند که می‌توانید انجام دهید. برای مشاهده لیست کامل ابزارهای موجود برای هر سرویس و امتحان کردن آنها، به بخش محصولات پشتیبانی‌شده در مستندات رسمی مراجعه کنید.

۶. تمیز کردن

برای پاکسازی پروژه بدون حذف آن، می‌توانید APIها و سرویس‌های MCP که فعال کرده‌اید را غیرفعال کنید:

  1. در کنسول گوگل کلود، به داشبورد API & Services بروید.
  2. روی هر یک از APIهای Google Workspace و MCP که فعال کرده‌اید (مثلاً Calendar MCP، Chat MCP) کلیک کنید و روی Disable API کلیک کنید.

اگر دیگر قصد استفاده از آنها را ندارید، اعتبارنامه‌های کلاینت OAuth را در کنسول Google Auth Platform حذف کنید.

۷. تبریک

تبریک! شما با موفقیت سرورهای رسمی Google Workspace MCP را با استفاده از Antigravity پیکربندی و آزمایش کردید.

اسناد مرجع