پیکربندی سرورهای Google Workspace MCP

پیش‌نمای توسعه‌دهندگان نرم‌افزار: به‌عنوان بخشی از برنامه پیش‌نمای توسعه‌دهندگان نرم‌افزار Google Workspace دردسترس است، که دسترسی زودرس به برخی ویژگی‌ها را اعطا می‌کند.

‫Google Workspace سرورهای راه دور Model Context Protocol (MCP) ارائه می‌دهد که به عامل‌های هوش مصنوعی امکان می‌دهد به‌طور ایمن با داده‌های Google Workspace تعامل داشته باشند. با پیکربندی سرورهای MCP در Google Workspace، به برنامه‌های هوش مصنوعی مانند Google Antigravity و Claude امکان می‌دهید تا کنش‌هایی را در برنامه‌های Google Workspace مانند Gmail،‏ Google Drive، «سندنگار Google»، «کاربرگ‌نگار Google»، «اسلایدنگار Google»، «تقویم Google»، Google Chat، و Google Classroom انجام دهند. هر محصول Google Workspace سرور MCP اختصاصی خودش را دارد.

سرورهای MCP در Google Workspace روشی استاندارد برای عامل‌های هوش مصنوعی فراهم می‌کنند تا:

• خواندن داده‌ها: جستجوی ایمیل‌ها، بازیابی فایل‌ها، و فهرست کردن رویدادهای تقویم.
• اقدام کردن: ایجاد پیش‌نویس ایمیل، بارگذاری فایل، و زمان‌بندی جلسه.
• رعایت امنیت: همان اجازه‌ها و کنترل‌های حاکمیت داده کاربر را به ارث می‌برد.

پیش‌نیازها

• عضویت در برنامه پیش‌نمایش توسعه‌دهندگان Google Workspace.

• پروژه 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 Classroom را پیکربندی می‌کنید، یک کلاس آزمایشی Google Classroom با حداقل یک حساب دانش‌آموز آزمایشی. اگر کلاس Google Classroom ندارید که بتوانید از آن برای آزمایش استفاده کنید، یکی در واسط کاربر ایجاد کنید و یک محصل آزمایشی اضافه کنید.

پیکربندی سرورهای Google Workspace MCP

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

فعال کردن میاناهای برنامه‌سازی کاربردی

برای استفاده از سرورهای MCP در Google Workspace، باید APIهای زیر را در پروژه Google Cloud خود فعال کنید:

• Gmail API
• Google Drive API
• Google Docs API
• Google Sheets API
• Google Slides API
• Google Calendar API
• Google Chat API
• People API

• Google Classroom API

CLI

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
docs.googleapis.com \
sheets.googleapis.com \
slides.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
people.googleapis.com \
classroom.googleapis.com --project=PROJECT_ID

PROJECT_ID را با شناسه پروژه Google Cloud خودتان جایگزین کنید.

کنسول

میاناهای برنامه‌سازی کاربردی را در کنسول Google Cloud فعال کنید:

فعال کردن میاناهای برنامه‌سازی کاربردی

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

برای فعال کردن مؤلفه‌های MCP برای هر محصول Google Workspace، باید سرویس‌های زیر را در پروژه Google Cloud خود فعال کنید:

• Gmail MCP API
• Google Drive MCP API
• Google Docs MCP API
• Google Sheets MCP API
• Google Slides MCP API
• Google Calendar MCP API
• Google Chat MCP API
• People MCP API

• Google Classroom MCP API

CLI

gcloud services enable gmailmcp.googleapis.com \
drivemcp.googleapis.com \
docsmcp.googleapis.com \
sheetsmcp.googleapis.com \
slidesmcp.googleapis.com \
calendarmcp.googleapis.com \
chatmcp.googleapis.com \
people.googleapis.com \
classroommcp.googleapis.com --project=PROJECT_ID

PROJECT_ID را با شناسه پروژه Google Cloud خودتان جایگزین کنید.

کنسول

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

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

پیکربندی برنامه Chat

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

1. در کنسول Google Cloud، Google Chat API را جستجو کنید و روی Google Chat API > مدیریت > پیکربندی کلیک کنید.

   به Google Chat API بروید

2. راه‌اندازی برنامه Chat:

   1. در فیلد نام برنامه، Chat MCP را وارد کنید.
   2. در فیلد نشانی وب چهره‌نما، https://developers.google.com/chat/images/quickstart-app-avatar.png را وارد کنید.
   3. در شرح، Chat MCP server را وارد کنید.
   4. در بخش عملکرد، ویژگی‌های تعاملی را با خاموش کردن فعال کردن ویژگی‌های تعاملی غیرفعال کنید.
   5. در بخش گزارش‌ها، گزارش کردن خطاها در Logging را انتخاب کنید.

3. روی ذخیره کلیک کنید.

برای کسب اطلاعات بیشتر درباره ساختن برنامه Chat، انتخاب معماری برنامه Google Chat را ببینید.

راه‌اندازی صفحه کسب رضایت OAuth

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

1. در کنسول Google Cloud، به پلاتفرم Google Auth > نمانام‌سازی بروید.

   رفتن به نمانام‌سازی

2. اگر قبلاً پلاتفرم Google Auth را پیکربندی کرده‌اید، می‌توانید تنظیمات «صفحه رضایت OAuth» زیر را در نمانام‌سازی، مخاطبان، و دسترسی به داده پیکربندی کنید. اگر پیامی با این مضمون دیدید: پلاتفرم Google Auth هنوز پیکربندی نشده است، روی شروع به کار کلیک کنید:

   1. در بخش اطلاعات برنامه، در نام برنامه، Workspace MCP Servers را تایپ کنید.
   2. در ایمیل پشتیبانی کاربر، نشانی ایمیل خودتان یا گروه Google مناسبی را انتخاب کنید.
   3. روی بعدی کلیک کنید.
   4. در بخش مخاطبان، داخلی را انتخاب کنید. اگر نمی‌توانید داخلی را انتخاب کنید، خارجی را انتخاب کنید.
   5. روی بعدی کلیک کنید.
   6. در بخش اطلاعات تماس، نشانی ایمیلی را وارد کنید که بتوانید ازطریق آن از هرگونه تغییر در پروژه‌تان مطلع شوید.
   7. روی بعدی کلیک کنید.
   8. در بخش پایان، خط‌مشی داده‌های کاربر سرویس‌های Google API را مرور کنید و اگر موافقید، با «خط‌مشی داده‌های کاربر سرویس‌های Google API» موافقم را انتخاب کنید.
   9. روی ادامه کلیک کنید.
   10. روی ایجاد کردن کلیک کنید.
   11. اگر خارجی را برای نوع کاربر انتخاب کرده‌اید، کاربران آزمایشی را اضافه کنید:
       1. روی مخاطبان کلیک کنید.
       2. در بخش کاربران آزمایشی، روی افزودن کاربران کلیک کنید.
       3. نشانی ایمیل خودتان و هر کاربر آزمایشی مجاز دیگری را وارد کنید، سپس روی ذخیره کلیک کنید.

3. روی دسترسی به داده‌ها > افزودن یا برداشتن دامنه‌ها کلیک کنید. پانلی با فهرستی از دامنه‌ها برای هر API که در پروژه Google Cloud خود فعال کرده‌اید ظاهر می‌شود.

   1. در بخش افزودن دستی دامنه‌ها، دامنه‌های سرورهای MCP را که می‌خواهید استفاده کنید جای‌گذاری کنید:

      • Gmail:
        • https://www.googleapis.com/auth/gmail.readonly
        • https://www.googleapis.com/auth/gmail.compose
      • Google Drive:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
      • سندنگار Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/documents.readonly
        • https://www.googleapis.com/auth/documents
      • کاربرگ‌نگار Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/spreadsheets.readonly
        • https://www.googleapis.com/auth/spreadsheets
      • اسلایدنگار Google:
        • https://www.googleapis.com/auth/drive.readonly
        • https://www.googleapis.com/auth/drive.file
        • https://www.googleapis.com/auth/presentations.readonly
        • https://www.googleapis.com/auth/presentations
      • تقویم 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
      • 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
      • People API:
        • https://www.googleapis.com/auth/directory.readonly
        • https://www.googleapis.com/auth/userinfo.profile
        • https://www.googleapis.com/auth/contacts.readonly
      • Google Classroom:
        • https://www.googleapis.com/auth/classroom.announcements
        • https://www.googleapis.com/auth/classroom.courses.readonly
        • https://www.googleapis.com/auth/classroom.coursework.students
        • https://www.googleapis.com/auth/classroom.courseworkmaterials
        • https://www.googleapis.com/auth/classroom.rosters.readonly
        • https://www.googleapis.com/auth/classroom.student-submissions.students.readonly
        • https://www.googleapis.com/auth/classroom.topics.readonly

   2. روی افزودن به جدول کلیک کنید.

   3. روی به‌روزرسانی کلیک کنید.

   4. پس‌از انتخاب کردن دامنه‌های موردنیاز برنامه‌تان، در صفحه دسترسی به داده، روی ذخیره کلیک کنید.

پیکربندی کردن کارخواه MCP

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

Antigravity

برای افزودن سرورهای MCP راه دور Google Workspace به Antigravity، پیکربندی سرور را به فایل mcp_config.json خود اضافه کنید. این دستورالعمل‌ها از Antigravity 2.0،‏ Antigravity IDE، و Antigravity CLI پشتیبانی می‌کنند.

1. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

   1. در کنسول Google Cloud، به Google Auth Platform > Clients > Create Client بروید

      رفتن به «ایجاد کارخواه»

   2. برنامه وب را به‌عنوان نوع برنامه انتخاب کنید.

   3. نامی وارد کنید.

   4. در بخش نشانی‌های وب هدایت مجاز، روی + افزودن نشانی وب کلیک کنید، و سپس https://antigravity.google/oauth-callback را در فیلد نشانی‌های وب اضافه کنید.

   5. استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید.

   6. روی ایجاد کلیک کنید و شناسه کارخواه و رمز کارخواه را کپی کنید.

2. فایل پیکربندی ~/.gemini/config/mcp_config.json را باز یا ایجاد کنید.

3. پیکربندی mcpServers را به mcp_config.json اضافه کنید:

   {
     "mcpServers": {
       "gmail": {
         "serverUrl": "https://gmailmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "drive": {
         "serverUrl": "https://drivemcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "docs": {
         "serverUrl": "https://docsmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "sheets": {
         "serverUrl": "https://sheetsmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "slides": {
         "serverUrl": "https://slidesmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "calendar": {
         "serverUrl": "https://calendarmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "chat": {
         "serverUrl": "https://chatmcp.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "people": {
         "serverUrl": "https://people.googleapis.com/mcp/v1",
         "oauth": {
           "clientId": "OAUTH_CLIENT_ID",
           "clientSecret": "OAUTH_CLIENT_SECRET"
         }
       },
       "classroom": {
         "serverUrl": "https://classroommcp.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 را اصالت‌سنجی کنید. می‌توانید بااستفاده از تنظیمات GUI یا CLI اصالت‌سنجی کنید:

   • برای Antigravity IDE یا GUI‏ (Antigravity 2.0):

     1. صفحه تنظیمات را باز کنید (مثلاً روی تنظیمات در پایین سمت راست کلیک کنید یا تنظیمات کاربر Antigravity را باز کنید).
     2. به سفارشی‌سازی‌ها بروید.
     3. در بخش سرورهای MCP نصب‌شده، روی بازآوری کلیک کنید.
     4. برای هر سرور فهرست‌شده (gmail،‏ drive،‏ docs، sheets،‏ slides،‏ calendar،‏ chat،‏ people، و classroom)، روی اصالت‌سنجی کلیک کنید، به سیستم «حساب Google» خود وارد شوید، کد مجوز را کپی کنید، آن را در کادر گفتگوی ورودی جای‌گذاری کنید، و روی ارسال کلیک کنید.

   • برای Antigravity CLI:

     1. Antigravity CLI را شروع کنید:

        agy
        

     2. با اجرای دستور زیر، پانل مدیریت MCP تعاملی را باز کنید:

        /mcp
        

     3. اصالت‌سنجی کردن هر سرور MCP:

        1. بااستفاده از کلیدهای جهت‌نما، سرور را انتخاب کنید، به کنش اصالت‌سنجی بروید، و کلید ورود را فشار دهید. جریان ورود به سیستم را در مرورگرتان تکمیل کنید، کد مجوز را کپی کنید، آن را در پیام‌واره پایانه جای‌گذاری کنید، و کلید ورود را فشار دهید.
        2. این مراحل را برای هر سروری که پیکربندی کرده‌اید تکرار کنید (gmail، drive، docs، sheets، slides، calendar، chat، people، و classroom).

6. تأیید کنید که سرورها به‌درستی پیکربندی شده‌اند و درحال اجرا هستند:

   • برای Antigravity IDE یا GUI: دکمه خروج از سیستم در کنار هر سرور در بخش سفارشی‌سازی‌ها > سرورهای MCP نصب‌شده نمایش داده می‌شود.
   • برای Antigravity CLI: پانل /mcp را باز کنید تا سرورهای MCP پیکربندی‌شده‌تان را ببینید. سرورهای درستی‌سنجی‌شده و اصالت‌سنجی‌شده اصالت‌سنجی‌شده را در کنار نامشان در پانل تعاملی TUI نمایش می‌دهند. می‌توانید هر سروری را در نمای داشبورد انتخاب کنید تا وضعیت آن را بررسی کنید و همه ابزارهای دردسترس آن را فهرست کنید.

سرورهای MCP راه دور برای استفاده در Antigravity آماده‌اند.

Claude

برای استفاده از سرورهای MCP ازراه‌دور Google Workspace با Claude.ai یا Claude Desktop، باید طرح Claude Enterprise،‏ Pro،‏ Max، یا Team داشته باشید.

برای افزودن سرورهای MCP راه دور Google Workspace به Claude، یک متصل‌کننده سفارشی با شناسه کارخواه OAuth و رمز کارخواه پیکربندی کنید.

1. شناسه و رمز کارخواه OAuth 2.0 ایجاد کنید:

   1. در کنسول Google Cloud، به Google Auth Platform > Clients > Create Client بروید

      رفتن به «ایجاد کارخواه»

   2. برنامه وب را به‌عنوان نوع برنامه انتخاب کنید.

   3. نامی وارد کنید.

   4. در بخش URIهای هدایت مجاز، روی + افزودن URI کلیک کنید، سپس https://claude.ai/api/mcp/auth_callback را در فیلد URIها اضافه کنید.

   5. استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید.

   6. روی ایجاد کلیک کنید و شناسه کارخواه و رمز کارخواه را کپی کنید.

2. پیکربندی کردن سرور MCP در Claude:

   1. در Claude.ai یا Claude Desktop، به تنظیمات (یا تنظیمات سرپرست) > رابط‌ها بروید.
   2. روی افزودن متصل‌کننده سفارشی کلیک کنید.

   3. جزئیات اتصال را برای محصول Google Workspace که می‌خواهید اضافه کنید وارد کنید:

      • نام سرور: نامی برای سرور، مثل Gmail.
      • نشانی وب سرور MCP ازراه‌دور: نشانی وب محصول Google Workspace، مانند یکی از موارد زیر:
        • Gmail: https://gmailmcp.googleapis.com/mcp/v1
        • Google Drive: ‏ https://drivemcp.googleapis.com/mcp/v1
        • سندنگار Google: https://docsmcp.googleapis.com/mcp/v1
        • کاربرگ‌نگار Google: ‏https://sheetsmcp.googleapis.com/mcp/v1
        • اسلایدنگار Google: https://slidesmcp.googleapis.com/mcp/v1
        • تقویم Google: https://calendarmcp.googleapis.com/mcp/v1
        • Google Chat: ‏ https://chatmcp.googleapis.com/mcp/v1
        • People API: https://people.googleapis.com/mcp/v1
        • Google Classroom: https://classroommcp.googleapis.com/mcp/v1

   4. در تنظیمات پیشرفته، شناسه کارخواه OAuth و رمز کارخواه OAuth را وارد کنید.

   5. روی افزودن کلیک کنید.

   6. این مراحل را برای هر محصول Google Workspace که می‌خواهید اضافه کنید تکرار کنید.

موارد دیگر

بسیاری از برنامه‌های هوش مصنوعی روش‌هایی برای متصل شدن به سرور MCP ازراه‌دور دارند. معمولاً باید جزئیات مربوط به سرور را وارد کنید، مانند نام، نقاط پایانی، پروتکل انتقال، و روش اصالت‌سنجی. برای سرورهای MCP راه دور Google Workspace، موارد زیر را وارد کنید:

• نام سرور: googleworkspace

• سرورها: هر محصول Google Workspace نشانی وب سرور خودش را دارد:

  • Gmail: https://gmailmcp.googleapis.com/mcp/v1
  • Google Drive: ‏ https://drivemcp.googleapis.com/mcp/v1
  • سندنگار Google: https://docsmcp.googleapis.com/mcp/v1
  • کاربرگ‌نگار Google: ‏https://sheetsmcp.googleapis.com/mcp/v1
  • اسلایدنگار Google: https://slidesmcp.googleapis.com/mcp/v1
  • تقویم Google: https://calendarmcp.googleapis.com/mcp/v1
  • Google Chat: ‏ https://chatmcp.googleapis.com/mcp/v1
  • People API: https://people.googleapis.com/mcp/v1
  • Google Classroom: https://classroommcp.googleapis.com/mcp/v1

• انتقال: HTTP قابل جاری‌سازی

• اصالت‌سنجی: سرور MCP ازراه‌دور Google Workspace از OAuth 2.0 استفاده می‌کند. هنگام ایجاد کارخواه OAuth 2.0، استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید. برای جزئیات، به آشنایی با اصالت‌سنجی و صدور مجوز مراجعه کنید.

  کارخواه MCP شما به یک ژتون بازآوری نیاز دارد تا کاربران مجبور نباشند تقریباً هر ساعت دوباره به سیستم وارد شوند. سرور OAuth 2.0‏ Google فقط زمانی ژتون بازآوری صادر می‌کند که درخواست مجوز شامل access_type=offline باشد. درخواست کردن فقط محدوده offline_access OpenID Connect (OIDC) آن را برنمی‌گرداند. اگر کارخواه MCP شما از پارامترهای مجوز سفارشی پشتیبانی می‌کند، access_type=offline را به درخواست مجوز اضافه کنید. برای دریافت ژتون بازآوری جدید برای کاربری که قبلاً دسترسی اعطا کرده است، prompt=consent را نیز اضافه کنید. اگر مشتری MCP شما از پارامترهای مجوز سفارشی پشتیبانی نمی‌کند، کاربران باید هربار که کد دسترسی منقضی می‌شود دوباره به سیستم وارد شوند. برای جزئیات، بازآوری کد دسترسی را ببینید.

برای جزئیات بیشتر درباره متصل کردن انواع مختلف کارخواه‌ها، پیکربندی MCP در برنامه هوش مصنوعی را ببینید.

آزمایش کردن سرورهای Google Workspace MCP

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

سؤالات زیر را از کارخواه MCP خود بپرسید:

• «آریل در آخرین ایمیلش درباره طرح بازاریابی ما چه گفت؟»

  کارخواه ایمیل‌های Ariel را بااستفاده از gmail.search_threads فیلتر می‌کند، محتوای جدیدترین رشته را با gmail.get_thread بازیابی می‌کند، و سپس آن را برای شما خلاصه می‌کند.

• «ایمیلی به [e-mail] پیش‌نویس کن و بگو که طرح بازاریابی را تأیید می‌کنم.»

  کارخواه از gmail.create_draft برای ایجاد ایمیل در پوشه پیش‌نویس‌های شما استفاده می‌کند، و به شما امکان می‌دهد آن را در Gmail مرور و ارسال کنید.

• «فایل Marketing Plan را خلاصه کن.»

  کارخواه با drive.search_files تماس می‌گیرد تا «طرح بازاریابی» را پیدا کند، سپس از drive.read_file_content برای بازیابی و خلاصه کردن محتوای آن استفاده می‌کند.

• «محتوای ساختاری یادداشت‌های جلسه «سندنگار Google» را به من نشان بده.»

  مشتری ساختار و محتوای سند را بااستفاده از docs.read_doc واکشی می‌کند.

• «Read sheet Sheet1 from Google Sheet Quarterly Sales.» (برگه Sheet1 را از «کاربرگ‌نگار Google» با عنوان «فروش فصلی» بخوان.)

  کارخواه مقادیر جدول را بااستفاده از sheets.get_values واکشی می‌کند.

• «چیدمان کلامی ارائه «نمای کلی محصول» در «اسلایدنگار Google» را به من نشان بده.»

  کارخواه ساختارهای چیدمان دیداری ارائه را بااستفاده از slides.read_presentation واکشی می‌کند.

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

  مشتری بااستفاده از calendar.list_events زمان‌بندی شما را بررسی می‌کند و جزئیات جلسه بعدی‌تان با آریل را ارائه می‌دهد.

• «طبق نمایه Google من، نامم چیست؟»

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

• «درحال‌حاضر چه کلاس‌هایی را تدریس می‌کنم؟»

  مشتری بااستفاده از classroom.list_course_summaries برنامه زمانی شما را بررسی می‌کند و دوره‌های فعالی را که در آن‌ها نقش معلم دارید خلاصه می‌کند.

• «برای کلاس زمین‌شناسی‌ام، اعلامیه‌ای درباره سفر علمی پیش‌رو پیش‌نویس کن.»

  کارخواه از classroom.create_announcement برای پیش‌نویس کردن اطلاعیه استفاده می‌کند، که می‌توانید آن را در برنامه Google Classroom مرور و پست کنید.

اگر ابزارها با موفقیت اجرا شوند و پاسخ‌های مرتبط دریافت کنید، سرورهای MCP در Google Workspace شما به‌درستی پیکربندی شده‌اند.

عیب‌یابی

اگر در اتصال به سرورهای MCP با مشکلی مواجه شدید، می‌توانید گزارش‌های OAuth را برای یافتن خطاها بررسی کنید. از سرپرستتان بخواهید رویدادهای گزارش OAuth را در ابزار بررسی امنیتی بررسی کند.

اگر درخواست‌های شما به سرورهای MCP رد شد، بررسی کنید که در Google Auth Platform > کارخواه‌ها، گزینه استفاده از این کارخواه برای نماینده مجهز به هوش مصنوعی برای کارخواه OAuth 2.0 شما انتخاب شده باشد. اگر نمی‌توانید این تنظیم را در کارخواه OAuth موجود تغییر دهید، کارخواه OAuth جدیدی ایجاد کنید و استفاده از این کارخواه برای نماینده مجهز به هوش مصنوعی را انتخاب کنید و برنامه‌تان را به‌روز کنید تا از آن استفاده کند. اگر از یک کارخواه OAuth موجود هم برای عامل هوشواره‌ای و هم برای ویژگی‌های غیرعامل استفاده می‌شود، یک کارخواه OAuth جداگانه برای عامل هوشواره‌ای ایجاد کنید و کارخواه موجود را برای ویژگی‌های غیرعامل نگه دارید. برای دستورالعمل‌ها، به پیکربندی کارخواه MCP و مدیریت کارخواه‌های OAuth مراجعه کنید.

اگر برنامه‌تان از حساب سرویس با واگذاری در سطح دامنه استفاده می‌کند، نمی‌توانید استفاده از این کارخواه برای عامل با بهره‌گیری از هوش مصنوعی را برای آن انتخاب کنید زیرا حساب‌های سرویس در پلاتفرم Google Auth > کارخواه‌ها مدیریت نمی‌شوند. درخواست‌های ارسال‌شده به سرورهای MCP از حساب‌های خدماتی که از واگذاری در سراسر دامنه استفاده می‌کنند به‌این دلیل رد نمی‌شوند. دسترسی توسط تنظیمات واگذاری در سراسر دامنه که سرپرست Google Workspace شما مدیریت می‌کند کنترل می‌شود. برای جزئیات، کنترل دسترسی به میانای برنامه‌سازی کاربردی با واگذاری در سراسر دامنه را ببینید.

اگر سرورهای MCP را از Google Apps Script فراخوانی کنید، Apps Script یک کارخواه OAuth پیش‌فرض برای دستورات شما ایجاد و مدیریت می‌کند، اما نمی‌توانید از این کارخواه برای نماینده مجهز به هوش مصنوعی استفاده کنید را برای آن انتخاب کنید. این موضوع حتی اگر اسکریپت شما از پروژه استاندارد Google Cloud استفاده کند نیز اعمال می‌شود. درعوض، کارهای زیر را انجام دهید:

1. در کنسول Google Cloud، به پلاتفرم Google Auth > کارخواه‌ها بروید، یک کارخواه OAuth ایجاد کنید، و از این کارخواه برای یک عامل مجهز به هوش مصنوعی استفاده کنید را انتخاب کنید.
2. در اسکریپت خود، از کتابخانه OAuth2 برای Apps Script برای صدور مجوز برای کاربران با آن کارخواه OAuth استفاده کنید.
3. وقتی با سرورهای MCP تماس می‌گیرید، کد دسترسی را که کتابخانه برمی‌گرداند به‌جای کد ScriptApp.getOAuthToken ارسال کنید.

پروژه‌های Apps Script که سرورهای MCP را فراخوانی نمی‌کنند تحت‌تأثیر قرار نمی‌گیرند.

اگر تقریباً هر ساعت از شما خواسته می‌شود دوباره به سیستم وارد شوید، کارخواه MCP شما ژتون بازآوری دریافت نمی‌کند. سرور OAuth 2.0 در Google فقط زمانی ژتون بازآوری صادر می‌کند که درخواست مجوز شامل access_type=offline باشد. درخواست کردن فقط گستره offline_access OpenID Connect (OIDC) چیزی برنمی‌گرداند. اگر کارخواه MCP شما از پارامترهای مجوز سفارشی پشتیبانی می‌کند، access_type=offline را به درخواست مجوز اضافه کنید. برای دریافت ژتون بازآوری جدید برای کاربری که قبلاً دسترسی اعطا کرده است، prompt=consent را نیز اضافه کنید. اگر کارخواه MCP شما از پارامترهای مجوز سفارشی پشتیبانی نمی‌کند، باید هربار که کد دسترسی منقضی می‌شود دوباره به سیستم وارد شوید. برای جزئیات، بازآوری کد دسترسی را ببینید.

محصولات پشتیبانی‌شده

محصولات Google Workspace زیر از سرورهای MCP‏ Google Workspace پشتیبانی می‌کنند و ابزارهای زیر را ارائه می‌دهند:

• Gmail
  • create_draft
  • get_message
  • get_thread
  • label_message
  • label_thread
  • list_drafts
  • list_labels
  • search_threads
  • unlabel_message
  • unlabel_thread
• Google Drive
  • copy_file
  • create_file
  • download_file_content
  • get_file_metadata
  • get_file_permissions
  • list_recent_files
  • read_file_content
  • search_files
• سندنگار Google
  • read_doc
  • update_doc
• کاربرگ‌نگار Google
  • get_values
  • get_spreadsheet
  • update_spreadsheet
  • update_values
  • update_formulas
  • insert_dimension
• اسلایدنگار Google
  • read_presentation
  • update_presentation
• تقویم Google
  • create_event
  • delete_event
  • get_event
  • list_calendars
  • list_events
  • respond_to_event
  • search_events
  • suggest_time
  • update_event
• Google Chat
  • search_conversations
  • list_messages
  • search_messages
  • send_message
  • mark_as_read
  • mark_as_unread
  • list_memberships
• People API
  • get_user_profile
  • search_contacts
  • search_directory_people
• Google Classroom
  • create_announcement
  • create_course_work
  • create_course_work_rubric
  • create_topic
  • get_announcements
  • get_course_roster
  • get_course_work
  • get_course_work_rubric
  • get_courses
  • get_guardian_info
  • list_announcement_summaries
  • list_course_summaries
  • list_course_work_submissions
  • list_course_work_summaries
  • list_topics
  • update_course_work

ملاحظه امنیتی مهم: تزریق پیام‌واره غیرمستقیم

وقتی مدل زبانی را درمعرض داده‌های غیرقابل‌اعتماد قرار می‌دهید، خطر حمله تزریق پیام‌واره غیرمستقیم وجود دارد. چون کارخواه‌های MCP مثل Google Antigravity ازطریق سرورهای MCP در Google Workspace به ابزارها و میاناهای برنامه‌سازی کاربردی قدرتمند دسترسی دارند، می‌توانند داده‌های «حساب Google» شما را بخوانند، اصلاح کنند، و حذف کنند.

برای کاهش این خطرات، این روال‌های مطلوب را دنبال کنید:

• فقط از ابزارهای مورداعتماد استفاده کنید. هرگز سرورهای MCP‏ Google Workspace را به برنامه‌های غیرقابل‌اعتماد یا تأییدنشده متصل نکنید.
• درخصوص ورودی‌های غیرقابل‌اعتماد احتیاط کنید. از کارخواه MCP خود نخواهید که ایمیل‌ها، اسناد، یا منابع دیگر را از منابع تأییدنشده پردازش کند. این ورودی‌ها ممکن است حاوی دستورالعمل‌های پنهانی باشند که می‌توانند جلسه شما را بربایند و به مهاجم اجازه دهند داده‌های شما را تغییر دهد، به‌سرقت ببرد، یا حذف کند.
• همه کنش‌ها را مرور کنید. همیشه کنش‌هایی را که مشتری هوش مصنوعی شما ازجانب شما انجام می‌دهد به‌دقت بازبینی کنید تا مطمئن شوید درست هستند و با اهداف شما مطابقت دارند.

موضوعات مرتبط

• سرورهای MCP‏ Google Workspace در Antigravity (آزمایشگاه کد)
• ساختن عامل هوش مصنوعی Google Workspace با ADK و MCP
• رابط‌های سرور MCP در Google Workspace در برنامه‌های Gemini Enterprise