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

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

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

پیش‌نیازها

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

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

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

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

CLI

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

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

کنسول

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

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

«سرور 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

«سرور MCP جستجوی جهانی» در Gmail،‏ Google Drive، «تقویم Google»، و 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»، و 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

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

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

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

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

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 پیکربندی‌شده‌تان را ببینید. سرورهای درستی‌سنجی‌شده و اصالت‌سنجی‌شده اصالت‌سنجی‌شده را در کنار نامشان در پانل تعاملی TUI نمایش می‌دهند. می‌توانید سرور workspace-universal را در نمای داشبورد انتخاب کنید تا وضعیت آن را بررسی کنید و همه ابزارهای دردسترس آن را فهرست کنید.

Claude

برای افزودن Universal Search MCP Server به 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.

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

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

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

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

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

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

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