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

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

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

پیش‌نیازها

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

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

فعال کردن APIها

برای استفاده از سرور جستجوی جهانی 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 ، شناسه پروژه گوگل کلود خود را وارد کنید.

کنسول

فعال کردن APIها در کنسول Google Cloud:

فعال کردن APIها

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

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

وقتی با سرور جستجوی جهانی 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

سرور جستجوی جهانی MCP در Gmail، Google Drive، Google Calendar و 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/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 را احراز هویت کنید. می‌توانید با استفاده از تنظیمات GUI یا CLI احراز هویت کنید:

    • برای محیط برنامه‌نویسی یا رابط کاربری گرافیکی آنتی‌گراویتی (آنتی‌گراویتی ۲.۰):

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

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

      1. شروع رابط خط فرمان آنتی‌گراویتی:

        agy

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

        /mcp

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

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

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

کلود

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

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

  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 می‌شود.

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

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

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

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

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

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

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