به نمایندگان هوش مصنوعی اجازه دهید با Universal Search MCP Server برای Workspace در سراسر فضای کاری جستجو کنند

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

Universal Search MCP Server برای Google Workspace از استاندارد پروتکل بافتار مدل (MCP) استفاده می‌کند تا به عامل‌های هوش مصنوعی اجازه دهد مصنوعات Workspace شما را جستجو کنند. این سرور روشی برای جستجو در چندین محصول Google Workspace، ازجمله پیام‌های Gmail، فایل‌های Google Drive، رویدادهای «تقویم Google»، و فضاها و پیام‌های Google Chat، بااستفاده از یک ابزار واحد ارائه می‌دهد.

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

پیش‌نیازها

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

• یک پروژه Google Cloud. برای ایجاد پروژه، ایجاد پروژه را ببینید.

• یک کارخواه MCP، مثل Google Antigravity.

• برای اجرای فرمان‌های موجود در این صفحه، gcloud CLI را در یکی از محیط‌های توسعه نرم‌افزار زیر راه‌اندازی کنید:

  Cloud Shell

  برای استفاده از ترمینال آنلاین با gcloud CLI که قبلاً راه‌اندازی شده است، Cloud Shell را فعال کنید:

  فعال کردن Cloud Shell

  پوسته محلی

  برای استفاده از محیط توسعه نرم‌افزار محلی، این مراحل را دنبال کنید:

  1. Google Cloud CLI را نصب کنید. اگر قبلاً gcloud CLI را نصب کرده‌اید، با اجرای gcloud components update مطمئن شوید که جدیدترین نسخه را دارید.
  2. اگر از ارائه‌دهنده هویت (IdP) خارجی استفاده می‌کنید، با هویت فدراسیونی خود به سیستم gcloud CLI وارد شوید. برای اطلاعات بیشتر، به ورود به سیستم gcloud CLI با هویت فدراسیونی مراجعه کنید.
  3. gcloud CLI را مقداردهی اولیه کنید.

پیکربندی سرور MCP «جستجوی همگانی»

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

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

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

CLI

gcloud services enable workspacemcp.googleapis.com \
  --project=PROJECT_ID

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

کنسول

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

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

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

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

اگر قبلاً صفحه رضایت OAuth را برای سرورهای MCP دیگر پیکربندی کرده‌اید، مطمئن شوید که گستره‌های لازم را برای «سرور MCP جستجوی جهانی» اضافه کرده‌اید.

وقتی با Universal Search MCP Server اصالت‌سنجی می‌کنید، می‌توانید انتخاب کنید که همه دامنه‌های درخواستی یا فقط زیرمجموعه‌ای از آن‌ها اصالت‌سنجی شوند. سرور به این انتخاب‌ها احترام می‌گذارد و فقط در محصولاتی جستجو می‌کند که دسترسی به آن‌ها اعطا شده است.

برای مثال، اگر با همه دامنه‌های زیر اصالت‌سنجی کنید:

• https://www.googleapis.com/auth/gmail.readonly
• https://www.googleapis.com/auth/drive.readonly
• https://www.googleapis.com/auth/calendar.readonly
• https://www.googleapis.com/auth/chat.messages.readonly
• https://www.googleapis.com/auth/chat.spaces.readonly
• https://www.googleapis.com/auth/chat.memberships.readonly

سرور MCP «جستجوی جهانی» در Gmail،‏ Google Drive، «تقویم Google»، و Google Chat جستجو خواهد کرد.

اما اگر https://www.googleapis.com/auth/gmail.readonly را حذف کنید و فقط به https://www.googleapis.com/auth/drive.readonly، https://www.googleapis.com/auth/calendar.readonly، https://www.googleapis.com/auth/chat.messages.readonly، https://www.googleapis.com/auth/chat.spaces.readonly، و https://www.googleapis.com/auth/chat.memberships.readonly دسترسی اعطا کنید، جستجوی جامع فقط نتایج Google Drive،‏ Google Calendar، و Google Chat را برمی‌گرداند. این ویژگی ایمیلتان را جستجو نمی‌کند یا نتایج Gmail را برنمی‌گرداند.

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

3. یک یا چند مورد از دامنه‌های زیر را اضافه کنید:

   • https://www.googleapis.com/auth/gmail.readonly
   • https://www.googleapis.com/auth/drive.readonly
   • https://www.googleapis.com/auth/calendar.readonly
   • https://www.googleapis.com/auth/chat.messages.readonly
   • https://www.googleapis.com/auth/chat.spaces.readonly
   • https://www.googleapis.com/auth/chat.memberships.readonly

   https://www.googleapis.com/auth/chat.spaces.readonly و https://www.googleapis.com/auth/chat.memberships.readonly را اضافه کنید تا سرور بتواند تشخیص دهد چه کسی در هر مکالمه Google Chat حضور دارد. بدون آن‌ها، نتایج Google Chat به‌عنوان هم‌رسانی‌شده خارجی درنظر گرفته می‌شود و ممکن است به تأیید کاربر نیاز داشته باشد یا فیلتر شود.

4. روی به‌روزرسانی و سپس ذخیره کلیک کنید.

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

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

برای افزودن «سرور MCP جستجوی جهانی» به کارخواه MCP خود، دستورالعمل‌های مربوط به کارخواه خود را دنبال کنید.

شناسه‌های کارخواه OAuth 2.0 واگذارشده به کاربر که با Universal Search MCP Server تماس می‌گیرند باید استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را در Google Auth Platform > کارخواه‌ها انتخاب کرده باشند. برای به‌روزرسانی شناسه کارخواه OAuth 2.0 موجود، این تنظیم را در پلاتفرم Google Auth > کارخواه‌ها انتخاب کنید، همان‌طور که در مدیریت کارخواه‌های OAuth شرح داده شده است. اگر نمی‌توانید این تنظیم را در کارخواه موجود تغییر دهید، یا اگر کارخواه از ویژگی‌های غیرعامل نیز پشتیبانی می‌کند، شناسه کارخواه OAuth 2.0 جدیدی برای عامل هوش مصنوعی خود ایجاد کنید. برای درخواست‌های ردشده، حساب‌های سرویس با واگذاری در سراسر دامنه، یا Google Apps Script، به عیب‌یابی مراجعه کنید.

Antigravity

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

1. یک شناسه کارخواه OAuth 2.0 و رمز از نوع برنامه وب ایجاد کنید. در بخش شناسه‌های URI هدایت مجاز، روی + افزودن شناسه URI کلیک کنید، سپس https://antigravity.google/oauth-callback را در فیلد شناسه‌های URI اضافه کنید. استفاده از این کارخواه برای عامل مجهز به هوش مصنوعی را انتخاب کنید. برای دستورالعمل‌ها، به پیکربندی سرورهای MCP در Google Workspace مراجعه کنید.

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

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

   {
     "mcpServers": {
       "workspace-universal": {
         "serverUrl": "https://workspacemcp.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 یا GUI‏ (Antigravity 2.0):

     1. صفحه تنظیمات را باز کنید (مثلاً روی تنظیمات در پایین سمت راست کلیک کنید یا تنظیمات کاربر Antigravity را باز کنید).
     2. به سفارشی‌سازی‌ها بروید.
     3. در بخش سرورهای MCP نصب‌شده، روی بازآوری کلیک کنید.
     4. workspace-universal را در فهرست پیدا کنید، روی اصالت‌سنجی کلیک کنید، به سیستم «حساب Google» خود وارد شوید، کد مجوز را کپی کنید، آن را در کادر گفتگوی ورودی جای‌گذاری کنید، و روی ارسال کلیک کنید.

   • برای Antigravity CLI:

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

        agy
        

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

        /mcp
        

     3. بااستفاده از کلیدهای جهت‌نما، workspace-universal را انتخاب کنید، به کنش اصالت‌سنجی بروید، و کلید ورود را فشار دهید. جریان ورود به سیستم را در مرورگرتان تکمیل کنید، کد مجوز را کپی کنید، آن را در پیام‌واره پایانه جای‌گذاری کنید، و کلید ورود را فشار دهید.

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

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

Claude

برای افزودن سرور MCP «جستجوی جهانی» به Claude، یک متصل‌کننده سفارشی پیکربندی کنید.

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

2. در تنظیمات Claude، یک متصل‌کننده سفارشی اضافه کنید:

   • نام سرور: Universal Search MCP Server
   • نشانی وب سرور MCP راه دور: https://workspacemcp.googleapis.com/mcp/v1
   • شناسه کارخواه OAuth و رمز کارخواه OAuth: اعتبارنامه‌هایتان را وارد کنید.
   • دامنه‌ها: شامل https://www.googleapis.com/auth/gmail.readonly، https://www.googleapis.com/auth/drive.readonly، https://www.googleapis.com/auth/calendar.readonly، https://www.googleapis.com/auth/chat.messages.readonly، https://www.googleapis.com/auth/chat.spaces.readonly، و https://www.googleapis.com/auth/chat.memberships.readonly.

آزمایش کردن سرور MCP «جستجوی همگانی»

از مشتری MCP خود سؤالاتی بپرسید که نیاز به جستجو در محصولات مختلف دارد:

• «هر چیزی را که به پروژه X مربوط می‌شود در ایمیل، اسناد، و پیام‌های گپ من پیدا کن.»
• «جلسه بعدی من درباره طرح بازاریابی چه زمانی است و جدیدترین یادداشت‌ها و پیام‌های گپ درباره آن چیست؟»

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

ابزارهای پشتیبانی‌شده

«سرور MCP جستجوی همگانی» ابزار زیر را ارائه می‌دهد. برای طرح‌واره‌های ورودی و خروجی، به مرجع MCP «جستجوی همگانی» مراجعه کنید.

• search_corpus: براساس پُرسمان ارائه‌شده، در چندین محصول Google Workspace، ازجمله Drive،‏ Gmail، «تقویم»، و Chat جستجو می‌کند.