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

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

The Universal Search MCP Server provides a standardized way for AI agents to search for information across your entire Google Workspace account without needing to call individual product-specific tools.

پیش‌نیازها

پیکربندی سرور جستجوی جهانی MCP

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

Enable the APIs

برای استفاده از سرور جستجوی جهانی MCP، رابط برنامه‌نویسی کاربردی MCP گوگل ورک‌اسپیس و رابط‌های برنامه‌نویسی کاربردی (API) محصولاتی را که می‌خواهید در پروژه گوگل کلود خود جستجو کنید، فعال کنید:

  • رابط برنامه‌نویسی کاربردی جیمیل
  • رابط برنامه‌نویسی کاربردی گوگل درایو
  • رابط برنامه‌نویسی تقویم گوگل
  • رابط برنامه‌نویسی کاربردی گوگل چت

  • رابط برنامه‌نویسی کاربردی MCP گوگل ورک‌اسپیس

رابط خط فرمان 

gcloud services enable gmail.googleapis.com \
drive.googleapis.com \
calendar-json.googleapis.com \
chat.googleapis.com \
workspacemcp.googleapis.com --project=PROJECT_ID

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

کنسول

Enable the APIs in the Google Cloud console:

Enable the APIs

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

If you have already configured the OAuth consent screen for other MCP servers, ensure you have added the required scopes for the Universal Search MCP Server.

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

برای مثال، اگر با تمام حوزه‌های زیر احراز هویت کنید:

  • 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

Universal Search MCP Server will search across Gmail, Google Drive, Google Calendar, and Google Chat.

با این حال، اگر فقط به 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/gmail.readonly را حذف کنید)، جستجوی جهانی فقط نتایج Google Drive، Google Calendar و Google Chat را برمی‌گرداند. ایمیل شما را جستجو نمی‌کند یا نتایج Gmail را برنمی‌گرداند.

  1. در کنسول گوگل کلود، به مسیر Google Auth Platform > Data Access بروید.
  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

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

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

کلاینت MCP خود را پیکربندی کنید

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

ضد جاذبه

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

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

  2. فایل پیکربندی ~/.gemini/antigravity/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 : The client secret you created.

  4. mcp_config.json را ذخیره کنید.

  5. سرور MCP را احراز هویت کنید. می‌توانید با استفاده از تنظیمات GUI یا CLI احراز هویت کنید:

    • For Antigravity IDE or GUI (Antigravity 2.0):

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

    • برای رابط خط فرمان ضد جاذبه:

      1. Start Antigravity CLI:

        agy

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

        /mcp

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

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

    • برای Antigravity IDE یا GUI: یک دکمه خروج در کنار workspace-universal در بخش سفارشی‌سازی‌ها > سرورهای MCP نصب‌شده نمایش داده می‌شود.
    • For Antigravity CLI: Open the /mcp panel to view your configured MCP servers. Verified and authenticated servers display Authed next to their names inside the interactive TUI panel. You can select the workspace-universal server under the dashboard view to inspect its status and list all of its available tools.

کلود

برای افزودن سرور جستجوی جهانی MCP به کلود، یک کانکتور سفارشی پیکربندی کنید.

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

  2. In Claude settings, add a custom connector:

    • نام سرور : 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 می‌شود.

Test the Universal Search MCP Server

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

  • «هر چیزی که مربوط به پروژه X باشد را در ایمیل، اسناد و پیام‌های چت من پیدا کن.»
  • "When is my next meeting about the marketing plan, and what are the latest notes and chat messages on it?"

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

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

سرور جستجوی جهانی MCP ابزار زیر را ارائه می‌دهد:

  • search_corpus : بر اساس عبارت جستجو شده، جستجو را در چندین محصول Google Workspace (Google Drive، Gmail، Google Calendar و Google Chat) انجام می‌دهد.