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

Google Workspace için Universal Search MCP Sunucusu, yapay zeka ajanlarının Workspace yapılarınızı araması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, Google Chat alanları ve mesajları dahil olmak üzere birden fazla Google Workspace ürününde arama yapma imkanı sunar.

Universal Search MCP sunucusu, yapay zeka ajanlarının ürüne özel araçları ayrı ayrı çağırmasına gerek kalmadan tüm Google Workspace hesabınızda bilgi araması için standart bir yöntem sunar.

Ön koşullar

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 etkinleştirin:

KSA

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

PROJECT_ID yerine Google Cloud proje kimliğinizi yazın.

Konsol

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

API'leri etkinleştirme

Universal Search MCP sunucusu, kimlik doğrulama ve yetkilendirme için OAuth 2.0'ı kullanır. OAuth istemci kimliği oluşturabilmek 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 zaten yapılandırdıysanız Universal Search MCP sunucusu için gerekli kapsamları eklediğinizden emin olun.

Universal Search MCP sunucusuyla kimlik doğrulaması yaptığınızda, istenen tüm kapsamların veya yalnızca bir alt kümesinin kimliğini 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ğrulaması yaparsanı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

Universal Search 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 için erişim izni verirseniz (https://www.googleapis.com/auth/gmail.readonly için erişim izni vermezseniz) evrensel arama yalnızca Google Drive, Google Takvim ve Google Chat'ten sonuç döndürür. E-postalarınızda arama yapmaz veya Gmail sonuçlarını 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 kapsamlardan birini veya daha fazlasını 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

Universal Search MCP sunucusunu MCP istemcinize eklemek için istemcinizin talimatlarını uygulayın.

Antigravity

Universal Search MCP sunucusunu Antigravity'ye 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 URI'ler alanına https://antigravity.google/oauth-callback değerini ekleyin. Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin. Talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

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

  3. workspace-universal yapılandırmasını mcp_config.json hizmetine 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 uygulamasını bulun, Authenticate'i (Kimlik doğrula) 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şlatma:

        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 seçeneğini belirleyin, 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'a 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ünde workspace-universal'nin yanında Oturumu kapat düğmesi gösterilir.
    • Antigravity CLI için: Yapılandırılmış MCP sunucularınızı görüntülemek için /mcp panelini açın. Doğrulanmış ve kimliği doğrulanmış sunucuların adlarının yanında, etkileşimli TUI panelinde Authed (Kimliği Doğrulandı) ifadesi gösterilir. Durumunu incelemek ve mevcut tüm araçlarını listelemek için kontrol paneli görünümünde workspace-universal sunucusunu seçebilirsiniz.

Claude

Universal Search MCP sunucusunu Claude'a 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, ardından Bu istemciyi yapay zeka destekli bir temsilci için kullan'ı seçin. Talimatlar için Google Workspace MCP sunucularını yapılandırma başlıklı makaleyi inceleyin.

  2. Claude ayarlarında özel bir 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ı ekleyin.

Evrensel Arama MCP sunucusunu test etme

MCP istemcinize farklı ürünlerde arama yapmayı gerektiren sorular sormayı deneyin:

  • "E-postalarım, 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 konuyla ilgili en son notlar ve sohbet mesajları neler?"

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

Desteklenen araçlar

Universal Search MCP sunucusu aşağıdaki aracı sunar:

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