Workspace için Evrensel Arama MCP Sunucusu ile yapay zeka temsilcilerinin Workspace'te arama yapmasına izin verme

Google Workspace için Evrensel Arama MCP Sunucusu, yapay zeka ajanlarının Workspace öğelerinizde arama yapmasına olanak tanımak için Model Context Protocol (MCP) standardını kullanır. Bu sunucu, tek bir araç kullanarak Gmail iletileri, Google Drive dosyaları, Google Takvim etkinlikleri ve Google Chat alanları ile iletileri de dahil olmak üzere birden fazla Google Workspace ürününde arama yapma olanağı sağlar.

Universal Search MCP Server, yapay zeka ajanlarının ürünlere özel araçları ayrı ayrı çağırmasına gerek kalmadan Google Workspace hesabınızın tamamında bilgi araması yapması için standartlaştırılmış bir yöntem sunar.

Ön koşullar

  • Google Cloud projesi. Proje oluşturmak için Proje oluşturma başlıklı makaleyi inceleyin.

  • Google Antigravity gibi bir MCP istemcisi.

  • Bu sayfadaki komutları çalıştırmak için gcloud CLI'yı aşağıdaki geliştirme ortamlarından birinde ayarlayın:

    Cloud Shell

    gcloud KSA'nın önceden ayarlandığı bir online terminal kullanmak için Cloud Shell'i etkinleştirin:

    Cloud Shell'i etkinleştirin.

    Yerel kabuk

    Yerel geliştirme ortamı kullanmak için aşağıdaki adımları uygulayın:

    1. Google Cloud KSA'yı yükleyin. gcloud CLI'yi daha önce yüklediyseniz gcloud components update komutunu çalıştırarak en son sürümü kullandığınızdan emin olun.
    2. Harici bir kimlik sağlayıcı (IdP) kullanıyorsanız birleştirilmiş kimliğinizle gcloud CLI'da oturum açın. Daha fazla bilgi için Federasyon kimliğinizle gcloud CLI'da oturum açma başlıklı makaleyi inceleyin.
    3. gcloud CLI'yı başlatın.

Evrensel Arama MCP sunucusunu yapılandırma

Universal Search MCP sunucusunu kullanmak için Google Cloud projenizde etkinleştirmeniz ve ardından MCP istemcinizi bu sunucuya bağlanacak şekilde yapılandırmanız gerekir.

API'leri etkinleştirme

Universal Search MCP Sunucusu'nu kullanmak için Google Cloud projenizde Google Workspace MCP API'yi ve arama yapmak istediğiniz ürünlerin API'lerini etkinleştirin:

  • Gmail API
  • Google Drive API
  • Google Calendar API
  • Google Chat API

  • Google Workspace MCP API

KSA

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

PROJECT_ID kısmını Google Cloud proje kimliğinizle değiştirin.

Konsol

Google Cloud Console'da API'leri etkinleştirin:

API'leri etkinleştirme

Evrensel Arama MCP Sunucusu, kimlik doğrulama ve yetkilendirme için OAuth 2.0'ı kullanır. OAuth istemci kimliği oluşturabilmeniz için önce OAuth kullanıcı rızası ekranını yapılandırmanız gerekir.

OAuth kullanıcı rızası ekranını diğer MCP sunucuları için daha önce yapılandırdıysanız Evrensel Arama MCP sunucusu için gerekli kapsamları eklediğinizden emin olun.

Universal Search MCP sunucusuyla kimlik doğruladığınızda, istenen kapsamların tümüyle veya yalnızca bir alt kümesiyle kimlik doğrulamayı seçebilirsiniz. Sunucu bu seçimlere uyar ve yalnızca erişim izni verilen ürünlerde arama yapar.

Örneğin, aşağıdaki kapsamların tümüyle kimlik doğrulama yapıyorsanız:

  • 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

Evrensel Arama MCP Sunucusu; Gmail, Google Drive, Google Takvim ve Google Chat'te arama yapar.

Ancak yalnızca https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly ve https://www.googleapis.com/auth/chat.messages.readonly'a erişim izni verirseniz (https://www.googleapis.com/auth/gmail.readonly'ı çıkarırsanız) evrensel arama yalnızca Google Drive, Google Takvim ve Google Chat'teki sonuçları döndürür. E-postanızı aramaz veya Gmail sonuçları döndürmez.

  1. Google Cloud Console'da Google Auth Platform > Data Access'e (Veri Erişimi) gidin.
  2. Kapsam Ekle veya Kaldır'ı tıklayın.

  3. Aşağıdaki kapsamları ekleyin:

    • 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. Güncelle'yi ve ardından Kaydet'i tıklayın.

Kullanıcı rızası ekranını ayarlamayla ilgili ayrıntılı talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

MCP istemcinizi yapılandırma

Evrensel Arama MCP Sunucusu'nu MCP istemcinize eklemek için istemcinize yönelik talimatları uygulayın.

Antigravity

Antigravity'ye Universal Search MCP sunucusunu eklemek için sunucu yapılandırmasını mcp_config.json dosyanıza ekleyin. Bu talimatlar Antigravity 2.0, Antigravity IDE ve Antigravity CLI'yı destekler.

  1. Web uygulaması türünde bir OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun. Yetkilendirilmiş yönlendirme URI'leri bölümünde + URI ekle'yi tıklayın ve ardından URI'ler alanına https://antigravity.google/oauth-callback ekleyin. Talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

  2. Yapılandırma dosyasını açın veya oluşturun ~/.gemini/antigravity/mcp_config.json.

  3. workspace-universal yapılandırmasını mcp_config.json'ye ekleyin:

    {
  "mcpServers": {
    "workspace-universal": {
      "serverUrl": "https://workspacemcp.googleapis.com/mcp/v1",
      "oauth": {
        "clientId": "OAUTH_CLIENT_ID",
        "clientSecret": "OAUTH_CLIENT_SECRET"
      }
    }
  }
}

    Aşağıdakini değiştirin:

    • OAUTH_CLIENT_ID: Oluşturduğunuz istemci kimliği.
    • OAUTH_CLIENT_SECRET: Oluşturduğunuz istemci gizli anahtarı.

  4. mcp_config.json tasarruf edin.

  5. MCP sunucusunun kimliğini doğrulayın. GUI ayarlarını veya KSA'yı kullanarak kimlik doğrulaması yapabilirsiniz:

    • Antigravity IDE veya GUI (Antigravity 2.0) için:

      1. Ayarlar ekranınızı açın (ör. sol alttaki Ayarlar'ı tıklayın veya Antigravity Kullanıcı Ayarları'nı açın).
      2. Özelleştirmeler'e gidin.
      3. Yüklü MCP Sunucuları bölümünde Yenile'yi tıklayın.
      4. Listede workspace-universal simgesini bulun, Authenticate'i (Kimlik doğrulama) tıklayın, Google Hesabınızda oturum açın, yetkilendirme kodunu kopyalayın, giriş iletişim kutusuna yapıştırın ve Submit'i (Gönder) tıklayın.

    • Antigravity CLI için:

      1. Antigravity CLI'yı başlatın:

        agy

      2. Aşağıdaki komutu çalıştırarak etkileşimli MCP yönetim panelini açın:

        /mcp

      3. Ok tuşlarını kullanarak workspace-universal simgesini seçin, Kimlik doğrulama işlemine gidin ve Enter tuşuna basın. Tarayıcınızda oturum açma akışını tamamlayın, yetkilendirme kodunu kopyalayın, terminal istemine yapıştırın ve Enter tuşuna basın.

  6. Sunucunun doğru şekilde yapılandırıldığını ve çalıştığını doğrulayın:

    • Antigravity IDE veya GUI için: Özelleştirmeler > Yüklü MCP Sunucuları bölümündeki workspace-universal simgesinin yanında bir Oturumu kapat düğmesi gösterilir.
    • Antigravity CLI için: Yapılandırılmış MCP sunucularınızı görüntülemek üzere /mcp panelini açın. Doğrulanmış ve kimliği doğrulanmış sunucular, etkileşimli TUI panelinde adlarının yanında Authed (Kimliği Doğrulanmış) ifadesini gösterir. Durumunu incelemek ve kullanılabilir tüm araçlarını listelemek için kontrol paneli görünümünde workspace-universal sunucusunu seçebilirsiniz.

Claude

Claude'a Universal Search MCP sunucusunu eklemek için özel bir bağlayıcı yapılandırın.

  1. Web uygulaması türünde bir OAuth 2.0 istemci kimliği ve gizli anahtarı oluşturun. Talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

  2. Claude ayarlarında özel bağlayıcı ekleyin:

    • Sunucu adı: Universal Search MCP Server
    • Uzak MCP sunucu URL'si: https://workspacemcp.googleapis.com/mcp/v1
    • OAuth istemci kimliği ve OAuth istemci gizli anahtarı: Kimlik bilgilerinizi girin.
    • Kapsamlar: https://www.googleapis.com/auth/gmail.readonly, https://www.googleapis.com/auth/drive.readonly, https://www.googleapis.com/auth/calendar.readonly ve https://www.googleapis.com/auth/chat.messages.readonly kapsamlarını dahil edin.

Genel Arama MCP Sunucusunu Test Etme

MCP müşterinize farklı ürünlerde arama yapmayı gerektiren sorular sormayı deneyin:

  • "E-postam, dokümanlarım ve sohbet mesajlarımda X projesiyle ilgili her şeyi bul."
  • "Pazarlama planıyla ilgili bir sonraki toplantım ne zaman ve bu toplantıyla ilgili en son notlar ve sohbet mesajları neler?"

Araçlar başarıyla çalışırsa ve birden fazla üründen alakalı yanıtlar alırsanız Universal Search MCP sunucunuz doğru şekilde yapılandırılmıştır.

Desteklenen araçlar

Evrensel Arama MCP Sunucusu aşağıdaki aracı sunar:

  • search_corpus: Belirtilen sorguya göre birden fazla Google Workspace ürününde (Google Drive, Gmail, Google Takvim ve Google Chat) arama yapar.